PYBOX
PyBOX is a Python software for simulating the propagation of gravity-driven pyroclastic density currents (PDCs) using a box-model approach. It predicts two-dimensional inundation areas using the energy-conoid method and topography derived from the Copernicus GLO-30 Digital Elevation Model (DEM), a DSM-product. Simulations support multiple particle-size classes
Python code Box model Pyroclastic density currents Invasion maps Hazard assessment
| Id | Title | Data Type | Description |
|---|---|---|---|
| lat | Latitude | number | Vent latitude (decimal degrees) |
| lon | Longitude | number | Vent longitude (decimal degrees) |
| l0 | Initial front distance | number | Initial PDC front distance from the vent |
| h0 | Initial height | number | Initial PDC thickness (m) |
| theta0 | Temperature | number | Initial PDC temperature (K) |
| multiple_values | Multiple particle-size classes | array | A separate set of parameters must be provided for each particle-size class: volume fraction (eps0), density (rhos), and diameter (ds). The sum of all particle volume fractions (eps0) must be < 1 |
| dt | Time step | number | Numerical integration time step (s) |
| margin | Margin | number | Single distance value (m) from the given vent location applied equally in the -x, x and -y, y directions to define the topography spatial extent |
| Id | Title | Description |
|---|---|---|
| input_data | Input parameters | Summary of input parameters used in the simulation |
| dem | Input topography | Digital elevation data used as terrain input for the simulation |
| invasion_map | PDC invasion area | Two-dimensional inundation extent computed using the energy-conoid approach |
| spatial_evolution | Mean PDC properties | Evolution of mean PDC properties as function of distance from the vent |
| deposit_thickness | PDC deposit | Deposit thickness decay with distance from the vent |
| overlay_image | PDC invasion area over input topography | Simulated inundation extent overlaid on the input topography used for the simulation |
Execution modes
- Asynchronous
Links
- CIV repository (text/html)
- PyBox: a Python tool for simulating the kinematics of Pyroclastic density currents with the box-model approach, Reference and User's Guide (application/pdf)
- A fast, calibrated model for pyroclastic density currents kinematics and hazard (text/html)
- PyBOX-Web release on Zenodo (DOI: 10.5281/zenodo.18920969) (text/html)
- PyBOX-Web source code repository on GitHub (text/html)
- Process description as JSON (application/json)
- Process description as HTML (text/html)
- Jobs list as HTML (text/html)
- Jobs list as JSON (application/json)
- Execution for this process as JSON (application/json)