The TETRA_VOLUME function computes properties of a tetrahedral mesh array. The basic property is the volume. An auxiliary data array may be supplied which specifies weights at each vertex which are interpolated through the volume during integration. Higher order moments (with respect to the X, Y, and Z axis) may be computed as well (with or without weights).

## Syntax

*Result *= TETRA_VOLUME ( *Verts*, *Conn* [, AUXDATA=*array*] [, MOMENT=*variable*] )

## Return Value

Returns the cumulative (weighted) volume of the tetrahedrons in the mesh.

## Arguments

### Verts

Array of vertices [3, *n*].

### Conn

Tetrahedral connectivity array.

## Keywords

### AUXDATA

Array of input auxiliary data (one value per vertex). If present, these values are used to weight a vertex. The volume area integral will linearly interpolate these values. The volume integral will linearly interpolate these values within each tetrahedra. The default weight is 1.0 which results in a basic volume.

### MOMENT

Set this keyword to a named variable that will contain a three-element float vector which corresponds to the first order moments computed with respect to the X, Y and Z axis. The computation is:

where v is the (weighted) volume of the tetrahedron and c is the centroid of the tetrahedron, thus

yields the (weighted) centroid of the tetrahedral mesh.

## Version History

5.5 |
Introduced |