aam-translator

Prepare geospatial inputs for the U.S. DOT Advanced Acoustic Model (AAM), and read common outputs back.

The primary user of this library is NPS ActiveSpace, an open-source geospatial noise modeling project used by the United States National Park Service.

• .ELV — NMBGF elevation grid
• .IMP — NMBGF ground-impedance grid
• .INP — single-event AAM scenario input (Computation mode, calculation grid, terrain inputs, noise source tracks)
• .POI, {basename}.txt, .Single.POI.csv — see Reading AAM output

from aam_translator import write_terrain, load_terrain, write_inp, write_aam_inputs
from aam_translator import read_poi, read_run_log

Requires Python >=3.12 (CI: 3.12 on Linux and Windows). Install in another project with:

pip install git+https://github.com/elliott-ruebush/aam-translator.git

Or from a local clone:

pip install -e /path/to/aam_translator

Docs

• DEM → AAM ELV pipeline — AEQD bilinear resample; load_terrain reloads from ELV + clip.
• Reading AAM output — .POI, run logs, alignment checks, multi-point tracks, runtime gotchas.
• References — AAM .inp / NMBGF format specs and glossary (in git); vendor manual PDF/.txt and Plt2Elv.f are documented but not redistributed — see references/manuals/ and references/source/.