Jive reference manual
List of all members | Static Public Member Functions
jive::geom::LinearTetrahedron Class Reference

Constructs shape objects that encapsulate the geometrical properties of linear tetrahedron elements. More...

Inheritance diagram for jive::geom::LinearTetrahedron:
Inheritance graph

Static Public Member Functions

static jem::Ref< InternalShapegetShape (int ipCount=4, int bndIpCount=3)
 Returns a shape with a specified number of integration points. More...
 
static jem::Ref< InternalShapegetShape (const Matrix &intPoints, const Vector &intWeights, const Matrix &bndIntPoints, const Vector &bndIntWeights)
 Returns a shape with a specific set of integration points. More...
 
static jem::Ref< InternalShapegetShape (const Matrix &intPoints, const Vector &intWeights, const ShapeBoundary &boundary)
 Returns a shape with a specific set of boundaries. More...
 

Additional Inherited Members

- Public Types inherited from jive::geom::TypeDefs
typedef jem::util::Properties Properties
 A type representing a set of properties. More...
 
typedef util::Vector Vector
 A vector type. More...
 
typedef util::Matrix Matrix
 A matrix type. More...
 

Detailed Description

#include <jive/geom/Tetrahedron.h>

The LinearTetrahedron class provides functions for constructing InternalShape objects that encapsulate the geometrical properties of tetrahedron elements with four nodes and linear shape functions. The following figure shows how the nodes are numbered (left image) and where they are located in the local coordinate system (right image).

LinearTetrahedron.jpg

Note that the local node coordinates of a linear tetrahedron are identical to the node coordinates of a standard linear tetrahedron.

A linear tetrahedron has four boundaries. The table below indicates which boundaries are attached to which nodes.

Boundary index

Node indices

0 0, 2, 1
1 0, 1, 3
2 1, 2, 3
3 0, 3, 2

The normals on the boundaries point away from the interior of the tetrahedron. The boundaries are normally represented by BoundaryShape objects that are constructed by the LinearBoundaryTriangle class. However, you can also specify your own set of BoundaryShape objects to be used.

Note that the LinearTetrahedron class has only static members; it should be used as a mini name space.

See also
QuadraticTetrahedron

Member Function Documentation

static jem::Ref<InternalShape> jive::geom::LinearTetrahedron::getShape ( int  ipCount = 4,
int  bndIpCount = 3 
)
static

Returns an InternalShape object that encapsulates the geometrical properties of a linear tetrahedron element. The parameter ipCount specifies the number of integration points within the element. The parameter bndIpCount specifies the number of integration points on each boundary.

This function simply executes:

return getShape (
StdTetrahedron::getGaussPoints ( ipCount ),
StdTetrahedron::getGaussWeights ( ipCount ),
StdTriangle::getGaussPoints ( bndIpCount ),
StdTriangle::getGaussWeights ( bndIpCount )
);

Note that the actual number of integration points within the element and on the boundaries may be different from ipCount and bndIpCount; read the documentation of the StdSquare and StdLine classes for more information.

Parameters
ipCount- the number of integration points within the element.
bndIpCount- the number of integration points on each boundary.
Returns
An InternalShape object representing a linear tetrahedron element.
See also
StdTetrahedron, StdTriangle
static jem::Ref<InternalShape> jive::geom::LinearTetrahedron::getShape ( const Matrix intPoints,
const Vector intWeights,
const Matrix bndIntPoints,
const Vector bndIntWeights 
)
static

Returns an InternalShape object that represents a linear tetrahedron element with a specific set of integration points. The matrix intPoints should contain the local coordinates of the integration points within the element: intPoints(i,j) should be equal to the i-th local coordinate of the j-th integration point. The vector intWeights should contain the integration weights in the local coordinate system: intWeights[j] should be equal to the local integration weight associated with the j-th integration point.

The matrix bndIntPoints should contain the local coordinates of the integration points on each boundary. The vector bndIntWeights should contain the corresponding integration weights, also in the local coordinate system of the boundaries (see the documentation of the LinearBoundaryLine class for more information).

Note that all the input arrays are copied by reference. You should not modify the contents of these arrays after calling this function.

You can use the StdTetrahedron and StdTriangle classes to compute the integration point coordinates and weights. Here is an example:

Ref<InternalShape> s = LinearTetrahedron::getShape (
StdTetrahedron::getGaussPoints ( 11 ),
StdTetrahedron::getGaussWeights ( 11 ),
StdTriangle::getGaussPoints ( 7 ),
StdTriangle::getGaussWeights ( 7 ),
);
Parameters
intPoints- a matrix containing the local coordinates of the integration points within the element.
intWeights- a vector containing the weights of the internal integration points in the local coordinate system.
bndIntPoints- a matrix containing the local coordinates of the integration points on each boundary.
bndIntWeights- a vector containing the weights of the boundary integration points in the local coordinate system of the boundaries.
Precondition
intPoints.size(0) == 3 &&
intPoints.size(1) == intWeights.size() &&
bndIntPoints.size(0) == 2 &&
bndIntPoints.size(1) == bndIntWeights.size()
Returns
An InternalShape object that encapsulates the geometrical properties of a linear tetrahedron element.
See also
StdTriangle, StdTetrahedron
static jem::Ref<InternalShape> jive::geom::LinearTetrahedron::getShape ( const Matrix intPoints,
const Vector intWeights,
const ShapeBoundary boundary 
)
static

Returns an InternalShape object that represents a linear tetrahedron element with a specific set of integration points and boundaries. The matrix intPoints should contain the local coordinates of the integration points within the element: intPoints(i,j) should be equal to the i-th local coordinate of the j-th integration point. The vector intWeights should contain the integration weights in the local coordinate system: intWeights[j] should be equal to the local integration weight associated with the j-th integration point.

The ShapeBoundary object boundary specifies the boundaries to be associated with the returned shape object.

Note that all the two input arrays and the members of the ShapeBoundary object are copied by reference. You should not modify the contents of these arrays and members after calling this function.

Parameters
intPoints- a matrix containing the local coordinates of the integration points within the element.
intWeights- a vector containing the weights of the internal integration points in the local coordinate system.
boundary- the boundaries of the shape object that is returned by this function.
Precondition
intPoints.size(0) == 3 &&
intPoints.size(1) == intWeights.size()
Returns
An InternalShape object that encapsulates the geometrical properties of a linear tetrahedron element.