floatCSEP: Floating Experiments

Earthquake forecasting experiments made simple.

GitHub Repository Zenodo License PyPI version Conda Version

Quickstart

start Get Started

learn1 Forecasting Concepts

learn2 Testing Theory

experiment Experiment Concepts

api API Reference

tutorials Tutorials

What is floatCSEP

The Collaboratory for the Study of Earthquake Predictability (CSEP) has organized Earthquake Forecast Testing Experiments during the last decades and is now consolidating its research into open-software initiatives.

floatCSEP is an easy-to-use software application that contains the workflow to deploy Earthquake Forecasting Experiments. It is based on the code python library pyCSEP (Github), which contains the core routines to test earthquake forecasts. While pyCSEP focuses on evaluation routines, floatCSEP provides the surrounding workflow needed to define, run, and update complete testing experiments.

Why floatCSEP?

floatCSEP fills the gap to set up a testing experiment by

  • Standardizing experiment definitions, such as clear input/testing data partitions, spatial/magnitude domains, model parameters, tests, etc.

  • Orchestrating the workflow by an automated execution of all experiment tasks (building source codes, querying input data, create and test forecasts, output visualizations , etc.), while maintaining a prospective testing philosophy when required.

  • Assisting with containerizing the computational environment (using Docker).

  • Automated reporting and result visualization tools.

Goals

  • Test your forecasts with simple commands.

  • Set up a testing experiment for your forecasts using authoritative data sources/benchmarks.

  • Encapsulate the complete experiment’s definition and rules in a couple of lines.

  • Reproduce, reuse, and share forecasting experiments.

Target users

floatCSEP is aimed at earthquake forecast model developers, Testing Center operators, and researchers in statistical seismology who want to evaluate forecasts and design experiments in a consistent way.

Running

Start using floatCSEP by installing the latest version and running the tutorials with simply:

$ floatcsep run config.yml

Collaborators

  • Pablo Iturrieta, GFZ Potsdam, Germany (pciturri@gfz-potsdam.de)

  • William Savran, University of Nevada, Reno, USA

  • Jose Bayona, University of Bristol, United Kingdom

  • Francesco Serafini, University of Edinburgh, United Kingdom

  • Kenny Graham, GNS Science, New Zealand

  • Khawaja Asim, GFZ Potsdam, Germany

  • Fabio Silva, Southern California Earthquake Center, USA

  • Marcus Hermann, University of Naples ‘Frederico II’, Italy

  • Max Werner, University of Bristol, United Kingdom

  • Danijel Schorlemmner, GFZ Potsdam, Germany

  • Philip Maechling, Southern California Earthquake Center, USA