Calculates the coordinates and weights for numerical integration of the tetrahedra element. The coordinates are those ones mapped from the hexahedron element to the baricentric coordinates of the tetrahedron. More...

#include <TetraNumericalIntegration.h>

Collaboration diagram for TetraNumericalIntegration:

[legend]

List of all members.

Public Member Functions
	TetraNumericalIntegration ()
	Default constructor.
	TetraNumericalIntegration (TetraNumericalIntegration &Instance)
	Copy-initializer constructor.
	~TetraNumericalIntegration ()
	Class destructor.
TetraNumericalIntegration &	operator= (TetraNumericalIntegration &Instance)
	Copies the contents of instance to the object.
	operator LineNumericalIntegration & ()
	Cast operator for the reference of the class attribute "LineNI".
	operator TriangleNumericalIntegration & ()
	Cast operator for the reference of the class attribute "TriangleNI".
void	SetMaxPolyOrder (unsigned long MaxPolyOrder)
	Sets the maximum polynomial order.
void	SetNumberCoordsWeights (unsigned long NumberRow, unsigned long NumberData)
	Sets the coordinates and weights table for the specific TetraNumericalIntegration allocated.
unsigned long	GetMaxPolyOrder ()
	Returns the maximum polynomial order.
LineNumericalIntegration &	GetLineNumericalIntegration (unsigned long LiDirection=1)
	Returns the reference to LineNumericalIntegration. According to LiDirection parameter returns one of the LineNumericalIntegration attributes of the TetraNumericalIntegration class.
unsigned long	GetNumberIntegrationPointsSets ()
	Returns the number of sets of integration points calculated using the polynomial and integration orders.
unsigned long	GetMaxNumberIntegrationPointsSets (unsigned long LiDirection=1)
	Returns the maximum number of sets of integration points according to LineNI[1-4] class attributes.
long	GetIntegrationPointsSetNumber (NumericalIntegrationAttributes_S &NIAttributes, unsigned long IntegrandOrder)
	Returns the set number of the integration points for the given polynomial order.
unsigned long	GetNumberIntegrationPoints (NumericalIntegrationAttributes_S &NIAttributes, ElementShape_E EntityShape, unsigned long IntegrandOrder, long &IntegPointsSetNumber)
	Returns the number of integration points given by integrand order for the quadrature rule stored in the class. Returns also the number of the set which stores the points.
unsigned long	GetNumberIntegrationPoints (ElementShape_E EntityShape, long IntegrationPointsSetNumber, unsigned long LiDirection=1)
	Returns the number of integration points for a given set number to a specific baricentric direction number.
unsigned long	GetTotalNumberIntegrationPoints ()
	Returns the total number of integration points.
double *const	GetIntegrationPointsCoords (NumericalIntegrationAttributes_S &NIAttributes, ElementShape_E EntityShape, unsigned long IntegrandOrder, unsigned long &NumberIntegPoints, unsigned long LiDirection=1)
	Returns the coordinates of the integration points. In the case of Shape=TRIANGLE, this method collects the coordinates for the triangle element from the coordinates of the line everytime the method is executed. If Shape=TETRAHEDRON, this method collects the coordinates for the tetra element from the coordinates of the line everytime the method is executed.
double *const	GetIntegrationPointsWeights (NumericalIntegrationAttributes_S &NIAttributes, ElementShape_E EntityShape, unsigned long IntegrandOrder, unsigned long &NumberIntegPoints, unsigned long LiDirection=1)
	Returns the weights of the integration points. This method assumes that the weights have been already calculated by the procedure RunNumericalIntegration.
double *	GetIntegrationPointsWeightsBySets (unsigned long SetNumber, unsigned long &NumberIntegPoints)
	return the integration points weights as a double*, according to the given set.
unsigned long *const	GetIndices (NumericalIntegrationAttributes_S &NIAttributes, unsigned long IntegrandOrder, unsigned long &NumberIndices)
	Get Indices for tensorization of numerical integration coordinates and weights. This method assumes that the indices have been already calculated by the procedure RunNumericalIntegration.
OneIndexTable< unsigned long > &	GetIndices ()
	Get Indices for tensorization of numerical integration coordinates and weights. This method assumes that the indices have been already calculated by the procedure RunNumericalIntegration.
unsigned long *	GetIndicesBySet (unsigned long SetNumber, unsigned long &NumberIndices)
	Returns the tensor indices. This method assumes that the tensor indices have been already calculated by the procedure RunNumericalIntegration.
void	RunNumericalIntegration (NumericalIntegrationAttributes_S &NIAttributes, ElementShape_E EntityShape, BuiltInArray< unsigned long > &PolyOrder)
	Calculates the tensorization indices and the weigths for numerical integration of the polynomial orders given in the input parameter PolyOrder and integrand orders calculated by [1,IOFactor] * P..
void	Print (FILE *File, ElementShape_E EntityShape)
	: Prints the numerical integration attributes and values to the given ascii file.
Protected Attributes
LineNumericalIntegration	LineNI1
	Instance of the LineNumericalIntegration class used to store the line coordinates and weights in direction L1.
LineNumericalIntegration	LineNI2
	Instance of the LineNumericalIntegration class used to store the line coordinates and weights in direction L2.
LineNumericalIntegration	LineNI3
	Instance of the LineNumericalIntegration class used to store the line coordinates and weights in direction L3.
LineNumericalIntegration	LineNI4
	Instance of the LineNumericalIntegration class used to store the line coordinates and weights in direction L4.
TriangleNumericalIntegration	TriangleNI
	Instance of the TriangleNumericalIntegration class used to store the triangle coordinates and weights.
OneIndexTable< double >	Weights
	Table to store the tetra integration weights for all polynomial orders P and integrand orders calculated as [1,IOFactor] * P.
OneIndexTable< double >	Coords
	Table that stores the integration points coordinates for tetrahedra.
OneIndexTable< unsigned long >	TensorIndices
	Table to store the tensorization indices p, q, r and s for every integration point of the tetra element and polynomial order.
unsigned long	Pmax
	Maximum polynomial order.

Detailed Description

Calculates the coordinates and weights for numerical integration of the tetrahedra element. The coordinates are those ones mapped from the hexahedron element to the baricentric coordinates of the tetrahedron.

Author:: Fabiano Fernandes Bargos/Marco Lcio Bittencourt

Date:: March/15/2011

Note:: Only the tensorization indices and weights are stored. The coordinates are calculated only if it is necessary. There is not variable to store the coordinates for the tetrahedra, but only for lines.

Constructor & Destructor Documentation

TetraNumericalIntegration::TetraNumericalIntegration ( TetraNumericalIntegration & Instance )

Copy-initializer constructor.

Parameters:

[in] Instance - instance of the TetraNumericalIntegration class

Member Function Documentation

unsigned long *const TetraNumericalIntegration::GetIndices	(	NumericalIntegrationAttributes_S &	NIAttributes,
		unsigned long	IntegrandOrder,
		unsigned long &	NumberIndices
	)

Get Indices for tensorization of numerical integration coordinates and weights. This method assumes that the indices have been already calculated by the procedure RunNumericalIntegration.

Parameters:

[in]	IntegrandOrder	- order of the integrand. Based on this value, the number of integration points is calculated for the quadrature rule stored in the class data.
[out]	NumberIndices	- number of tensorization indices.

Returns:: Pointer to the array of indices

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

Get Indices for tensorization of numerical integration coordinates and weights. This method assumes that the indices have been already calculated by the procedure RunNumericalIntegration.

Returns:: Pointer to the array of indices

unsigned long * TetraNumericalIntegration::GetIndicesBySet	(	unsigned long	SetNumber,
		unsigned long &	NumberIndices
	)

Returns the tensor indices. This method assumes that the tensor indices have been already calculated by the procedure RunNumericalIntegration.

Parameters:

[in]	SetNumber	- the set number.
[out]	NumberIndices	- number of tensor indices

Returns:: Pointer to the array with the tensor indices.

double *const TetraNumericalIntegration::GetIntegrationPointsCoords	(	NumericalIntegrationAttributes_S &	NIAttributes,
		ElementShape_E	EntityShape,
		unsigned long	IntegrandOrder,
		unsigned long &	NumberIntegPoints,
		unsigned long	LiDirection = `1`
	)

Returns the coordinates of the integration points. In the case of Shape=TRIANGLE, this method collects the coordinates for the triangle element from the coordinates of the line everytime the method is executed. If Shape=TETRAHEDRON, this method collects the coordinates for the tetra element from the coordinates of the line everytime the method is executed.

Parameters:

[in]	EntityShape	- entity shape for which the coordinates of the integration points must be returned. For example, the element shape is SQUARE, but only the edge points are required. In this case, EntityShape must be LINE.
[in]	IntegrandOrder	- order of the integrand. Based on this value, the number of integration points are calculated for the quadrature rule stored in the class data.
[out]	NumberIntegPoints	- number of integration points
[in]	LiDirection	- Baricentric direction number.

Returns:: Pointer to the array with the coordinates.

long TetraNumericalIntegration::GetIntegrationPointsSetNumber	(	NumericalIntegrationAttributes_S &	NIAttributes,
		unsigned long	IntegrandOrder
	)

Returns the set number of the integration points for the given polynomial order.

Parameters:

[in] PolyOrder - Polynomial order

Returns:: a long type with the set number value.

double *const TetraNumericalIntegration::GetIntegrationPointsWeights	(	NumericalIntegrationAttributes_S &	NIAttributes,
		ElementShape_E	EntityShape,
		unsigned long	IntegrandOrder,
		unsigned long &	NumberIntegPoints,
		unsigned long	LiDirection = `1`
	)

Returns the weights of the integration points. This method assumes that the weights have been already calculated by the procedure RunNumericalIntegration.

Parameters:

[in]	EntityShape	- entity shape for which the weights of the integration points must be returned. For example, the element shape is SQUARE, but only the edge points are required. In this case, EntityShape must be LINE.
[in]	IntegrandOrder	- order of the integrand. Based on this value, the number of integration points are calculated for the quadrature rule stored in the class data.
[out]	NumberIntegrationPoints	- number of integration points
[in]	LiDirection	- Baricentric direction number.

Returns:: Pointer to the array with the weights

double * TetraNumericalIntegration::GetIntegrationPointsWeightsBySets	(	unsigned long	SetNumber,
		unsigned long &	NumberIntegPoints
	)

return the integration points weights as a double*, according to the given set.

Parameters:

[in]	SetNumber	- Integration point set number.
[out]	NumberIntegPoints	- Number of integration points.

return - double* pointer with the integration points weights

LineNumericalIntegration & TetraNumericalIntegration::GetLineNumericalIntegration ( unsigned long LiDirection = 1 )

Returns the reference to LineNumericalIntegration. According to LiDirection parameter returns one of the LineNumericalIntegration attributes of the TetraNumericalIntegration class.

Parameters:

[in] LiDirection - Baricentric direction number.

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

unsigned long TetraNumericalIntegration::GetMaxNumberIntegrationPointsSets ( unsigned long LiDirection = 1 )

Returns the maximum number of sets of integration points according to LineNI[1-4] class attributes.

Parameters:

[in] LiDirection - Baricentric direction number.

Returns:: the maximum number of sets as an unsigned long.

unsigned long TetraNumericalIntegration::GetMaxPolyOrder ( )

Returns the maximum polynomial order.

Returns:: Maximum polynomial order as an unsigned long.

unsigned long TetraNumericalIntegration::GetNumberIntegrationPoints	(	NumericalIntegrationAttributes_S &	NIAttributes,
		ElementShape_E	EntityShape,
		unsigned long	IntegrandOrder,
		long &	IntegPointsSetNumber
	)

Returns the number of integration points given by integrand order for the quadrature rule stored in the class. Returns also the number of the set which stores the points.

Parameters:

[in]	EntityShape	- entity shape for which the number of integration points must be returned. For example, the element shape is SQUARE, but only the edge points are required. In this case, EntityShape must be LINE.
[in]	IntegrandOrder	- order of the integrand. Based on this value, the number of integration points is calculated for the quadrature rule stored in the class data.
[out]	IntegPointsSetNumber	- number of the integration point set which stores the coordinates.

Returns:: Number of integration points as an unsigned long

unsigned long TetraNumericalIntegration::GetNumberIntegrationPoints	(	ElementShape_E	EntityShape,
		long	IntegrationPointsSetNumber,
		unsigned long	LiDirection = `1`
	)

Returns the number of integration points for a given set number to a specific baricentric direction number.

Parameters:

[in]	EntityShape	- entity shape for which the integration points must be returned. For example, the element shape is SQUARE, but only the edge points are required. In this case, EntityShape must be LINE.
[in]	IntegrationPointsSetNumber	- number of the integration point set which stores the coordinates.
[in]	LiDirection	- Baricentric direction number.

Returns:: the number of integration points for a given set number as an unsigned long. If the set number is not used, returns 0.

unsigned long TetraNumericalIntegration::GetNumberIntegrationPointsSets ( )

Returns the number of sets of integration points calculated using the polynomial and integration orders.

Returns:: Number of sets as an unsigend long

unsigned long TetraNumericalIntegration::GetTotalNumberIntegrationPoints ( )

Returns the total number of integration points.

Returns:: an unsigned long with the total number of integration points value.

TetraNumericalIntegration::operator LineNumericalIntegration & ( )

Cast operator for the reference of the class attribute "LineNI".

Returns:: reference to the class attribute "LineNI" of type LineNumericalIntegration

TetraNumericalIntegration::operator TriangleNumericalIntegration & ( )

Cast operator for the reference of the class attribute "TriangleNI".

Returns:: reference to the class attribute "TriangleNI" of type TriangleNumericalIntegration

TetraNumericalIntegration & TetraNumericalIntegration::operator= ( TetraNumericalIntegration & Instance )

Copies the contents of instance to the object.

Parameters:

[in] Instance - instance of the TetraNumericalIntegration class

Returns:: Instance of the TetraNumericalIntegration class

void TetraNumericalIntegration::Print	(	FILE *	File,
		ElementShape_E	EntityShape
	)

: Prints the numerical integration attributes and values to the given ascii file.

Parameters:

[in]	File	- pointer to the ascii file
[in]	EntityShape	- entity shape for which the attributes of the integration points must be printed.

void TetraNumericalIntegration::RunNumericalIntegration	(	NumericalIntegrationAttributes_S &	NIAttributes,
		ElementShape_E	EntityShape,
		BuiltInArray< unsigned long > &	PolyOrder
	)

Calculates the tensorization indices and the weigths for numerical integration of the polynomial orders given in the input parameter PolyOrder and integrand orders calculated by [1,IOFactor] * P..

Parameters:

[in]	NIAttributes	- parameters of the quadrature rule.
[in]	EntityShape	- entity shape for which the coordinates and weights integration points must be calculated. For example, the element shape is SQUARE, but only the edge points are required. In this case, EntityShape must be LINE.
[in]	PolyOrder	- element orders for a p-nonuniform mesh in an increasing sequence. For a p-uniform, this array stores only one value

void TetraNumericalIntegration::SetMaxPolyOrder ( unsigned long MaxPolyOrder )

Sets the maximum polynomial order.

Parameters:

[in] MaxPolyOrder - maximum polynomial order.

void TetraNumericalIntegration::SetNumberCoordsWeights	(	unsigned long	NumberRow,
		unsigned long	NumberData
	)

Sets the coordinates and weights table for the specific TetraNumericalIntegration allocated.

Parameters:

[in]	NumberRow	- Number of table row.
[in]	NumberData	- Number of table coefficients.

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

include/interpolation/numericalintegration/TetraNumericalIntegration.h
src/interpolation/numericalintegration/TetraNumericalIntegration.cpp

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation