SonTek ADP Software Manual

Hide thumbs

Table Of Contents

Table of Contents

Quick Links

SonTek

6837 Nancy Ridge Drive, Suite A, San Diego, CA 92121 USA

Telephone (858) 546-8327 • • • • Fax (858) 546-8150

E-mail: inquiry@sontek.com • • • • Internet: http://www.sontek.com

Acoustic Doppler Profiler (ADP    )

Software Manual

Version 6.42

ADP (Acoustic Doppler Profiler) is a registered trademark of SonTek Inc.

translated, or reduced to any electronic medium or Machine-readable form without prior consent in writing from SonTek. Every effort has been

made to ensure the accuracy of this manual. However, SonTek makes no warranties with respect to this documentation and disclaims any

implied warranties of merchantability and fitness for a particular purpose. SonTek shall not be liable for any errors or for incidental or

consequential damages in connection with the furnishing, performance, or use of this manual or the examples herein. The information in this

document is subject to change without notice.

Table of Contents

Need help?

Do you have a question about the ADP and is the answer not in the manual?

Questions and answers

Summary of Contents for SonTek ADP

Page 1 However, SonTek makes no warranties with respect to this documentation and disclaims any implied warranties of merchantability and fitness for a particular purpose. SonTek shall not be liable for any errors or for incidental or consequential damages in connection with the furnishing, performance, or use of this manual or the examples herein.
Page 2 SonTek ADP Software Manual Version 6.42 (November 1, 2000)
Page 3: Introduction
SonTek INTRODUCTION Thank you for buying an ADP from SonTek. Included with your ADP is Software Version 6.42 or later, which is designed to provide a powerful and flexible means to control instrument operation and access data. All software is written for DOS on PC-compatible computers. The software is intended to be easy to use, and it is our hope that the manual should be needed only as a reference.
Page 5: Table Of Contents
SECTION 7. Recorder Data Extraction (SONREC) ............24 SECTION 8. Additional Support..................26 APPENDIX A. Automatic File Naming Convention.............. 27 APPENDIX B. Correcting for Vessel Motion Using GPS Position Data ......28 ADP Software Manual Version 6.42 (November 1, 2000)
Page 7: Software Summary
C, for all ADP data conversion routines (the GADP___.EXE files). This code allows the user to easily write their own software to access the ADP binary data files. The code should be easily understandable to anyone with basic experience programming in C.
Page 8: Real-Time Data Collection (Adpsa)
SonTek SECTION 2. Real-Time Data Collection (ADPSA) This program collects data from an ADP in real time. The software must be run from DOS on a PC-compatible computer with a minimum 33-MHz 386 processor, 640K RAM, VGA graphics, and a hard disk. It provides a menu driven format to select ADP data collection parameters, real- time display of the velocity data, and writes the ADP data to binary files on the computer hard disk.
Page 9: Command Line Options
C:\ADP\AA HOURLY The first word specifies the path (“C:\ADP\”) for the data file and the first two characters (“AA”) in the file name. The remainder of the file name is generated using the date and time (see Appendix A). The second word on this line specifies the interval at which new data files are created.
Page 10 Using the –p command line option allows ADPSA to integrate GPS position data into the file. See sections 2.5 and 3.5 for more information about using GPS position data to correct ADP velocity data from a moving vessel. When using integrated GPS data, the user must create a one- line ASCII text file named “GPSPORT.DEF”...
Page 11: Setting Up Data Acquisition Parameters
The computer date and time are shown in the upper right hand corner of the screen. It is important to note that this is the date and time used for data collection by ADPSA. The ADP internal clock is set to match the computer clock, and all data has a time stamp that matches the computer clock.
Page 12: User Setup Parameters
Temperature is required for calculating the speed of sound, which converts Doppler shift to water velocity. The entered temperature may or may not be applied for sound speed calculations depending upon the temperature mode setting (see below). Figure 1 – ADPSA Setup Screen ADP Software Manual Version 6.42 (November 1, 2000)
Page 13 MEASURED, the sound speed will be based upon the value from the ADP temperature sensor. See the ADP Principles of Operation for details on the effect of sound speed on ADP operation. Temperature Mode: (Multiple-choice) Temperature mode refers to the source of temperature data for sound speed calculations.
Page 14 ENU coordinate system is preferred. Sensor Mounting Depth (m): (Enter value) This sets the depth at which the ADP is mounted (at the level of the transducer faces). This value is for display purposes to determine the depth of each cell.
Page 15: Data Acquisition Display
Start Time This time is obtained from the computer clock (note that the ADP clock is set to match the PC clock at the start of data collection) and represents the start of the first averaging interval.
Page 16 Displays the most-recent data from the ADP temperature sensor. Pressure (dB) Displays the most-recent data from the optional ADP pressure sensor, in dBar. This field will show 0 if the pressure sensor is not installed. Bottom Track Display (if enabled) Displays the most-recent bottom-track data: averaged depth (m), Veast and Vnorth (cm/s).
Page 17: Velocity Profile Data
Signal strength is the magnitude of the return signal from the water, and is a function of the frequency of the ADP, the amount of scattering material in the water, and the range from the instrument. Signal strength is plotted using internal units called counts;...
Page 18: Integrated Gps Data
F1 – Change Vel Reference: (Multiple-choice) This allows the user to select how ADP velocity data are displayed. “Relative to ADP” gives the raw velocity relative to the instrument. “Relative to GPS” uses the GPS calculated vessel speed and the magnetic variation (from the setup menu) to determine the absolute water velocity, independent of vessel motion.
Page 19 Recommended cell sizes for the different ADP frequencies are 0.5 m, 1.0 m, 1.0 m, 2.0 m, 4.0 m, and 4.0 m for the 3000 kHz, 1500 kHz, 1000 kHz, 750 kHz, 500 kHz, and 250 kHz, respectively.
Page 20: Data Recording
2.6. Data Recording ADP data are recorded in a standard binary file format; the same format is used whether data are recorded using ADPSA or on the internal recorder. When data collection is started, the hardware configuration and user operating parameters are stored in a file header structure. With each profile, the system stores a binary record containing velocity, signal strength, standard deviation, heading, pitch, roll, profile time, and a number of other parameters.
Page 21: Binary Data Conversion (Gadp
ADPSA or recorded internally in ADP memory, use the same format. The exact format of the binary data files is given in the ADP Operation Manual. The data conversion software discussed in this section extract various portions of the data from the binary file to an easily manipulated ASCII format.
Page 22: Profile Header Conversion: Gadphdr
SonTek output file with the same name as the ADP data file (i.e. TEST.CTL). The information in the .CTL file is in a self-explanatory ASCII text format. 3.2. Profile Header Conversion: GADPHDR This program extracts the header information that is recorded with each velocity profile. This information includes time, heading, pitch, roll, temperature, pressure, and sound speed.
Page 23: Profile Data Conversion: Gadpamp / Snr / Std
File names must be given without extension. The programs assume that the ADP data file has extension .ADP. If no output file name is specified, the programs use the same name as the binary data file. Specifying the first and last profile permits the user to extract a subset of the data.
Page 24: Velocity Data Conversion: Gadpvel
3.4. Velocity Data Conversion: GADPVEL This program extracts velocity data from an ADP data file and writes them to an ASCII file in tabular format. GADPVEL creates files with extensions ".V1", ".V2", and ".V3" corresponding to velocity components based upon the coordinate system selected (Beams 1, 2, and 3 / Vx, Vy, and Vz / VEast, VNorth, and VUp).
Page 25: Gps Data Conversion: Gadpgps
File names must be given without extension. The program assumes that the ADP data file has extension .ADP. If no output file name is specified, the program uses the same name as the ADP data file. Specifying the first and last profile permits the user to extract a subset of the data. If they are not specified, the program extracts all profiles in the file.
Page 26: Compass Calibration (Compcal)
COMPCAL <com port> <baud rate> where • <com port> is the serial port number to which the ADP is connected (1 for COM1 or 2 for COM2). • <baud rate> is the communication baud rate setting of the ADP; if no value is given, the program assumes the default setting of 9600 baud.
Page 27: Obtaining Correct Magnetic Variation (Magdecl)
North and TRUE North. For example, a declination of +10 deg means that Magnetic North is 10 deg to the East of TRUE North. SonTek's ADP, ADV, and ARGONAUT systems use a magnetic compass to measure the direction of North, which results in velocities referenced to magnetic North instead of TRUE North.
Page 28: Terminal Emulator (Sonterm)
SonTek SECTION 6. Terminal Emulator (SONTERM) This program is for direct communication with the ADP over a computer serial port. To run the program type “SONTERM” at the DOS prompt. Direct communication with the ADP is used for a variety of functions including system diagnostics, autonomous deployment, manual recorder- data retrieval, and placing the system in sleep mode.
Page 29 Alt+F7 - 7 Alt+F8 - 8 Stop bits Alt+F1 - 1 Alt+F2 - 2 Defaults D - Return all settings to default values (COM1, 9600 baud, no parity, 8 data bits, 2 stop bits) ADP Software Manual Version 6.42 (November 1, 2000)
Page 30: Recorder Data Extraction (Sonrec)
SONREC <com port> <baud rate> <extraction rate> where • <com port> is the serial port number to which the ADP is connected (1 for COM1 or 2 for COM2). • <baud rate> is the communication baud rate setting of the ADP; if no value is given, the program assumes the default setting of 9600 baud.
Page 31 SonTek Upon execution, SONREC wakes the ADP and establishes a direct link to the recorder at the specified extraction rate. The program then downloads the directory of files stored on the recorder and displays this information on the screen. The directory screen shows the following information.
Page 32: Additional Support
See our web page for information concerning new products and software / firmware upgrades. SonTek also maintains an FTP site for software upgrades and data exchanges. To access the FTP site, login anonymously to ftp.sontek.com, use your e-mail address as a password, and use the path /pub.
Page 33: Appendix A. Automatic File Naming Convention
When automatically generating data file names in the real-time software (running ADPSA with the -f or –g command line options), the ADP uses a file naming convention based upon the date and time at which the file was created. Unless the clock has been reset such that two files are started within the same minute, the file name cannot be repeated.
Page 34: Appendix B. Correcting For Vessel Motion Using Gps Position Data
This appendix provides the algorithms to calculate vessel motion from GPS data, and to remove vessel motion from ADP velocity data. These algorithms are used for the display of absolute velocity data in the real-time software (see sections 2.4 and 2.5), and for the output of absolute velocity data in ASCII format using the data conversion software (see SECTION 3).
Page 35 = xyz1[i] - xyz0[i]; XyzToEnu(StartGpsPos.Lat, StartGpsPos.Lon, dxyz, denu); dt = EndGpsPos.Utc - StartGpsPos.Utc; if(dt < 0) dt += 604800.0; /* correct for week crossover */ if(dt >= 1) GpsVeast = denu[0] / dt; ADP Software Manual Version 6.42 (November 1, 2000)
Page 36 = sin(ar); /* correct velocity in all bins for(i=0; i < nbins; i++) /* ADP velocity is rotated for magnetic variation /* Prf.Vel[0][i] is magnetic east, Prf.Vel[1][i] is north*/ /* vertical velocity (Prf.Vel[2][i]) is not affected /* recall that velocity is stored as mm/s AbsVel[i][0] = ca*Prf.Vel[0][i] + sa*Prf.Vel[1][i] + 1000*GpsVeast;...