transformez 0.2.1

A standalone utility for vertical elevation datum transformations.

🌍 Transformez ↕

Global vertical datum transformations, simplified.

Transformez Les Données

🚀 v0.2.0: Now supporting global tidal transformations via FES2014 & SEANOE.

Transformez is a standalone Python engine for converting geospatial data between vertical datums (e.g., MLLW ↔ NAVD88 ↔ Ellipsoid).

---

Installation

pip install transformez

Requires htdp to be in your system PATH for frame transformations.

Usage

Generate a vertical shift grid for anywhere on Earth.

# Transform MLLW to WGS84 Ellipsoid in Norton Sound, AK
# (Where NOAA has no coverage!)
transformez -R -166/-164/63/64 -E 3s \
    --input-datum mllw \
    --output-datum 4979 \
    --output shift_ak.tif

Transform a raster directly. Transformez reads the bounds/resolution from the file.

transformez --dem input_bathymetry.tif \
    --input-datum "mllw" \
    --output-datum "5703:geoid=geoid12b" \
    --output output_navd88.tif

Integrate directly into your download pipeline.

# Download GEBCO and shift EGM96 to WGS84 on the fly
fetchez gebco ... --hook transformez:datum_in=5773,datum_out=4979

Python API

from transformez.transform import VerticalTransform
from fetchez.spatial import Region

# Define a region in India (Bay of Bengal)
region = Region(80, 85, 10, 15)

# Initialize Transformer
# Requesting "MLLW" in India triggers the Global Fallback automatically
vt = VerticalTransform(
    region=region,
    nx=1000, ny=1000,
    epsg_in="mllw",       # Will resolve to FES2014 LAT
    epsg_out="epsg:4979"  # WGS84 Ellipsoid
)

# Generate Shift
shift, unc = vt._vertical_transform(vt.epsg_in, vt.epsg_out)

Supported Datums

• Tidal: mllw, mhhw, msl, lat

• Ellipsoidal: 4979 (WGS84), 6319 (NAD83 2011)

• Orthometric: 5703 (NAVD88), egm2008, egm96

• Geoids: g2018, g2012b, geoid09, xgeoid20b

License

This project is licensed under the MIT License - see the LICENSE file for details. Copyright (c) 2010-2026 Regents of the University of Colorado