# aquaticecodynamics/libaed-water architecture

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

- Interactive diagram: https://gitdiagram.com/aquaticecodynamics/libaed-water
- Repository: https://github.com/aquaticecodynamics/libaed-water

## Overview

AED is a Fortran library for aquatic ecosystem simulation, with libaed-water described as its core water-biochemistry library. The documented user workflow is to use AED modules in an aquatic ecosystem model to simulate water quality, biogeochemistry, habitat, and ecosystem dynamics. The source excerpts expose only C headers, not Fortran call relationships, so module connections are omitted rather than inferred.

Main entry points: [`src`](https://github.com/aquaticecodynamics/libaed-water/tree/master/src) (AED library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Simulation Core"]
  node_aed["AED library"]
  node_core_engine["Simulation core<br/>[aed_core.F90]"]
  node_common_state["Shared state<br/>[aed_common.F90]"]
  node_external_interface["External interface<br/>[aed_external.F90]"]
  node_utilities["Model utilities<br/>[aed_util.F90]"]
  node_csv_input["CSV parameter reader<br/>[aed_csv_reader.F90]"]
  node_dummy["Dummy module<br/>[aed_dummy.F90]"]
end

subgraph group_water["Water Processes"]
  node_water["Water column<br/>[aed_water.F90]"]
  node_oxygen["Oxygen dynamics<br/>[aed_oxygen.F90]"]
  node_carbon["Carbon cycling<br/>[aed_carbon.F90]"]
  node_methane["Methane dynamics<br/>[aed_methane.F90]"]
  node_methane_bubbles["Methane bubbles"]
  node_habitat["Water habitat"]
end

subgraph group_chem["Biogeochemistry"]
  node_geochemistry["Geochemistry"]
  node_gc_solver["Geochemistry solver<br/>[aed_gcsolver.F90]"]
  node_gc_types["Geochemistry types<br/>[aed_gctypes.F90]"]
  node_nitrogen["Nitrogen cycling<br/>[aed_nitrogen.F90]"]
  node_phosphorus["Phosphorus cycling<br/>[aed_phosphorus.F90]"]
  node_silica["Silica cycling<br/>[aed_silica.F90]"]
  node_organic_matter["Organic matter"]
  node_sediment_flux["Sediment flux<br/>[aed_sedflux.F90]"]
  node_totals["Biogeochemical totals<br/>[aed_totals.F90]"]
  node_gclib["Geochemistry library<br/>[aed_gclib.F90]"]
end

subgraph group_bio["Aquatic Biology"]
  node_phytoplankton["Phytoplankton"]
  node_phyto_abm["Phytoplankton ABM<br/>[aed_phyto_abm.F90]"]
  node_zooplankton["Zooplankton"]
  node_zoop_utils["Zooplankton utilities<br/>[aed_zoop_utils.F90]"]
  node_bio_particles["Biological particles"]
  node_bio_utils["Biology utilities<br/>[aed_bio_utils.F90]"]
  node_pathogens["Pathogens<br/>[aed_pathogens.F90]"]
  node_pesticides["Pesticides<br/>[aed_pesticides.F90]"]
  node_noncohesive["Noncohesive sediment"]
  node_tracer["Tracer transport<br/>[aed_tracer.F90]"]
end

node_modeler(("Model developer"))

node_modeler -->|"uses for simulation"| node_aed

click node_aed "https://github.com/aquaticecodynamics/libaed-water/tree/master/src"
click node_core_engine "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_core.F90"
click node_common_state "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_common.F90"
click node_external_interface "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_external.F90"
click node_utilities "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_util.F90"
click node_csv_input "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_csv_reader.F90"
click node_water "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_water.F90"
click node_oxygen "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_oxygen.F90"
click node_carbon "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_carbon.F90"
click node_methane "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_methane.F90"
click node_methane_bubbles "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_methane_bubbles.F90"
click node_habitat "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_habitat_water.F90"
click node_geochemistry "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_geochemistry.F90"
click node_gc_solver "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_gcsolver.F90"
click node_gc_types "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_gctypes.F90"
click node_nitrogen "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_nitrogen.F90"
click node_phosphorus "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_phosphorus.F90"
click node_silica "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_silica.F90"
click node_organic_matter "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_organic_matter.F90"
click node_sediment_flux "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_sedflux.F90"
click node_totals "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_totals.F90"
click node_phytoplankton "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_phytoplankton.F90"
click node_phyto_abm "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_phyto_abm.F90"
click node_zooplankton "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_zooplankton.F90"
click node_zoop_utils "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_zoop_utils.F90"
click node_bio_particles "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_bio_particles.F90"
click node_bio_utils "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_bio_utils.F90"
click node_pathogens "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_pathogens.F90"
click node_pesticides "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_pesticides.F90"
click node_noncohesive "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_noncohesive.F90"
click node_tracer "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_tracer.F90"
click node_dummy "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_dummy.F90"
click node_gclib "https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_gclib.F90"

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_aed,node_core_engine,node_common_state,node_external_interface,node_utilities,node_csv_input,node_dummy toneBlue
class node_water,node_oxygen,node_carbon,node_methane,node_methane_bubbles,node_habitat toneAmber
class node_geochemistry,node_gc_solver,node_gc_types,node_nitrogen,node_phosphorus,node_silica,node_organic_matter,node_sediment_flux,node_totals,node_gclib toneMint
class node_phytoplankton,node_phyto_abm,node_zooplankton,node_zoop_utils,node_bio_particles,node_bio_utils,node_pathogens,node_pesticides,node_noncohesive,node_tracer toneRose
class node_modeler toneIndigo
```

## Components

### Simulation Core

- [AED library](https://github.com/aquaticecodynamics/libaed-water/tree/master/src): `src`
- [Simulation core](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_core.F90): `src/aed_core.F90`
- [Shared state](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_common.F90): `src/aed_common.F90`
- [External interface](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_external.F90): `src/aed_external.F90`
- [Model utilities](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_util.F90): `src/aed_util.F90`
- [CSV parameter reader](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_csv_reader.F90): `src/aed_csv_reader.F90`
- [Dummy module](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_dummy.F90): `src/aed_dummy.F90`

### Water Processes

- [Water column](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_water.F90): `src/aed_water.F90`
- [Oxygen dynamics](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_oxygen.F90): `src/aed_oxygen.F90`
- [Carbon cycling](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_carbon.F90): `src/aed_carbon.F90`
- [Methane dynamics](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_methane.F90): `src/aed_methane.F90`
- [Methane bubbles](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_methane_bubbles.F90): `src/aed_methane_bubbles.F90`
- [Water habitat](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_habitat_water.F90): `src/aed_habitat_water.F90`

### Biogeochemistry

- [Geochemistry](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_geochemistry.F90): `src/aed_geochemistry.F90`
- [Geochemistry solver](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_gcsolver.F90): `src/aed_gcsolver.F90`
- [Geochemistry types](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_gctypes.F90): `src/aed_gctypes.F90`
- [Nitrogen cycling](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_nitrogen.F90): `src/aed_nitrogen.F90`
- [Phosphorus cycling](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_phosphorus.F90): `src/aed_phosphorus.F90`
- [Silica cycling](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_silica.F90): `src/aed_silica.F90`
- [Organic matter](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_organic_matter.F90): `src/aed_organic_matter.F90`
- [Sediment flux](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_sedflux.F90): `src/aed_sedflux.F90`
- [Biogeochemical totals](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_totals.F90): `src/aed_totals.F90`
- [Geochemistry library](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_gclib.F90): `src/aed_gclib.F90`

### Aquatic Biology

- [Phytoplankton](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_phytoplankton.F90): `src/aed_phytoplankton.F90`
- [Phytoplankton ABM](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_phyto_abm.F90): `src/aed_phyto_abm.F90`
- [Zooplankton](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_zooplankton.F90): `src/aed_zooplankton.F90`
- [Zooplankton utilities](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_zoop_utils.F90): `src/aed_zoop_utils.F90`
- [Biological particles](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_bio_particles.F90): `src/aed_bio_particles.F90`
- [Biology utilities](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_bio_utils.F90): `src/aed_bio_utils.F90`
- [Pathogens](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_pathogens.F90): `src/aed_pathogens.F90`
- [Pesticides](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_pesticides.F90): `src/aed_pesticides.F90`
- [Noncohesive sediment](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_noncohesive.F90): `src/aed_noncohesive.F90`
- [Tracer transport](https://github.com/aquaticecodynamics/libaed-water/blob/master/src/aed_tracer.F90): `src/aed_tracer.F90`

### Other components

- **Model developer**

## Connections

- Model developer → AED library: uses for simulation (evidence: `README.md`)
