ATL_MATCHREGION

Ensure the axes in a Region match those in a Frame

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.