Transform N-dimensional coordinates

This routine applies a
Mapping to transform the coordinates of a set of points in an arbitrary number of dimensions. It is the
appropriate routine to use if the coordinates are not purely 1- or 2-dimensional and are stored
in a single array (which they need not fill completely).

CALL AST_TRANN(
THIS, NPOINT, NCOORD_IN, INDIM, IN, FORWARD, NCOORD_OUT, OUTDIM, OUT, STATUS )

Pointer to the Mapping to be applied.

The number of points to be transformed.

The number of coordinates being supplied for each input point (i.e. the number of
dimensions of the space in which the input points reside).

The
number of elements along the first dimension of the IN array (which contains the input
coordinates). This value is required so that the coordinate values can be correctly located if
they do not entirely fill this array. The value given should not be less than NPOINT.

An array containing the
coordinates of the input (untransformed) points. These should be stored such that the
value of coordinate number COORD for input point number POINT is found in element
IN(POINT,COORD).

A .TRUE. value indicates that the Mapping

`’`

s forward coordinate transformation is to be applied, while a .FALSE. value indicates that
the inverse transformation should be used. The
number of coordinates being generated by the Mapping for each output point (i.e. the
number of dimensions of the space in which the output points reside). This need not be the
same as NCOORD_IN.

The number of elements along
the first dimension of the OUT array (which will contain the output coordinates). This
value is required so that the coordinate values can be correctly located if they will not
entirely fill this array. The value given should not be less than NPOINT.

An array into which the coordinates of the
output (transformed) points will be written. These will be stored such that the value of
coordinate number COORD for output point number POINT will be found in element
OUT(POINT,COORD).

The global status.

If the number of points to be transformed exceeds the largest value that can be represented by
a 4-byte integer, then the alternative

`"`

8-byte`"`

interface for this function should be used.
This alternative interface uses 8 byte integer arguments (instead of 4-byte). Specifically,
the arguments NPOINT, INDIM and OUTDIM are changed from type INTEGER to type
INTEGER$\ast $8.
The function name is changed by appending the digit `"`

8`"`

to the name. Thus, AST_TRANN becomes
AST_TRANN8. Copyright (C) 2024 East Asian Observatory