#include <cx/DataAccess.h> cxLattice *cxLatRootNew(long nDim, long dims)
integer function cxLatRootNew(nDim, dims) integer nDim, dims(nDim)
- Number of lattice dimensions.
- Array specifying length in each dimension.
Refer to "IRIS Explorer Module Writer's Guide" for more information on the structure of cxLattice and its contents.
Lattice data structures are allocated from a shared memory arena. This shared memory is a limited resource, so it is possible for the memory to be exhausted, causing the allocation routine to fail.
See cxDataManAbortOnError for more details on writing portable module code that copes well with limited memory.
Many modules assume that a lattice has data. Modules built with the IRIS Explorer module builder utility (mbuilder(1)) also require that coordinates be present. It is strongly recommended that you lattices be created with both data and coordinates for compatibility. cxLatRootNew, used in conjunction with cxDataNew, cxCoordNew, cxCoordDefaultNew and cxLatPtrSet, allow the lattice, data and coordinates to be created separately.
[ Documentation Home ]