Description:
This
routine checks for matching axes in a supplied Region and Frame. If possible, a new region is created
containing a set of axes that correspond in number and type (but not necessarily in specific attributes)
to those in the supplied Frame. This means that AST_CONVERT should be able to find a Mapping
between the supplied Frame and the returned Region. Note, the order of the axes in the returned
Region may not match those in the Frame, but AST_CONVERT will be able to identify any required
re-ordering.
If it is not possible to find a matching Region (for instance, if there are no axes in common between the
supplied Region and Frame), an error is reported.
Invocation
CALL ATL_MATCHREGION( REGION,
FRAME, NEWREG, STATUS )
Arguments
REGION = INTEGER (Given)
An AST pointer for the
Region to be modified.
FRAME = INTEGER (Given)
An AST pointer for a Frame to be matched.
NEWREG = INTEGER (Returned)
An AST pointer to the returned Region.
STATUS = INTEGER
(Given and Returned )
The global status.