Module tides 

Solid-earth tide station displacement (IERS Conventions, Chapter 7).

solid_earth_tide computes the tidal displacement of an Earth-fixed (ITRF) GNSS station caused by the lunar and solar gravitational attraction. It is a derived work of the IERS Conventions (2010) reference routine DEHANTTIDEINEL.F (and its companion routines ST1IDIU, ST1ISEM, ST1L1, STEP2DIU, STEP2LON, CAL2JD, DAT), reproduced here in Rust.

How this derived work is based upon and differs from the original Software:

• It is a line-for-line Rust translation of the in-phase degree-2/degree-3 displacement, the out-of-phase corrections (ST1IDIU, ST1ISEM), the latitude-dependence correction (ST1L1), and the frequency-dependent step-2 diurnal/long-period band corrections (STEP2DIU, STEP2LON), evaluating the identical Love/Shida numbers, Doodson/argument tables, and leap-second table.
• It keeps the permanent (mean) tide deformation: the original routine’s commented-out “Step 3” permanent-tide removal is left disabled, matching the ITRF/IGS conform-to-mean-tide convention.
• The routine names are changed from the IERS originals (per the IERS Conventions Software License), and the Fortran subroutine structure is inlined into private helpers.

The Sun and Moon geocentric positions are inputs (metres, ECEF/ITRF); the caller supplies them, e.g. from crate::astro::bodies::sun_moon_ecef.

IERS Conventions Software License: permission is granted to use this software for any purpose, including commercial applications, free of charge, and to distribute derived works subject to the conditions reproduced above. Results obtained with this software acknowledge use of the IERS Conventions software.

Structs

OceanLoadingBlq

Per-station ocean-loading BLQ coefficients (Bos-Scherneck / HARDISP format).

OceanLoadingBlqBlock

One parsed standard BLQ station block.

StationDisplacement

Component-resolved station displacement in ITRF/ECEF metres.

StationDisplacementEpoch

UTC epoch for station displacement evaluation.

StationDisplacementOptions

Switches for the high-level station displacement entry.

StationPolarMotion

IERS polar-motion coordinates of the epoch, in arcseconds.

Enums

BlqParseErrorKind

OceanTideConstituent

BLQ tidal constituents supported by the ARG2 evaluator.

StationDisplacementPosition

Station position accepted by the high-level displacement API.

TideError

TideInputErrorKind

Constants

NUM_OCEAN_CONSTITUENTS

Number of BLQ tidal constituents (M2 S2 N2 K2 K1 O1 P1 Q1 Mf Mm Ssa).

OCEAN_LOADING_CONSTITUENTS

Standard BLQ column order.

Functions

ocean_tide_loading

Ocean tide loading displacement of an ITRF station, in metres (ECEF).

parse_ocean_loading_blq_block

Parse one standard Bos-Scherneck/HARDISP BLQ station block.

parse_ocean_loading_blq_blocks

Parse all standard station blocks in a BLQ file.

solid_earth_pole_tide

Solid-Earth pole tide displacement of an ITRF station, in metres (ECEF).

solid_earth_tide

Solid-earth tide displacement of an ITRF station, in metres (ECEF).

station_displacement_ecef_m

Evaluate the enabled station displacement corrections, returning ITRF/ECEF metre components.

station_displacement_ecef_m_batch

Evaluate station displacement for many epochs. Each element is equivalent to a scalar station_displacement_ecef_m call for the same position, epoch, and options, so per-epoch failures stay local to their output row.