Transform N-dimensional coordinates held in separate arrays astTranP
If the coordinates are stored in a single (2-dimensional) array, then the astTranN function might be more suitable.
"
ncoord_in"
elements.
Element "
ptr_in[coord]"
should point at the first element of an array of double (with
"
npoint"
elements) which contain the values of coordinate number "
coord"
for each
input (untransformed) point. The value of coordinate number "
coord"
for input point
number "
point"
is therefore given by "
ptr_in[coord][point]"
(assuming both indices
are zero-based). ’
s
forward coordinate transformation is to be applied, while a zero value indicates
that the inverse transformation should be used. "
ncoord_in"
. "
ncoord_out"
elements. Element "
ptr_out[coord]"
should point at the
first element of an array of double (with "
npoint"
elements) into which the
values of coordinate number "
coord"
for each output (transformed) point will
be written. The value of coordinate number "
coord"
for output point number
"
point"
will therefore be found in "
ptr_out[coord][point]"
. If the forward coordinate transformation is being applied, the Mapping supplied must
have the value of "
ncoord_in"
for its Nin attribute and the value of "
ncoord_out"
for
its Nout attribute. If the inverse transformation is being applied, these values should
be reversed.
This routine is not available in the Fortran 77 interface to the AST library.
"
8-byte"
interface for this function should be used. This alternative interface uses 8
byte integer arguments (instead of 4-byte). Specifically, the argument "
npoint"
, is
changed from type "
int"
to type "
int64_t"
(defined in header file stdint.h). The
function name is changed by appending the digit "
8"
to the name. Thus, astTranP
becomes astTranP8.