IVERT

ICESat-2 Validation of Elevations Reporting Tool

IVERT validates Digital Elevation Models (DEMs) by comparing their elevations against ICESat-2 satellite photon data. It supports topographic, bathymetric, and mixed coastal DEMs, runs fully offline on any machine, and handles vertical datum conversions automatically.

Developed by the CIRES Coastal DEM Team. Primary authors: Mike MacFerrin (IVERT) and Matthew Love (continuous-dems utilities).

Capabilities

Validate topographic, bathymetric, and coastal DEMs against ICESat-2 ATL03/ATL24 photons
Combines ATL03/ATL08/ATL13/ATL24 for photon-level classifications, plus external datasets (such as the Global Buildings Atlas) to classify built structures.
Additional coastline filtering to minimize false-positive ATL08 "ground" photons appearing offshore over water, and unreasonably-shallow "bathy floor" photons with large errors over deep water.
Automatic vertical datum conversions (NAVD88, EGM2008, MLLW, and many more)
Configurable photon confidence and quality filtering
Statistical outputs: bias, RMSE, NMAD, per-cell error maps
Automatically-generated plots of DEM accuracies compared to ICESat-2.
Export errors to GeoTIFF, GeoPackage, Shapefile, or XYZ text
Local photon database management — download once, validate many times

Installation

pip install ivert

(^ coming soon)

For development (editable install from this repo):

git clone https://github.com/ciresdem/IVERT.git
cd IVERT
pip install -e .

Three dependencies — fetchez, globato, and transformez — are pulled automatically from the continuous-dems GitHub organization and do not need to be installed separately.

Quick start

1. Set up IVERT's data directories and credentials (run once on a new machine):

ivert setup

This creates the local ~/.ivert data directories and checks your ~/.netrc for NASA Earthdata Login credentials, offering to save them if they are not already present. Earthdata credentials are required to download ICESat-2 data (register for a free account).

2. Download ICESat-2 photon data for your area (bounding box in W/E/S/N order):

ivert database download -- -74.0/-73.0/40.5/41.0

3. Validate your DEM:

ivert validate mydem.tif

4. Check the output directory for mydem_results.h5, a validation plot (.png), and error exports (.tif, .gpkg).

Documentation

Command	Description
ivert setup	Create data directories and set up NASA Earthdata credentials
ivert validate	Validate DEMs against ICESat-2 data
ivert database	Download and manage the local photon database
ivert cache	View and clear the local file cache
ivert options	View and change configuration settings

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ivert-0.6.4.tar.gz (1.4 MB view details)

Uploaded Jul 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ivert-0.6.4-py3-none-any.whl (127.5 kB view details)

Uploaded Jul 19, 2026 Python 3

File details

Details for the file ivert-0.6.4.tar.gz.

File metadata

Download URL: ivert-0.6.4.tar.gz
Upload date: Jul 19, 2026
Size: 1.4 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for ivert-0.6.4.tar.gz
Algorithm	Hash digest
SHA256	`8ddd8922e1efbd45c8f659a17d433d65df68474ee5aed1c7de498bdd28ba566d`
MD5	`ea1fe202ca427e022c8666228e2be4ff`
BLAKE2b-256	`a5aa68b2270099c77e76e40daede60c3fac9f841931fcef4c02eff8ba4891005`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ivert-0.6.4.tar.gz:

Publisher: publish-to-pypi.yml on continuous-dems/ivert

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ivert-0.6.4.tar.gz
- Subject digest: 8ddd8922e1efbd45c8f659a17d433d65df68474ee5aed1c7de498bdd28ba566d
- Sigstore transparency entry: 2196548830
- Sigstore integration time: Jul 19, 2026
Source repository:
- Permalink: continuous-dems/ivert@b4347e016c16707fec66ca148d4a3cd153a5c4ce
- Branch / Tag: refs/tags/0.6.4
- Owner: https://github.com/continuous-dems
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-to-pypi.yml@b4347e016c16707fec66ca148d4a3cd153a5c4ce
- Trigger Event: release