# csiro/connectivity architecture

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

- Interactive diagram: https://gitdiagram.com/csiro/connectivity
- Repository: https://github.com/csiro/connectivity

## Overview

Connectivity is a multi-resolution landscape-connectivity and biodiversity-indicator product, implemented by a shared Rust numerical core with Python and R interfaces. The user workflow is to supply habitat-condition and spatial inputs, optionally including traversal, protected-area, or climate data; prepare raster overviews and spatial windows; build and route a least-cost graph; then calculate connectivity indicators. The graph includes the documented Connected Habitat, PARC-connectedness, and BERI capabilities. Some binding and indicator wiring is documented but not visible in sampled implementation, so those links are marked unverified.

Main entry points: [`crates/connectivity-core/src/core.rs`](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/core.rs) (Core orchestration), [`crates/connectivity-core/src/builder.rs`](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/builder.rs) (Graph builder), [`python/connectivity/core.py`](https://github.com/csiro/connectivity/blob/main/python/connectivity/core.py) (Python API), [`python/connectivity/rastio.py`](https://github.com/csiro/connectivity/blob/main/python/connectivity/rastio.py) (Raster I/O)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Language interfaces"]
  node_python_api["Python API<br/>[core.py]"]
  node_python_rust["Python Rust binding<br/>[lib.rs]"]
  node_r_binding["R binding<br/>[lib.rs]"]
  node_runlog["Run logging<br/>[runlog.py]"]
end

subgraph group_spatial["Spatial preparation"]
  node_raster_io["Raster I/O<br/>[rastio.py]"]
  node_tiles["Tile processing<br/>[tiles.py]"]
  node_datasets["Datasets<br/>[datasets.py]"]
  node_affine["Raster geometry<br/>[affine.rs]"]
  node_overviews["Overview preparation<br/>[overview.rs]"]
  node_windows["Multi-scale windows<br/>[window.rs]"]
end

subgraph group_engine["Connectivity engine"]
  node_core["Core orchestration<br/>[core.rs]"]
  node_builder["Graph builder<br/>[builder.rs]"]
  node_graph["Sparse graph<br/>[graph.rs]"]
  node_routing["Least-cost routing<br/>[routing.rs]"]
  node_tables["Distance tables<br/>[tables.rs]"]
  node_template["Graph templates<br/>[template.rs]"]
end

subgraph group_indicators["Indicators and modes"]
  node_climate["Climate similarity<br/>[climate.rs]"]
  node_crossing["NoData crossing<br/>[crossing.rs]"]
  node_gate["Landmass gating<br/>[gate.rs]"]
  node_strict["Strict crossing<br/>[strict.rs]"]
  node_metrics["Connectivity metrics<br/>[metrics.rs]"]
  node_coverage["Protected coverage<br/>[coverage.rs]"]
end

node_analyst(("Analyst"))

node_analyst -->|"submits analysis"| node_python_api
node_python_api -->|"reads rasters"| node_raster_io
node_python_api -->|"records runs"| node_runlog
node_python_api -.->|"invokes engine"| node_python_rust
node_analyst -.->|"uses R package"| node_r_binding
node_raster_io -.->|"supplies tiles"| node_tiles
node_raster_io -.->|"loads datasets"| node_datasets
node_python_rust -.->|"calls core"| node_core
node_r_binding -.->|"uses engine"| node_core
node_core -->|"derives transforms"| node_affine
node_core -->|"builds overviews"| node_overviews
node_core -->|"configures windows"| node_windows
node_core -->|"builds connectivity"| node_builder
node_builder -->|"constructs graph"| node_graph
node_builder -->|"uses distances"| node_tables
node_builder -->|"uses templates"| node_template
node_builder -->|"applies crossing"| node_crossing
node_builder -->|"applies gating"| node_gate
node_builder -->|"uses strict mode"| node_strict
node_core -->|"handles climate inputs"| node_climate
node_core -.->|"calculates indicators"| node_metrics
node_routing -->|"routes over"| node_graph
node_core -.->|"routes paths"| node_routing
node_core -.->|"supports protected metrics"| node_coverage
node_core -.->|"produces indicators"| node_metrics

click node_python_api "https://github.com/csiro/connectivity/blob/main/python/connectivity/core.py"
click node_python_rust "https://github.com/csiro/connectivity/blob/main/python/src/lib.rs"
click node_r_binding "https://github.com/csiro/connectivity/blob/main/r/connectivity/src/rust/src/lib.rs"
click node_raster_io "https://github.com/csiro/connectivity/blob/main/python/connectivity/rastio.py"
click node_tiles "https://github.com/csiro/connectivity/blob/main/python/connectivity/tiles.py"
click node_datasets "https://github.com/csiro/connectivity/blob/main/python/connectivity/datasets.py"
click node_affine "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/affine.rs"
click node_overviews "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/overview.rs"
click node_windows "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/window.rs"
click node_core "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/core.rs"
click node_builder "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/builder.rs"
click node_graph "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/graph.rs"
click node_routing "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/routing.rs"
click node_tables "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/tables.rs"
click node_template "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/template.rs"
click node_climate "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/climate.rs"
click node_crossing "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/crossing.rs"
click node_gate "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/gate.rs"
click node_strict "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/strict.rs"
click node_metrics "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/metrics.rs"
click node_coverage "https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/coverage.rs"
click node_runlog "https://github.com/csiro/connectivity/blob/main/python/connectivity/runlog.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_python_api,node_python_rust,node_r_binding,node_runlog toneBlue
class node_raster_io,node_tiles,node_datasets,node_affine,node_overviews,node_windows toneAmber
class node_core,node_builder,node_graph,node_routing,node_tables,node_template toneMint
class node_climate,node_crossing,node_gate,node_strict,node_metrics,node_coverage toneRose
class node_analyst toneIndigo
```

## Components

### Language interfaces

- [Python API](https://github.com/csiro/connectivity/blob/main/python/connectivity/core.py): `python/connectivity/core.py`
- [Python Rust binding](https://github.com/csiro/connectivity/blob/main/python/src/lib.rs): `python/src/lib.rs`
- [R binding](https://github.com/csiro/connectivity/blob/main/r/connectivity/src/rust/src/lib.rs): `r/connectivity/src/rust/src/lib.rs`
- [Run logging](https://github.com/csiro/connectivity/blob/main/python/connectivity/runlog.py): `python/connectivity/runlog.py`

### Spatial preparation

- [Raster I/O](https://github.com/csiro/connectivity/blob/main/python/connectivity/rastio.py): `python/connectivity/rastio.py`
- [Tile processing](https://github.com/csiro/connectivity/blob/main/python/connectivity/tiles.py): `python/connectivity/tiles.py`
- [Datasets](https://github.com/csiro/connectivity/blob/main/python/connectivity/datasets.py): `python/connectivity/datasets.py`
- [Raster geometry](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/affine.rs): `crates/connectivity-core/src/affine.rs`
- [Overview preparation](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/overview.rs): `crates/connectivity-core/src/overview.rs`
- [Multi-scale windows](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/window.rs): `crates/connectivity-core/src/window.rs`

### Connectivity engine

- [Core orchestration](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/core.rs): `crates/connectivity-core/src/core.rs`
- [Graph builder](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/builder.rs): `crates/connectivity-core/src/builder.rs`
- [Sparse graph](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/graph.rs): `crates/connectivity-core/src/graph.rs`
- [Least-cost routing](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/routing.rs): `crates/connectivity-core/src/routing.rs`
- [Distance tables](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/tables.rs): `crates/connectivity-core/src/tables.rs`
- [Graph templates](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/template.rs): `crates/connectivity-core/src/template.rs`

### Indicators and modes

- [Climate similarity](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/climate.rs): `crates/connectivity-core/src/climate.rs`
- [NoData crossing](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/crossing.rs): `crates/connectivity-core/src/crossing.rs`
- [Landmass gating](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/gate.rs): `crates/connectivity-core/src/gate.rs`
- [Strict crossing](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/strict.rs): `crates/connectivity-core/src/strict.rs`
- [Connectivity metrics](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/metrics.rs): `crates/connectivity-core/src/metrics.rs`
- [Protected coverage](https://github.com/csiro/connectivity/blob/main/crates/connectivity-core/src/coverage.rs): `crates/connectivity-core/src/coverage.rs`

### Other components

- **Analyst**

## Connections

- Analyst → Python API: submits analysis (evidence: `README.md`)
- Python API → Raster I/O: reads rasters (evidence: `python/connectivity/core.py`)
- Python API → Run logging: records runs (evidence: `python/connectivity/core.py`)
- Python API → Python Rust binding: invokes engine
- Analyst → R binding: uses R package (evidence: `README.md`)
- Raster I/O → Tile processing: supplies tiles
- Raster I/O → Datasets: loads datasets
- Python Rust binding → Core orchestration: calls core (evidence: `README.md`)
- R binding → Core orchestration: uses engine (evidence: `README.md`)
- Core orchestration → Raster geometry: derives transforms (evidence: `crates/connectivity-core/src/core.rs`)
- Core orchestration → Overview preparation: builds overviews (evidence: `crates/connectivity-core/src/core.rs`)
- Core orchestration → Multi-scale windows: configures windows (evidence: `crates/connectivity-core/src/core.rs`)
- Core orchestration → Graph builder: builds connectivity (evidence: `crates/connectivity-core/src/core.rs`)
- Graph builder → Sparse graph: constructs graph (evidence: `crates/connectivity-core/src/builder.rs`)
- Graph builder → Distance tables: uses distances (evidence: `crates/connectivity-core/src/builder.rs`)
- Graph builder → Graph templates: uses templates (evidence: `crates/connectivity-core/src/builder.rs`)
- Graph builder → NoData crossing: applies crossing (evidence: `crates/connectivity-core/src/builder.rs`)
- Graph builder → Landmass gating: applies gating (evidence: `crates/connectivity-core/src/builder.rs`)
- Graph builder → Strict crossing: uses strict mode (evidence: `crates/connectivity-core/src/builder.rs`)
- Core orchestration → Climate similarity: handles climate inputs (evidence: `crates/connectivity-core/src/core.rs`)
- Core orchestration → Connectivity metrics: calculates indicators
- Least-cost routing → Sparse graph: routes over (evidence: `crates/connectivity-core/src/routing.rs`)
- Core orchestration → Least-cost routing: routes paths
- Core orchestration → Protected coverage: supports protected metrics (evidence: `README.md`)
- Core orchestration → Connectivity metrics: produces indicators (evidence: `README.md`)
