Next: NDF_NEWP - Create a new primitive NDF
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_NCHNK - Determine the number of chunks of contiguous pixels in an NDF
- Description:
The routine creates a new simple NDF and returns an identifier
for it. The NDF may subsequently be manipulated with the NDF_
routines.
- Invocation:
CALL NDF_NEW( FTYPE, NDIM, LBND, UBND, PLACE, INDF, STATUS )
- Arguments:
-
FTYPE = CHARACTER * ( * ) (Given)
-
Full type of the NDF's DATA component (e.g. '_REAL' or
'COMPLEX_INTEGER').
-
NDIM = INTEGER (Given)
-
Number of NDF dimensions.
-
LBND( NDIM ) = INTEGER (Given)
-
Lower pixel-index bounds of the NDF.
-
UBND( NDIM ) = INTEGER (Given)
-
Upper pixel-index bounds of the NDF.
-
PLACE = INTEGER (Given and Returned)
-
An NDF placeholder (e.g. generated by the NDF_PLACE routine)
which indicates the position in the data system where the new
NDF will reside. The placeholder is annulled by this routine,
and a value of NDF__NOPL will be returned (as defined in the
include file NDF_PAR).
-
INDF = INTEGER (Returned)
-
Identifier for the new NDF.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
-
This routine creates a "simple" NDF, i.e. one whose array
components will be stored in "simple" form by default (see
SGP/38).
-
The full data type of the DATA component is specified via the
FTYPE argument and the data type of the VARIANCE component
defaults to the same value. These data types may be set
individually with the NDF_STYPE routine if required.
-
If this routine is called with STATUS set, then a value of
NDF__NOID will be returned for the INDF argument, although no
further processing will occur. The same value will also be
returned if the routine should fail for any reason. In either
event, the placeholder will still be annulled. The NDF__NOID
constant is defined in the include file NDF_PAR.
Next: NDF_NEWP - Create a new primitive NDF
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_NCHNK - Determine the number of chunks of contiguous pixels in an NDF
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