Next: AST_REMOVEROW - Remove a row from a table
Up: AST Routine Descriptions
Previous: AST_REMOVEPARAMETER - Remove a global parameter from a table
AST_REMOVEREGIONS
-
Remove any Regions from a Mapping
- Description:
- This function searches the suppliedMapping (which may be a
compound Mapping such as a CmpMap) for any component Mappings
that are instances of the AST Region class. It then creates a new
Mapping from which all Regions have been removed. If a Region
cannot simply be removed (for instance, if it is a component of a
parallel CmpMap), then it is replaced with an equivalent UnitMap
in the returned Mapping.
- Invocation:
- RESULT = AST_REMOVEREGIONS( THIS, STATUS )
- Arguments:
-
THIS = INTEGER (Given)
-
Pointer to the original Mapping.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Class Applicability:
-
CmpFrame
-
If the supplied Mapping is a CmpFrame, any component Frames that
are instances of the Region class are replaced by the equivalent
Frame.
-
FrameSet
-
If the supplied Mapping is a FrameSet, the returned Mapping
will be a copy of the supplied FrameSet in which Regions have
been removed from all the inter-Frame Mappings, and any Frames
which are instances of the Region class are repalced by the
equivalent Frame.
-
Mapping
-
This function applies to all Mappings.
-
Region
-
If the supplied Mapping is a Region, the returned Mapping will
be the equivalent Frame.
- Returned Value:
-
AST_REMOVEREGIONS = INTEGER
-
A new pointer to the (possibly modified) Mapping.
- Notes:
- This function can safely be applied even to Mappings which
contain no Regions. If no Regions are found, it
behaves exactly like AST_CLONE and returns a pointer to the
original Mapping.
- The Mapping returned by this function may not be independent
of the original (even if some Regions were removed), and
modifying it may therefore result in indirect modification of
the original. If a completely independent result is required, a
copy should be made using AST_COPY.
- A null Object pointer (AST__NULL) will be returned if this
function is invoked with STATUS set to an error value, or if it
should fail for any reason.
Next: AST_REMOVEROW - Remove a row from a table
Up: AST Routine Descriptions
Previous: AST_REMOVEPARAMETER - Remove a global parameter from a table
AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk
Copyright (C) 2009 Science \& Technology Facilities Council