Merge branch 'main' into main

Author: KennyGraham1

.github/workflows/build-test.yml

@@ -8,7 +8,7 @@ on:
     branches: [ main ]
 
 jobs:
-  build:
+  build-test:
     if: github.repository == 'cseptesting/floatcsep'
     runs-on: ${{ matrix.os }}
     strategy:
@@ -44,6 +44,12 @@ jobs:
           pip install -e .[dev]
           python -c "import floatcsep; print('Version: ', floatcsep.__version__)"
 
+      - name: Free disk
+        run: |
+          micromamba clean --all --yes
+          rm -rf "$MAMBA_ROOT_PREFIX/pkgs" || true
+          df -h
+
       - name: Test with pytest
         run: |
           pytest --durations=0
@@ -53,4 +59,62 @@ jobs:
         uses: codecov/codecov-action@v3
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
-          fail_ci_if_error: false
+          fail_ci_if_error: false
+
+  pip_smoke_linux:
+    if: github.repository == 'cseptesting/floatcsep'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/[email protected]
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install system deps (WeasyPrint)
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libglib2.0-0 \
+            libpango-1.0-0 \
+            libpangoft2-1.0-0 \
+            libharfbuzz0b \
+            libharfbuzz-subset0
+
+      - name: Pip-only install (no tests)
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+          python -c "import floatcsep; print('floatcsep OK:', floatcsep.__version__)"
+          python -c "import weasyprint; print('WeasyPrint OK:', weasyprint.__version__)"
+          floatcsep --help
+
+
+  pip_smoke_macos:
+    if: github.repository == 'cseptesting/floatcsep'
+    runs-on: macos-latest
+    steps:
+      - uses: actions/[email protected]
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install system deps (WeasyPrint)
+        run: |
+          brew update
+          brew install cairo pango gdk-pixbuf libffi glib
+
+      - name: Pip-only install (no tests)
+        env:
+          DYLD_FALLBACK_LIBRARY_PATH: /opt/homebrew/lib:/usr/local/lib:${{ env.DYLD_FALLBACK_LIBRARY_PATH }}
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+          python -c "import floatcsep; print('floatcsep OK:', floatcsep.__version__)"
+          python -c "import weasyprint; print('WeasyPrint OK:', weasyprint.__version__)"
+          floatcsep --help

.github/workflows/lockfile.yml

@@ -0,0 +1,38 @@
+name: lockfile
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  lock:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install conda-lock
+        run: |
+          python -m pip install --upgrade pip
+          pip install conda-lock
+
+      - name: Render linux lock
+        run: |
+          conda-lock render -p linux-64
+
+      - name: Set up micromamba
+        uses: mamba-org/setup-micromamba@v1
+        with:
+          micromamba-version: "latest"
+
+      - name: Create env from lock and import floatcsep
+        run: |
+          micromamba create -y -n lockenv --file conda-linux-64.lock
+          micromamba run -n lockenv python -c "import floatcsep; print('OK', floatcsep.__version__)"

CITATION.cff

@@ -0,0 +1,33 @@
+cff-version: 1.2.0
+message: "If you use floatCSEP in your research, please cite the Zenodo release."
+title: "floatCSEP: An application to deploy and conduct reproducible, prospective earthquake forecasting experiments"
+type: software
+license: "BSD-3-Clause"
+
+repository-code: "https://github.com/cseptesting/floatcsep"
+url: "https://floatcsep.readthedocs.io"
+
+version: "0.3.0"
+doi: "10.5281/zenodo.15576250"
+publisher: "Zenodo"
+
+authors:
+  - family-names: "Iturrieta"
+    given-names: "Pablo"
+    orcid: "https://orcid.org/0000-0002-4787-1343"
+    affiliation: "GFZ Helmholtz Centre for Geosciences, Potsdam, Germany"
+
+  - family-names: "Khawaja"
+    given-names: "Asim M."
+    orcid: "https://orcid.org/0000-0002-6196-4503"
+    affiliation: "GFZ Helmholtz Centre for Geosciences, Potsdam, Germany"
+
+  - family-names: "Savran"
+    given-names: "William H."
+    orcid: "https://orcid.org/0000-0001-5404-0778"
+    affiliation: "University of Nevada, Reno, United States"
+
+  - family-names: "Schorlemmer"
+    given-names: "Danijel"
+    orcid: "https://orcid.org/0000-0003-3969-1059"
+    affiliation: "GFZ Helmholtz Centre for Geosciences, Potsdam, Germany; Swiss Seismological Service at ETH Zürich, Zürich, Switzerland"

CONTRIBUTING.md

@@ -54,7 +54,7 @@ Please complete the following steps in advance to help us fix any potential bug
 
 - Make sure that you are using the latest version (or a tag release).
 - Determine if your bug is really a bug and not an error on your side e.g. using incompatible environment components/versions (Make sure that you have read the [documentation](https://floatcsep.readthedocs.io). If you are looking for support, you might want to check [this section](#i-have-a-question)).
-- To see if other users have experienced (and potentially already solved) the same issue you are having, check if there is not already a bug report existing for your bug or error in the [bug tracker](https://github.com/cseptesting/floatcsepissues?q=label%3Abug).
+- To see if other users have experienced (and potentially already solved) the same issue you are having, check if there is not already a bug report existing for your bug or error in the [bug tracker](https://github.com/cseptesting/floatcsep/issues?q=label%3Abug).
 - Collect information about the bug:
   - Stack trace (Traceback)
   - OS, Platform and Version (Windows, Linux, macOS, x86, ARM)

CREDITS.md

@@ -1,10 +1,70 @@
-Developer and scientific team:
-
-* Pablo Iturrieta - Deutsches GeoForschungsZentrum (GFZ), Germany - [email protected]
-* William Savran - University of Nevada, USA
-* Asim Khawaja - GFZ, Germany
-* Toño Bayona - University of Bristol, United Kingdom
-* Danijel Schorlemmer -  GFZ, Germany
-* Fabio Silva - Southern California Earthquake Center (SCEC), USA
-* Phil Maechling - SCEC, USA
-* Max Werner - University of Bristol, United Kingdom
+# Credits
+
+This project is the result of a collaborative effort by the following developer and scientific team.
+Contributions include software development, scientific design, manuscript writing, testing, documentation, and project coordination.
+```floatCSEP``` is described in a manuscript submitted to Journal of Open-Science Software (https://joss.theoj.org/), whose authors were active collaborators at the time of submission.
+
+We describe contributions using short free-text descriptions and, where appropriate, the CRediT contributor roles (https://credit.niso.org/).
+
+## Developer and scientific team
+
+- **Pablo Iturrieta** – GFZ Helmholtz Centre for Geosciences, Germany –   [email protected]  
+  *Contributions:* [Conceptualization; Software (lead); Documentation; Methodology; Project administration; Formal Analysis; MS Writing – original draft]
+
+- **William Savran** – University of Nevada, USA  
+  *Contributions:* [Conceptualization; Software; Methodology; Formal Analysis; Validation; MS Writing – review & editing]
+
+- **Marcus Herrmann** – University of Naples, Italy  
+  *Contributions:* [Conceptualization; Software; Methodology; Documentation; Validation; MS Writing – review & editing]
+
+- **Toño Bayona** – University of Bristol, United Kingdom  
+  *Contributions:* [Methodology; Formal analysis; Validation; MS Writing – review & editing]
+
+- **Matt Gerstenberger** – Earth Sciences New Zealand  
+  *Contributions:* [Conceptualization; MS Writing – review & editing; Supervision]
+
+- **Kenny Graham** – Earth Sciences New Zealand  
+  *Contributions:* [Software; Methodology; MS Writing – review & editing; ]
+
+- **Phil Maechling** – Southern California Earthquake Center (SCEC), USA
+  *Contributions:* [Conceptualization; Infrastructure; MS Writing – review & editing; Community coordination]
+
+- **Warner Marzocchi** – University of Naples, Italy  
+  *Contributions:* [Conceptualization; Supervision; MS Writing – review & editing]
+
+- **Leila Mizrahi** – ETH Zürich, Switzerland  
+  *Contributions:* [Software; Methodology; MS Writing – review & editing; ]
+
+- **Danijel Schorlemmer** – GFZ, Germany  
+  *Contributions:* [Conceptualization; Supervision; Funding acquisition]
+
+- **Francesco Serafini** – University of Bristol, United Kingdom v  
+  *Contributions:* [Conceptualization; Methodology; Validation; MS Writing - review & editing]
+
+- **Fabio Silva** – SCEC, USA  
+  *Contributions:* [Validation; Infrastructure; Integration with SCEC systems]
+
+- **Asim Khawaja** – GFZ, Germany  
+  *Contributions:* [Software; Methodology]
+
+- **Max Werner** – University of Bristol, United Kingdom  
+  *Contributions:* [Conceptualization; Methodology; Formal Analysis; Supervision; MS Writing – review & editing; Community coordination; Funding Acquisition]
+
+---
+
+## Contribution roles (CRediT legend)
+
+- **Conceptualization** – Ideas; formulation or evolution of overarching research goals and aims.
+- **Methodology** – Development or design of methods; creation of models or workflows.
+- **Software** – Programming, software development, implementation of code, or maintenance.
+- **Validation** – Verification of results, including code verification and benchmarking.
+- **Formal analysis** – Application of statistical, mathematical, or computational techniques.
+- **Data curation** – Management of data, such as assembling catalogs or input datasets.
+- **Writing – original draft** – Preparation of the initial manuscript or main documentation text.
+- **Writing – review & editing** – Critical review, commentary, and revision of text.
+- **Supervision** – Oversight and leadership responsibility, including mentoring.
+- **Project administration** – Coordination and management of the project.
+- **Funding acquisition** – Acquisition of financial support for the project.
+- **Infrastructure** – Setup and maintenance of computing environments and deployment.
+
+---

README.md

@@ -2,7 +2,7 @@
 
 <img src="https://i.postimg.cc/6p5krRnB/float-CSEP-Logo-CMYK.png" width="320"> 
 
-**An application to deploy reproducible and prospective experiments of earthquake forecasting**
+**An application to deploy and conduct reproducible, prospective earthquake forecasting experiments**
 
 <p left>
 
@@ -68,16 +68,21 @@ documentation for detailed instructions and additional installation methods.
 
 # Run an Experiment
 
-Using the command terminal, navigate to an example experiment in ``floatcsep/tutorials/`` and
+Using the command terminal, navigate to any tutorial experiment in ``floatcsep/tutorials/`` and
 type
 
 ```
 floatcsep run config.yml
 ```
 
 A runtime directory will be created in a `results` folder. The experiment results can be
-visualized in `results/report.md` or `results/report.pdf`. **Check out the experiment, models and tests definition in
-the tutorials**!
+visualized in `results/report.md`, `results/report.pdf` or in a dashboard with:
+
+```
+floatcsep view config.yml
+```
+
+**Check out the experiment, models and tests definition in the tutorials [documentation](https://floatcsep.readthedocs.io/en/latest/tutorials/case_a.html)** or in the configuration files for each case in ``floatcsep/tutorials/``. 
 
 # Important Links
 
@@ -109,7 +114,13 @@ license. Please see
 the [license file](https://github.com/cseptesting/floatcsep/blob/main/LICENSE) for more
 information.
 
-## Support
+## How to cite
+
+If you use **floatCSEP** in your work, please cite it using the **“Cite this repository”** link on the right side of the GitHub page or with:
+
+> Iturrieta, P., Khawaja, A. M., Savran, W. H., & Schorlemmer, D. (2025). floatCSEP: An application to deploy and conduct reproducible and prospective earthquake forecasting (Version 0.3.0) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.15576250
+
+# Support
      
 | <img src="https://i.postimg.cc/rFKQ0vRL/GFZ-Wortbildmarke-EN-Helmholtzdunkelblau-RGB.png" alt="GFZ logo" height="50"/> | <img src="https://i.postimg.cc/CLc5tQcZ/Geo-INQUIRE-logo.png" alt="GeoInquire logo" height="72"/> | <img src="https://i.postimg.cc/tC1LdjYf/scec.png" alt="SCEC logo" height="90"/> |
 |:----------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------:|