How envdes/pyclmuapp works
pyclmuapp prepares and runs urban-climate simulations with CLMU in Docker or Singularity: users provide or create forcing and urban surface inputs, configure a case, execute it, and inspect model outputs. The CLI is the evidenced runtime entry point; the README also documents U-Surf and local-climate-zone integration. Several subsystems are represented by their exact tree paths, but their wiring is not established by the sampled excerpts, so uncertain links are omitted.
Main entry points: usp.py USP simulation workflow · _cli.py CLI workflow · era5_forcing.py Forcing acquisition · clmuapp.py Web interface
Components 20
User interfaces
- CLI workflow
pyclmuapp/_cli.py - Web interface
dockerfile/pyclmuapp/clmuapp.py
Simulation inputs
- Case configuration
pyclmuapp/config/config_man.json - Surface and domain inputs
pyclmuapp/usp.py - Surface data creation
pyclmuapp/input_data.py - City and LCZ integration
pyclmuapp/getcity.py - Forcing acquisition
pyclmuapp/era5_forcing.py - Forcing conversion
pyclmuapp/era_forcing.py - GEE forcing path
pyclmuapp/era5_forcing_gee.py
Case execution
- USP simulation workflow
pyclmuapp/usp.py - PTS workflow
pyclmuapp/pts.py - CLMU case operations
pyclmuapp/clmu.py - Container control
pyclmuapp/container.py
Outputs and data
- Simulation outputs
- Output inspection
pyclmuapp/usp.py - Forcing NetCDF
Other components
- Research user
- ERA5 services
- Container runtime
- CLMU model
Connections 22
- Research user → CLI workflow: runs
- CLI workflow → USP simulation workflow: invokes
- CLI workflow → Forcing acquisition: requests forcing
- CLI workflow → Case configuration: loads defaults
- Research user → Web interface: uses
- Web interface → USP simulation workflow: runs simulation
- Web interface → Forcing acquisition: creates forcing
- Forcing acquisition → ERA5 services: retrieves data
- Forcing acquisition → Forcing conversion: converts data
- Forcing conversion → Forcing NetCDF: writes
- GEE forcing path → ERA5 services: retrieves data
- USP simulation workflow → Surface and domain inputs: checks and modifies
- USP simulation workflow → CLMU case operations: prepares case
- USP simulation workflow → Container control: dispatches run
- PTS workflow → CLMU case operations: prepares case
- PTS workflow → Container control: dispatches run
- CLMU case operations → CLMU model: configures case
- Container control → Container runtime: controls
- Container runtime → CLMU model: runs model
- CLMU model → Simulation outputs: writes results
- USP simulation workflow → Output inspection: reads outputs
- Output inspection → Simulation outputs: opens NetCDF