Python tools from the Collaboratory for the Study of Earthquake Predictability
Project description
PyCSEP: Collaboratory for the Study of Earthquake Predictability
The PyCSEP tools help earthquake forecast model developers evaluate their forecasts with the goal of understanding earthquake predictability.
PyCSEP should:
- Help modelers become familiar with formats, procedures, and evaluations used in CSEP Testing Centers.
- Provide vetted software for model developers to use in their research.
- Provide quantative and visual tools to assess earthquake forecast quality.
- Promote open-science ideas by ensuring transparency and availability of scientific code and results.
- Curate benchmark models and data sets for modelers to conduct retrospective experiments of their forecasts.
Installing PyCSEP
PyCSEP can be installed using pip
or built from source. We are working on a conda-forge
recipe and PyPI distribution.
If you plan on contributing to this package, visit the
contribution guidelines for installation instructions.
pip install pycsep
From Source
Use this approach if you want the most up-to-date code. This creates an editable installation that can be synced with the latest GitHub commit.
We recommend using virtual environments when installing python packages from source to avoid any dependency conflicts. We prefer
conda
as the package manager over pip
, because conda
does a good job of handling binary distributions of packages
across multiple platforms. Also, we recommend using the miniconda
installer, because it is lightweight and only includes
necessary pacakages like pip
and zlib
.
Using Conda
If you don't have conda
on your machine, download and install Miniconda.
git clone https://github.com/SCECcode/pycsep
cd pycsep
conda env create -f requirements.yml
conda activate csep-dev
# Installs in editor mode with all dependencies
pip install -e .
Note: If you want to go back to your default environment use the command conda deactivate
.
Using Pip / Virtualenv
We highly recommend using Conda, because this tools helps to manage binary dependencies on Python packages. If you must use Virtualenv follow these instructions:
git clone https://github.com/SCECcode/pycsep
cd pycsep
python -m virtualenv venv
source venv/bin/activate
# Installs in editor mode with all dependencies
pip install -e .[all]
Note: If you want to go back to your default environment use the command deactivate
.
Documentation and Changelog
The documentation can be found at here, and the change long can be found here.
Releases
We follow semver for our versioning strategy.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pycsep-0.1.0.dev0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1d507e67df0ff0eb45d03e4c2ec1889983879a6067741586c7e7746ec13fe318 |
|
MD5 | a0960dcea05d95fd698c86b81851d286 |
|
BLAKE2b-256 | 97314b709fd70bc8a86964f58ef49a47befa754c2a54f7db49295a761319cf1a |