mbotps
Section: MB-System 5.0 (1)
Updated: 3 June 2013
Index
NAME
mbotps - Predicts tides using the OSU Tidal Prediction Software (OTPS) distribution.VERSION
Version 5.0SYNOPSIS
mbotps [-Atideformat -Byear/month/day/hour/minute/second -Dinterval -Eyear/month/day/hour/minute/second -Fformat -Idatalist.mb-1 -M -Ooutput -Rlon/lat -V]DESCRIPTION
MBotps is a utility that predicts tides using the OTPSnc (OSU Tidal Prediction Software) package that can be downloaded at:
http://www.coas.oregonstate.edu/research/po/research/tide/ The OTPSnc utilities are operated in a batch mode using command files with a fairly arcane format. MBotps provides a command line interface that allows MB-System users to easily obtain tide models for specified locations and times. MBotps is built during a normal installation of MB-System, but will work only if the OTPSnc package has been installed separately, the program predict_tide is in the user's path, and the user has both read and write permission in the directory containing the OTPSnc programs.MBotps can be operated in two modes. First, users may use the -R, -B, and -E options to specify a location and the beginning and end times of a tidal model for that location. The -D option sets the time interval of values in the output tidal model, and the -O option sets the output tidal model filename.
Alternatively, instead of specifying a place and time range, the user may specify one or more swath data files using the -I option. A tidal model is produced for each swath file in which tidal values are calculated using the sonar navigation locations at intervals specified with the -D option, and if the -M option is specified, the swath file's processing parameter file is modified so that mbprocess applies the tidal model during processing.
AUTHORSHIP
David W. Caress (caress@mbari.org)
Monterey Bay Aquarium Research Institute
Dale N. Chayes (dale@ldeo.columbia.edu)
Lamont-Doherty Earth ObservatoryOPTIONS
Lat/Lon/Time file:tmp_mbotps_llt_6995.txt
Constituents to include: m2 s2 n2 k2 k1 o1 p1 q1
Predict OCEAN tide
Interpolate minor constituents
Model: ss/sandbox/tides/OTPSnc/DATA/Model_tpxo7.2
Model is on grid uniform in lat,lon
Lat limits: -90.125 90.125
Lon limits: 0.125 360.125
Constituents: m2 s2 n2 k2 k1 o1 p1 q1 mf mm m4 ms4 mn4
Predict elevations (m)
Constituents to include: m2 s2 n2 k2 k1 o1 p1 q1
Reading model... done
Results are really in tide_tpxo7.2_model.txt
The output tidal model is in the file tide_tpxo7.2_model.txt, which includes
data that look like:
# Tide model generated by program mbotps
# Version: $Id: mbotps.1 2096 2013-06-04 08:17:22Z caress $
# MB-System Version: 5.1.2beta12
# Tide model generated by program mbotps
# which in turn calls OTPS program predict_tide obtained from:
# http://www.coas.oregonstate.edu/research/po/research/tide/
# Run by user <caress> on cpu <shepard-9.local> at <Wed Dec 23 01:56:31 2009>
# Model: ss/sandbox/tides/OTPSnc/DATA/Model_tpxo7.2
# Constituents included: m2 s2 n2 k2 k1 o1 p1 q1
2009 02 21 00 00 00 -0.6870
2009 02 21 00 01 00 -0.6840
2009 02 21 00 02 00 -0.6820
2009 02 21 00 03 00 -0.6790
2009 02 21 00 04 00 -0.6770
2009 02 21 00 05 00 -0.6740
2009 02 21 00 06 00 -0.6710
2009 02 21 00 07 00 -0.6690
.................
2009 02 21 23 54 00 -0.7970
2009 02 21 23 55 00 -0.7960
2009 02 21 23 56 00 -0.7940
2009 02 21 23 57 00 -0.7930
2009 02 21 23 58 00 -0.7910
2009 02 21 23 59 00 -0.7890
Now, suppose that one wants to apply tide corrections directly to a set of EM3002
data in GSF format. First, execute mbotps with the datalist for the swath
data specified as input:
mbotps -Idatalist.mb-1 -V
The resulting shell output looks like:
Program mbotps
Version $Id: mbotps.1 2096 2013-06-04 08:17:22Z caress $
MB-system Version 5.1.2beta12
---------------------------------------
Processing tides for himbb05291.d23.mb121
35602 records read from himbb05291.d23.mb121.fnv
Lat/Lon/Time file:tmp_mbotps_llt_7413.txt
Constituents to include: m2 s2 n2 k2 k1 o1 p1 q1
Predict OCEAN tide
Interpolate minor constituents
Model: ss/sandbox/tides/OTPSnc/DATA/Model_tpxo7.2
Model is on grid uniform in lat,lon
Lat limits: -90.125 90.125
Lon limits: 0.125 360.125
Constituents: m2 s2 n2 k2 k1 o1 p1 q1 mf mm m4 ms4 mn4
Predict elevations (m)
Constituents to include: m2 s2 n2 k2 k1 o1 p1 q1
Reading model... done
Results are in tmp_mbotps_llttd_7413.txt
Results are really in himbb05291.d23.mb121.tde
The output tide files have the same structure shown above:
# Tide model generated by program mbotps
# Version: $Id: mbotps.1 2096 2013-06-04 08:17:22Z caress $
# MB-System Version: 5.1.2beta12
# Tide model generated by program mbotps
# which in turn calls OTPS program predict_tide obtained from:
# http://www.coas.oregonstate.edu/research/po/research/tide/
# Run by user <caress> on cpu <shepard-9.local> at <Wed Dec 23 23:04:55 2009>
# Model: ss/sandbox/tides/OTPSnc/DATA/Model_tpxo7.2
# Constituents included: m2 s2 n2 k2 k1 o1 p1 q1
2005 10 18 19 01 36 0.0800
2005 10 18 19 02 36 0.0790
2005 10 18 19 03 36 0.0770
2005 10 18 19 04 36 0.0760
2005 10 18 19 05 37 0.0750
2005 10 18 19 06 37 0.0730
2005 10 18 19 07 37 0.0720
2005 10 18 19 08 37 0.0710
2005 10 18 19 09 37 0.0700
In addition to generating *.tde files for each swath file referenced by the
input datalist structure, mbotps modifies the parameter file associated
with each swath file (creating it if necessary) so that tide correction is enabled
using the *.tde file and tide format 2. When mbprocess is run on the same
datalist, the files will be reprocessed, and the processing will include the
application of the tide correction to all bathymetry.
Last Updated: 3 June 2013