Skip to main content

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).

Note: This repository will soon be ported over to the continuous-dems ecosystem.


(TODO: Add some pretty pictures here)


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. 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

2. Validate your DEM:

ivert validate mydem.tif

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


Documentation

Command Description
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

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.3.tar.gz (1.4 MB view details)

Uploaded Source

Built Distribution

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

ivert-0.6.3-py3-none-any.whl (122.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ivert-0.6.3.tar.gz
  • Upload date:
  • 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.3.tar.gz
Algorithm Hash digest
SHA256 d8210d77dcf0b5faad0b5b715a9240c7477cf0dd7341b5d65ea16a5ad593aebb
MD5 6389ab5757688b544f932bca835c171e
BLAKE2b-256 6a580d1cb6184c0977eca046aaf31357ec581df02d63d77766dc8c3340d3d600

See more details on using hashes here.

Provenance

The following attestation bundles were made for ivert-0.6.3.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.

File details

Details for the file ivert-0.6.3-py3-none-any.whl.

File metadata

  • Download URL: ivert-0.6.3-py3-none-any.whl
  • Upload date:
  • Size: 122.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for ivert-0.6.3-py3-none-any.whl
Algorithm Hash digest
SHA256 e93b0449e7ae3224642146c7e3ab92d14614da9f55e92e1437dce14cf5fce64d
MD5 fd1488511403187e375b2c12cc55fbb8
BLAKE2b-256 05eae5a55615cdc48271b1ff4bf31c48e077a05e8cc0f8995a1e5cc5dec39b98

See more details on using hashes here.

Provenance

The following attestation bundles were made for ivert-0.6.3-py3-none-any.whl:

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.

Release history Release notifications | RSS feed

0.6.10

2 files

0.6.9

2 files

0.6.8

2 files

0.6.7

2 files

0.6.6

2 files

0.6.5

2 files

0.6.4

2 files

This release

0.6.3 This release

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page