YSI SonTek ADVField, Technical Documentation Manual

Page: 149 / 228

SonTek/YSI
ADVField Software Manual (September 1, 2001) 17
Section 3. Real-Time Data Conversion (GET___.EXE)
The ADV real-time data conversion programs (known as the
GET
programs) extract specific por-
tions of data from the ADV binary files and convert the data to easily read ASCII files. Data col-
lected using the ADV internal recorder use a different file format (see Section 9). The following
conversion routines are provided for real-time data files.
•
GETCTL
- Extracts file configuration and setup information
•
GETAMP
- Extracts signal amplitude data
•
GETCOR
- Extracts correlation data
•
GETHPR
- Extracts optional heading, pitch, and roll data
•
GETSEN
- Extracts optional sensor data - heading, pitch, roll, temperature, and pressure
•
GETSNR
- Extracts signal to noise ratio (SNR) data
•
GETVEL
- Extracts velocity data
If the name of any of these programs is entered by itself, the program displays information on its
use and a description of the parameters specified on the command line. These programs can be
run from any PC-compatible computer using the DOS operating system.
Be aware that the data conversion software will overwrite an existing file of the same name
without
prompting you for confirmation. Since the output files always use the same file name
extensions, and normally use the same name as the binary data file, this is not usually a concern.
If you modify any of the output files during analysis, be careful that the modified file is not acci-
dentally overwritten when extracting other portions of the data.
3.1. File Header Conversion
(GETCTL.EXE)
This program extracts the file configuration (i.e., “control”) information stored at the beginning
of each ADV binary data file. The following command syntax starts the
GETCTL
program.
GETCTL [ADV file] [output file]
File names must be given without an extension.
GETCTL
assumes the ADV data file has extension
.ADV
, and it assigns the extension
.CTL
to the output file. For example,
GETCTL WAVEDATA TEST
extracts the configuration information from binary file
WAVEDATA.ADV
and places the output in an
ASCII file named
TEST.CTL
. If
[output file]
is not specified,
GETCTL
creates an output file
with the same root name as the ADV data file. For example,
GETCTL WAVEDATA
extracts the configuration information to output file
WAVEDATA.CTL
. The output from
GETCTL
is
in a self-explanatory ASCII text format.
3.2. Data Sample Conversion
(GETAMP, GETCOR, GETHPR, GETSEN, GETSNR, GETVEL)
These programs extract different portions of the ADV data that are recorded with each sample.
The following command lines can be used to execute any of these programs.
GET___ [ADV file]
GET___ [ADV file] [output file]
GET___ [ADV file] [output file] [probe #]
GET___ [ADV file] [output file] [probe #] [first sample] [last sample]