#include <shape.h>

Inheritance diagram for oomph::Shape:

Public Member Functions
	Shape (const unsigned &N)
	Constructor for a single-index set of shape functions. More...

	Shape (const unsigned &N, const unsigned &M)
	Constructor for a two-index set of shape functions. More...

	Shape (const Shape &shape)
	Broken copy constructor. More...

	Shape ()

void	operator= (const Shape &shape)

void	operator= (Shape *const &shape_pt)

	~Shape ()
	Destructor, clear up the memory allocated by the object. More...

void	resize (const unsigned &N, const unsigned &M=1)
	Change the size of the storage. More...

double &	operator[] (const unsigned &i)
	Overload the bracket operator to provide access to values. More...

const double &	operator[] (const unsigned &i) const
	Overload the bracket operator (const version) More...

double &	operator() (const unsigned &i)
	Overload the round bracket operator to provide access to values. More...

const double &	operator() (const unsigned &i) const
	Overload the round bracket operator (const version) More...

double &	operator() (const unsigned &i, const unsigned &j)
	Overload the round bracket operator, allowing for two indices. More...

const double &	operator() (const unsigned &i, const unsigned &j) const
	Overload the round bracket operator, allowing for two indices (const version) More...

unsigned	nindex1 () const
	Return the range of index 1 of the shape function object. More...

unsigned	nindex2 () const
	Return the range of index 2 of the shape function object. More...

Protected Member Functions
void	range_check (const unsigned &i, const unsigned &j) const
	Private function that checks whether the index is in range. More...

Protected Attributes
double *	Psi
	Pointer that addresses the storage that will be used to read and set the shape functions. The shape functions are packed into a flat array of doubles. More...

double *	Allocated_storage
	Pointer that addresses the storage allocated by the object on construction. This will be the same as Psi if the object is not copied. More...

unsigned	Index1
	Size of the first index of the shape function. More...

unsigned	Index2
	Size of the second index of the shape function. More...

Detailed Description

A Class for shape functions. In simple cases, the shape functions have only one index that can be thought of as corresponding to the nodal points. In general, however, when quantities and their gradients are interpolated separately, the shape function have two indices: one corresponding to the nodal points, and the other to the "type" of quantity being interpolated: function, derivative, &c The second index can also represent the vector coordinate for vector-valued (Nedelec) shape functions.

The implementation of Shape functions is designed to permit fast copying of entire sets of values by resetting the internal pointer to the data, Psi; functionality that is required, for example, when setting the test functions in Galerkin elements and when reading pre-computed values of the shape functions. In general, we cannot know at construction time whether the pointer to the values will be reset or not and, therefore, whether the storage for values should be allocated by the object. We choose to allocate storage on construction and store an additional pointer Allocated_data that always addresses the storage allocated by the object. If the Psi pointer is reset then this storage will be "wasted", but only for the lifetime of the object. The cost for non-copied Shape functions is one additional pointer.

Definition at line 81 of file shape.h.

Constructor & Destructor Documentation

◆ Shape() [1/4]

oomph::Shape::Shape ( const unsigned & N )

inline

Constructor for a single-index set of shape functions.

Definition at line 128 of file shape.h.

References Allocated_storage, and oomph::QuadTreeNames::N.

◆ Shape() [2/4]

oomph::Shape::Shape	(	const unsigned &	N,
		const unsigned &	M
	)

inline

Constructor for a two-index set of shape functions.

Definition at line 132 of file shape.h.

References Allocated_storage.

◆ Shape() [3/4]

oomph::Shape::Shape ( const Shape & shape )

inline

Broken copy constructor.

Definition at line 136 of file shape.h.

References oomph::BrokenCopy::broken_copy().

◆ Shape() [4/4]

oomph::Shape::Shape ( )

inline

Default constructor - just assigns a null pointers and zero index sizes.

Definition at line 140 of file shape.h.

◆ ~Shape()

oomph::Shape::~Shape ( )

inline

Destructor, clear up the memory allocated by the object.

Definition at line 190 of file shape.h.

References Allocated_storage.

Member Function Documentation

◆ nindex1()

unsigned oomph::Shape::nindex1 ( ) const

inline

Return the range of index 1 of the shape function object.

Definition at line 262 of file shape.h.

References Index1.

Referenced by oomph::LineDerivatives::compute_surface_derivatives(), oomph::AxisymmetricDerivatives::compute_surface_derivatives(), oomph::SurfaceDerivatives::compute_surface_derivatives(), oomph::ClampedHermiteShellBoundaryConditionElement::dshape_local(), oomph::ProjectableDarcyElement< DARCY_ELEMENT >::jacobian_and_shape_of_field(), oomph::ProjectableAxisymmetricPoroelasticityElement< AXISYMMETRIC_POROELASTICITY_ELEMENT >::jacobian_and_shape_of_field(), and oomph::ClampedHermiteShellBoundaryConditionElement::shape().

◆ nindex2()

unsigned oomph::Shape::nindex2 ( ) const

inline

Return the range of index 2 of the shape function object.

Definition at line 265 of file shape.h.

References Index2.

Referenced by oomph::ClampedHermiteShellBoundaryConditionElement::dshape_local(), oomph::TRaviartThomasDarcyElement< ORDER >::scale_basis(), oomph::TPoroelasticityElement< ORDER >::scale_basis(), oomph::TAxisymmetricPoroelasticityElement< ORDER >::scale_basis(), and oomph::ClampedHermiteShellBoundaryConditionElement::shape().

◆ operator()() [1/4]

double& oomph::Shape::operator() ( const unsigned & i )

inline

Overload the round bracket operator to provide access to values.

Definition at line 225 of file shape.h.

References Index2, and range_check().

◆ operator()() [2/4]

const double& oomph::Shape::operator() ( const unsigned & i ) const

inline

Overload the round bracket operator (const version)

Definition at line 234 of file shape.h.

References Index2, and range_check().

◆ operator()() [3/4]

double& oomph::Shape::operator()	(	const unsigned &	i,
		const unsigned &	j
	)

inline

Overload the round bracket operator, allowing for two indices.

Definition at line 243 of file shape.h.

References range_check().

◆ operator()() [4/4]

const double& oomph::Shape::operator()	(	const unsigned &	i,
		const unsigned &	j
	)		const

inline

Overload the round bracket operator, allowing for two indices (const version)

Definition at line 253 of file shape.h.

References range_check().

◆ operator=() [1/2]

void oomph::Shape::operator= ( const Shape & shape )

inline

The assignment operator does a shallow copy (resets the pointer to the data)

Definition at line 144 of file shape.h.

References Index1, Index2, and Psi.

◆ operator=() [2/2]

void oomph::Shape::operator= ( Shape *const & shape_pt )

inline

The assignment operator does a shallow copy (resets the pointer to the data)

Definition at line 167 of file shape.h.

References Index1, Index2, and Psi.

◆ operator[]() [1/2]

double& oomph::Shape::operator[] ( const unsigned & i )

inline

Overload the bracket operator to provide access to values.

Definition at line 207 of file shape.h.

References Index2, and range_check().

◆ operator[]() [2/2]

const double& oomph::Shape::operator[] ( const unsigned & i ) const

inline

Overload the bracket operator (const version)

Definition at line 216 of file shape.h.

References Index2, and range_check().

◆ range_check()

void oomph::Shape::range_check	(	const unsigned &	i,
		const unsigned &	j
	)		const

inlineprotected

Private function that checks whether the index is in range.

Definition at line 102 of file shape.h.

Referenced by operator()(), oomph::DShape::operator()(), and operator[]().

◆ resize()

void oomph::Shape::resize	(	const unsigned &	N,
		const unsigned &	M = `1`
	)

inline

Change the size of the storage.

Definition at line 193 of file shape.h.

References Allocated_storage, and oomph::QuadTreeNames::N.

Member Data Documentation

◆ Allocated_storage

double* oomph::Shape::Allocated_storage

protected

Pointer that addresses the storage allocated by the object on construction. This will be the same as Psi if the object is not copied.

Definition at line 93 of file shape.h.

Referenced by oomph::DShape::DShape(), resize(), oomph::DShape::resize(), Shape(), oomph::DShape::~DShape(), ~Shape(), and oomph::ShapeWithDeepCopy::~ShapeWithDeepCopy().

◆ Index1

unsigned oomph::Shape::Index1

protected

Size of the first index of the shape function.

Definition at line 96 of file shape.h.

Referenced by nindex1(), oomph::DShape::nindex1(), operator=(), and oomph::ShapeWithDeepCopy::ShapeWithDeepCopy().

◆ Index2

unsigned oomph::Shape::Index2

protected

Size of the second index of the shape function.

Definition at line 99 of file shape.h.

Referenced by nindex2(), oomph::DShape::nindex2(), operator()(), operator=(), operator[](), and oomph::ShapeWithDeepCopy::ShapeWithDeepCopy().

◆ Psi

double* oomph::Shape::Psi

protected

Pointer that addresses the storage that will be used to read and set the shape functions. The shape functions are packed into a flat array of doubles.

Definition at line 88 of file shape.h.

Referenced by operator=(), oomph::OneDimLagrange::shape< 2 >(), oomph::OneDimLagrange::shape< 3 >(), oomph::OneDimLagrange::shape< 4 >(), and oomph::ShapeWithDeepCopy::ShapeWithDeepCopy().

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

shape.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Shape() [1/4]

◆ Shape() [2/4]

◆ Shape() [3/4]

◆ Shape() [4/4]

◆ ~Shape()

Member Function Documentation

◆ nindex1()

◆ nindex2()

◆ operator()() [1/4]

◆ operator()() [2/4]

◆ operator()() [3/4]

◆ operator()() [4/4]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ range_check()

◆ resize()

Member Data Documentation

◆ Allocated_storage

◆ Index1

◆ Index2

◆ Psi