A class to contain the data and executors for a field and define some basic operations. More...

#include <vector.hpp>

Public Types
using	VectorValueType = ValueType

Public Member Functions
	Vector (const Executor &exec, localIdx size)
	Create an uninitialized Vector with a given size on an executor.

	Vector (const Executor &exec, const ValueType *in, localIdx size, Executor hostExec=SerialExecutor())
	Create a Vector with a given size from existing memory on an executor.

	Vector (const Executor &exec, localIdx size, ValueType value)
	Create a Vector with a given size on an executor and uniform value.

	Vector (const Executor &exec, std::vector< ValueType > in)
	Create a Vector from a given vector of values on an executor.

	Vector (const Executor &exec, const Vector< ValueType > &in)
	Create a Vector as a copy of a Vector on a specified executor.

	Vector (const Vector< ValueType > &rhs)
	Copy constructor, creates a new field with the same size and data as the parsed field.

	Vector (Vector< ValueType > &&rhs) noexcept
	Move constructor, moves the data from the parsed field to the new field.

	~Vector ()
	Destroy the Vector object.

template<typename func >
void	apply (func f)
	applies a functor, transformation, to the field

Vector< ValueType >	copyToExecutor (Executor dstExec) const
	Copies the data to a new field on a specific executor.

Vector< ValueType >	copyToHost () const
	Returns a copy of the field back to the host.

void	copyToHost (Vector< ValueType > &result)
	Copies the data (from anywhere) to a parsed host field.

ValueType &	operator[] (const localIdx i)=delete

const ValueType &	operator[] (const localIdx i) const =delete

void	operator= (const ValueType &rhs)
	Assignment operator, Sets the field values to that of the passed value.

void	operator= (const Vector< ValueType > &rhs)
	Assignment operator, Sets the field values to that of the parsed field.

Vector< ValueType > &	operator+= (const Vector< ValueType > &rhs)
	Arithmetic add operator, addition of a second field.

Vector< ValueType > &	operator-= (const Vector< ValueType > &rhs)
	Arithmetic subtraction operator, subtraction by a second field.

Vector< ValueType >	operator* (const Vector< scalar > &rhs)
	Arithmetic multiply operator, multiply by a second field.

Vector< ValueType >	operator* (const scalar rhs)
	Arithmetic multiply operator, multiplies every cell in the field by a scalar.

Vector< ValueType > &	operator*= (const Vector< scalar > &rhs)
	Arithmetic multiply operator, multiplies this field by another field element-wise.

Vector< ValueType > &	operator*= (const scalar rhs)
	Arithmetic multiply-assignment operator, multiplies every cell in the field by a scalar and updates the field in place.

void	resize (const localIdx size)
	Resizes the field to a new size.

ValueType *	data ()
	Direct access to the underlying field data.

const ValueType *	data () const
	Direct access to the underlying field data.

const Executor &	exec () const
	Gets the executor associated with the field.

localIdx	size () const
	Gets the size of the field.

label	ssize () const
	Gets the size of the field.

bool	empty () const
	Checks if the field is empty.

View< ValueType >	view () &&=delete

View< const ValueType >	view () const &&=delete

View< ValueType >	view () &
	Gets the field as a view.

View< const ValueType >	view () const &
	Gets the field as a view.

View< ValueType >	view (std::pair< localIdx, localIdx > range) &&=delete

View< const ValueType >	view (std::pair< localIdx, localIdx > range) const &&=delete

View< ValueType >	view (std::pair< localIdx, localIdx > range) &
	Gets a sub view of the field as a view.

View< const ValueType >	view (std::pair< localIdx, localIdx > range) const &
	Gets a sub view of the field as a view.

std::pair< localIdx, localIdx >	range () const
	Gets the range of the field.

Detailed Description

template<typename ValueType>
class NeoN::Vector< ValueType >

A class to contain the data and executors for a field and define some basic operations.

Definition at line 52 of file vector.hpp.

Member Typedef Documentation

◆ VectorValueType

template<typename ValueType >

using NeoN::Vector< ValueType >::VectorValueType = ValueType

Definition at line 57 of file vector.hpp.

Constructor & Destructor Documentation

◆ Vector() [1/7]

template<typename ValueType >

NeoN::Vector< ValueType >::Vector	(	const Executor &	exec,
		localIdx	size
	)

inline

Create an uninitialized Vector with a given size on an executor.

Parameters

exec	Executor associated to the field
size	size of the field

Definition at line 64 of file vector.hpp.

◆ Vector() [2/7]

template<typename ValueType >

NeoN::Vector< ValueType >::Vector	(	const Executor &	exec,
		const ValueType *	in,
		localIdx	size,
		Executor	hostExec = `SerialExecutor()`
	)

inline

Create a Vector with a given size from existing memory on an executor.

Parameters

exec	Executor associated to the field
in	Pointer to existing data
size	size of the field
hostExec	Executor where the original data is located

Definition at line 82 of file vector.hpp.

◆ Vector() [3/7]

template<typename ValueType >

NeoN::Vector< ValueType >::Vector	(	const Executor &	exec,
		localIdx	size,
		ValueType	value
	)

inline

Create a Vector with a given size on an executor and uniform value.

Parameters

exec	Executor associated to the field
size	size of the field
value	the default value

Definition at line 106 of file vector.hpp.

◆ Vector() [4/7]

template<typename ValueType >

NeoN::Vector< ValueType >::Vector	(	const Executor &	exec,
		std::vector< ValueType >	in
	)

inline

Create a Vector from a given vector of values on an executor.

Parameters

exec	Executor associated to the field
in	a vector of elements to copy over

Definition at line 124 of file vector.hpp.

◆ Vector() [5/7]

template<typename ValueType >

NeoN::Vector< ValueType >::Vector	(	const Executor &	exec,
		const Vector< ValueType > &	in
	)

inline

Create a Vector as a copy of a Vector on a specified executor.

Parameters

exec	Executor associated to the field
in	a Vector of elements to copy over

Definition at line 133 of file vector.hpp.

◆ Vector() [6/7]

template<typename ValueType >

NeoN::Vector< ValueType >::Vector ( const Vector< ValueType > & rhs )

inline

Copy constructor, creates a new field with the same size and data as the parsed field.

Parameters

rhs	The field to copy from.

Definition at line 141 of file vector.hpp.

◆ Vector() [7/7]

template<typename ValueType >

NeoN::Vector< ValueType >::Vector ( Vector< ValueType > && rhs )

inlinenoexcept

Move constructor, moves the data from the parsed field to the new field.

Parameters

rhs	The field to move from.

Definition at line 147 of file vector.hpp.

◆ ~Vector()

template<typename ValueType >

NeoN::Vector< ValueType >::~Vector ( )

inline

Destroy the Vector object.

Definition at line 156 of file vector.hpp.

Member Function Documentation

◆ apply()

template<typename ValueType >

template<typename func >

void NeoN::Vector< ValueType >::apply ( func f )

inline

applies a functor, transformation, to the field

Parameters

f	The functor to map over the field.

Note: Ideally the f should be a KOKKOS_LAMBA

Definition at line 168 of file vector.hpp.

◆ copyToExecutor()

template<typename ValueType >

Vector< ValueType > NeoN::Vector< ValueType >::copyToExecutor ( Executor dstExec ) const

inline

Copies the data to a new field on a specific executor.

Parameters

dstExec The executor on which the data should be copied.

Returns: A copy of the field on the host.

Definition at line 178 of file vector.hpp.

◆ copyToHost() [1/2]

template<typename ValueType >

Vector< ValueType > NeoN::Vector< ValueType >::copyToHost ( ) const

inline

Returns a copy of the field back to the host.

Returns: A copy of the field on the host.

Definition at line 192 of file vector.hpp.

◆ copyToHost() [2/2]

template<typename ValueType >

void NeoN::Vector< ValueType >::copyToHost ( Vector< ValueType > & result )

inline

Copies the data (from anywhere) to a parsed host field.

Parameters

result The field into which the data must be copied. Must be sized.

Warning: exits if the size of the result field is not the same as the source field.

Definition at line 202 of file vector.hpp.

◆ data() [1/2]

template<typename ValueType >

ValueType * NeoN::Vector< ValueType >::data ( )

inline

Direct access to the underlying field data.

Returns: Pointer to the first cell data in the field.

Definition at line 346 of file vector.hpp.

◆ data() [2/2]

template<typename ValueType >

const ValueType * NeoN::Vector< ValueType >::data ( ) const

inline

Direct access to the underlying field data.

Returns: Pointer to the first cell data in the field.

Definition at line 352 of file vector.hpp.

◆ empty()

template<typename ValueType >

bool NeoN::Vector< ValueType >::empty ( ) const

inline

Checks if the field is empty.

Returns: True if the field is empty, false otherwise.

Definition at line 376 of file vector.hpp.

◆ exec()

template<typename ValueType >

const Executor & NeoN::Vector< ValueType >::exec ( ) const

inline

Gets the executor associated with the field.

Returns: Reference to the executor.

Definition at line 358 of file vector.hpp.

◆ operator*() [1/2]

template<typename ValueType >

Vector< ValueType > NeoN::Vector< ValueType >::operator* ( const scalar rhs )

inline

Arithmetic multiply operator, multiplies every cell in the field by a scalar.

Parameters

rhs	The scalar to multiply with the field.

Returns: The result of the multiplication.

Definition at line 282 of file vector.hpp.

◆ operator*() [2/2]

template<typename ValueType >

Vector< ValueType > NeoN::Vector< ValueType >::operator* ( const Vector< scalar > & rhs )

inline

Arithmetic multiply operator, multiply by a second field.

Parameters

rhs	The field to subtract from this field.

Returns: The result of the multiply.

Definition at line 267 of file vector.hpp.

◆ operator*=() [1/2]

template<typename ValueType >

Vector< ValueType > & NeoN::Vector< ValueType >::operator*= ( const scalar rhs )

inline

Arithmetic multiply-assignment operator, multiplies every cell in the field by a scalar and updates the field in place.

Parameters

rhs	The scalar to multiply with the field.

Definition at line 308 of file vector.hpp.

◆ operator*=() [2/2]

template<typename ValueType >

Vector< ValueType > & NeoN::Vector< ValueType >::operator*= ( const Vector< scalar > & rhs )

inline

Arithmetic multiply operator, multiplies this field by another field element-wise.

Parameters

rhs	The field to multiply with this field.

Returns: The result of the element-wise multiplication.

Definition at line 295 of file vector.hpp.

◆ operator+=()

template<typename ValueType >

Vector< ValueType > & NeoN::Vector< ValueType >::operator+= ( const Vector< ValueType > & rhs )

inline

Arithmetic add operator, addition of a second field.

Parameters

rhs	The field to add with this field.

Returns: The result of the addition.

Definition at line 243 of file vector.hpp.

◆ operator-=()

template<typename ValueType >

Vector< ValueType > & NeoN::Vector< ValueType >::operator-= ( const Vector< ValueType > & rhs )

inline

Arithmetic subtraction operator, subtraction by a second field.

Parameters

rhs	The field to subtract from this field.

Returns: The result of the subtraction.

Definition at line 255 of file vector.hpp.

◆ operator=() [1/2]

template<typename ValueType >

void NeoN::Vector< ValueType >::operator= ( const ValueType & rhs )

inline

Assignment operator, Sets the field values to that of the passed value.

Parameters

rhs	The value to set the field to.

Definition at line 220 of file vector.hpp.

◆ operator=() [2/2]

template<typename ValueType >

void NeoN::Vector< ValueType >::operator= ( const Vector< ValueType > & rhs )

inline

Assignment operator, Sets the field values to that of the parsed field.

Parameters

rhs	The field to copy from.

Warning: This field will be sized to the size of the parsed field.

Definition at line 228 of file vector.hpp.

◆ operator[]() [1/2]

template<typename ValueType >

const ValueType & NeoN::Vector< ValueType >::operator[] ( const localIdx i ) const

delete

◆ operator[]() [2/2]

template<typename ValueType >

ValueType & NeoN::Vector< ValueType >::operator[] ( const localIdx i )

delete

◆ range()

template<typename ValueType >

std::pair< localIdx, localIdx > NeoN::Vector< ValueType >::range ( ) const

inline

Gets the range of the field.

Returns: The range of the field {0, size()}.

Definition at line 434 of file vector.hpp.

◆ resize()

template<typename ValueType >

void NeoN::Vector< ValueType >::resize ( const localIdx size )

inline

Resizes the field to a new size.

Parameters

size	The new size to set the field to.

Definition at line 319 of file vector.hpp.

◆ size()

template<typename ValueType >

localIdx NeoN::Vector< ValueType >::size ( ) const

inline

Gets the size of the field.

Returns: The size of the field.

Definition at line 364 of file vector.hpp.

◆ ssize()

template<typename ValueType >

label NeoN::Vector< ValueType >::ssize ( ) const

inline

Gets the size of the field.

Returns: The size of the field.

Definition at line 370 of file vector.hpp.

◆ view() [1/8]

template<typename ValueType >

View< ValueType > NeoN::Vector< ValueType >::view ( ) &

inline

Gets the field as a view.

Returns: View of the field.

Definition at line 388 of file vector.hpp.

◆ view() [2/8]

template<typename ValueType >

View< ValueType > NeoN::Vector< ValueType >::view ( ) &&

delete

◆ view() [3/8]

template<typename ValueType >

View< const ValueType > NeoN::Vector< ValueType >::view ( ) const &

inline

Gets the field as a view.

Returns: View of the field.

Definition at line 397 of file vector.hpp.

◆ view() [4/8]

template<typename ValueType >

View< const ValueType > NeoN::Vector< ValueType >::view ( ) const &&

delete

◆ view() [5/8]

template<typename ValueType >

View< ValueType > NeoN::Vector< ValueType >::view ( std::pair< localIdx, localIdx > range ) &

inline

Gets a sub view of the field as a view.

Returns: View of the field.

Definition at line 412 of file vector.hpp.

◆ view() [6/8]

template<typename ValueType >

View< ValueType > NeoN::Vector< ValueType >::view ( std::pair< localIdx, localIdx > range ) &&

delete

◆ view() [7/8]

template<typename ValueType >

View< const ValueType > NeoN::Vector< ValueType >::view ( std::pair< localIdx, localIdx > range ) const &

inline

Gets a sub view of the field as a view.

Returns: View of the field.

Definition at line 423 of file vector.hpp.

◆ view() [8/8]

template<typename ValueType >

View< const ValueType > NeoN::Vector< ValueType >::view ( std::pair< localIdx, localIdx > range ) const &&

delete

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

/home/runner/work/NeoN/NeoN/include/NeoN/core/parallelAlgorithms.hpp
/home/runner/work/NeoN/NeoN/include/NeoN/core/vector.hpp

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

◆ VectorValueType

Constructor & Destructor Documentation

◆ Vector() [1/7]

◆ Vector() [2/7]

◆ Vector() [3/7]

◆ Vector() [4/7]

◆ Vector() [5/7]

◆ Vector() [6/7]

◆ Vector() [7/7]

◆ ~Vector()

Member Function Documentation

◆ apply()

◆ copyToExecutor()

◆ copyToHost() [1/2]

◆ copyToHost() [2/2]

◆ data() [1/2]

◆ data() [2/2]

◆ empty()

◆ exec()

◆ operator*() [1/2]

◆ operator*() [2/2]

◆ operator*=() [1/2]

◆ operator*=() [2/2]

◆ operator+=()

◆ operator-=()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ range()

◆ resize()

◆ size()

◆ ssize()

◆ view() [1/8]

◆ view() [2/8]

◆ view() [3/8]

◆ view() [4/8]

◆ view() [5/8]

◆ view() [6/8]

◆ view() [7/8]

◆ view() [8/8]