NDF_AMAP - Obtain mapped access to an NDF axis array

Description:

The routine obtains mapped access to an NDF axis array, returning a pointer to the mapped values and a count of the number of elements mapped.

Invocation:

CALL NDF_AMAP( INDF, COMP, IAXIS, TYPE, MMOD, PNTR, EL, STATUS )

Arguments:

INDF = INTEGER (Given)

NDF identifier.

COMP = CHARACTER $*$ ( $*$ ) (Given)

Name of the axis array component to be mapped: 'CENTRE', 'VARIANCE' (or 'ERROR') or 'WIDTH'.

IAXIS = INTEGER (Given)

Number of the NDF axis whose array is to be mapped.

TYPE = CHARACTER $*$ ( $*$ ) (Given)

Numeric type to be used for access (e.g. '_REAL').

MMOD = CHARACTER $*$ ( $*$ ) (Given)

Mapping mode for access to the array: 'READ', 'UPDATE' or 'WRITE'.

PNTR( $*$ ) = INTEGER (Returned)

Pointer(s) to the mapped values (see the Notes section).

EL = INTEGER (Returned)

Number of elements mapped.

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

• A comma-separated list of axis array component names may also be given, in which case the routine will map all the requested axis arrays using the same numeric type and mapping mode. Pointers to the values of these mapped arrays will be returned (in the specified order) in the elements of the array PNTR, which must be of sufficient size to accommodate them.