NAME

cxDataNew - create new data structure

C SPECIFICATION

#include <cx/DataAccess.h>

typedef enum {
 cx_prim_byte,
 cx_prim_short,
 cx_prim_long,
 cx_prim_float,
 cx_prim_double
} cxPrimType;

cxData *cxDataNew(long nDim, long dims[],
  long nDataVar, cxPrimType primType)

FORTRAN SPECIFICATION

integer cx_prim_byte
integer cx_prim_short
integer cx_prim_long
integer cx_prim_float
integer cx_prim_double

parameter (cx_prim_byte = 0)
parameter (cx_prim_short = 1)
parameter (cx_prim_long = 2)
parameter (cx_prim_float = 3)
parameter (cx_prim_double = 4)

integer function cxDataNew(ndim, dims, ndatavar, primtype)
integer ndim, dims(ndim), ndatavar, primtype

PARAMETERS

nDim: Number of dimensions.
dims: Array specifying length in each dimension.
nDataVar: Number of data elements per node.
primType: Primitive data type.

FUNCTION RETURN VALUE

Returns a pointer to a new data structure.

DESCRIPTION

Allocates only the data portion of a lattice. The data created will have nDim dimensions; the length of each dimension is specified in the array dims. Each node of the data will have space for nDataVar elements; the type of each element is specified by primType.