- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑
Description:
This routine ‘pastes’
an array on to
another array. Values of the underlying array are replaced by values in the pasted array, except that
bad values may also be made transparent, in other words the original base array appears through the
bad values. Origin information is used to situate the paste operation.
Invocation
CALL KPG1_PASTx(
TRANSP, BAD, OFFSET, IDIMS, ELI, INARR, ODIMS, ELO, BASE, STATUS )
Arguments
TRANSP
= LOGICAL (Given)
Whether bad pixels are transparent or not. If true, bad pixels in the pasted array
will not be pasted into the revised array. This is ignored if BAD is false.
BAD = LOGICAL (Given)
If
true then there may be bad values in the pasted array. If false then there are definitely no
bad values in the pasted array.
OFFSET( NDF__MXDIM ) = INTEGER (Given)
The
offset in each dimension of the pasted array’
s origin with respect to the origin of the base
array.
IDIMS( NDF__MXDIM ) = INTEGER (Given)
The dimensions of the array to be
pasted. Unused dimensions up to NDF__MXDIM should be set to one.
ELI = INTEGER
(Given)
The number of elements in the array to be pasted.
INARR( ELI ) = ? (Given)
The
array that will be pasted on to the base array.
ODIMS( NDF__MXDIM ) = INTEGER
(Given)
The dimensions of the base array. Unused dimensions up to NDF__MXDIM should
be set to one.
ELO = INTEGER (Given)
The number of elements in the base array.
BASE( ELO ) = ? (Given and Returned)
The base array on to which the input array will
be pasted.
STATUS = INTEGER (Given and Returned)
The global status.
Notes:
-
This routine works in n-D, where n is 1 to 7. Even if the array has actually less dimensions there is
negligible loss of efficiency to supply dummy (=1) higher dimensions.
-
There is a routine for each numeric data type: replace "
x"
in the routine name by D, R, I, W, UW, B or
UB as appropriate. The base and paste arrays supplied to the routine must have the data type
specified.
- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑