Ctrl K

3D Earthquake Explorer

A web application for the three dimensional visualisation of earthquake hypocentres and their focal mechanisms based on the FDSN API.

1
mention
3
contributors
Get started
136 commitsLast commit ≈ 3 days ago0 stars0 forks

Description

3D Earthquake Explorer

The 3D earthquake explorer shows earthquakes and their focal mechanisms on a globe.
It can be deployed as a static set and does not require a backend.

The earthquakes are loaded from an FDSN Web Service endpoint directly in the browser.
It is currently accessible via the GFZ Earthquake Explorer, but endpoints can be manually specified with the url parameter.

How to use

Open the GFZ Earthquake Explorer (https://geofon.gfz-potsdam.de/eqexplorer/). Apply filters as required. Afterwards, click on the 3D button, as highlighted in the screenshot:

Screenshot of EqExplorer filter

A new window with the 3D Earthquake Explorer will open.

Alternative: passing FDSN requests

If you want to include the viewer into your own application, either as direct link to the GFZ service or your own static page, add the FDSN API call as url parameter to the domain. Note that the url parameter must be encoded.

https://geofon.gfz.de/3dexplorer/?url=<FDSN request>

FDSN Endpoint Requirments

The FDSN endpoint must support the parameter includefocalmechanisms=true and deliver the principalAxes and nodalPlanes attributes (see QuakeML2.0 documentation) for the individaual events.

Screenshots

3D Viewer Screenshot

Development

Run npm install followed by npm run dev. This starts a development server at http://localhost:8080 .

In case you have problems with the current node version, you can also
use the docker setup:

docker compose -f docker-compose-dev.yml build
docker compose -f docker-compose-dev.yml up -d

The app should be visible the same way on http://localhost:8080.

Tests

There are a few test that can be run with npm run test.

License and Copyright

Copyright GFZ Helmholtz Centre for Geosciences.

This software is primarily licensed EUPL-1.2. Some files are licensed MIT, CC-BY-4.0 or CC0-1.0, as indicated
in their respective headers oder as specified in REUSE.toml.

Logo of 3D Earthquake Explorer
Keywords
Programming languages
  • JavaScript 81%
  • Python 12%
  • HTML 5%
  • SCSS 1%
  • Dockerfile 0%
License
</>Source code

Participating organisations

GFZ Helmholtz Centre for Geoscience

Mentions

Contributors

MV
Matthias Volk
GFZ Helmholtz Centre for Geosciences
NB
Nils Brinckmann
GFZ Helmholtz Centre for Geosciences

Helmholtz Program-oriented Funding IV

Related software

Earthquake Explorer

EA

Up-to-date information and essential background knowledge about earthquakes. Users can access, explore, and analyze earthquake data from around the world by the Earthquake Explorer in a mobile optimized modern web platform.

Updated 7 days ago
12