compute_tidal_elevations.py

  • Calculates tidal elevations for an input file following [3]

  • Can use OTIS format tidal solutions provided by Oregon State University and ESR

  • Can use Global Tide Model (GOT) solutions provided by Richard Ray at GSFC

  • Can use Finite Element Solution (FES) models provided by AVISO

  • Can read and write ascii, netCDF4, HDF5, (cloud optimized) geotiff and (geo)parquet formats

Source code

Calling Sequence

usage: compute_tidal_elevations.py [-h] [--directory DIRECTORY]
                                   [--tide {AODTM-5,AOTIM-5,AOTIM-5-2018,Arc2kmTM,CATS0201,CATS2008,CATS2008-v2023,CATS2008_load,DTU23,EOT20,EOT20_load,FES2012,FES2014,FES2014_extrapolated,FES2014_load,FES2022,FES2022_extrapolated,FES2022_load,GOT4.10,GOT4.10_load,GOT4.7,GOT4.7_load,GOT4.8,GOT4.8_load,GOT5.5,GOT5.5D,GOT5.5D_extrapolated,GOT5.5_extrapolated,GOT5.5_load,GOT5.6,GOT5.6_extrapolated,Gr1km-v2,Gr1kmTM,HAMTIDE11,RE14,TPXO10-atlas-v2,TPXO10-atlas-v2-nc,TPXO7.2,TPXO7.2_load,TPXO8-atlas,TPXO8-atlas-nc,TPXO9-atlas,TPXO9-atlas-nc,TPXO9-atlas-v2,TPXO9-atlas-v2-nc,TPXO9-atlas-v3,TPXO9-atlas-v3-nc,TPXO9-atlas-v4,TPXO9-atlas-v4-nc,TPXO9-atlas-v5,TPXO9-atlas-v5-nc,TPXO9.1}]
                                   [--gzip]
                                   [--definition-file DEFINITION_FILE]
                                   [--crop] [--buffer BUFFER]
                                   [--format {csv,netCDF4,HDF5,GTiff,cog,parquet}]
                                   [--variables VARIABLES [VARIABLES ...]]
                                   [--header HEADER] [--delimiter DELIMITER]
                                   [--type {drift,grid,time series}]
                                   [--epoch EPOCH]
                                   [--deltatime DELTATIME [DELTATIME ...]]
                                   [--standard {UTC,GPS,TAI,LORAN,datetime}]
                                   [--projection PROJECTION]
                                   [--interpolate METHOD] [--extrapolate]
                                   [--cutoff CUTOFF]
                                   [--nodal-corrections CORRECTIONS]
                                   [--infer-minor]
                                   [--minor-constituents MINOR [MINOR ...]]
                                   [--append-node] [--apply-flexure]
                                   [--fill-value FILL_VALUE] [--verbose]
                                   [--mode MODE]
                                   [infile] [outfile]

Positional Arguments

infile

Input file to run

outfile

Computed output file

Named Arguments

--directory, -D

Working data directory

--tide, -T

Possible choices: AODTM-5, AOTIM-5, AOTIM-5-2018, Arc2kmTM, CATS0201, CATS2008, CATS2008-v2023, CATS2008_load, DTU23, EOT20, EOT20_load, FES2012, FES2014, FES2014_extrapolated, FES2014_load, FES2022, FES2022_extrapolated, FES2022_load, GOT4.10, GOT4.10_load, GOT4.7, GOT4.7_load, GOT4.8, GOT4.8_load, GOT5.5, GOT5.5D, GOT5.5D_extrapolated, GOT5.5_extrapolated, GOT5.5_load, GOT5.6, GOT5.6_extrapolated, Gr1km-v2, Gr1kmTM, HAMTIDE11, RE14, TPXO10-atlas-v2, TPXO10-atlas-v2-nc, TPXO7.2, TPXO7.2_load, TPXO8-atlas, TPXO8-atlas-nc, TPXO9-atlas, TPXO9-atlas-nc, TPXO9-atlas-v2, TPXO9-atlas-v2-nc, TPXO9-atlas-v3, TPXO9-atlas-v3-nc, TPXO9-atlas-v4, TPXO9-atlas-v4-nc, TPXO9-atlas-v5, TPXO9-atlas-v5-nc, TPXO9.1

Tide model to use in correction

--gzip, -G

Tide model files are gzip compressed

--definition-file

Tide model definition file

--crop, -C

Crop tide model to bounds of data

--buffer, -B

Buffer for cropping tide model

--format, -F

Possible choices: csv, netCDF4, HDF5, GTiff, cog, parquet

Input and output data format

  • 'csv': ascii with comma-separated values

  • 'netCDF4': Network Common Data Format version 4

  • 'HDF5': Hierarchical Data Format version 5

  • 'GTiff': GeoTiff georeferenced raster imagery

  • 'cog': Cloud Optimized GeoTIFF

  • 'parquet': Apache (geo)parquet

--variables, -v

Variable names of data in input file

--header, -H

Number of header lines for csv files

--delimiter

Delimiter for csv or ascii files

--type, -t

Possible choices: drift, grid, time series

Input data type

  • 'drift': drift buoys or satellite/airborne altimetry (time per data point)

  • 'grid': spatial grids or images (single time for all data points)

  • 'time series': station locations with multiple time values

--epoch, -e

Reference epoch of input time

  • 'days since 1858-11-17T00:00:00' (default Modified Julian Days)

--deltatime, -d

Input delta time for files without date variables

  • can be set to 0 to use exact calendar date from epoch

--standard, -s

Possible choices: UTC, GPS, TAI, LORAN, datetime

Input time standard for delta times

  • 'UTC': Coordinate Universal Time

  • 'GPS': GPS Time

  • 'LORAN': Long Range Navigator Time

  • 'TAI': International Atomic Time

  • 'datetime': formatted datetime string in UTC

--projection, -P

Spatial projection as EPSG code or PROJ4 string

--interpolate, -I

Possible choices: spline, linear, nearest, bilinear

Spatial interpolation method

--extrapolate, -E

Extrapolate with nearest-neighbors

--cutoff, -c

Extrapolation cutoff in kilometers

  • set to 'inf' to extrapolate for all points

--nodal-corrections

Possible choices: OTIS, FES, GOT, perth3

Nodal corrections to apply

--infer-minor

Infer values for minor constituents

--minor-constituents

Minor constituents to infer

--append-node

Append equilibrium amplitudes for node tides

--apply-flexure

Apply ice flexure scaling factor to height values

Only valid for models containing flexure fields

--fill-value, -f

Invalid value for spatial fields

--verbose, -V

Verbose output of processing run

--mode, -M

Permission mode of output file