Class Avogadro::Core::Cube#

class Cube#

Provide a data structure for regularly spaced 3D grids.

Author

Marcus D. Hanwell

Public Types

enum Type#

Different Cube types relating to the data

Values:

enumerator VdW#
enumerator ESP#
enumerator ElectronDensity#
enumerator MO#
enumerator FromFile#
enumerator None#

Public Functions

Cube()#
~Cube()#
inline Vector3 min() const#
Returns:

The minimum point in the cube.

inline Vector3 max() const#
Returns:

The maximum point in the cube.

inline Vector3 spacing() const#
Returns:

The spacing of the grid.

inline Vector3i dimensions() const#
Returns:

The x, y and z dimensions of the cube.

bool setLimits(const Vector3 &min, const Vector3 &max, const Vector3i &points)#

Set the limits of the cube.

Parameters:

  • min – The minimum point in the cube.

  • max – The maximum point in the cube.

  • points – The number of (integer) points in the cube.

bool setLimits(const Vector3 &min, const Vector3 &max, float spacing)#

Set the limits of the cube.

Parameters:

  • min – The minimum point in the cube.

  • max – The maximum point in the cube.

  • spacing – The interval between points in the cube.

bool setLimits(const Vector3 &min, const Vector3i &dim, float spacing)#

Set the limits of the cube.

Parameters:

  • min – The minimum point in the cube.

  • dim – The integer dimensions of the cube in x, y and z.

  • spacing – The interval between points in the cube.

bool setLimits(const Vector3 &min, const Vector3i &dim, const Vector3 &spacing)#

Set the limits of the cube.

Parameters:

  • min – The minimum point in the cube.

  • dim – The integer dimensions of the cube in x, y and z.

  • spacing – The interval between points in the cube.

bool setLimits(const Cube &cube)#

Set the limits of the cube - copy the limits of an existing Cube.

Parameters:

cube – Existing Cube to copy the limits from.

bool setLimits(const Molecule &mol, float spacing, float padding)#

Set the limits of the cube.

Parameters:

  • mol – Molecule to take limits from

  • spacing – The spacing of the regular grid

  • padding – Padding around the molecule

std::vector<float> *data()#
Returns:

Vector containing all the data in a one-dimensional array.

const std::vector<float> *data() const#
bool setData(const std::vector<float> &values)#

Set the values in the cube to those passed in the vector.

bool addData(const std::vector<float> &values)#

Adds the values in the cube to those passed in the vector.

unsigned int closestIndex(const Vector3 &pos) const#
Parameters:

pos – Position to get closest index for.

Returns:

Index of the point closest to the position supplied.

Vector3i indexVector(const Vector3 &pos) const#
Parameters:

pos – Position to get closest index for.

Returns:

The i, j, k index closest to the position supplied.

Vector3 position(unsigned int index) const#
Parameters:

index – Index to be translated to a position.

Returns:

Position of the given index.

float value(int i, int j, int k) const#

This function is very quick as it just returns the value at the point.

Returns:

Cube value at the integer point i, j, k.

float value(const Vector3i &pos) const#

This function is very quick as it just returns the value at the point.

Returns:

Cube value at the integer point pos.

float valuef(const Vector3f &pos) const#

This function uses trilinear interpolation to find the value at points between those specified in the cube.

Warning

This function is quite computationally expensive and should be avoided where possible.

Returns:

Cube value at the specified position.

float value(const Vector3 &pos) const#

This function uses trilinear interpolation to find the value at points between those specified in the cube.

Warning

This function is quite computationally expensive and should be avoided where possible.

Returns:

Cube value at the specified position.

bool setValue(unsigned int i, unsigned int j, unsigned int k, float value)#

Sets the value at the specified point in the cube.

Parameters:

  • i – x component of the position.

  • j – y component of the position.

  • k – z component of the position.

  • value – Value at the specified position.

inline bool setValue(unsigned int i, float value)#

Sets the value at the specified index in the cube.

Parameters:

i – 1-dimensional index of the point to set in the cube.

void fill(float value)#

Sets all indices in the cube to the specified value.

Parameters:

value – Value to fill the cube with.

bool fillStripe(unsigned int i, unsigned int j, unsigned int kfirst, unsigned int klast, float value)#

Sets all indices in a Z stripe of the cube to the specified value.

Parameters:

  • i – x component of the position.

  • j – y component of the position.

  • kfirst – first z position to fill.

  • klast – last z position to fill.

  • value – Value to fill the stripe with.

inline float minValue() const#
Returns:

The minimum value at any point in the Cube.

inline float maxValue() const#
Returns:

The maximum value at any point in the Cube.

inline void setName(const std::string &name_)#
inline std::string name() const#
inline void setCubeType(Type type)#
inline Type cubeType() const#
inline Mutex *lock() const#

Provides locking.

Protected Attributes

std::vector<float> m_data#
Vector3 m_min#
Vector3 m_max#
Vector3 m_spacing#
Vector3i m_points#
float m_minValue#
float m_maxValue#
std::string m_name#
Type m_cubeType#
Mutex *m_lock#