ucgmsim-workflow 2026.9.1__py3-none-any.whl

ucgmsim_workflow-2026.9.1.dist-info/METADATA

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: ucgmsim-workflow
+Version: 2026.9.1
+Summary: Next generation workflow powered by cylc.
+Author: QuakeCoRE
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: im-calculation<2026.09.01,>=2025.12.5
+Requires-Dist: velocity-modelling>=2026.2.1
+Requires-Dist: nshmdb>=2026.09.1
+Requires-Dist: oq_wrapper>=2025.12.3
+Requires-Dist: qcore-utils>=2025.12.2
+Requires-Dist: source_modelling>=2026.08.1
+Requires-Dist: geopandas
+Requires-Dist: pandas[hdf5,parquet]
+Requires-Dist: pyyaml
+Requires-Dist: xarray[io]
+Requires-Dist: numpy
+Requires-Dist: scipy
+Requires-Dist: shapely
+Requires-Dist: tqdm
+Requires-Dist: typer
+Requires-Dist: requests
+Requires-Dist: schema
+Requires-Dist: structlog
+Requires-Dist: psutil
+Requires-Dist: parse>=1.21.0
+Requires-Dist: rich>=14.3.2
+Provides-Extra: test
+Requires-Dist: pytest>=6.0.0; extra == "test"
+Requires-Dist: hypothesis[numpy]>=6.0.0; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: coverage[toml]; extra == "test"
+Provides-Extra: types
+Requires-Dist: pandas-stubs; extra == "types"
+Requires-Dist: types-geopandas; extra == "types"
+Requires-Dist: types-requests; extra == "types"
+Requires-Dist: scipy-stubs; extra == "types"
+Provides-Extra: dev
+Requires-Dist: ruff>=0.16.5; extra == "dev"
+Requires-Dist: deptry; extra == "dev"
+Requires-Dist: ty>=0.0.75; extra == "dev"
+Requires-Dist: numpydoc; extra == "dev"

ucgmsim_workflow-2026.9.1.dist-info/RECORD

@@ -0,0 +1,42 @@
+workflow/__init__.py,sha256=_1YJQk8uG677uqautnX12LjL-F-LVYIRELxcggz3DWc,5391
+workflow/defaults.py,sha256=OPDKSiDtnzJtw8qmfgTqa0HBclAaEuqLGWYMzEcBbVk,1598
+workflow/log_utils.py,sha256=-1XDS-yO0asolQd4909ppRVlYOb4Kw1ltPVmsfpCNKM,5381
+workflow/realisations.py,sha256=x3nrTFyRBFrkRdSj1il3qBbWBGG8CqyuBi2PQMugQ4w,49292
+workflow/schemas.py,sha256=bYxskumR20eNNptHLUeWiTquoe8BNPlmdgEofWUJxOo,45255
+workflow/utils.py,sha256=FILOF1H5NxLWTjxDJr5kcUYC4jAGe5x_AiAaWr9lGWE,6395
+workflow/default_parameters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+workflow/default_parameters/root/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+workflow/default_parameters/root/defaults.yaml,sha256=Coof7sY7DYNEe2mczZTaUv1CdveHj_rISoOjTdQPDOs,24053
+workflow/default_parameters/v24_2_2_1/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+workflow/default_parameters/v24_2_2_1/defaults.yaml,sha256=3eQ8NTXdyf4qNlCupSUoyU5EO08R06I6BuPiRsxoPF8,104
+workflow/default_parameters/v24_2_2_2/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+workflow/default_parameters/v24_2_2_2/defaults.yaml,sha256=ntgGDaUjfERFHc9UzQk3FqVHydL2U8UpfzM9bD67Ra0,104
+workflow/default_parameters/v24_2_2_4/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+workflow/default_parameters/v24_2_2_4/defaults.yaml,sha256=FKTAb1iw-j4HMLDc8k1-FKc6Rdio_tNY_4fA5D_ljkk,105
+workflow/scripts/__init__.py,sha256=yp7ioOlu5lBDPu1vBmANdyKoFUV6eiV6CJffCSfkQ5w,248
+workflow/scripts/bb_sim.py,sha256=rHuuXgcH86f57o9K0WuYllwnZmUuvQUuK2ofRyk0Dc8,7364
+workflow/scripts/check_domain.py,sha256=ftm9-Al8lf_8lwLcOPQx2v15ZtB1U8HlpAh0tTusim8,3232
+workflow/scripts/check_srf.py,sha256=PShXMGRfkm0QjgJdu-rKmxG2mohjDPMOH57UbbRxuno,4424
+workflow/scripts/convert_vm_hdf5_to_emod3d.py,sha256=RI1GPcJTOnZ89Wy2A1yoMruA5dqa6Fj5i3LQFVEwDIU,2142
+workflow/scripts/copy_velocity_model_parameters.py,sha256=iGMmCjYVsa9LmCi2S8ip1G_aA9dMBM0A0X4VSMUpDBU,2159
+workflow/scripts/create_e3d_par.py,sha256=ueVVUQJjaCV_gb0-e54XfVy14V3ujNsEYpsaDyJXzck,8743
+workflow/scripts/gcmt_auto_simulate.py,sha256=VbSIhGcfjl6aPpFGtEkHKREYShtIiNJusDNFRFoQ3jM,3743
+workflow/scripts/gcmt_to_realisation.py,sha256=ORcX1QC76FVERho0F3bTbSmKt2fJa81FZrSm97mK4Hw,11531
+workflow/scripts/generate_domain.py,sha256=GEwnjPsoHp7MQo7A2LBRKehxkyduMqw4EhHP5P0n2JU,17993
+workflow/scripts/generate_rupture_propagation.py,sha256=dIE45UFkU7y3cNJ2VljfNPfvCtvFT5bD0oLhLwn2yUk,3891
+workflow/scripts/generate_station_coordinates.py,sha256=6pFT3ppXHF2F5KMofU4XvccwtLL8EQPkbWhQAQ3JyEE,4626
+workflow/scripts/generate_stoch.py,sha256=5_hzGmAKog0ad_YCL4ZL__exBVZnj-soKi34888JGwU,3602
+workflow/scripts/generate_velocity_model.py,sha256=R2ZTBbK7s0cuZYccky4-CbhQWUiclZHol85MjI-9hBQ,8862
+workflow/scripts/hf_sim.py,sha256=CstarixSv7TaP8kSL85F4UT8WgC8wNEB4_W4a5lYY68,16306
+workflow/scripts/im_calc.py,sha256=avXK6HMTFrrOQMEQEn0E9iZEOKoBX8KhmQi8X6wK4_8,11028
+workflow/scripts/import_realisation.py,sha256=knmk4V6WuG9FYDebUAEe-ZvocparQlpHLx34a7OI4Bo,2956
+workflow/scripts/lf_to_xarray.py,sha256=sE7cBoyQY42YBj_olpS2mides5AfcbtXl8839bM_0UE,1318
+workflow/scripts/merge_ts.py,sha256=--hQ03PqWpSXb-Df4WKaLXvCTu9shfS3ZsGkr29Agjc,12079
+workflow/scripts/migrate.py,sha256=3eGmeEHRIe1fOLVvs3KcVCjrz9-WMydQLLseU7Rr5_o,18181
+workflow/scripts/nshm2022_to_realisation.py,sha256=ECMxyi0m7hDtU0j8cbKceECBJ3k5hpW-ecHSSrlsx64,15212
+workflow/scripts/realisation_to_srf.py,sha256=OjBJjgMBOvEH6l5zTYn2gCmumQhwBO2uh_TTvFURsJM,30027
+ucgmsim_workflow-2026.9.1.dist-info/METADATA,sha256=OeNXxeibrSKakaU5UdJPySHeQk_ncTqm0111PReYJVM,1417
+ucgmsim_workflow-2026.9.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+ucgmsim_workflow-2026.9.1.dist-info/entry_points.txt,sha256=6VOCmCjzz8y1GfrjgYjnQbXt3g5-d2L_zFIC4jH8rb8,1292
+ucgmsim_workflow-2026.9.1.dist-info/top_level.txt,sha256=jT-znOUjxvwdr-w5ECrvROWZ9y_Doiz0yVYSI0VxpXA,9
+ucgmsim_workflow-2026.9.1.dist-info/RECORD,,

ucgmsim_workflow-2026.9.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ucgmsim_workflow-2026.9.1.dist-info/entry_points.txt

@@ -0,0 +1,23 @@
+[console_scripts]
+bb-sim = workflow.scripts.bb_sim:app
+check-domain = workflow.scripts.check_domain:app
+check-srf = workflow.scripts.check_srf:app
+convert-vm-hdf5-to-emod3d = workflow.scripts.convert_vm_hdf5_to_emod3d:app
+copy-domain-parameters = workflow.scripts.copy_velocity_model_parameters:app
+create-e3d-par = workflow.scripts.create_e3d_par:app
+gcmt-auto-simulate = workflow.scripts.gcmt_auto_simulate:app
+gcmt-to-realisation = workflow.scripts.gcmt_to_realisation:app
+generate-domain = workflow.scripts.generate_domain:app
+generate-model-coordinates = workflow.scripts.generate_model_coordinates:app
+generate-rupture-propagation = workflow.scripts.generate_rupture_propagation:app
+generate-station-coordinates = workflow.scripts.generate_station_coordinates:app
+generate-stoch = workflow.scripts.generate_stoch:app
+generate-velocity-model = workflow.scripts.generate_velocity_model:app
+hf-sim = workflow.scripts.hf_sim:app
+im-calc = workflow.scripts.im_calc:app
+import-realisation = workflow.scripts.import_realisation:app
+lf-to-xarray = workflow.scripts.lf_to_xarray:app
+merge-ts = workflow.scripts.merge_ts:app
+migrate = workflow.scripts.migrate:app
+nshm2022-to-realisation = workflow.scripts.nshm2022_to_realisation:app
+realisation-to-srf = workflow.scripts.realisation_to_srf:app

ucgmsim_workflow-2026.9.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+workflow

workflow/__init__.py

@@ -0,0 +1,103 @@
+"""QuakeCoRE Scientific Software Stack.
+
+## Overview
+The QuakeCoRE scientific workflow is composed of a number of independent components
+
+- `workflow` :: This module, which implements the Cybershake workflow. It defines a cylc workflow and scripts that researchers can use to build their own automated research pipeline using scientifically validated, regularly tested, well-documented components built from the software team.
+- `source_modelling` :: A collection of modules for modelling sources.
+- `velocity_modelling` :: The next-generation velocity model.
+- `qcore` :: Utilities and common functions.
+
+## Using the Workflow
+
+To deploy the workflow on NeSI, first clone the repository and then install the cylc workflow
+
+```
+$ git clone https://github.com/ucgmsim/workflow
+$ # add inputs into workflow/cylc/inputs
+$ cp -r workflow/cylc ~/cylc-src/cybershake # OR a suitable name for your custom workflow
+$ cylc install cybershake
+$ cylc play cybershake
+```
+
+And that's it! You can monitor the progress of your workflow with `cylc log cybershake` and `squeue -u $USER` to see the slurm job queue for your user.
+
+## The Stages
+
+The workflow repository contains all the tools necessary to build a
+workflow for ground motion model simulations. We build and maintain a
+Cybershake workflow, but researchers may wish to build their own. For
+this reason, the workflow is build out of composable parts we intend
+for anyone to reuse to build their own workflow based on the
+Cybershake workflow. Below you will find documentation for all the
+workflow stages, their inputs, outputs and environments.
+
+```mermaid
+flowchart LR
+    A[NSHM To Realisation] --> B[SRF Generation]
+    A --> C[Domain Generation]
+    B --> D[Stoch Generation]
+    C --> E[Velocity Model Generation]
+    C --> F[Station Selection]
+    C --> G[Write Model Coordinates]
+    B --> H[Create EMOD3D Parameters]
+    E --> H
+    F --> H
+    G --> H
+    H --> I[EMOD3D]
+    D --> J[High Frequency Simulation]
+    I --> M[Broadband Simulation]
+    J --> M
+    M --> N[Intensity Measure Calculation]
+    I -->|Optionally| K[Merge Timeslices]
+    K --> L[Create Simulation Video]
+```
+
+
+Many of the stages will run in a _container_. A container is a self-contained execution environment with all the system and Python libraries required to execute workflow stages. It is also isolated from the host system and may not be able to access certain directories. We maintain a [cybershake container](https://hub.docker.com/r/earthquakesuc/runner) that has a copy of the latest validated workflow, and environment. Use this container as much as possible in your own scripts to run your code.
+
+To find the documentation for a given stage, find the module that runs this stage in the above flow diagram and then click the corresponding link
+
+| Stage                         | Module                                                |
+|:------------------------------|:------------------------------------------------------|
+| NSHM to Realisation           | `workflow.scripts.nshm2022_to_realisation`            |
+| SRF Generation                | `workflow.scripts.realisation_to_srf`                 |
+| Domain Generation             | `workflow.scripts.generate_velocity_model_parameters` |
+| Stoch Generation              | `workflow.scripts.generate_stoch`                     |
+| Velocity Model Generation     | `workflow.scripts.generate_velocity_model`            |
+| Station Selection             | `workflow.scripts.generate_station_coordinates`       |
+| Write Model Coordinates       | `workflow.scripts.generate_model_coordinates`         |
+| EMOD3D                        | See below.                                            |
+| High Frequency Simulation     | `workflow.scripts.hf_sim`                             |
+| Broadband Simulation          | `workflow.scripts.bb_sim`                             |
+| Create Simulation Video       | `workflow.scripts.plot_ts`                            |
+| Intensity Measure Calculation | `workflow.scripts.im_calc`                            |
+
+
+## EMOD3D
+
+Most stages are documented in their corresponding python module
+
+### Description
+Run a low frequency ground motion simulation using EMOD3D.
+
+### Inputs
+1. A parameter file in "key=value" format,
+2. An SRF file,
+3. A station file list (latitude, longitude, and x, y), see .
+
+### Outputs
+1. Ground acceleration timeslice files, one per core.
+2. Seismograms, one per station.
+
+### Environment
+This stage must be run on a system with MPI installed. Typically, we run this stage in Maui on NeSI HPCs or Kisti. Due to high computational requirements, this stage usually cannot be run locally.
+
+### Usage
+On an HPC with slurm enabled `srun emod3d-mpi_v3.0.8 -args "par=$CYLC_WORKFLOW_SHARE_DIR/LF/e3d.par"` will run EMOD3D. Depending on the number of cores rerequested, this may invoke multiple proesses on different compute nodes (for Maui, this will occur when the number of cores exceeds 40). EMOD3D has support for checkpointing, so repeat invocations will continue from their previous checkpointed stage.
+
+### For More Help
+See Graves, 1996[^1] for a description of the mathematical and technical details of EMOD3D's implementation.
+
+[^1]: Graves, Robert W. "Simulating seismic wave propagation in 3D elastic media using staggered-grid finite differences." Bulletin of the seismological society of America 86.4 (1996): 1091-1106.
+"""