# olegkho/lidu_copy_delme architecture

> Architecture diagram of the GitHub repository olegkho/lidu_copy_delme, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/olegkho/lidu_copy_delme
- Repository: https://github.com/olegkho/lidu_copy_delme

## Overview

Living Dunes is a process-based coastal dune ecosystem simulator with CLI, desktop GUI, and web interfaces. Its principal workflow is to configure a run, initialize a landscape, advance coupled environmental, vegetation, and aeolian processes, then save outputs for evaluation or visualization. The graph preserves the README’s documented interfaces and scientific capabilities, plus substantial indexed modules. Several subsystem details come from the README or file tree rather than sampled implementation, so uncertain connections are omitted; edges cite only visible index references or README statements.

Main entry points: [`living_dunes/simulation/simulation_sequence.py`](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/simulation/simulation_sequence.py) (Simulation sequence), [`living_dunes/sediment_transport/aeolian_tools.py`](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/sediment_transport/aeolian_tools.py) (Aeolian transport), [`living_dunes/geomorphology/geomorphology_tools.py`](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/geomorphology/geomorphology_tools.py) (Geomorphology), [`living_dunes/geospatial/geospatial_tools.py`](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/geospatial/geospatial_tools.py) (Geospatial tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry"]
  node_cli["CLI entry<br/>[cli.py]"]
  node_webgui["Web interface<br/>[gui_app.py]"]
  node_server["Web server<br/>[server_manager.py]"]
  node_webhandlers["Request handlers"]
end

subgraph group_simulation["Simulation control"]
  node_config["Configuration<br/>[validate_config.py]"]
  node_simseq["Simulation sequence"]
  node_global["Simulation state"]
end

subgraph group_science["Ecosystem processes"]
  node_environment["Environmental drivers"]
  node_weather["Weather drivers<br/>[weather_manager.py]"]
  node_vegetation["Vegetation dynamics"]
  node_demography["Plant demography"]
  node_sediment["Aeolian transport<br/>[aeolian_tools.py]"]
  node_threshold["Transport thresholds"]
  node_formulas["Sediment formulas"]
  node_geomorph["Geomorphology"]
end

subgraph group_data["Spatial data and outputs"]
  node_landscape["Landscape tools<br/>[landscape_tools.py]"]
  node_geospatial["Geospatial tools"]
  node_netcdf["NetCDF parsing<br/>[netcdf_parser.py]"]
  node_save["Array output<br/>[save_array_data.py]"]
end

subgraph group_presentation["Results and interfaces"]
  node_metrics["Evaluation metrics<br/>[metrics_tracker.py]"]
  node_visualization["Visualization"]
end

node_user(("Researcher"))

node_user -->|"starts run"| node_cli
node_user -->|"opens interface"| node_webgui
node_webgui -.->|"uses web mode"| node_server
node_server -->|"routes requests"| node_webhandlers
node_cli -.->|"supplies config"| node_config
node_config -.->|"configures run"| node_simseq
node_simseq -->|"uses state"| node_global
node_simseq -->|"advances drivers"| node_environment
node_simseq -->|"uses weather"| node_weather
node_simseq -->|"advances vegetation"| node_vegetation
node_simseq -->|"advances demography"| node_demography
node_simseq -->|"advances transport"| node_sediment
node_sediment -->|"uses thresholds"| node_threshold
node_sediment -->|"uses formulas"| node_formulas
node_simseq -->|"advances landforms"| node_geomorph
node_simseq -->|"uses landscape"| node_landscape
node_simseq -->|"uses spatial tools"| node_geospatial
node_geomorph -->|"uses spatial tools"| node_geospatial
node_geomorph -->|"uses landscape tools"| node_landscape
node_simseq -->|"writes arrays"| node_save
node_simseq -->|"records evaluation"| node_metrics
node_metrics -->|"uses spatial tools"| node_geospatial
node_user -.->|"explores results"| node_visualization
node_visualization -.->|"reads NetCDF"| node_netcdf

click node_cli "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/utils/cli.py"
click node_webgui "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/web_manager/gui/gui_app.py"
click node_server "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/web_manager/server_manager.py"
click node_config "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/utils/config_manager/validate_config.py"
click node_simseq "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/simulation/simulation_sequence.py"
click node_global "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/utils/global_container.py"
click node_environment "https://github.com/olegkho/lidu_copy_delme/tree/main/living_dunes/environment"
click node_weather "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/environment/weather_manager.py"
click node_vegetation "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/vegetation/vegetation_tools.py"
click node_demography "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/vegetation/demography_tools.py"
click node_sediment "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/sediment_transport/aeolian_tools.py"
click node_threshold "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/sediment_transport/threshold_dynamics.py"
click node_formulas "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/sediment_transport/sediment_formulas.py"
click node_geomorph "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/geomorphology/geomorphology_tools.py"
click node_landscape "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/geospatial/landscape_tools.py"
click node_geospatial "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/geospatial/geospatial_tools.py"
click node_netcdf "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/data_management/netcdf_parser.py"
click node_save "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/data_management/save_array_data.py"
click node_metrics "https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/evaluation/metrics_tracker.py"
click node_visualization "https://github.com/olegkho/lidu_copy_delme/tree/main/living_dunes/visualization"
click node_webhandlers "https://github.com/olegkho/lidu_copy_delme/tree/main/living_dunes/web_manager/server_handlers"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_webgui,node_server,node_webhandlers toneBlue
class node_config,node_simseq,node_global toneAmber
class node_environment,node_weather,node_vegetation,node_demography,node_sediment,node_threshold,node_formulas,node_geomorph toneMint
class node_landscape,node_geospatial,node_netcdf,node_save toneRose
class node_metrics,node_visualization,node_user toneIndigo
```

## Components

### User entry

- [CLI entry](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/utils/cli.py): `living_dunes/utils/cli.py`
- [Web interface](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/web_manager/gui/gui_app.py): `living_dunes/web_manager/gui/gui_app.py`
- [Web server](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/web_manager/server_manager.py): `living_dunes/web_manager/server_manager.py`
- [Request handlers](https://github.com/olegkho/lidu_copy_delme/tree/main/living_dunes/web_manager/server_handlers): `living_dunes/web_manager/server_handlers`

### Simulation control

- [Configuration](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/utils/config_manager/validate_config.py): `living_dunes/utils/config_manager/validate_config.py`
- [Simulation sequence](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/simulation/simulation_sequence.py): `living_dunes/simulation/simulation_sequence.py`
- [Simulation state](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/utils/global_container.py): `living_dunes/utils/global_container.py`

### Ecosystem processes

- [Environmental drivers](https://github.com/olegkho/lidu_copy_delme/tree/main/living_dunes/environment): `living_dunes/environment`
- [Weather drivers](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/environment/weather_manager.py): `living_dunes/environment/weather_manager.py`
- [Vegetation dynamics](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/vegetation/vegetation_tools.py): `living_dunes/vegetation/vegetation_tools.py`
- [Plant demography](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/vegetation/demography_tools.py): `living_dunes/vegetation/demography_tools.py`
- [Aeolian transport](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/sediment_transport/aeolian_tools.py): `living_dunes/sediment_transport/aeolian_tools.py`
- [Transport thresholds](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/sediment_transport/threshold_dynamics.py): `living_dunes/sediment_transport/threshold_dynamics.py`
- [Sediment formulas](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/sediment_transport/sediment_formulas.py): `living_dunes/sediment_transport/sediment_formulas.py`
- [Geomorphology](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/geomorphology/geomorphology_tools.py): `living_dunes/geomorphology/geomorphology_tools.py`

### Spatial data and outputs

- [Landscape tools](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/geospatial/landscape_tools.py): `living_dunes/geospatial/landscape_tools.py`
- [Geospatial tools](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/geospatial/geospatial_tools.py): `living_dunes/geospatial/geospatial_tools.py`
- [NetCDF parsing](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/data_management/netcdf_parser.py): `living_dunes/data_management/netcdf_parser.py`
- [Array output](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/data_management/save_array_data.py): `living_dunes/data_management/save_array_data.py`

### Results and interfaces

- [Evaluation metrics](https://github.com/olegkho/lidu_copy_delme/blob/main/living_dunes/evaluation/metrics_tracker.py): `living_dunes/evaluation/metrics_tracker.py`
- [Visualization](https://github.com/olegkho/lidu_copy_delme/tree/main/living_dunes/visualization): `living_dunes/visualization`

### Other components

- **Researcher**

## Connections

- Researcher → CLI entry: starts run
- Researcher → Web interface: opens interface
- Web interface → Web server: uses web mode
- Web server → Request handlers: routes requests (evidence: `living_dunes/web_manager/server_manager.py`)
- CLI entry → Configuration: supplies config
- Configuration → Simulation sequence: configures run
- Simulation sequence → Simulation state: uses state (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Simulation sequence → Environmental drivers: advances drivers (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Simulation sequence → Weather drivers: uses weather (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Simulation sequence → Vegetation dynamics: advances vegetation (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Simulation sequence → Plant demography: advances demography (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Simulation sequence → Aeolian transport: advances transport (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Aeolian transport → Transport thresholds: uses thresholds (evidence: `living_dunes/sediment_transport/aeolian_tools.py`)
- Aeolian transport → Sediment formulas: uses formulas (evidence: `living_dunes/sediment_transport/aeolian_tools.py`)
- Simulation sequence → Geomorphology: advances landforms (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Simulation sequence → Landscape tools: uses landscape (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Simulation sequence → Geospatial tools: uses spatial tools (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Geomorphology → Geospatial tools: uses spatial tools (evidence: `living_dunes/geomorphology/geomorphology_tools.py`)
- Geomorphology → Landscape tools: uses landscape tools (evidence: `living_dunes/geomorphology/geomorphology_tools.py`)
- Simulation sequence → Array output: writes arrays (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Simulation sequence → Evaluation metrics: records evaluation (evidence: `living_dunes/simulation/simulation_sequence.py`)
- Evaluation metrics → Geospatial tools: uses spatial tools (evidence: `living_dunes/evaluation/metrics_tracker.py`)
- Researcher → Visualization: explores results
- Visualization → NetCDF parsing: reads NetCDF
