next up previous
Next: NDF_ANNUL - Annul an NDF identifier
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_AFORM - Obtain the storage form of an NDF axis array

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.



next up previous
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