Campbell Scientific PC208 Datalogger Support Software - Manual (Page 57)

SECTION 4. SPLIT
4-3
Each time it executes, SPLIT keeps track of the
number of bytes it reads from the input file and
saves this information in the parameter file.
SPLIT can start where it last left off by
appending to the input filename. This is
specified by appending the Input filename with
'/LAST' or '/L'. This feature may be used to
process only the new data from a file in which
new data is being appended periodically (e.g., a
data file generated by TELCOM).
CAUTION: When using the /L option, if
START and STOP conditions (Sections
4.3.3, 4.3.4) are specified, they must exist
in the newly appended data or SPLIT will
never begin execution.
By appending the Input filename with '/number'
SPLIT will "seek" that position in the file. This
option saves time by starting part way through a
large data file. The number specifies the number
of characters into the file to seek before doing
anything. All characters including spaces,
carriage returns, and line feeds are counted.
Beginning and ending points may be specified.
For example:
'TEST.DAT/256'
'TEST.DAT/256..1024'
The first example will cause SPLIT to skip 256
characters before beginning. The second
example skips 256 characters before beginning
and stop execution on character 1024.
CAUTION: When using the seek function
on a file in Final Storage Format, /F should
also be appended to the input file name.
This tells SPLIT that the file must be
decoded as Final Storage.
SPLIT automatically recognizes the type of data
file it is reading except for the Raw A/D data from
the burst mode (see datalogger manual, Burst
Mode serial port option). To read this type of data
and convert to ASCII append the INPUT data file
name with a '/B#', where the # is the number of
elements in each BURST. This number does not
include the array ID number or calibration data.
This option works with all subsequent commands
except when the '/T' option is used in the OUTPUT
FILE line (Section 4.3.2), the SELECT line (Section
4.3.6), cannot be used.
EXAMPLE: LOGAN.DAT/B100
This tells SPLIT that the input file is Raw A/D
data with 100 values in each BURST, excluding
the Output Array ID.
4.3.2 NAME OF OUTPUT FILE TO GENERATE
Enter an OUTPUT filename to create a file. The
file is created on the default drive or directory
unless the filename is preceded with an alternate
drive or directory. SPLIT will assign this file an
extension of .PRN if an extension is not specified
by the user. Whenever an OUTPUT filename is
entered, regardless of extension, an OUTPUT file
is created when the "RUN" option in the
Command Menu is selected.
If this line is left blank, SPLIT does not write an
OUTPUT file to disk but will display processed
values on the screen and drive results out to a
printer if requested (see/P below).
CAUTION: The OUTPUT filename cannot
be the same as the INPUT filename. SPLIT
displays an error message if this condition
occurs.
Several OUTPUT options may be specified to
alter the default OUTPUT to the file. To specify
an option, the OUTPUT filename must be
appended with a slash and the OUTPUT option.
If no option is specified the default OUTPUT file
will be stored under the given filename and
displayed to the screen. Table 4.3-3 is a
summary of the Output Option commands.
TABLE 4.3-3. Output Options
OPTION DESCRIPTION
/B# Breaks up arrays into #+1 elements.
/[comment] Store comment if input data is blank
or Out of Range.
/F Alter STOP condition to trigger TIME
SERIES processing output.
/G Outputs only those arrays containing
one or more Out of Range elements.
/M Match files.
/# Field width of output column
(default 8).
/0 Converts data to Comma Separated
ASCII format.
/1 Converts data to Printable ASCII
format.