mbauvloglist
Section:  MB-System 5.0  (l)
Updated:  24 November 2006 
Index


 
NAME

mbauvloglist - Lists table data from an MBARI AUV mission log file.

 
VERSION

Version 5.0

 
SYNOPSIS

mbauvloglist -Ifile [-Llonflip
-Olist -V -H ]

 
DESCRIPTION

MBauvloglist reads an MBARI AUV mission log file and lists specified
fields in tab-delimited text output. MBARI AUV mission logs  are binary
files with an ascii header describing the units, name, and binary size 
of each value in a single record. An example of a log file header is:

# binary fastcatlog



# timeTag time %8.8e ,time ,UNKNOWN 



# double conductivity %8.8e ,Calculated conductivity ,Siemens/meter 



# double temperature %8.8e ,Calculated temperature ,Celsius 



# double pressure %8.8e ,Calculated pressure ,Decibars 



# double calculated_salinity %8.8e ,Calculated salinity ,Volts 



# double cond_frequency %8.8e ,Raw Conductivity frequency ,Hertz 



# double temp_counts %8.8e ,Raw Pressure A/D counts ,Unitless 



# double pressure_counts %8.8e ,pressure_counts ,Unitless 



# double pressure_temp_comp_voltage_reading %8.8e ,Raw pressure temp compensation voltage reading ,Volts 



# double calculated_sound_velocity %8.8e ,Calculated sound velocity ,M/s 



# begin

The values found in the various MBARI AUV mission logs include:

        "time"


        "mPos_x"


        "mPos_y"


        "mDepth"


        "mGpsNorth"


        "mGpsEast"


        "mGpsValid"


        "mPhi"


        "mTheta"


        "mPsi"


        "mOmega_x"


        "mOmega_y"


        "mOmega_z"


        "mPsaRange"


        "mAltitude"


        "mDvlAltitude"


        "mWaterSpeed"


        "mDvlValid"


        "mDvlNewData"


        "mDeltaT"


        "nfix"


        "efix"


        "filter_north"


        "filter_east"


        "filter_depth"


        "north_current"


        "east_current"


        "speed_bias"


        "heading_bias"


        "latitude"


        "longitude"


        "conductivity"


        "temperature"


        "pressure"


        "calculated_salinity"


        "cond_frequency"


        "temp_counts"


        "pressure_counts"


        "pressure_temp_comp_voltage_reading"


        "calculated_sound_velocity"


        "depth"


        "temp"


        "pressure"


        "temp_period"


        "pres_period"




Users can extract arbitrary text lists of values in the AUV log files by using the -O
and -F options to specify the values and formats in the order desired.

 
AUTHORSHIP

David W. Caress (caress@mbari.org)




  Monterey Bay Aquarium Research Institute



Dale N. Chayes (dale@ldeo.columbia.edu)




  Lamont-Doherty Earth Observatory

 
OPTIONS


-H


This "help" flag cause the program to print out a description
of its operation and then exit immediately.
-F


printformat



Sets the printing format (in fprintf() style) of the next value specified using
the -O option.By default, mbauvloglist uses the print format specified
in the log file header.
format 
-I


ifile



Sets the input MBARI AUV mission log  filename. 
-L

lonflip



Sets the range of the longitude values output.
If lonflip=-1 then the longitude values will be in
the range from -360 to 0 degrees. If lonflip=0 
then the longitude values will be in
the range from -180 to 180 degrees. If lonflip=1 
then the longitude values will be in
the range from 0 to 360 degrees.
Default: mbauvloglist uses the user default lonflip set using
mbdefaults.
-O


valuename



Causes mbauvloglist to output the specified value. This option can be 
given multiple times, and the values will be output in the order specified.
-V


The -V option causes the program to be verbose.

 
EXAMPLE

To extract a list of pressure and water sound speed from the CTD log of an
AUV mission, use:

        mbauvloglist -I mvc_logs/2006.224.00/fastcatlog.log \ 


                -F%f -O pressure -O calculated_sound_velocity 




This simple list is ordered as the data were collected, following the ups
and downs of the AUV mission. In order to construct a model of the water
sound speed as a function of depth, one can sort the output of mbauvloglist
(using the program sort) to be ordered with increasing pressure (depth), 
and then resampled into uniform increments of pressure using the GMT
program sample1d.

        mbauvloglist -I mvc_logs/2006.224.00/fastcatlog.log \ 


                -F%f -O pressure -O calculated_sound_velocity \ 


                | sort -n -u > auv_ssv.txt


        sample1d auv_ssv.txt -Fl -H1 -S0.0 -I10.0 > auv_ssv_bin.txt


 
SEE ALSO

mbsystem(l), sample1d, sort.

 
BUGS

Indubitably.



 
Index

NAME

VERSION

SYNOPSIS

DESCRIPTION

AUTHORSHIP

OPTIONS

EXAMPLE

SEE ALSO

BUGS

Return to list of MB-System manual pages...

Back to MB-System Home Page...