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

SECTION 4. SPLIT
4-7
SPLIT will begin reading on data output at 1000
hours and 05 seconds on day 27.
CAUTION: SPLIT will not start reading if
the exact specified STARTing time cannot
be found. The interval (5 minutes, 60
minutes, and 5 seconds in the examples
above) must be evenly divisible into 60
minutes.
4.3.4 STOP READING IN
The STOP value is expressed with the same
syntax as the START value, with the exception
that there is no time sync. If this parameter is
left blank then SPLIT will execute until the END
OF FILE (EOF). Logical "and" and "or"
statements can be used when specifying the
STOP condition (Section 4.3.3).
The STOP condition specifies when to stop
processing data. This feature allows segments
of data to be removed from large data files. For
instance, if a data file contained one month of
data and just one day is desired, the start and
stop values allow the user to get just that days
data. The array containing the stop condition is
not included in the output file. If the stop value
is not found then SPLIT will display a message
to give another filename where the data is
continued or to press ESC (escape) to end.
This feature is useful when data is contained on
several diskettes.
The C and F commands alter the meaning of
the STOP condition.
4.3.4.1 'C' OPTION FORMATTING EVENT
DRIVEN TESTS CONTAINING CONDITIONAL
OUTPUT ARRAYS
To understand the 'C' option, assume that one
or more conditional Output Arrays with unique
Output Array IDs compose a test, followed by
an unconditional Output Array which defines the
end of a test. The unconditional "end of test"
Output Array is OUTPUT for every test, but the
conditional Output Arrays may or may not be
present. Several tests exist throughout the file.
It is desired to SELECT (Section 4.3.6)
elements from each Output Array in a test and
OUTPUT them on one SPLIT output line. The
'C' option is used to OUTPUT blanks in place of
absent conditional OUTPUTs, and to continue
reading the file for subsequent COPY (Section
4.3.5) and STOP conditions after a STOP
condition is encountered.
The PARameter file, up to and including the
COPY line, is set up as follows:
•
The INPUT file must be entered on the
INPUT file line as many times as there are
OUTPUT array IDs in a test.
•
A 'C,' followed by the ID from the "end of
test" Output Array is entered on all STOP
lines except the STOP line associated with
the "end of test" Output Array. The "end of
test" STOP line is left blank. This enables
the 'C' option and defines the STOP
condition for all Output Arrays except the
"end of test".
•
The first COPY line contains the COPY
condition for the first Output Array of the
test, the second COPY line contains the
COPY condition for the second Output
Array of the test, etc. The last COPY line
contains the COPY condition for the "end of
test" Output Array.
The STOP condition is found for each
conditional Output Array because the
unconditional "end of test" Output Array is never
missing. If one of the conditional Output Arrays
is missing, the STOP condition is encountered
before the missing array's COPY condition is
found. When a STOP condition is found before
a COPY condition, the 'C' option outputs blanks
in place of the missing Output Array's
SELECTed elements, thus keeping Output
Arrays from the same test on the same SPLIT
output line. SPLIT will continue reading the
INPUT files for subsequent COPY and STOP
conditions in this same manner until the EOF is
reached or execution is stopped by the user.
EXAMPLE: C,5[55.3]
4.3.4.2 'F' OPTION CONDITIONAL OUTPUT
OF TIME SERIES PROCESSING
The 'F,' and the '/F' options are identical in
function. The 'F' option operates only on the file
associated with the STOP condition, while the
/F option operates on all INPUT files.
The 'F' option, for use with Time Series
functions only (Section 4.3.6), causes Time
Series processing to be OUTPUT when a
STOP condition is found. The Time Series
processing includes elements in the STOP
condition Output Array if that Output Array
satisfies the COPY condition (Section 4.3.5).