pyCSEP: Tools for Earthquake Forecast Developers

PyCSEP tools help earthquake forecast model developers evaluate their forecasts and provide the machinery to implement experiments within CSEP testing centers.


The Collaboratory for the Study of Earthquake Predictability (CSEP) supports an international effort to conduct earthquake forecasting experiments. CSEP supports these activities by developing the cyberinfrastructure necessary to run earthquake forecasting experiments including the statistical framework required to evaluate probabilistic earthquake forecasts.

PyCSEP is a python library that provides tools for (1) evaluating probabilistic earthquake forecasts, (2) working with earthquake catalogs in this context, and (3) creating visualizations. Official experiments that run in CSEP testing centers will be implemented using the code provided by this package.

Project Goals

  1. Help modelers become familiar with formats, procedures, and evaluations used in CSEP Testing Centers.

  2. Provide vetted software for model developers to use in their research.

  3. Provide quantitative and visual tools to assess earthquake forecast quality.

  4. Promote open-science ideas by ensuring transparency and availability of scientific code and results.

  5. Curate benchmark models and data sets for modelers to conduct retrospective experiments of their forecasts.


We highly encourage users of this package to get involved in the development process. Any contribution is helpful, even suggestions on how to improve the package, or additions to the documentation (those are particularly welcome!). Check out the Contribution guidelines for a step by step on how to contribute to the project. If there are any questions, please contact us!

Contacting Us

  • For general discussion and bug reports please post issues on the pyCSEP GitHub.

  • This project adheres to a Code of Conduct. By participating you agree to follow its terms.

List of Contributors

  • Fabio Silva, Southern California Earthquake Center

  • Philip Maechling, Southern California Earthquake Center

  • William Savran, University of Nevada, Reno

  • Pablo Iturrieta, GFZ Potsdam

  • Khawaja Asim, GFZ Potsdam

  • Han Bao, University of California, Los Angeles

  • Kirsty Bayliss, University of Edinburgh

  • Jose Bayona, University of Bristol

  • Thomas Beutin, GFZ Potsdam

  • Marcus Hermann, University of Naples ‘Frederico II’

  • Edric Pauk, Southern California Earthquake Center

  • Max Werner, University of Bristol

  • Danijel Schorlemmner, GFZ Potsdam