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
ivert upgrade Upgrade IVERT to the latest version

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.2.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.2-py3-none-any.whl (122.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ivert-0.6.2.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.2.tar.gz
Algorithm Hash digest
SHA256 4624adbcb358b9b2db2ea535ae38a2b7f5473b97bad31b6d0b8c6873cfae890a
MD5 0b1859501da6a298c61f36913775217e
BLAKE2b-256 9a645f116795f9ea068cfa2c0d9069ef076dc493c57faeea7e5c89eb14e6db28

See more details on using hashes here.

Provenance

The following attestation bundles were made for ivert-0.6.2.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.2-py3-none-any.whl.

File metadata

  • Download URL: ivert-0.6.2-py3-none-any.whl
  • Upload date:
  • Size: 122.3 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 dbf9e8fc58a9f2851d71e285885b201073749ba94df74efdafb1fe0a788810b2
MD5 37660a6238e4d1064e7d0237cd9bc490
BLAKE2b-256 c13147e064e82aa85719de6e9748fbf98dd81ff0e1f2c959705d9a1a9659fa2f

See more details on using hashes here.

Provenance

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

0.6.3

2 files

This release

0.6.2 This release

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