GeoNet: Tutorials for accessing GeoNet Data

Tutorials for accessing GeoNet Data

GeoNet has a wide range of data that are collected for monitoring and researching geohazards in New Zealand. We have built several tutorials to help access this data through data services.

GeoNet's Key Data Services:

AWS (Amazon Web Services): A copy of GeoNet's raw data is held by Amazon Web Services Open Data Program.
FDSN (The International Federation of Digital Seismograph Networks): Defined web services for accessing seismic waveform, station, and event information. FDSN web services are limited to weak and strong motion seismometers and pressure sensors.
Tilde: An API for accessing coastal, DART, GNSS time series, envirosensor, scanDOAS, manually collected volcano data, and landslide time series data.
DELTA: Git Repository for GeoNet sensor network metadata.

Before using GeoNet data please ensure you have read and understood our Data Policy and Disclaimer. To cite our datasets, please also use the DOI's (Digital Object Identifiers) on our Data Policy page.

Tutorials

The main tutorial page contains material to help you use the tutorials effectively.

The following section links to tutorials describing access to various GeoNet datasets via AWS, FDSN, or Tilde, plus some tutorials for specific data types. These tutorials are written in Python and we have now deprecated our tutorials written in R. If you would like to access the notebooks written in R, please use this github commit. In order to improve the interaction between the code and users, the tutorials are Jupyter Notebooks, which integrates code and its output into a single document that combines visualisations, narrative text, mathematical equations, and other media.

These tutorials use Python 3. We do not support Python 2.7.

Coastal Sea Level Gauge Data

These tutorials demostrate how to access Coastal Sea Level data (colloquially known as tsunami gauge data) through AWS, FDSN, and Tilde. The tutorials are presented in Jupyter notebooks and written in Python.

Tutorial name	Description
AWS Open Data tutorial	Accessing tsunami gauge data using the AWS Open Data Program.
FDSN Clients tutorial	Demonstrates different ways to manage multiple clients, including the GeoNet archive and near real-time clients.
FDSN Specific Event tutorial	Demostrates how to get waveforms for a specific event using the event ID and utilising information returned from querying event and station services.
FDSN Dataselect service tutorial	Examples of using the FDSN dataselect service to request waveform data.
FDSN Event service tutorial	Examples of using the FDSN event service to get event information and parse QuakeML.
FDSN Station service tutorial	Examples of using the FDSN station service to get station information and parse StationXML.
Tilde Data Summary tutorial	Demonstrates how to find what data exists, and show that as a table, map, or graph.
Tilde Data tutorial	Demonstrates how to retrieve and graph data.
Tilde Data Statistics tutorial	Demonstrates how to get different statistics from a data set.

DART Data

These tutorials demonstrate how to retrieve and perform basic tasks with DART Data, using the Tilde API. The tutorials are presented in Jupyter notebooks and written in Python. Data included in these tutorials show examples using raw and de-tided water height data.

Tutorial name	Description
Tilde Data Summary tutorial	Demonstrates how to find what data exists, and show that as a table, map, or graph.
Tilde Data tutorial	Demonstrates how to retrieve and graph data.
Tilde Data Statistics tutorial	Demonstrates how to get different statistics from a data set.

Envirosensor Data

These tutorials demonstrate how to retrieve and perform basic tasks with Envirosensor Data, using the Tilde API. The tutorials are presented in Jupyter notebooks and written in Python.

Tutorial name	Description
Tilde Data Summary tutorial	Demonstrates how to find what data exists, and show that as a table, map, or graph.
Tilde Data tutorial	Demonstrates how to retrieve and graph data.
Tilde Data Statistics tutorial	Demonstrates how to get different statistics from a data set.

GNSS data

This tutorial demostrates how to retrieve and graph GNSS time series data, mostly using the Tilde API. The tutorial is presented in a Jupyter notebook and written in Python.

Tutorial name	Description
Tilde Data tutorial	Demonstrates how to retrieve and graph data, including GNSS time series from the GeoNet Network, using Tilde.

Seismic data products

These notebooks demonstrate simple ways to use the GeoNet AWS and FDSN webservices to access seismic data. The tutorials are presented in Jupyter notebooks and written in Python.

Tutorial name	Description
AWS Open Data tutorial	Accessing seismic data products using the AWS Open Data Program.
FDSN Clients tutorial	Demonstrates different ways to manage multiple clients, including the GeoNet archive and near real-time clients.
FDSN General tutorial	Demostrates how to get waveforms for a specific event using the event ID and utilising information returned from querying event and station services.
FDSN Dataselect service tutorial	Examples of using the FDSN dataselect service to request waveform data.
FDSN Event service tutorial	Examples of using the FDSN event service to get event information and parse QuakeML.
FDSN Station service tutorial	Examples of using the FDSN station service to get station information and parse StationXML.

Volcano data

As volcano data are wide ranging, we provide specific tutorials for volcano data. The general Tilde tutorials are also relevant. The tutorials are presented in Jupyter notebooks and written in Python.

Tutorial name	Description
Volcano envirosensor	Demonstrates how to retrieve and graph multiGas data, fumarole and water temperature data, water level data, self potential and ground temperature data, wind data, and rainfall data.
Volcano GNSS	Demonstrates how to retrieve and graph GNSS data.
Volcano manually collected	Demonstrates how to retrieve and graph water chemistry data, airborne gas emission rate data, soil gas data, lake levelling (Lake Taupō) data, and how to create spreadsheet-like output files for water chemistry data.
Volcano scanDOAS	Demonstrates how to retrieve and graph scanDOAS data, including working with data from multiple sensors.
Volcano data aggregation	Demonstrates how to use Tilde's data aggregation functions with volcano data.
Volcano multi-domain data	Demonstrates how to retrieve and graph data from more than one data domain. Covers Tilde data with Volcanic Alert Level data, and Tilde data with historic volcanic activity data.
Tilde Data Summary tutorial	Demonstrates how to find what data exists, and show that as a table, map, or graph.
Tilde Data tutorial	Demonstrates how to retrieve and graph data.
Tilde Data Statistics tutorial	Demonstrates how to get different statistics from a data set.