Next: NDF_SECT - Create an NDF section
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_SBND - Set new pixel-index bounds for an NDF
NDF_SCOPY
- Selectively copy NDF components to a new location
- Description:
The routine propagates (copies) selected components of an NDF to
a new location and returns an identifier for the resulting new
base NDF.
- Invocation:
CALL NDF_SCOPY( INDF1, CLIST, PLACE, INDF2, STATUS )
- Arguments:
-
INDF1 = INTEGER (Given)
-
Identifier for the NDF (or NDF section) to be copied.
-
CLIST = CHARACTER * ( * ) (Given)
-
A comma-separated list of the NDF components which are to be
propagated to the new data structure. By default, the HISTORY,
LABEL and TITLE components and all extensions are copied. See
the "Component Propagation" section for further details.
-
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).
-
INDF2 = INTEGER (Returned)
-
Identifier for the new NDF.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
-
If this routine is called with STATUS set, then a value of
NDF__NOID will be returned for the INDF2 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.
-
Component Propagation
-
The components whose values are to be propagated (copied) from
the existing NDF to the new data structure are specified via the
CLIST argument. Thus CLIST='DATA,QUALITY' would cause the DATA
and QUALITY components to be propagated (if available) from the
existing NDF to the new structure, in addition to those
propagated by default. Component propagation may be suppressed
by supplying a component name with the prefix 'NO'. Thus
CLIST='DATA,NOHISTORY' would propagate the DATA component, but
suppress propagation of HISTORY. If component names appear more
than once in the CLIST value, then the last occurrence takes
precedence.
-
Propagation of specific NDF extensions may be suppressed by
using 'NOEXTENSION()' as one of the items in the CLIST argument;
a list of the extensions to be suppressed should appear between
the parentheses. Thus CLIST='AXIS,NOEXTENSION(IRAS,ASTERIX)'
would propagate the AXIS component, but suppress propagation of
the IRAS and ASTERIX extensions (if present). Propagation of
suppressed extensions may be re-enabled by specifying
'EXTENSION()' in a similar manner at a later point in the CLIST
value.
-
Component names in the CLIST argument may be abbreviated to 3
characters, but extension names must appear in full.
Next: NDF_SECT - Create an NDF section
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_SBND - Set new pixel-index bounds for 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