Shake3D Research

A community project by the Ready Kiwi team · credits, data sources, methods and limits

Unofficial, and not an emergency service. New Zealand has no official earthquake early warning system; official warnings come from NEMA and Civil Defence. Shake3D's alerts, sounds and opt-in notifications can be late, wrong or missed. In an earthquake: Drop, Cover and Hold. Terms & limits

What this is

Shake3D Research is an experimental, volunteer-run earthquake early warning research project. It shows New Zealand's live ground motion, GeoNet's official earthquake reports, and its own automatic, provisional estimate of where an earthquake is and where shaking may reach. It was built out of love for Aotearoa.

Every provisional stage on the map is badged as unofficial. GeoNet's report supersedes it whenever one is published. No authority has certified or approved Shake3D, and it is not part of New Zealand's official warning systems such as Emergency Mobile Alert.

Data

We acknowledge the New Zealand GeoNet programme and its sponsors NHC, Earth Sciences NZ, LINZ, NEMA and MBIE for providing data used by this project. GeoNet data is used under CC BY 3.0 NZ and LINZ data under CC BY 4.0. Shake3D processes this data: its estimates are its own, not GeoNet's or LINZ's. This project is not affiliated with, endorsed by, or operated by GeoNet, Earth Sciences New Zealand, the Natural Hazards Commission, LINZ, NEMA or Civil Defence.

Software

Open-source components used, with their licences. Server-side libraries run on our machine and are not redistributed; browser libraries are served to you with their licence notices intact.

ComponentVersionLicenceUsed for
ObsPy1.5.1LGPL-3.0SeedLink client, waveform handling, instrument response
SeisBench (PhaseNet)0.11.5GPL-3.0Machine-learned phase picking
GaMMA (vendored)1.2.17MITPhase association
PyOcto0.1.12MITPhase association
PyTorch2.6.0 (CPU)BSD-3Model inference
NumPy / SciPy2.4.4 / 1.17.1BSD-3Numerics
ringserver / slink2dali4.5.6 / 0.8Apache-2.0Local waveform relay and archive
MapLibre GL JS5.24.0BSD-33D map (served to your browser)
PMTiles4.5.0BSD-3Tile archive access
Leaflet1.9.4BSD-2Supporting pages
Inter / Noto Sans—SIL OFL 1.1Typography and map labels

Methods

The research detector is our own implementation built on published early-warning methods: wavefield shaking estimation in the family of PLUM (Kodera et al., 2018), machine-learned phase picking and association, early P-wave size estimates, and standard ground-motion-to-intensity relations (Worden et al., 2012). Citing these ideas is how the field works; it does not mean the original authors reviewed or endorsed this system. The rupture-extent estimate is our own proxy and is not the ETH FinDer software (Böse et al.).

How these methods are combined, and every threshold, gate and calibration, are internal research choices and are not documented here.

Limits

The full list, and the terms Shake3D is offered on, are on the terms & limits page.