# francisotia/geodev-lab-project architecture

> Architecture diagram of the GitHub repository francisotia/geodev-lab-project, 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/francisotia/geodev-lab-project
- Repository: https://github.com/francisotia/geodev-lab-project

## Overview

This repository is a geospatial learning project focused on Ogbia settlements: its stated question is which settlements lie in low-lying land within 200 metres of a watercourse. The workflow represented here is data preparation, settlement-point extraction, spatial proximity analysis and mapping; separate scripts also explore ward counts and health-facility coverage. The scripts are standalone rather than a single orchestrated application. Connections reflect the sampled source and README; unsampled stages are included only where the README documents them.

Main entry points: [`data/processed/Ogbia_Wards_utm32.gpkg`](https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/Ogbia_Wards_utm32.gpkg) (Ward boundaries), [`data/processed/settlement_extents_utm32.gpkg`](https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/settlement_extents_utm32.gpkg) (Settlement extents), [`month-03/week-11/my_week11_map.py`](https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-11/my_week11_map.py) (Proximity map), [`month-03/week-10/my_map.py`](https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-10/my_map.py) (Settlement map)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prep["Data preparation"]
  node_settlement_extents[("Settlement extents")]
  node_waterways[("Waterway layers")]
  node_wards[("Ward boundaries")]
  node_facilities[("Health facilities")]
  node_centroid_extract["Centroid extraction"]
  node_settlement_points_csv[("Settlement points CSV")]
  node_settlement_points_gpkg[("Settlement points layer")]
end

subgraph group_analysis["Spatial analysis"]
  node_reach_analysis["Waterway proximity<br/>[my_reach.py]"]
  node_ward_counts["Ward settlement counts<br/>[my_counts.py]"]
  node_coverage_gaps["Facility coverage gaps<br/>[coverage_gap.py]"]
end

subgraph group_outputs["Maps and reporting"]
  node_waterway_map["Proximity map<br/>[my_week11_map.py]"]
  node_settlement_map["Settlement map<br/>[my_map.py]"]
end

subgraph group_tabular["Tabular exploration"]
  node_population_join["Ward population join<br/>[join_population.py]"]
  node_population_csv[("Ward population")]
  node_csv_summary["CSV statistics<br/>[summary.py]"]
  node_settlement_csv[("Settlement measurements")]
end

node_analyst(("Project analyst"))

node_analyst -->|"runs"| node_centroid_extract
node_settlement_extents -->|"reads"| node_centroid_extract
node_centroid_extract -->|"exports"| node_settlement_points_csv
node_analyst -->|"runs"| node_reach_analysis
node_settlement_extents -->|"reads"| node_reach_analysis
node_waterways -->|"reads"| node_reach_analysis
node_analyst -->|"runs"| node_waterway_map
node_settlement_extents -->|"reads"| node_waterway_map
node_waterways -->|"reads"| node_waterway_map
node_wards -->|"reads"| node_waterway_map
node_analyst -->|"runs"| node_ward_counts
node_settlement_points_gpkg -->|"reads"| node_ward_counts
node_wards -->|"reads"| node_ward_counts
node_analyst -->|"runs"| node_coverage_gaps
node_wards -->|"reads"| node_coverage_gaps
node_facilities -->|"reads"| node_coverage_gaps
node_analyst -->|"runs"| node_settlement_map
node_wards -->|"reads"| node_settlement_map
node_settlement_extents -->|"reads"| node_settlement_map
node_settlement_points_gpkg -->|"reads"| node_settlement_map
node_analyst -->|"runs"| node_population_join
node_wards -->|"reads"| node_population_join
node_population_csv -->|"reads"| node_population_join
node_analyst -->|"runs"| node_csv_summary
node_settlement_csv -->|"reads"| node_csv_summary

click node_settlement_extents "https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/settlement_extents_utm32.gpkg"
click node_waterways "https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/waterway_river_and_stream_utm32.gpkg"
click node_wards "https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/Ogbia_Wards_utm32.gpkg"
click node_facilities "https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/health_facilities.gpkg"
click node_centroid_extract "https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-10/my_extract_settlments_centroid.py"
click node_settlement_points_csv "https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/settlement_points.csv"
click node_settlement_points_gpkg "https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/settlement_points.gpkg"
click node_reach_analysis "https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-11/my_reach.py"
click node_waterway_map "https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-11/my_week11_map.py"
click node_ward_counts "https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-11/my_counts.py"
click node_coverage_gaps "https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-11/coverage_gap.py"
click node_settlement_map "https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-10/my_map.py"
click node_population_join "https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-10/join_population.py"
click node_population_csv "https://github.com/francisotia/geodev-lab-project/blob/main/data/raw/ward_population.csv"
click node_csv_summary "https://github.com/francisotia/geodev-lab-project/blob/main/summary.py"
click node_settlement_csv "https://github.com/francisotia/geodev-lab-project/blob/main/settlement_extent.csv"

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_settlement_extents,node_waterways,node_wards,node_facilities,node_centroid_extract,node_settlement_points_csv,node_settlement_points_gpkg toneBlue
class node_reach_analysis,node_ward_counts,node_coverage_gaps toneAmber
class node_waterway_map,node_settlement_map toneMint
class node_population_join,node_population_csv,node_csv_summary,node_settlement_csv toneRose
class node_analyst toneIndigo
```

## Components

### Data preparation

- [Settlement extents](https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/settlement_extents_utm32.gpkg): `data/processed/settlement_extents_utm32.gpkg`
- [Waterway layers](https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/waterway_river_and_stream_utm32.gpkg): `data/processed/waterway_river_and_stream_utm32.gpkg`
- [Ward boundaries](https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/Ogbia_Wards_utm32.gpkg): `data/processed/Ogbia_Wards_utm32.gpkg`
- [Health facilities](https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/health_facilities.gpkg): `data/processed/health_facilities.gpkg`
- [Centroid extraction](https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-10/my_extract_settlments_centroid.py): `month-03/week-10/my_extract_settlments_centroid.py`
- [Settlement points CSV](https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/settlement_points.csv): `data/processed/settlement_points.csv`
- [Settlement points layer](https://github.com/francisotia/geodev-lab-project/blob/main/data/processed/settlement_points.gpkg): `data/processed/settlement_points.gpkg`

### Spatial analysis

- [Waterway proximity](https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-11/my_reach.py): `month-03/week-11/my_reach.py`
- [Ward settlement counts](https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-11/my_counts.py): `month-03/week-11/my_counts.py`
- [Facility coverage gaps](https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-11/coverage_gap.py): `month-03/week-11/coverage_gap.py`

### Maps and reporting

- [Proximity map](https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-11/my_week11_map.py): `month-03/week-11/my_week11_map.py`
- [Settlement map](https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-10/my_map.py): `month-03/week-10/my_map.py`

### Tabular exploration

- [Ward population join](https://github.com/francisotia/geodev-lab-project/blob/main/month-03/week-10/join_population.py): `month-03/week-10/join_population.py`
- [Ward population](https://github.com/francisotia/geodev-lab-project/blob/main/data/raw/ward_population.csv): `data/raw/ward_population.csv`
- [CSV statistics](https://github.com/francisotia/geodev-lab-project/blob/main/summary.py): `summary.py`
- [Settlement measurements](https://github.com/francisotia/geodev-lab-project/blob/main/settlement_extent.csv): `settlement_extent.csv`

### Other components

- **Project analyst**

## Connections

- Project analyst → Centroid extraction: runs (evidence: `month-03/week-10/my_extract_settlments_centroid.py`)
- Settlement extents → Centroid extraction: reads (evidence: `month-03/week-10/my_extract_settlments_centroid.py`)
- Centroid extraction → Settlement points CSV: exports (evidence: `month-03/week-10/my_extract_settlments_centroid.py`)
- Project analyst → Waterway proximity: runs (evidence: `month-03/week-11/my_reach.py`)
- Settlement extents → Waterway proximity: reads (evidence: `month-03/week-11/my_reach.py`)
- Waterway layers → Waterway proximity: reads (evidence: `month-03/week-11/my_reach.py`)
- Project analyst → Proximity map: runs (evidence: `month-03/week-11/my_week11_map.py`)
- Settlement extents → Proximity map: reads (evidence: `month-03/week-11/my_week11_map.py`)
- Waterway layers → Proximity map: reads (evidence: `month-03/week-11/my_week11_map.py`)
- Ward boundaries → Proximity map: reads (evidence: `month-03/week-11/my_week11_map.py`)
- Project analyst → Ward settlement counts: runs (evidence: `month-03/week-11/my_counts.py`)
- Settlement points layer → Ward settlement counts: reads (evidence: `month-03/week-11/my_counts.py`)
- Ward boundaries → Ward settlement counts: reads (evidence: `month-03/week-11/my_counts.py`)
- Project analyst → Facility coverage gaps: runs (evidence: `month-03/week-11/coverage_gap.py`)
- Ward boundaries → Facility coverage gaps: reads (evidence: `month-03/week-11/coverage_gap.py`)
- Health facilities → Facility coverage gaps: reads (evidence: `month-03/week-11/coverage_gap.py`)
- Project analyst → Settlement map: runs (evidence: `month-03/week-10/my_map.py`)
- Ward boundaries → Settlement map: reads (evidence: `month-03/week-10/my_map.py`)
- Settlement extents → Settlement map: reads (evidence: `month-03/week-10/my_map.py`)
- Settlement points layer → Settlement map: reads (evidence: `month-03/week-10/my_map.py`)
- Project analyst → Ward population join: runs (evidence: `month-03/week-10/join_population.py`)
- Ward boundaries → Ward population join: reads (evidence: `month-03/week-10/join_population.py`)
- Ward population → Ward population join: reads (evidence: `month-03/week-10/join_population.py`)
- Project analyst → CSV statistics: runs (evidence: `summary.py`)
- Settlement measurements → CSV statistics: reads (evidence: `summary.py`)
