Calculates the shape functions and their derivatives for the hexa element. The edge and face shape functions and their derivatives are also stored. More...

#include <HexaShapeFunctions.h>

Collaboration diagram for HexaShapeFunctions:

[legend]

List of all members.

Public Member Functions
	HexaShapeFunctions ()
	Default constructor.
	HexaShapeFunctions (unsigned long MaxPolyOrder)
	Constructor with parameter.
	HexaShapeFunctions (HexaShapeFunctions &Instance)
	Copy-initializer constructor.
	~HexaShapeFunctions ()
	Class destructor.
HexaShapeFunctions &	operator= (HexaShapeFunctions &Instance)
	Assigns one Instance to the current object.
void	SetMaxPolyOrder (unsigned long MaxPolyOrder)
	Sets the maximum polynomial order for the shape functions.
LineShapeFunctions &	GetLineShapeFunctions ()
	Returns the LineSF attribute of the HexaShapeFunctions class.
unsigned long	GetMaxPolyOrder ()
	Returns the maximum polynomial order for the hexa shape functions.
long	GetShapeFunctionSetNumber (unsigned long PolyOrder)
	Returns the set number of the shape functions values for the given a polynomial order.
void	GetShapeFunctions (unsigned long PolyOrder, long SFSetNumber, long IPSetNumber, IPCP_E IPCPFlag, unsigned long TensorIndicesNI, unsigned long NumberIndicesNI, double ShapeFunctions)
	Returns the shape functions for the element given the shape, polynomial order and integrand order calculated on the integration or collocation points. This method assumes that the values of the shape functions have been already calculated by the method RunShapeFunctions.
double *const	GetShapeFunctions (ElementShape_E EntityShape, long SFSetNumber, long IPSetNumber, IPCP_E IPCPFlag, unsigned long &NumberSFValues)
	Returns the shape functions for the element given the shape, polynomial order and integrand order calculated on the integration or collocation points. This method assumes that the values of the shape functions have been already calculated by the method RunShapeFunctions.
double *const	GetShapeFunctions (ElementShape_E EntityShape, long SFSetNumber, long IPSetNumber, IPCP_E IPCPFlag, unsigned long &TotalNumberSFValues, unsigned long &NumberSFValues, unsigned long &NumberPoints)
	Returns the shape functions for the element given the shape, polynomial order and integrand order calculated on the integration or collocation points. This method assumes that the values of the shape functions have been already calculated by the method RunShapeFunctions.
double *const	GetdShapeFunctions (ElementShape_E EntityShape, long SFSetNumber, long IPSetNumber, IPCP_E IPCPFlag, unsigned long &NumberSFValues)
	Returns the derivatives of the shape functions for the element given the shape, the polynomial order and integrand order calculated on the integration or collocation points. This method assumes that the values of the derivatives of the shape functions have been already calculated by the method RunShapeFunctions.
unsigned long *const	GetIndices (ElementShape_E EntityShape, unsigned long PolyOrder, unsigned long &NumberIndices)
	Returns the tensorization indices p, q and r for each node/mode.
OneIndexTable< unsigned long > &	GetIndices ()
	Get Indices for tensorization of shape functions.
void	RunShapeFunctions (ElementShape_E EntityShape, ShapeFunctionsAttributes_S SFunctions, NumericalIntegration &NI, collocationPoints &CP, BuiltInArray< unsigned long > &PolyOrder)
	Calculates the shape functions values and their derivatives on the integration and collocation points also calculated for the input element orders given in the PolyOrder argument.
void	Print (FILE *File, ElementShape_E EntityShape, BuiltInArray< unsigned long > &PolyOrder)
	: Prints the shape functions attributes and values to the given ascii file.
void	BuildIndices (BuiltInArray< unsigned long > &PolyOrder, ShapeFunctionsAttributes_S SFAttributes)
	Protected function for the calculation of the tensorization indices p , q and r for each polynomial order given in the input argument PolyOrder. The indices are stored in the table Indices. This methods is executed in the RunShapeFunctions method.
Protected Attributes
OneIndexTable< unsigned long >	TensorIndices
	Stores the tensorization indices p, q and r for each node/mode.
LineShapeFunctions	LineSF
	Instance of the line shape functions.
SquareShapeFunctions	SquareSF
	Instance of the square shape functions.
TwoIndexTable< double >	SFIP
	Table that stores the shape functions for each polynomial order and sets of integration points.
TwoIndexTable< double >	dSFIP
	Table that stores the derivatives of the shape functions for each polynomial order and sets of integration points. The partial derivatives of each function Ni are stored as Ni,csi, Ni,eta and Ni,zeta.
TwoIndexTable< double >	SFCP
	Table that stores the shape functions values for each polynomial order and sets of collocatiion points.
TwoIndexTable< double >	dSFCP
	Table that stores the derivatives of the shape functions for each polynomial order and sets of collocation points. The partial derivatives of each function Ni are stored as Ni,csi, Ni,eta and Ni,zeta.
BuiltInArray< unsigned long >	NumbIntegPoints
	the Number of integration points applied on each shape functions for each polynomial order.
BuiltInArray< unsigned long >	NumbCollocPoints
	the Number of collocation points applied on each shape functions for each polynomial order.
unsigned long	Pmax
	Maximum polynomial order.

Detailed Description

Calculates the shape functions and their derivatives for the hexa element. The edge and face shape functions and their derivatives are also stored.

Author:: Marco Lucio Bittencourt/ Fabiano Fernandes Bargos

Date:: March/14/2011

---

Constructor & Destructor Documentation

HexaShapeFunctions::HexaShapeFunctions ( unsigned long MaxPolyOrder )

Constructor with parameter.

Parameters:

[in] MaxPolyOrder - maximum polynomial order for the line shape functions

HexaShapeFunctions::HexaShapeFunctions ( HexaShapeFunctions & Instance )

Copy-initializer constructor.

Returns:: Reference for instance of the HexaShapeFunctions class

Member Function Documentation

void HexaShapeFunctions::BuildIndices	(	BuiltInArray< unsigned long > &	PolyOrder,
		ShapeFunctionsAttributes_S	SFAttributes
	)

Protected function for the calculation of the tensorization indices p , q and r for each polynomial order given in the input argument PolyOrder. The indices are stored in the table Indices. This methods is executed in the RunShapeFunctions method.

Parameters:

[in]	PolyOrder	- element orders for a p-nonuniform mesh in a increasing sequence. For a p-uniform, thsi array stores only one value.
[in]	SFAttributes,:	attributes for the shape functions using the ShapeFunctionsAttributes_S struct.

Auxiliary variable used in for-loops and also for indexing the pointer pIndTI.

double *const HexaShapeFunctions::GetdShapeFunctions	(	ElementShape_E	EntityShape,
		long	SFSetNumber,
		long	IPSetNumber,
		IPCP_E	IPCPFlag,
		unsigned long &	NumberSFValues
	)

Returns the derivatives of the shape functions for the element given the shape, the polynomial order and integrand order calculated on the integration or collocation points. This method assumes that the values of the derivatives of the shape functions have been already calculated by the method RunShapeFunctions.

Parameters:

[in]	EntityShape	- entity shape for which the interpolation functions and derivatives must be calculated. If it is HEXAHEDRON, the vertex, edge, face, body shape functions and derivatives are calculated; if it is SQUARE, only the vertex, edge and face shape functions and their derivatives are calculated, if it is LINE, only the line shape functions and their derivatives are calculated.
[in]	SFSetNumber	- Set number of the shape functions.
[in]	IPSetNumber	- Set number of the integration points.
[in]	IPCPFlag	- specifies if the shape functions are to be returned on the integration (IP) or collocation (CP) points
[out]	NumberSFValues	- Number of shape functions values.

Returns:: pointer to the double array with the values of the derivatives of the shape functions

unsigned long *const HexaShapeFunctions::GetIndices	(	ElementShape_E	EntityShape,
		unsigned long	PolyOrder,
		unsigned long &	NumberIndices
	)

Returns the tensorization indices p, q and r for each node/mode.

Parameters:

[in]	EntityShape	- entity shape for which the interpolation functions and derivatives must be calculated. If it is HEXAHEDRON, the vertex, edge, face, body shape functions and derivatives are calculated; if it is SQUARE, only the vertex, edge and face shape functions and their derivatives are calculated, if it is LINE, only the line shape functions and their derivatives are calculated.
[in]	PolyOrder	- Polynomial order.
[out]	NumberIndices	- number of tensorization indices.

Returns:: Pointer to the array with the tensorization indices

OneIndexTable< unsigned long > & HexaShapeFunctions::GetIndices ( )

Get Indices for tensorization of shape functions.

Returns:: a OneIndexTable that store the tensor indices for each polynomial order.

LineShapeFunctions & HexaShapeFunctions::GetLineShapeFunctions ( )

Returns the LineSF attribute of the HexaShapeFunctions class.

Returns:: LineShapeFunctions& - reference to the class LineShapeFunctions.

unsigned long HexaShapeFunctions::GetMaxPolyOrder ( )

Returns the maximum polynomial order for the hexa shape functions.

Returns:: Maximum polynomial order as an unsigned long.

void HexaShapeFunctions::GetShapeFunctions	(	unsigned long	PolyOrder,
		long	SFSetNumber,
		long	IPSetNumber,
		IPCP_E	IPCPFlag,
		unsigned long *	TensorIndicesNI,
		unsigned long	NumberIndicesNI,
		double *	ShapeFunctions
	)

Returns the shape functions for the element given the shape, polynomial order and integrand order calculated on the integration or collocation points. This method assumes that the values of the shape functions have been already calculated by the method RunShapeFunctions.

Parameters:

[in]	PolyOrder	- the polynomial order.
[in]	SFSetNumber	- Set number of the shape functions.
[in]	IPSetNumber	- Set number of the integration points.
[in]	IPCPFlag	- specifies if the shape functions are to be returned on the integration (IP) or collocation (CP) points
[in]	TensorIndicesNI	- Tensor Indices on hexahedron from the integration points.
[in]	NumberIndicesNI	- Number of tensor indices from the integration points.
[out]	ShapeFunctions	- the hexahedron shape functions.

double *const HexaShapeFunctions::GetShapeFunctions	(	ElementShape_E	EntityShape,
		long	SFSetNumber,
		long	IPSetNumber,
		IPCP_E	IPCPFlag,
		unsigned long &	NumberSFValues
	)

Returns the shape functions for the element given the shape, polynomial order and integrand order calculated on the integration or collocation points. This method assumes that the values of the shape functions have been already calculated by the method RunShapeFunctions.

Parameters:

[in]	EntityShape	- entity shape for which the interpolation functions and derivatives must be calculated. If it is HEXAHEDRON, the vertex, edge, face, body shape functions and derivatives are calculated; if it is SQUARE, only the vertex, edge and face shape functions and their derivatives are calculated, if it is LINE, only the line shape functions and their derivatives are calculated.
[in]	SFSetNumber	- Set number of the shape functions.
[in]	IPSetNumber	- Set number of the integration points.
[in]	IPCPFlag	- specifies if the shape functions are to be returned on the integration (IP) or collocation (CP) points
[out]	NumberSFValues	- Number of shape functions values.

Returns:: pointer to the double array with the values of the line shape functions

double *const HexaShapeFunctions::GetShapeFunctions	(	ElementShape_E	EntityShape,
		long	SFSetNumber,
		long	IPSetNumber,
		IPCP_E	IPCPFlag,
		unsigned long &	TotalNumberSFValues,
		unsigned long &	NumberSFValues,
		unsigned long &	NumberPoints
	)

Returns the shape functions for the element given the shape, polynomial order and integrand order calculated on the integration or collocation points. This method assumes that the values of the shape functions have been already calculated by the method RunShapeFunctions.

Parameters:

[in]	EntityShape	- entity shape for which the interpolation functions and derivatives must be calculated. If it is HEXAHEDRON, the vertex, edge, face, body shape functions and derivatives are calculated; if it is SQUARE, only the vertex, edge and face shape functions and their derivatives are calculated, if it is LINE, only the line shape functions and their derivatives are calculated.
[in]	SFSetNumber	- Set number of the shape functions.
[in]	IPSetNumber	- Set number of the integration points.
[in]	IPCPFlag	- specifies if the shape functions are to be returned on the integration (IP) or collocation (CP) points
[out]	TotalNumberSFValues	- Total number of elements of the shape functions matrix.
[out]	NumberSFValues	- Number of shape functions values.
[out]	NumberPoints	- Number of points of the integration or collocation depending of the IPCPFlag.

Returns:: pointer to the double array with the values of the line shape functions

long HexaShapeFunctions::GetShapeFunctionSetNumber ( unsigned long PolyOrder )

Returns the set number of the shape functions values for the given a polynomial order.

Parameters:

[in] PolyOrder - Polynomial order.

Returns:: a long with the set number value.

HexaShapeFunctions & HexaShapeFunctions::operator= ( HexaShapeFunctions & Instance )

Assigns one Instance to the current object.

Returns:: Reference for instance of the HexaShapeFunctions class

void HexaShapeFunctions::Print	(	FILE *	File,
		ElementShape_E	EntityShape,
		BuiltInArray< unsigned long > &	PolyOrder
	)

: Prints the shape functions attributes and values to the given ascii file.

Parameters:

[in]	File	- pointer to the ascii file.
[in]	EntityShape	- Entity shape for which the interpolation functions and derivatives must be printed. For example, the element shape is SQUARE, but only the edge shape functions is required. In this case, EntityShape must be LINE.
[in]	PolyOrder	- element orders for a p-nonuniform mesh in a increasing sequence. For a p-uniform, this array stores only one value

void HexaShapeFunctions::RunShapeFunctions	(	ElementShape_E	EntityShape,
		ShapeFunctionsAttributes_S	SFunctions,
		NumericalIntegration &	NI,
		collocationPoints &	CP,
		BuiltInArray< unsigned long > &	PolyOrder
	)

Calculates the shape functions values and their derivatives on the integration and collocation points also calculated for the input element orders given in the PolyOrder argument.

Parameters:

[in]	EntityShape	- entity shape for which the interpolation functions and derivatives must be calculated. If it is HEXAHEDRON, the vertex, edge, face, body shape functions and derivatives are calculated; if it is SQUARE, only the vertex, edge and face shape functions and their derivatives are calculated, if it is LINE, only the line shape functions and their derivatives are calculated.
[in]	SFunctions	- attributes of the shape functions
[in]	NI	- instance of the NumericalIntegration class
[in]	CP	- instance of the CollocationPoints class
[in]	PolyOrder	- element orders for a p-nonuniform mesh in a increasing sequence. For a p-uniform, thsi array stores only one value

Total number of shape functions (P1+1)^3 + (P2+1)^3 + ... + (Pn+1)^3.

Number of shape functions on collocation points: ((P1+1)^3)^3*((P1+1)^3)^3 + ((P1+1)^3)^3*((P2+1)^3)^3 + ... + ((Pn+1)^3)^3*((Pn+1)^3)^3.

Calculates the total number of integration points. Which is equal to the sum of the line integrations points by three: LineIntgPoint_1^3 + LineIntgPoint_2^3 + ... + LineIntgPoint_n^3

Allocates the tables of shape functions values and their derivatives on the integration and collocation points.

Auxiliary pointers for the indices and data of the tables for shape functions values and their derivatives on the integration points.

Auxiliary pointers for the indices and data of the tables for shape functions values and their derivatives. on the collocation points.

void HexaShapeFunctions::SetMaxPolyOrder ( unsigned long MaxPolyOrder )

Sets the maximum polynomial order for the shape functions.

Parameters:

[in] MaxOrder - maximum polynomial order.

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

include/interpolation/shapefunctions/HexaShapeFunctions.h
src/interpolation/shapefunctions/HexaShapeFunctions.cpp

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation