Provenance

Where the Numbers Come From

Every line of physics, every byte of bundled data, traced to its public-domain or permissively-licensed source. No GPL, no proprietary code, no licence ambiguity — just published equations and open datasets, re-implemented in Swift.

No-GPL pledge

Ægir Prediction does not link Bellhop, Kraken, RAM, or any other GPL-encumbered acoustics library. The ray solver, transmission-loss model, ambient-noise spectrum, and absorption calculation are all re-implemented from scratch in Swift against the canonical published equations cited below. The bundled data is either explicitly public-domain (US-government datasets) or permissively licensed (CC BY 4.0). So you can put Ægir to work anywhere — offline, in the field, in commercial projects — with no licence-clearance friction.

§ 01

Bathymetry

GEBCO 2025 Sub-Ice Grid

2025 Bundled

The General Bathymetric Chart of the Oceans is the canonical global ocean-depth dataset, jointly maintained by the IHO and IOC of UNESCO. The "sub-ice" variant uses BedMachine and Bedmap2 ice-shelf draft estimates so the Ross and Filchner-Ronne shelves resolve to bedrock rather than ice surface — material when planning Southern-Ocean acoustics. Ægir uses GEBCO for the depth lookup at every pin and as the bottom boundary for the ray solver.

Licence
Creative Commons CC BY 4.0 — attribution required, commercial use permitted.
Role in app
Depth lookup at every scenario pin; bottom-bounce geometry for the ray solver.
Bundled
17.8 MB at 5 arc-min global (baseline IPA); HQ regional packs add 200 MB – 1 GB per basin.
View at gebco.net
§ 02

Water Column

World Ocean Atlas 2023 (WOA23)

2024 Bundled

NOAA NCEI's quarter-degree climatology of temperature, salinity, dissolved oxygen, nitrate, phosphate, and silicate — averaged over decades of in-situ casts and re-gridded at 1° (Compact) and 0.25° (HQ). Ægir uses the temperature and salinity columns as the input to Mackenzie's nine-term sound-speed equation and as the basis for Francois-Garrison absorption.

Licence
Public domain — US Government scientific data, no copyright restrictions.
Role in app
Temperature + salinity columns for sound-speed and absorption calculations.
Bundled
89 MB at 1° global, 24-level (baseline IPA); HQ packs add 0.25° at 72 levels per region.
View at ncei.noaa.gov

Mackenzie Nine-Term Equation

1981 Cited reference

Mackenzie's nine-term polynomial relating temperature, salinity, and depth to sound speed is the workhorse formula for ocean-acoustic codes. Accurate to about 0.07 m/s over the full oceanographic envelope — finer than WOA23's underlying observations warrant, so the bottleneck is data, not formula. Ægir applies it column-by-column at every pin.

Citation
Mackenzie, K. V. (1981). "Nine-term equation for sound speed in the oceans." JASA, 70(3), 807–812.
Role in app
WOA23 T/S/depth → c(z) sound-speed profile; input to the ray solver.
Status
Equation reimplemented in Swift; underlying maths not copyrightable, paper cited as canonical reference.
View DOI 10.1121/1.386920
§ 03

Seafloor

Dutkiewicz et al. — Seafloor Sediment Census

2015 Bundled

The Dutkiewicz dataset is a digital map of seafloor lithology — calcareous ooze, siliceous ooze, pelagic clay, etc. — derived from 14,000 surface samples and gridded for global coverage. Ægir uses it to look up sediment class under every pin, which then keys into the APL-UW reflection-loss model.

Citation
Dutkiewicz, A., Müller, R. D., O'Callaghan, S., Jónasson, H. (2015). "Census of seafloor sediments in the world's ocean." Geology, 43(9), 795–798.
Licence
Open data — accompanying gridded dataset published under permissive terms via EarthByte.
Role in app
Sediment-class lookup at every pin; drives bottom-loss model.
Bundled
25 MB global classification grid.
View at earthbyte.org

APL-UW Technical Report 9407

1994 Cited reference

The Applied Physics Laboratory at the University of Washington's "High-Frequency Ocean Environmental Acoustic Models Handbook" is the standard reference for converting sediment class to acoustic reflection loss as a function of grazing angle and frequency. Ægir uses APL-UW's tabulated coefficients per sediment class to compute bottom-bounce loss in the ray solver — a documented, public-release model with no Bellhop / Kraken-style GPL entanglement.

Citation
Applied Physics Laboratory, University of Washington (1994). "APL-UW High-Frequency Ocean Environmental Acoustic Models Handbook," APL-UW TR 9407.
Status
Public-release technical report. Coefficients and equations reimplemented in Swift; figures and prose not redistributed.
Role in app
Bottom-loss vs. grazing-angle and frequency, per sediment class.
View at apps.dtic.mil
§ 04

Acoustic Physics

Francois & Garrison — Sound Absorption

1982 Cited reference

The two-paper Francois-Garrison set is the canonical model for sound absorption in seawater as a function of temperature, salinity, depth, pH, and frequency. It captures the boric-acid relaxation around 1 kHz and the magnesium-sulphate relaxation around 100 kHz, both critical for sub-100-kHz marine-acoustic work. Ægir applies it at every range bin in the transmission-loss integral.

Citation
Francois, R. E. & Garrison, G. R. (1982). "Sound absorption based on ocean measurements" — Parts I & II. JASA, 72(3), 896–907 & 72(6), 1879–1890.
Role in app
α(f, T, S, p, pH) absorption coefficient — applied per range bin.
Status
Equations reimplemented in Swift; papers cited.
View Part I (DOI)

Wenz — Ambient Noise Spectrum

1962 Cited reference

Wenz's 1962 paper laid out the spectral structure of ocean ambient noise — the wind-driven component above ~500 Hz, the shipping component in the 50-500 Hz band, biological and seismic at lower frequencies — and his curves remain the operational reference 60+ years later. Ægir composes the wind term from live wind speed and the shipping term from a modelled shipping-density climatology to produce a frequency-dependent NL at the receiver.

Citation
Wenz, G. M. (1962). "Acoustic ambient noise in the ocean: spectra and sources." JASA, 34(12), 1936–1956.
Role in app
Frequency-dependent ambient noise level (NL) for the sonar equation.
Status
Spectra reimplemented from the published curves; paper cited.
View DOI 10.1121/1.1909155

Computational Ocean Acoustics — Jensen, Kuperman, Porter, Schmidt

2011 (2nd ed.) Cited reference

The standard graduate-level textbook on ocean-acoustic numerical methods. Ægir's ray solver is built from the eikonal-tracing scheme described in Chapter 3, with surface-bottom-CZ classification and dynamic-ray-equation amplitude tracking per the same chapter. No code from the textbook's accompanying Bellhop/Kraken/RAMGeo distribution is used — only the equations.

Citation
Jensen, F. B., Kuperman, W. A., Porter, M. B., Schmidt, H. (2011). Computational Ocean Acoustics, 2nd ed. Springer. ISBN 978-1-4419-8677-1.
Role in app
Eikonal ray-trace algorithm, dynamic-ray amplitude tracking, surface/bottom/CZ ray classification.
Status
Equations reimplemented in Swift; bundled Bellhop/Kraken/RAMGeo NOT linked.
View at Springer
§ 05

Noise-Impact Criteria

NOAA Fisheries (NMFS) Technical Guidance

2024 · v3.0 Cited reference

NMFS's 2024 Update (Version 3.0) sets the marine-mammal hearing-group auditory-weighting functions and the received-level thresholds for the onset of temporary and permanent threshold shift (TTS / auditory injury). It is the operative US regulatory criterion behind incidental-take analysis and most marine-EIA underwater-noise assessment. Ægir applies the v3.0 weighting functions and onset thresholds to turn a transmission-loss field into hearing-group-weighted impact ranges.

Citation
NMFS (2024). 2024 Update to: Technical Guidance for Assessing the Effects of Anthropogenic Sound on Marine Mammal Hearing (Version 3.0). NOAA Technical Memorandum NMFS-OPR.
Role in app
Hearing-group weighting + TTS / injury onset thresholds for impact ranges.
Status
Public-domain US-Government guidance; criteria reimplemented in Swift, document cited.
View at fisheries.noaa.gov

Southall et al. — Marine Mammal Noise Exposure Criteria

2019 Cited reference

The Southall et al. 2019 review underpins the hearing-group structure (low-, high- and very-high-frequency cetaceans, sirenians, and pinnipeds in water and in air) and the auditory-weighting and exposure recommendations that the NMFS guidance builds on. Ægir uses its hearing-group definitions when weighting the field for non-US assessments and cross-checks.

Citation
Southall, B. L., et al. (2019). "Marine Mammal Noise Exposure Criteria: Updated Scientific Recommendations for Residual Hearing Effects." Aquatic Mammals, 45(2), 125–232.
Role in app
Hearing-group definitions and weighting basis.
Status
Published criteria reimplemented in Swift; paper cited.
View DOI 10.1578/AM.45.2.2019.125

Popper et al. — Sound Exposure Guidelines for Fishes & Sea Turtles

2014 Cited reference

The ASA-accredited Popper et al. 2014 guidelines provide the fish and sea-turtle exposure criteria — by hearing category and injury / mortality endpoint — that complement the marine-mammal criteria in a full EIA. Ægir applies them to produce fish and sea-turtle impact ranges alongside the marine-mammal ranges.

Citation
Popper, A. N., et al. (2014). Sound Exposure Guidelines for Fishes and Sea Turtles. ASA S3/SC1.4 TR-2014. Springer.
Role in app
Fish + sea-turtle exposure criteria for impact ranges.
Status
Published criteria reimplemented in Swift; guidelines cited.
View DOI 10.1007/978-3-319-06659-2
§ 06

Live Data Services

HYCOM Operational Forecast

live Optional online

The Hybrid Coordinate Ocean Model run by the US Naval Research Laboratory provides daily nowcast and forecast fields of temperature, salinity, and currents at 1/12° resolution. Ægir's HYCOM proxy (running on the same NAS as the marketing site) fetches fresh T/S columns to refine the WOA23 climatology when a connection is available; falls back to the bundled climatology when offline.

Licence
Public domain — US Government scientific data.
Role in app
Fresh T/S column overlay on top of WOA23 climatology; optional, never required.
Status
Cloudflare-tunnelled OPeNDAP proxy; raw data pulled from tds.hycom.org.
View at hycom.org

NOAA Wind & Wave Forecast

live Optional online

Surface wind and waves from NOAA's GFS and GFS-Wave models are the input to the wind-driven term of the Wenz noise spectrum. When online, Ægir reads the 10-metre wind speed at the pin location, derives a sea-state, and feeds it into the noise calculation; offline, the user selects sea-state manually. The fields are served through Ægir's own weather proxy (weather.aegirprediction.app), not fetched from any third-party weather API.

Licence
Public domain — US Government scientific data.
Role in app
Wind speed → sea-state → wind-driven Wenz noise term.
Status
Cloudflare-tunnelled proxy serving GFS / GFS-Wave as compact JSON; optional, never required.
View at nomads.ncep.noaa.gov

Shipping-Density Climatology

climatology Bundled

A modelled global shipping-density climatology underpins the shipping component of the Wenz ambient-noise spectrum. Higher-density basins (e.g. the Strait of Malacca, North Sea) get a 5-15 dB correction in the 50-500 Hz band over near-empty water.

Status
Approximated from static shipping-density climatology.
Role in app
Shipping-band Wenz noise term.
§ 07

Looking Ahead

Biot-Stoll Poroelastic Sediment Model

v1.1+ Deferred

The Biot-Stoll theory treats sediment as a saturated porous medium with both fluid and solid phases, capturing frequency-dependent attenuation that the simpler APL-UW class-based model misses — particularly relevant in the low-frequency band (sub-500 Hz). Deferred to v1.1+ because Biot-Stoll requires class-specific calibration parameters (porosity, grain density, frame moduli) that aren't yet in the Dutkiewicz pipeline; the simpler APL-UW model is closer to operationally deployable for v0.1.

Citation
Biot, M. A. (1962). "Mechanics of deformation and acoustic propagation in porous media." J. Appl. Phys. 33, 1482. Stoll, R. D. (1989). Sediment Acoustics. Springer.
Status
Not implemented in v0.1. Slated for v1.1+ once class-specific calibration parameters are integrated.
Roadmap item — not in v0.1