Tide Model Driver (TMD) version 3.0

Version 3.0.0 (95.3 MB) by Chad Greene
Tide Model Driver for MATLAB, version 3.0

71 Downloads

Updated 7 Aug 2023

From GitHub

View License on GitHub

View Tide Model Driver (TMD) version 3.0 on File Exchange

Tide Model Driver 3.0

TMD logo Tide Model Driver for MATLAB, version 3.0. This is a fast, user-friendly, well-documented rewrite of ESR's classic Tide Model Driver by Svetlana Erofeeva.

Installation

To start predicting tides, just add TMD to MATLAB and download your favorite tide model data. Each step is described in the links below:

  1. Add TMD to MATLAB.
  2. Get tide model data.

TMD Functions

For most applications, tmd_predict is the only function you will need to call directly, although you may occasionally want tmd_interp to retrieve bathymetry, tmd_ellipse to get tidal current characteristics, or tmd_conlist for a quick list of tidal constituents in a given model. Complete documentation is provided for the functions whose names are hyperlinked below, and simple text documentation can be found in the headers of all functions.

Main functions:

  • tmd_predict predicts tidal elevation, transport, or current velocities for given location(s) and time(s).
  • tmd_interp provides water column thickness, land/ocean mask, ice shelf flexure, and tidal constituent parameters at specified geographic locations, for a given tide model.
  • tmd_data loads gridded tide model data without interpolation.
  • tmd_conlist returns a list of tidal constituents in a TMD3.0 compatible consolidated NetCDF tide model file.
  • tmd_ellipse gives tidal ellipse parameters at specified location(s).

Under-the-hood functions:

  • tidal_range calculates the peak-to-peak tidal height range.
  • tmd_astrol computes the basic astronomical mean longitudes s, h, p, N.
  • tmd_constit returns amplitude, phase, frequency, alpha, species for tidal constituents.
  • tmd_harp predicts tidal time series using harmonic constants.
  • tmd_InferMinor returns correction for 16 minor tidal constiuents.
  • tmd_nodal calculates the nodal corrections for tidal constituents.
  • tmd_ll2ps converts geographic coordinates to polar stereographic kilometers for polar models.
  • tmd_ps2ll converts polar stereographic kilometers geographic coordinates for polar models.

Accessing Help

For any of the TMD functions listed above, you can get plain-text help in the Command Window by typing help followed by the name of the function. For example:

>> help tmd_predict

To access formatted documentation with lots of examples for any of the Main functions listed above, type tmd followed by the function name. For example:

>> tmd tmd_predict

If you're not sure what function name you're looking for, just type tmd into the Command Window, and it will bring up a complete function list:

>> tmd 

Tutorials & More Documentation

Be sure to check out the documentation for each of the Main functions. There, you'll find multiple examples of how to use each function. In addition, the following tutorials and other documentation may be of interest:

What's new in TMD 3.0?

TMD3.0 is a rewrite of the Tide Model Driver for MATLAB v2.5. The goal of this update was to create a clean, efficient set of functions that are well documented, easy to use, and easy to debug. We also wanted to reduce the size, complexity, and overall hassle of dealing with multi-file or binary tide model data files. The biggest changes in this update to TMD3.0 are as follows:

  • Introduced a new, consolidated NetCDF model data format.
  • All functions rewritten for improved performance (much faster and lower memory usage than TMD2.5).
  • Most functions were renamed and inputs have changed to make them more intuitive and easier to use.
  • All new documentation.
  • Updated the CATS2008 model, as described here.

Alternatives to MATLAB

Don't like MATLAB? No worries, just try one of these alternatives:

  • Python: pyTMD is a tidal prediction software that can read OTIS, GOT and FES formatted tidal solutions for predicting ocean and load tides.
  • Fortran: A Fortran version of this package is made available through OSU: OSU Tidal Prediction software (OTPS).
  • Octave: It is possible that TMD3.0 works with Octave as it is currently written. I haven't checked, but most of the TMD functions are pretty basic, so Octave's functions might be exact clones. If you use Octave and you want to give TMD3.0 a try, please let me know how it goes!

Author Info & Citation Information

We are working on a proper literature citation. For now, if you use TMD3.0, please cite the following:

Chad A. Greene, Svetlana Erofeeva, Laurie Padman, Susan Howard, Tyler Sutterley, and Gary Egbert (2023). The Tide Model Driver for MATLAB, version 3.0. https://github.com/chadagreene/Tide-Model-Driver.

Cite As

Chad A. Greene, Svetlana Erofeeva, Laurie Padman, Susan Howard, Tyler Sutterley, and Gary Egbert (2023). The Tide Model Driver for MATLAB, version 3.0. https://github.com/chadagreene/Tide-Model-Driver.

MATLAB Release Compatibility
Created with R2023a
Compatible with any release
Platform Compatibility
Windows macOS Linux
Tags Add Tags

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Versions that use the GitHub default branch cannot be downloaded

Version Published Release Notes
3.0.0

To view or report issues in this GitHub add-on, visit the GitHub Repository.
To view or report issues in this GitHub add-on, visit the GitHub Repository.