# udfGetElmCovar()

Return the element covariant at the quadrature point.

## Syntax

covar = udfGetElmCovar( udfHd ) ;

## Type

User Defined Element

## Parameters

- udfHd
- The opaque handle (pointer) which was passed to the user function.

## Return Value

- covar (Real*)
- Pointer to two dimensional real array of the element covariant. The first (fastest) dimension of the array is the number of elements, nItems, and the second (slower) dimension is six, for the xx, yy, zz, xy, yz and zx components.

## Description

This routine returns the element covariant at the quadrature point. The element covariant is given by

where is the local parent element
coordinate and is the global coordinate. The
latter is for the current (deformed) configuration if mesh displacement is active. For
example,

```
Real* covar ;
Real xx_covar, yy_covar, zz_covar ;
Real xy_covar, yz_covar, zx_covar ;
Integer elem ;
...
covar = udfGetElmCovar( udfHd ) ;
for ( elem = 0 ; elem < nItems ; elem++ ) {
xx_covar = covar[0*nItems+elem] ;
yy_covar = covar[1*nItems+elem] ;
zz_covar = covar[2*nItems+elem] ;
xy_covar = covar[3*nItems+elem] ;
yz_covar = covar[4*nItems+elem] ;
zx_covar = covar[5*nItems+elem] ;
...
}
```

## Errors

- This routine expects a valid udfHd.
- This routine may only be called within a Body Force, Material Model or Component Model user function.