SonTek/YSI Argonaut-XR Technical Manual - HydroScientific West
SonTek/YSI Argonaut-XR Technical Manual - HydroScientific West
SonTek/YSI Argonaut-XR Technical Manual - HydroScientific West
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
Section 6. GARG*/EARG* Data Extraction Programs (DOS)<br />
<strong>SonTek</strong>/<strong>YSI</strong><br />
All binary data files generated by the <strong>Argonaut</strong>, whether collected using the real-time data<br />
collection software ARGONAUT or recorded internally in <strong>Argonaut</strong> memory, use the same format.<br />
The precise format of the binary data files is given in the <strong>Argonaut</strong> Operation <strong>Manual</strong>. Several<br />
DOS-based programs are provided to extract different portions of the <strong>Argonaut</strong> binary data and<br />
convert the data to an ASCII text format.<br />
Note: Two versions exist for most of the data extraction programs – GARG*.EXE and EARG*.EXE.<br />
The only difference between the two versions is the measurement unit. Programs beginning with<br />
a “G” extract the data in metric units; those beginning with “E” extract the data in English units.<br />
For simplicity in examples, only the “G” programs will be illustrated.<br />
• GARGCTL / EARGCTL – Extracts the file configuration and setup information (recorded once for<br />
each data file).<br />
• GARGSAMP / EARGSAMP – Extracts all data recorded with each <strong>Argonaut</strong> sample.<br />
• GARGAMP / EARGAMP – Extracts raw signal strength data.<br />
• GARGVEL / EARGVEL – Extracts velocity data as individual components (Beam, XYZ, ENU).<br />
• GARGSTD / EARGSTD – Extracts velocity standard deviation data.<br />
• GARGPRES – Extracts pressure time-series data (if collected by optional sensor).<br />
Entering the name of any program from a DOS prompt without any parameters causes the<br />
program to display its command syntax.<br />
6.1. Control File Extraction: GARGCTL / EARGCTL<br />
GARGCTL (or EARGCTL) extracts the hardware configuration and user setup information from a<br />
binary data file. It is used by entering either of the commands below.<br />
GARGCTL <br />
GARGCTL <br />
File names must be given without extension. The program assumes that the <strong>Argonaut</strong> data file<br />
has extension .ARG and assigns the output data file the extension .CTL. For example,<br />
GARGCTL TEST HEADER<br />
extracts the configuration information from <strong>Argonaut</strong> binary data file TEST.ARG and places it into<br />
an ASCII file named HEADER.CTL. If is not specified, the program will create an<br />
output file with the same name as the <strong>Argonaut</strong> data file (i.e., TEST.CTL). The information in the<br />
.CTL file is in a self-explanatory ASCII text format.<br />
6.2. Sample Data Extraction: GARGSAMP / EARGSAMP<br />
GARGSAMP (or EARGSAMP) extracts all data recorded with each <strong>Argonaut</strong> sample. This information<br />
includes time, velocity, standard deviation, signal amplitude, compass data, temperature,<br />
pressure, and diagnostic data. The file will show 0 for any data where the sensor is not installed<br />
(i.e. compass/tilt or pressure sensor). The command format is as follows.<br />
GARGSAMP <br />
GARGSAMP <br />
GARGSAMP <br />
<strong>Argonaut</strong> Software <strong>Manual</strong> (March 1, 2001) 53