01.06.2013 Views

SonTek/YSI Argonaut-XR Technical Manual - HydroScientific West

SonTek/YSI Argonaut-XR Technical Manual - HydroScientific West

SonTek/YSI Argonaut-XR Technical Manual - HydroScientific West

SHOW MORE
SHOW LESS

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

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!