ANSI-C program: pt_density.c
NAME
pt_density - point density calculation (number of adjacent points
within a radius)
SYNOPSIS
pt_density <plist> <pmask> <SLC_par>
<pdens_out> [r_max]
| <plist> | (input) point list (int) |
| <pmask> | (input) point data stack of mask values (uchar, set to - to accept all points) |
| <SLC_par> | (input) SLC parameter file of point list coordinates |
| <pdens_out> | (output) point density (number of adjacent points) (type: float) |
| [r_max]; | maximum radius (range samples, default: 64 ) |
EXAMPLE
pt_density testsite.plist testsite.pmask 08256.rslc.par
testsite.pdens_out 100
Calculates, for each point in a point list, the number of points (point density) found within a given search radius (100 SLC range samples). The point density is then stored in the point data stack testsite.pdens_out (type: float).
INSTALLATION
Source code pt_density.c in ./IPTA/src, executable version
pt_density in ./IPTA/bin
DESCRIPTION
pt_density calculates, for each point in a point list, the number
of points (point density) found within a given search radius
(default: 64 SLC range samples).
Together with the input point list an input point mask can be
indicated to consider or ignore specific points. "-" can be
indicated instead of a pmask file to consider all points of the
list.
The SLC parameter file associated with the point list coordinate
geometry is required to calculate ground distances between pairs
of points. Such distances are calculated using the ground range
sampling (calculated from slant range sampling and incidence
angle) and the azimuth spacing. The maximum search area radius is
indicated in SLC range samples. Only valid points, i.e. points
with a non-zero value in the mask are considered. For points with
a zero in the mask the output is set to the NULL value.
The local search area in km^2 is written to standard output (look
for: Local search area around point (km^2): value).
The result of pt_density is a point data stack (type: float)
indicating a point density for each input point.
OPTIONS
none.
SEE ALSO
pt_density_reduction.c,
ipta.h.
© Copyrights for Documentation, Users Guide and Reference Manual by Gamma Remote Sensing, 2011.
UW, CW, OF,
last change 29-Mar-2011.