Next: NDF_ANNUL - Annul an NDF identifier
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_AFORM - Obtain the storage form of 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.
Next: NDF_ANNUL - Annul an NDF identifier
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_AFORM - Obtain the storage form of an NDF axis array
Starlink User Note 33
R.F. Warren-Smith
11th January 2000
E-mail:rfws@star.rl.ac.uk
Copyright © 2000 Council for the Central Laboratory of the Research Councils