ANSI-C program: cat_pt.c
NAME
cat_pt - concatenate point lists, point masks, and data
stacks
SYNOPSIS
cat_pt <plist1> <pmask1> <pdata1>
<plist2> <pmask2> <pdata2> <plist3>
<pmask3> <pdata3> <type> <mode>
| <plist1> | (input) point list 1 (int) |
| <pmask1> | (input) point data stack of mask values 1 (uchar) |
| <pdata1> | (input) point data stack 1 |
| <plist2> | (input) point list 2 (int) |
| <pmask2> | (input) point data stack of mask values 2 (uchar) |
| <pdata2>
|
(input) point data stack
2 |
| <plist3> |
(output) point list (int) |
| <pmask3> |
(output) concatenated data
stack of mask values (uchar) |
| <pdata3> |
(output) concatenated data
stack |
| <type> |
data stack type
(0:fcomplex 1:scomplex 2:float
3:int 4:short 5:byte) |
| <mode> |
concatenation mode: 0: simple concatenation of data, no checking for redundent points 1: remove redundent points from plist2 if they exist in plist1 2: remove redundent points from plist2 if they exist in plist1, and if pmask1[] = 0 and pmask2[] = 1, substitute valid data from pdata2 |
INSTALLATION
Source code cat_pt.c in ./IPTA/src, executable version cat_pt in
./IPTA/bin
DESCRIPTION
cat_pt is a program that
concatenates point lists, masks and data data stacks. There are
three concatenation modes
mode 0: simple concatenation with no checking for
duplicate points. The number of points in the output list is the
sum of the number of points in plist1 and plist2.
Modes 1 and 2 check if there are redundent points in plist2
and if there are, these are eliminated. Consequently, the output
list lenghth will be shorter if there are redundent points in
plist2. Mode 2 differs in that if a point is masked out in
plist1, but exists in plist 2 (pmask2 [i] != 0), the data values
are accepted and the pmask3 value is set to 1.
Note that in all modes the point numbering of plist1 is
preserved. This means that if a reference point is chosen from
plist1, the point number index will be the same in the output
list, mask, and data stack.
OPTIONS
none.