| ASCII MERGE will merge one
or more input ASCII files to an output ASCII file. The input
ASCII files and the output ASCII file can all be in different
formats and different directions. The default input format is
"unknown", which causes the program to try to determine
the format based on the filename extension and the contents
of the file. The input format can be specified with the "-if"
option. The default output format is "LAS". The output
format can be changed with the "-of" option.
The output file will contain all curves from the all of the
input files. However, all curves with the same name will be
merged into a single curve in the output file. This can be
changed with the "-a" option which specifies that
curves should only be merged if they have the same name and
the same four API codes. This can also be completely suppressed
by specifying the "-m" option.
By default, the depth range in the output file will be just
big enough to contain the depth ranges of all input files.
The depth range to output can be explicitly enlarged or restricted
with the "-r" option.
By default, the depth increment and direction of the output
file will be the same as the first input file. However, the
output file can be made top down or bottom up using the "-t"
and "-b" options respectively. The level spacing
can also be specified explicitly using the "-l"
option. However, the program will not interpolate, so this
option would generally be used to increase the level spacing.
The absent value used in the output file will by default
be the same absent value used in the first input file. The
output absent value can be specified with the "-n"
option.
Absent values will be filled in in the output file wherever
a curve value is not available, such as beyond the range of
a curve or where two different depth increments get merged
together and no interpolation method has been specified or
when the "-int 0" option was specified. The program
will use linear interpolation if "-int 1" is specified
and cubic spline interpolation if "-int 2" is specified.
If an interpolation method was specified, gaps in the data
will be filled with values as long as the number of consecutive
missing values does not exceed 20. This threshold can be specified
on the command line by using the "-gap". For example,
the missing value fill threshold would be set to 30 by adding
"-gap 30" to the command line.
If the depth ranges of two curves being merged overlap, the
value from the first input file containing a non absent value
for the curve will be used.
When the depth range of the files doesn't overlap at all,
then the depth range in between will be filled with absent
values so that the output file can have a consistent depth
increment.
The output file will contain all comment information from
the first file followed by all comment information from the
second file, and so on. In the "LAS" format, comments
are in the ~O section.
The output file will contain all constant information from
all files. However if a constant has the same exact value
in more than one input file, the constant will only appear
once in the output file.
By default, the program will perform the merge without sending
any messages to standard output. If the "-v" option
is used, the program will print messages to show what it is
doing, such as which input file it is reading, and what curves
are being merged. It will also print the depth every 200 frames
while it is merging the actual curve data. This sample print
frequency can be changed with the "-d" option.
Summary of command line options:
-? Shows command line options.
-h Shows command line options.
-v Verbose.
-ia Set input ASCII file names to the following arguments.
-if Set input ASCII file formats to the following arguments.
-oa Set output ASCII file name to the following argument.
-of Set output ASCII file format to the following argument.
-t Make the data top down.
-b Make the data bottom up.
-a Include API codes in curve merging criteria.
-l Set level spacing to following argument.
-r Force depth range to following two arguments.
-n Set output null value to next argument.
-d Set data sample print frequency to next argument.
-s Use next argument as default curve selection file.
-m Don't merge curves together at all (except depth).
-int Set interpolation type (0=none(default), 1=linear, 2=cubic
spline).
-gap Set number of absent values to not interpolate across.
(default = 20)
|