SMCE HRET14

Top-level Files of tip
Login

Files in the top-level directory from the latest check-in


HRET14 Tide Prediction Software

What is this software?

This software is used to predict the sea surface-height anomaly or ocean surface current associated with the baroclinic (internal) tide. The user inputs a filename containing a list of longtiude, latitude, time coordinates, and the software will output the predicted tidal elevation and current from the HRET14 baroclinic tide model. Input files in different formats are supported (RADS, SWOT, and GDP), but the user can modify these for other input format specifications. For detailed usage instructions, see below.

Who is this software for?

This software is for researchers who would like to predict baroclinic sea level anomaly (baroclinic surface pressure) or baroclinic surface currents associated with the ocean tides, M2, S2, N2, K1, and O1. The predictions are based on a model for the phase-locked tides obtained by mapping historical satellite altimeter data and hourly velocity estimates from surface drifters. Thus, the predictions will not include modulations related to time-variable refraction or other interactions with the environment.

How to get more information?

Email the author: Edward D. Zaron

Read about the development of HRET14: manuscript in review at JTech

Read about the previous version of HRET (version 8.1): Baroclinic Tidal Sea Level from Exact-Repeat Altimetry

Learn about tides and tidal analysis: Coastal Tides by Bernard Simon.

Quickstart for a cloud environment or Linux commandline installation

Installation

Within the SMCE environment the sample files can be copied into your user directory as follows:

mkdir /home/jovyan/DEMO_FILES
cp /efs/SWOT_shared/data/SWOT_SIMULATED_L2_KARIN_SSH_ECCO_LLC4320_SCIENCE_V1/SWOT_L2_LR_SSH_Expert_018_290_20121112T003212_20121112T012339_DG10_01.nc /home/jovyan/DEMO_FILES/

Options for using the software:

Command-line usage:

julia test.jl <PATHSPEC>
  1. If PATHSPEC ends in ".nc" (i.e., if it is the full path to a NetCDF file) then we compute baroclinic tide SLA predictions and write them in a file called PATHSPEC_hret.nc. The SWOT sample data, RADS passfile, and GDP data file formats are currently supported.

  2. If PATHSPEC ends in ".txt" then we treat the contents of PATHSPEC as a list of files and generate predictions, as above.

  3. If PATHSPEC ends in "/" then we compute tide predictions for all the files with names ending in ".nc" in this directory, as above.

  4. If PATHSPEC is omitted, then the default value is used, PATHSPEC=/home/jovyan/DEMO_FILES/.

This program will generate the output files, mentioned above, in addition to simple plots of the input coordinates (latitude,longitude), useful for basic sanity checking.

Caveats:

This program attempts to read and parse the input files to extract the latitude, longitude, and time at which predictions are requested. It has enough logic to handle cases, such as the simulated SWOT data files, where the two-dimensional (latitude,longitude) arrays must be matched with a one-dimensional time array.

The most important thing to verify, as a user, is that the reference time for the time variable has been parsed correctly. The start and end times of each input file, in YYYY-MM-DD HH:MM:SS format, are output to the console for you to check. The times are also written prominently on the sample figures created by this program.