# vladbus/iceberg-thermodynamic-model architecture

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

- Interactive diagram: https://gitdiagram.com/vladbus/iceberg-thermodynamic-model
- Repository: https://github.com/vladbus/iceberg-thermodynamic-model

## Overview

This repository supports a Fortran iceberg thermodynamic model with a Python toolkit for preparing real-world inputs, independently validating melt physics, and analyzing model runs. The principal user workflow represented here is: obtain and prepare forcing/grid/ocean/ice inputs, run the model, then assess and visualize results. The supplied tree and excerpts cover Python tooling, not the Fortran runtime or its production coupling; those model stages are therefore shown only where the README documents them. Links between Python components are limited to documented relationships and SOURCE INDEX references.

Main entry points: [`python/validation/lateral_melt.py`](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/lateral_melt.py) (Lateral melt reference), [`python/validation/basal_melt.py`](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/basal_melt.py) (Basal melt reference), [`python/ice/build_initial_ice.py`](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/ice/build_initial_ice.py) (Initial sea ice), [`python/analysis/stage10_18a_lateral_melt.py`](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/stage10_18a_lateral_melt.py) (Lateral melt analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Input preparation"]
  node_era5dl["ERA5 download<br/>[download_era5.py]"]
  node_era5check["ERA5 checks<br/>[check_era5.py]"]
  node_forcing["Forcing diagnostics"]
  node_coverage["Grid coverage<br/>[model_coverage.py]"]
  node_grid["Grid generation"]
  node_ice["Initial sea ice"]
  node_ocean["Initial ocean T/S"]
end

subgraph group_validation["Physics validation"]
  node_basal["Basal melt reference<br/>[basal_melt.py]"]
  node_lateral["Lateral melt reference<br/>[lateral_melt.py]"]
  node_observations["Observation validation"]
  node_calibration["Calibration assessment"]
  node_constraint["Observation constraints"]
end

subgraph group_analysis["Analysis and plots"]
  node_runctx["Run context<br/>[run_context.py]"]
  node_trajectory["Trajectory audit"]
  node_lat_analysis["Lateral melt analysis"]
  node_obs_analysis["Observation analysis"]
  node_existing_obs["Existing observations"]
  node_seasonal["Seasonal plots<br/>[seasonal_plots.py]"]
end

subgraph group_runtime["Model runtime"]
  node_runtime_model["Iceberg model"]
end

node_user(("Researcher"))

node_user -->|"requests data"| node_era5dl
node_user -->|"prepares grid"| node_grid
node_era5dl -->|"checks files"| node_era5check
node_ice -->|"supplies geometry"| node_coverage
node_ice -->|"supplies geometry"| node_forcing
node_ice -->|"provides grid context"| node_ocean
node_user -->|"runs model"| node_runtime_model
node_runtime_model -->|"produces run outputs"| node_runctx
node_user -->|"validates physics"| node_basal
node_lateral -->|"reuses equations"| node_basal
node_calibration -->|"uses reference"| node_basal
node_calibration -->|"assesses data"| node_observations
node_constraint -->|"uses reference"| node_lateral
node_constraint -->|"uses reference"| node_basal
node_user -->|"audits run"| node_trajectory
node_user -->|"analyzes results"| node_lat_analysis
node_lat_analysis -->|"uses reference"| node_lateral
node_lat_analysis -->|"uses reference"| node_basal
node_obs_analysis -->|"uses constraints"| node_constraint
node_obs_analysis -->|"uses reference"| node_lateral
node_existing_obs -->|"uses reference"| node_lateral
node_user -->|"plots run"| node_seasonal
node_seasonal -->|"resolves run"| node_runctx

click node_era5dl "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/era5/download_era5.py"
click node_era5check "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/era5/check_era5.py"
click node_forcing "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/era5/stage7_6c2_forcing_stats.py"
click node_coverage "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/era5/model_coverage.py"
click node_grid "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/grid/build_real_grid_inputs.py"
click node_ice "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/ice/build_initial_ice.py"
click node_ocean "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/ocean/build_initial_ts.py"
click node_basal "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/basal_melt.py"
click node_lateral "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/lateral_melt.py"
click node_observations "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/observational_validation.py"
click node_calibration "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/calibration_assessment.py"
click node_constraint "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/observational_constraint.py"
click node_runctx "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/run_context.py"
click node_trajectory "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/stage10.15_1_trajectory_audit.py"
click node_lat_analysis "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/stage10_18a_lateral_melt.py"
click node_obs_analysis "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/stage10_18b_observational_constraint.py"
click node_existing_obs "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/stage10_18c_existing_observations.py"
click node_seasonal "https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/plotting/seasonal_plots.py"

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_era5dl,node_era5check,node_forcing,node_coverage,node_grid,node_ice,node_ocean toneBlue
class node_basal,node_lateral,node_observations,node_calibration,node_constraint toneAmber
class node_runctx,node_trajectory,node_lat_analysis,node_obs_analysis,node_existing_obs,node_seasonal toneMint
class node_runtime_model toneRose
class node_user toneIndigo
```

## Components

### Input preparation

- [ERA5 download](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/era5/download_era5.py): `python/era5/download_era5.py`
- [ERA5 checks](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/era5/check_era5.py): `python/era5/check_era5.py`
- [Forcing diagnostics](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/era5/stage7_6c2_forcing_stats.py): `python/era5/stage7_6c2_forcing_stats.py`
- [Grid coverage](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/era5/model_coverage.py): `python/era5/model_coverage.py`
- [Grid generation](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/grid/build_real_grid_inputs.py): `python/grid/build_real_grid_inputs.py`
- [Initial sea ice](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/ice/build_initial_ice.py): `python/ice/build_initial_ice.py`
- [Initial ocean T/S](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/ocean/build_initial_ts.py): `python/ocean/build_initial_ts.py`

### Physics validation

- [Basal melt reference](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/basal_melt.py): `python/validation/basal_melt.py`
- [Lateral melt reference](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/lateral_melt.py): `python/validation/lateral_melt.py`
- [Observation validation](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/observational_validation.py): `python/validation/observational_validation.py`
- [Calibration assessment](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/calibration_assessment.py): `python/validation/calibration_assessment.py`
- [Observation constraints](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/validation/observational_constraint.py): `python/validation/observational_constraint.py`

### Analysis and plots

- [Run context](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/run_context.py): `python/analysis/run_context.py`
- [Trajectory audit](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/stage10.15_1_trajectory_audit.py): `python/analysis/stage10.15_1_trajectory_audit.py`
- [Lateral melt analysis](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/stage10_18a_lateral_melt.py): `python/analysis/stage10_18a_lateral_melt.py`
- [Observation analysis](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/stage10_18b_observational_constraint.py): `python/analysis/stage10_18b_observational_constraint.py`
- [Existing observations](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/analysis/stage10_18c_existing_observations.py): `python/analysis/stage10_18c_existing_observations.py`
- [Seasonal plots](https://github.com/vladbus/iceberg-thermodynamic-model/blob/main/python/plotting/seasonal_plots.py): `python/plotting/seasonal_plots.py`

### Model runtime

- **Iceberg model**

### Other components

- **Researcher**

## Connections

- Researcher → ERA5 download: requests data (evidence: `README.md`)
- Researcher → Grid generation: prepares grid (evidence: `README.md`)
- ERA5 download → ERA5 checks: checks files (evidence: `python/era5/check_era5.py`)
- Initial sea ice → Grid coverage: supplies geometry (evidence: `python/era5/model_coverage.py`)
- Initial sea ice → Forcing diagnostics: supplies geometry (evidence: `python/era5/stage7_6c2_forcing_stats.py`)
- Initial sea ice → Initial ocean T/S: provides grid context (evidence: `python/ocean/build_initial_ts.py`)
- Researcher → Iceberg model: runs model (evidence: `README.md`)
- Iceberg model → Run context: produces run outputs (evidence: `README.md`)
- Researcher → Basal melt reference: validates physics (evidence: `README.md`)
- Lateral melt reference → Basal melt reference: reuses equations (evidence: `python/validation/lateral_melt.py`)
- Calibration assessment → Basal melt reference: uses reference (evidence: `python/validation/calibration_assessment.py`)
- Calibration assessment → Observation validation: assesses data (evidence: `python/validation/calibration_assessment.py`)
- Observation constraints → Lateral melt reference: uses reference (evidence: `python/validation/observational_constraint.py`)
- Observation constraints → Basal melt reference: uses reference (evidence: `python/validation/observational_constraint.py`)
- Researcher → Trajectory audit: audits run (evidence: `README.md`)
- Researcher → Lateral melt analysis: analyzes results (evidence: `README.md`)
- Lateral melt analysis → Lateral melt reference: uses reference (evidence: `python/analysis/stage10_18a_lateral_melt.py`)
- Lateral melt analysis → Basal melt reference: uses reference (evidence: `python/analysis/stage10_18a_lateral_melt.py`)
- Observation analysis → Observation constraints: uses constraints (evidence: `python/analysis/stage10_18b_observational_constraint.py`)
- Observation analysis → Lateral melt reference: uses reference (evidence: `python/analysis/stage10_18b_observational_constraint.py`)
- Existing observations → Lateral melt reference: uses reference (evidence: `python/analysis/stage10_18c_existing_observations.py`)
- Researcher → Seasonal plots: plots run (evidence: `README.md`)
- Seasonal plots → Run context: resolves run (evidence: `python/plotting/seasonal_plots.py`)
