#include <MathNTensor.hh>

Inheritance diagram for numeric::MathNTensor< T, N >:

Public Types
typedef numeric::Size	Size

typedef MathNTensorBase< T >	parent

Public Types inherited from numeric::MathNTensorBase< T >
typedef numeric::Size	Size

Public Member Functions
	MathNTensor ()
	Default constructor – make a MathNTensor that's 0-dimensional with 0 elements. More...

	MathNTensor (utility::fixedsizearray1< Size, N > const &n_bins, T const &value=T())
	Constructor: make a MathNTensor from fixedsizearray of dims and single element. More...

	MathNTensor (utility::vector1< Size > const &n_bins, T const &value=T())
	Constructor: make a MathNTensor from vector of dims and single element. More...

	MathNTensor (MathNTensor const &src)
	Copy constructor. More...

MathNTensorBaseOP< T >	clone () const override
	Implementation of pure virtual clone function from base class. More...

MathNTensor< T, N > &	operator= (MathNTensor< T, N > const &rhs)
	Assignment operator. More...

	~MathNTensor () override
	Destructor. More...

T	sum () const

bool	is_valid_position (utility::fixedsizearray1< Size, N > const &positions) const
	Is the position in the N-Tensor given by the positions vector a valid position? More...

bool	is_valid_position (utility::vector1< Size > const &positions) const override
	Is the given coordinate a valid position in the tensor? More...

void	set_value (utility::vector1< Size > const &position, T const &value_in) override
	Set a value in a tensor. More...

T const &	value (utility::vector1< Size > const &position) const override
	Get a value from a tensor. More...

	MathNTensor (utility::fixedsizearray1< Size, N > const &n_bins, T const *data)
	Raw pointer constructor. Avoid this. More...

Size	n_bins (Size const dimension) const override
	return number of bins for ith dimension More...

T	min () const override
	Get the minimum value stored in this tensor. More...

T	max () const override
	Get the maximum value stored in this tensor. More...

Size	num_dimensions () const
	Return number of dimensions overall (i.e. the dimensionality of this MathNTensor). More...

void	replace_layer (Size layer, MathNTensor< T, N-1 > const &matrix)
	Copies elements of argument matrix into this object at position ( layer ) More...

T const &	data (Size const index) const

void	replace_layer (Size const layer, MathMatrix< T > const &matrix)
	ONLY for 3-dimensional tensors, replace a layer with a 2D matrix. More...

MathMatrix< T >	get_mathmatrix ()
	ONLY for 2-dimensional tensors, give me a MathMatrix that's identical to the tensor. (That is, convert the MathNTensor to MathMatrix form. More...

T &	operator() (utility::fixedsizearray1< Size, N > const &position)
	Access a position in the N-dimensional tensor. More...

T const &	operator() (utility::fixedsizearray1< Size, N > const &position) const
	Use an N-vector of coordinates to access a position in the N-dimensional tensor. More...

T &	operator() (utility::vector1< Size > const &position)

T const &	operator() (utility::vector1< Size > const &position) const

T &	operator() (Size const b1, Size const b2)

T &	operator() (Size const b1, Size const b2) const

T &	operator() (Size const b1, Size const b2, Size const b3)

T const &	operator() (Size const b1, Size const b2, Size const b3) const

T &	operator() (Size const b1, Size const b2, Size const b3, Size const b4)

T const &	operator() (Size const b1, Size const b2, Size const b3, Size const b4) const

T const &	operator() (Size const b1, Size const b2, Size const b3, Size const b4, Size const b5) const

T const &	operator() (Size const b1, Size const b2, Size const b3, Size const b4, Size const b5, Size const b6) const

void	operator/= (Real const divisor)

Size	size () const

utility::fixedsizearray1< Size, N > const &	n_bins () const

Public Member Functions inherited from numeric::MathNTensorBase< T >
	MathNTensorBase ()
	Default constructor. More...

virtual	~MathNTensorBase ()
	Virtual destructor needed for polymorphism. More...

	MathNTensorBase (Size const dimensionality_in)
	Costructor with dimensionality value. More...

Size	dimensionality () const
	Get the dimensionality of derived classes. More...

Private Attributes
utility::fixedsizearray1< Size, N >	n_bins_

Size	size_
	The total number of bins in the MathNTensor (the product of all dimensions). More...

T *	data_
	Array of data stored in this N-tensor. More...

Additional Inherited Members
Protected Member Functions inherited from numeric::MathNTensorBase< T >
void	set_dimensionality (Size const dimensionality_in)
	Lets the derived class set the dimensionality stored in the base class. More...

Member Typedef Documentation

◆ parent

template<class T , numeric::Size N>

typedef MathNTensorBase<T> numeric::MathNTensor< T, N >::parent

◆ Size

template<class T , numeric::Size N>

typedef numeric::Size numeric::MathNTensor< T, N >::Size

Constructor & Destructor Documentation

◆ MathNTensor() [1/5]

template<class T , numeric::Size N>

numeric::MathNTensor< T, N >::MathNTensor ( )

inline

Default constructor – make a MathNTensor that's 0-dimensional with 0 elements.

References numeric::MathNTensor< T, N >::data_, and numeric::MathNTensor< T, N >::size_.

◆ MathNTensor() [2/5]

template<class T , numeric::Size N>

numeric::MathNTensor< T, N >::MathNTensor	(	utility::fixedsizearray1< Size, N > const &	n_bins,
		T const &	value = `T()`
	)

inline

Constructor: make a MathNTensor from fixedsizearray of dims and single element.

The single element gets copied to every entry in the MathNTensor, initializing it.

References numeric::MathNTensor< T, N >::data_, detail::fill(), create_a3b_hbs::i, N, numeric::MathNTensor< T, N >::n_bins(), numeric::MathNTensor< T, N >::size_, and numeric::MathNTensor< T, N >::value().

◆ MathNTensor() [3/5]

template<class T , numeric::Size N>

numeric::MathNTensor< T, N >::MathNTensor	(	utility::vector1< Size > const &	n_bins,
		T const &	value = `T()`
	)

inline

Constructor: make a MathNTensor from vector of dims and single element.

The single element gets copied to every entry in the MathNTensor, initializing it.

References numeric::MathNTensor< T, N >::data_, detail::fill(), create_a3b_hbs::i, N, numeric::MathNTensor< T, N >::n_bins(), numeric::MathNTensor< T, N >::n_bins_, runtime_assert, utility::fixedsizearray1< T, S >::size(), numeric::MathNTensor< T, N >::size_, and numeric::MathNTensor< T, N >::value().

◆ MathNTensor() [4/5]

template<class T , numeric::Size N>

numeric::MathNTensor< T, N >::MathNTensor ( MathNTensor< T, N > const & src )

inline

Copy constructor.

References erraser_util::copy(), numeric::MathNTensor< T, N >::data_, and numeric::MathNTensor< T, N >::size_.

◆ ~MathNTensor()

template<class T , numeric::Size N>

numeric::MathNTensor< T, N >::~MathNTensor ( )

inlineoverride

Destructor.

References numeric::MathNTensor< T, N >::data_.

◆ MathNTensor() [5/5]

template<class T , numeric::Size N>

numeric::MathNTensor< T, N >::MathNTensor	(	utility::fixedsizearray1< Size, N > const &	n_bins,
		T const *	data
	)

inline

Raw pointer constructor. Avoid this.

References numeric::MathNTensor< T, N >::data(), numeric::MathNTensor< T, N >::data_, create_a3b_hbs::i, create_a3b_hbs::ii, N, numeric::MathNTensor< T, N >::n_bins_, and numeric::MathNTensor< T, N >::size_.

Member Function Documentation

◆ clone()

template<class T , numeric::Size N>

MathNTensorBaseOP< T > numeric::MathNTensor< T, N >::clone ( ) const

inlineoverridevirtual

Implementation of pure virtual clone function from base class.

Creates a copy of this object and returns an owning pointer to the copy. Must be implemented by derived classes.

Implements numeric::MathNTensorBase< T >.

Referenced by numeric::deep_copy().

◆ data()

template<class T , numeric::Size N>

T const& numeric::MathNTensor< T, N >::data ( Size const index ) const

inline

References numeric::MathNTensor< T, N >::data_, runtime_assert, and numeric::MathNTensor< T, N >::size_.

Referenced by numeric::MathNTensor< T, N >::MathNTensor(), and numeric::write_tensor_to_file_without_json().

◆ get_mathmatrix()

template<class T , numeric::Size N>

MathMatrix< T > numeric::MathNTensor< T, N >::get_mathmatrix ( )

inline

ONLY for 2-dimensional tensors, give me a MathMatrix that's identical to the tensor. (That is, convert the MathNTensor to MathMatrix form.

Throws if this is not a 2D tensor.

Returns: A MathMatrix containing the full contents of the MathNTensor.

Author: Vikram K. Mulligan (vmull.nosp@m.ig@u.nosp@m.w.edu).

References count, numeric::MathNTensor< T, N >::data_, create_a3b_hbs::i, create_a3b_hbs::j, N, numeric::MathNTensor< T, N >::n_bins_, and runtime_assert_string_msg.

◆ is_valid_position() [1/2]

template<class T , numeric::Size N>

bool numeric::MathNTensor< T, N >::is_valid_position ( utility::fixedsizearray1< Size, N > const & positions ) const

inline

Is the position in the N-Tensor given by the positions vector a valid position?

Returns true if each coordinate is in the range [1, dimension], false otherwise.

References create_a3b_hbs::i, N, and numeric::MathNTensor< T, N >::n_bins_.

Referenced by numeric::MathNTensor< T, N >::operator()(), numeric::MathNTensor< T, N >::replace_layer(), numeric::MathNTensor< T, N >::set_value(), and numeric::MathNTensor< T, N >::value().

◆ is_valid_position() [2/2]

template<class T , numeric::Size N>

bool numeric::MathNTensor< T, N >::is_valid_position ( utility::vector1< Size > const & position ) const

inlineoverridevirtual

Is the given coordinate a valid position in the tensor?

Returns false if out of range. Pure virtual; must be implemented by derived classes.

Implements numeric::MathNTensorBase< T >.

References create_a3b_hbs::i, N, and numeric::MathNTensor< T, N >::n_bins_.

◆ max()

template<class T , numeric::Size N>

T numeric::MathNTensor< T, N >::max ( ) const

inlineoverridevirtual

Get the maximum value stored in this tensor.

Implements pure virtual from base class.

Implements numeric::MathNTensorBase< T >.

References numeric::MathNTensor< T, N >::data_, and numeric::MathNTensor< T, N >::size_.

◆ min()

template<class T , numeric::Size N>

T numeric::MathNTensor< T, N >::min ( ) const

inlineoverridevirtual

Get the minimum value stored in this tensor.

Implements pure virtual from base class.

Implements numeric::MathNTensorBase< T >.

References numeric::MathNTensor< T, N >::data_, and numeric::MathNTensor< T, N >::size_.

◆ n_bins() [1/2]

template<class T , numeric::Size N>

utility::fixedsizearray1< Size, N > const& numeric::MathNTensor< T, N >::n_bins ( ) const

inline

References numeric::MathNTensor< T, N >::n_bins_.

Referenced by numeric::MathNTensor< T, N >::MathNTensor(), and numeric::MathNTensor< T, N >::operator()().

◆ n_bins() [2/2]

template<class T , numeric::Size N>

Size numeric::MathNTensor< T, N >::n_bins ( Size const dimension ) const

inlineoverridevirtual

return number of bins for ith dimension

Implements numeric::MathNTensorBase< T >.

References numeric::MathNTensor< T, N >::n_bins_.

Referenced by numeric::interpolation::multilinear_interpolation(), numeric::interpolation::spline::PolycubicSpline< N >::train(), and numeric::write_tensor_to_file().

◆ num_dimensions()

template<class T , numeric::Size N>

Size numeric::MathNTensor< T, N >::num_dimensions ( ) const

inline

Return number of dimensions overall (i.e. the dimensionality of this MathNTensor).

References N.

Referenced by numeric::MathNTensor< T, N >::operator=().

◆ operator()() [1/12]

template<class T , numeric::Size N>

T& numeric::MathNTensor< T, N >::operator()	(	Size const	b1,
		Size const	b2
	)

inline

References docking::b1, docking::b2, numeric::MathNTensor< T, N >::data_, N, and numeric::MathNTensor< T, N >::n_bins().

◆ operator()() [2/12]

template<class T , numeric::Size N>

T& numeric::MathNTensor< T, N >::operator()	(	Size const	b1,
		Size const	b2
	)		const

inline

References docking::b1, docking::b2, numeric::MathNTensor< T, N >::data_, N, and numeric::MathNTensor< T, N >::n_bins().

◆ operator()() [3/12]

template<class T , numeric::Size N>

T& numeric::MathNTensor< T, N >::operator()	(	Size const	b1,
		Size const	b2,
		Size const	b3
	)

inline

References docking::b1, docking::b2, docking::b3, numeric::MathNTensor< T, N >::data_, N, numeric::MathNTensor< T, N >::n_bins(), and runtime_assert.

◆ operator()() [4/12]

template<class T , numeric::Size N>

T const& numeric::MathNTensor< T, N >::operator()	(	Size const	b1,
		Size const	b2,
		Size const	b3
	)		const

inline

References docking::b1, docking::b2, docking::b3, numeric::MathNTensor< T, N >::data_, N, numeric::MathNTensor< T, N >::n_bins(), and runtime_assert.

◆ operator()() [5/12]

template<class T , numeric::Size N>

T& numeric::MathNTensor< T, N >::operator()	(	Size const	b1,
		Size const	b2,
		Size const	b3,
		Size const	b4
	)

inline

References docking::b1, docking::b2, docking::b3, numeric::MathNTensor< T, N >::data_, N, numeric::MathNTensor< T, N >::n_bins(), and runtime_assert.

◆ operator()() [6/12]

template<class T , numeric::Size N>

T const& numeric::MathNTensor< T, N >::operator()	(	Size const	b1,
		Size const	b2,
		Size const	b3,
		Size const	b4
	)		const

inline

References docking::b1, docking::b2, docking::b3, numeric::MathNTensor< T, N >::data_, N, numeric::MathNTensor< T, N >::n_bins(), and runtime_assert.

◆ operator()() [7/12]

template<class T , numeric::Size N>

T const& numeric::MathNTensor< T, N >::operator()	(	Size const	b1,
		Size const	b2,
		Size const	b3,
		Size const	b4,
		Size const	b5
	)		const

inline

References docking::b1, docking::b2, docking::b3, N, and numeric::MathNTensor< T, N >::n_bins().

◆ operator()() [8/12]

template<class T , numeric::Size N>

T const& numeric::MathNTensor< T, N >::operator()	(	Size const	b1,
		Size const	b2,
		Size const	b3,
		Size const	b4,
		Size const	b5,
		Size const	b6
	)		const

inline

References docking::b1, docking::b2, docking::b3, N, and numeric::MathNTensor< T, N >::n_bins().

◆ operator()() [9/12]

template<class T , numeric::Size N>

T& numeric::MathNTensor< T, N >::operator() ( utility::fixedsizearray1< Size, N > const & position )

inline

Access a position in the N-dimensional tensor.

Accessors, both as const and nonconst reference and via fixedsizearray1, vector1, or sequences of values.

References numeric::MathNTensor< T, N >::data_, create_a3b_hbs::i, numeric::MathNTensor< T, N >::is_valid_position(), N, numeric::MathNTensor< T, N >::n_bins_, and runtime_assert_string_msg.

◆ operator()() [10/12]

template<class T , numeric::Size N>

T const& numeric::MathNTensor< T, N >::operator() ( utility::fixedsizearray1< Size, N > const & position ) const

inline

Use an N-vector of coordinates to access a position in the N-dimensional tensor.

Const access (assignment prohibited).

References numeric::MathNTensor< T, N >::data_, create_a3b_hbs::i, numeric::MathNTensor< T, N >::is_valid_position(), N, numeric::MathNTensor< T, N >::n_bins_, and runtime_assert_string_msg.

◆ operator()() [11/12]

template<class T , numeric::Size N>

T& numeric::MathNTensor< T, N >::operator() ( utility::vector1< Size > const & position )

inline

References numeric::MathNTensor< T, N >::data_, create_a3b_hbs::i, numeric::MathNTensor< T, N >::is_valid_position(), N, numeric::MathNTensor< T, N >::n_bins_, and runtime_assert_string_msg.

◆ operator()() [12/12]

template<class T , numeric::Size N>

T const& numeric::MathNTensor< T, N >::operator() ( utility::vector1< Size > const & position ) const

inline

References numeric::MathNTensor< T, N >::data_, create_a3b_hbs::i, numeric::MathNTensor< T, N >::is_valid_position(), N, numeric::MathNTensor< T, N >::n_bins_, and runtime_assert_string_msg.

◆ operator/=()

template<class T , numeric::Size N>

void numeric::MathNTensor< T, N >::operator/= ( Real const divisor )

inline

References numeric::MathNTensor< T, N >::data_, create_a3b_hbs::ii, and numeric::MathNTensor< T, N >::size_.

◆ operator=()

template<class T , numeric::Size N>

MathNTensor< T, N >& numeric::MathNTensor< T, N >::operator= ( MathNTensor< T, N > const & rhs )

inline

Assignment operator.

References erraser_util::copy(), numeric::MathNTensor< T, N >::data_, numeric::MathNTensor< T, N >::n_bins_, numeric::MathNTensor< T, N >::num_dimensions(), numeric::MathNTensorBase< T >::set_dimensionality(), and numeric::MathNTensor< T, N >::size_.

◆ replace_layer() [1/2]

template<class T , numeric::Size N>

void numeric::MathNTensor< T, N >::replace_layer	(	Size const	layer,
		MathMatrix< T > const &	matrix
	)

inline

ONLY for 3-dimensional tensors, replace a layer with a 2D matrix.

References numeric::MathNTensor< T, N >::data_, create_a3b_hbs::ii, numeric::MathNTensor< T, N >::is_valid_position(), beta_nonlocal::jj, basic::options::OptionKeys::flxbb::layer::layer, matrix, N, numeric::MathNTensor< T, N >::n_bins_, and runtime_assert.

◆ replace_layer() [2/2]

template<class T , numeric::Size N>

void numeric::MathNTensor< T, N >::replace_layer	(	Size	layer,
		MathNTensor< T, N-1 > const &	matrix
	)

inline

Copies elements of argument matrix into this object at position ( layer )

layer is the FIRST index.

References numeric::MathNTensor< T, N >::data_, create_a3b_hbs::i, create_a3b_hbs::ii, internal_coordinates::indices, numeric::MathNTensor< T, N >::is_valid_position(), basic::options::OptionKeys::flxbb::layer::layer, matrix, N, numeric::MathNTensor< T, N >::n_bins_, offset, kmeans_adaptive_kernel_density_bb_dependent_rotlib::p, and runtime_assert.

◆ set_value()

template<class T , numeric::Size N>

void numeric::MathNTensor< T, N >::set_value	(	utility::vector1< Size > const &	position,
		T const &	value_in
	)

inlineoverridevirtual

Set a value in a tensor.

Note that bounds-checking only occurs in debug builds!

Note: Implements pure virtual function from base class.

Author: Vikram K. Mulligan (vmull.nosp@m.igan.nosp@m.@flat.nosp@m.iron.nosp@m.insti.nosp@m.tute.nosp@m..org)

Implements numeric::MathNTensorBase< T >.

References debug_assert, create_a3b_hbs::i, numeric::MathNTensor< T, N >::is_valid_position(), N, and runtime_assert.

◆ size()

template<class T , numeric::Size N>

Size numeric::MathNTensor< T, N >::size ( ) const

inline

References numeric::MathNTensor< T, N >::size_.

Referenced by numeric::write_tensor_to_file_without_json().

◆ sum()

template<class T , numeric::Size N>

T numeric::MathNTensor< T, N >::sum ( ) const

inline

References ObjexxFCL::internal::ObserverMediator::accumulate(), numeric::MathNTensor< T, N >::data_, numeric::MathNTensor< T, N >::size_, and pyrosetta.distributed.cluster.exceptions::T.

◆ value()

template<class T , numeric::Size N>

T const& numeric::MathNTensor< T, N >::value ( utility::vector1< Size > const & position ) const

inlineoverridevirtual

Get a value from a tensor.

Note that bounds-checking only occurs in debug builds!

Note: Implements pure virtual function from base class.

Author: Vikram K. Mulligan (vmull.nosp@m.igan.nosp@m.@flat.nosp@m.iron.nosp@m.insti.nosp@m.tute.nosp@m..org)

Implements numeric::MathNTensorBase< T >.

References debug_assert, create_a3b_hbs::i, numeric::MathNTensor< T, N >::is_valid_position(), N, and runtime_assert.

Referenced by numeric::MathNTensor< T, N >::MathNTensor().

Member Data Documentation

◆ data_

template<class T , numeric::Size N>

T* numeric::MathNTensor< T, N >::data_

private

Array of data stored in this N-tensor.

Referenced by numeric::MathNTensor< T, N >::data(), numeric::MathNTensor< T, N >::get_mathmatrix(), numeric::MathNTensor< T, N >::MathNTensor(), numeric::MathNTensor< T, N >::max(), numeric::MathNTensor< T, N >::min(), numeric::MathNTensor< T, N >::operator()(), numeric::MathNTensor< T, N >::operator/=(), numeric::MathNTensor< T, N >::operator=(), numeric::MathNTensor< T, N >::replace_layer(), numeric::MathNTensor< T, N >::sum(), and numeric::MathNTensor< T, N >::~MathNTensor().

◆ n_bins_

template<class T , numeric::Size N>

utility::fixedsizearray1< Size, N > numeric::MathNTensor< T, N >::n_bins_

private

Referenced by numeric::MathNTensor< T, N >::get_mathmatrix(), numeric::MathNTensor< T, N >::is_valid_position(), numeric::MathNTensor< T, N >::MathNTensor(), numeric::MathNTensor< T, N >::n_bins(), numeric::MathNTensor< T, N >::operator()(), numeric::MathNTensor< T, N >::operator=(), and numeric::MathNTensor< T, N >::replace_layer().

◆ size_

template<class T , numeric::Size N>

Size numeric::MathNTensor< T, N >::size_

private

The total number of bins in the MathNTensor (the product of all dimensions).

Referenced by numeric::MathNTensor< T, N >::data(), numeric::MathNTensor< T, N >::MathNTensor(), numeric::MathNTensor< T, N >::max(), numeric::MathNTensor< T, N >::min(), numeric::MathNTensor< T, N >::operator/=(), numeric::MathNTensor< T, N >::operator=(), numeric::MathNTensor< T, N >::size(), and numeric::MathNTensor< T, N >::sum().

The documentation for this class was generated from the following files:

src/numeric/MathNTensor.fwd.hh
src/numeric/MathNTensor.hh

Public Types

Public Member Functions

Private Attributes

Additional Inherited Members

Member Typedef Documentation

◆ parent

◆ Size

Constructor & Destructor Documentation

◆ MathNTensor() [1/5]

◆ MathNTensor() [2/5]

◆ MathNTensor() [3/5]

◆ MathNTensor() [4/5]

◆ ~MathNTensor()

◆ MathNTensor() [5/5]

Member Function Documentation

◆ clone()

◆ data()

◆ get_mathmatrix()

◆ is_valid_position() [1/2]

◆ is_valid_position() [2/2]

◆ max()

◆ min()

◆ n_bins() [1/2]

◆ n_bins() [2/2]

◆ num_dimensions()

◆ operator()() [1/12]

◆ operator()() [2/12]

◆ operator()() [3/12]

◆ operator()() [4/12]

◆ operator()() [5/12]

◆ operator()() [6/12]

◆ operator()() [7/12]

◆ operator()() [8/12]

◆ operator()() [9/12]

◆ operator()() [10/12]

◆ operator()() [11/12]

◆ operator()() [12/12]

◆ operator/=()

◆ operator=()

◆ replace_layer() [1/2]

◆ replace_layer() [2/2]

◆ set_value()

◆ size()

◆ sum()

◆ value()

Member Data Documentation

◆ data_

◆ n_bins_

◆ size_