Skip to content

ArWen 2.3.2

Choose a tag to compare

@FahrenheitResearch FahrenheitResearch released this 14 Aug 20:00
· 7 commits to main since this release

ArWen 2.3.2 builds 30 m terrain anywhere in the world, with no account and no API key.

Install this release with pip install gpuwm[geog]

A plain pip install gpuwm does not install the terrain dependencies. If you install without [geog] and follow the terrain guide, the command downloads about 160 MiB of tiles and then fails with a Python traceback instead of a clear message. gpuwm doctor does not detect it either. This is our bug, not yours. 2.3.3 removes the requirement so that a plain install works.

New

  • Copernicus DEM GLO-30 is the default elevation source outside the United States: 30 m ground sampling from 90 S to 84 N, fetched anonymously, no registration required.
  • terrain_source in [static.highres] picks the source by name: auto, copernicus-dem-glo30, srtm-gl1 or usgs-3dep-13as.
  • SRTM is available through OpenTopography's anonymous mirror and declares its own limits, so a request above 60 N or below 56 S is refused by name instead of answered with a hole.
  • A domain that runs off the edge of its source is refused with the source named, its footprint printed, and the overshoot given per edge.
  • Every run records which source it used and which geoid that source measures against: EGM2008 for Copernicus DEM, EGM96 for SRTM, NAVD88 for 3DEP.
  • docs/public/HIGHRES-TERRAIN.md documents the sources, their limits, their datums, and what switching between them does to a real domain.

Fixed

  • Building one domain through two elevation sources keeps both receipts; the second build no longer overwrites the first build's provenance.
  • The documentation called USGS 3DEP a surface model. It is bare earth.

Known issues

  • pip install gpuwm alone cannot run the terrain sources in this release. The dependency check runs after the tile download instead of before it, it raises a raw traceback rather than a named refusal, and doctor has no test for it. Install gpuwm[geog] until 2.3.3 lands.
  • Outside the United States only terrain is upgraded. Land use and soil stay at the older global data, because no freely licensed worldwide land-cover set separates an inland lake from the open sea, and getting that wrong at a coastline costs more than coarse land use does.
  • The worldwide default is a surface model, so a forested domain reads about 3.5 m higher than bare ground. Inside the United States usgs-3dep-13as is bare earth and stays the default there.
  • Nothing changes for existing United States domains: terrain_source = "auto" still selects 3DEP and builds the same bytes it built before.

Full notes: https://github.com/FahrenheitResearch/arwen/blob/v2.3.2/CHANGELOG.md