LocSum combines NLLoc location results and PDF "scatter-cloud" samples from a number of events.
Overview - Running the program-Input - Output - [NonLinLoc Home]
The LocSum utility combines single event NLLoc location files (Hypocenter-Phase files and binary Scatter files) into a single set of summary location files.
For flexibility, the LocSum utility takes most of its parameters from the command line.
The LocSum utility takes several of command line arguments.
Synopsis:
LocSum SizeGridRoot decimFactor OutRoot LocRoot [Len3Max [ProbMin [RMSMax [NRdgsMin [GapMax]]]]]
SizeGridRoot
(chars) OutRoot
.
decimFactor
(integer) decimFactor > 0
) for decimating the number of PDF Scatter samples. Every decimFactor
-th sample is saved to the output files.
OutRoot
(chars) LocRoot
(chars) *
and ?
); however, if any "wild-card" characters are used then the path and root name must be enclosed in double quotes (") to prevent the shell from evaluating the "wild-card" characters.
Len3Max
(float) ProbMin
(float) RMSMax
(float) NRdgsMin
(integer) GapMax
(float)
LocSum dursum0 1 dursum "dur.*.*.grid0.loc"
Using an existing 3D Grid Header file dursum0.hdr
to determine the grid size, creates a dummy grid buffer file, a grid header file, a set of summary Hypocenter-Phase files, binary Scatter files, and a set of ASCII Scatter files for each location in the current directory with root name "dur.*.*.grid0.loc"
. The output files are written to the root name dursum
. The scatter samples are not decimated since decimFactor
= 1
.
The LocSum utility creates the following files:
OutRoot.hyp
. This file includes SCATTER
blocks.
OutRoot.scat
.
OutRoot.scat.ext
, where ext
= XY, XZ, ZY
for sample locations in kilometers and ext
= longlat.XY, longlat.XZ, longlat.ZY
for sample locations in degrees of latitude and longitude and depth in kilometers. These ASCII formats are compatible with the GMT plotting package.
OutRoot.hdr
and an empty 3D Grid Buffer file named OutRoot.buf
. These file are created to insure compatibility with post-processing programs and utilities.
Back to the NonLinLoc site Home page.
Anthony Lomax