# ajcecil/digital-soil-mapping architecture

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

- Interactive diagram: https://gitdiagram.com/ajcecil/digital-soil-mapping
- Repository: https://github.com/ajcecil/digital-soil-mapping

## Overview

This repository hosts a static web-based digital soil-mapping viewer. The intended user workflow is to open the site and view soil-property maps; the tree also shows map exploration, data-viewing, and project-content pages. The README establishes the viewer’s purpose, but the sampled source contains only tile-generation scripts, not the web pages’ runtime wiring, so relationships between individual pages, JavaScript, and assets are not asserted.

Main entry points: [`docs/mapviewer.html`](https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/mapviewer.html) (Map viewer), [`docs/page_files/maps`](https://github.com/ajcecil/digital-soil-mapping/tree/main/docs/page_files/maps) (Soil map assets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Web experience"]
  node_home["Site home<br/>[index.html]"]
  node_mapviewer["Map viewer<br/>[mapviewer.html]"]
  node_explorer["Map explorer<br/>[explorer.js]"]
  node_dataviewer["Data viewer<br/>[dataviewer.html]"]
end

subgraph group_maps["Map content"]
  node_mapassets[("Soil map assets")]
  node_maptiles[("Map tiles")]
end

subgraph group_reference["Supporting content"]
  node_currentdata["Current data<br/>[current_data.csv]"]
  node_methods["Methods page<br/>[methods.html]"]
  node_projectcontent["Project articles"]
end

node_visitor(("Site visitor"))

node_visitor -->|"views maps"| node_mapviewer
node_mapviewer -->|"displays maps"| node_mapassets

click node_home "https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/index.html"
click node_mapviewer "https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/mapviewer.html"
click node_explorer "https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/explorer.js"
click node_dataviewer "https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/dataviewer.html"
click node_mapassets "https://github.com/ajcecil/digital-soil-mapping/tree/main/docs/page_files/maps"
click node_maptiles "https://github.com/ajcecil/digital-soil-mapping/tree/main/docs/page_files/maps/BPH/tiles"
click node_currentdata "https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/content/data/current_data.csv"
click node_methods "https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/methods.html"
click node_projectcontent "https://github.com/ajcecil/digital-soil-mapping/tree/main/docs/content"

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_home,node_mapviewer,node_explorer,node_dataviewer toneBlue
class node_mapassets,node_maptiles toneAmber
class node_currentdata,node_methods,node_projectcontent toneMint
class node_visitor toneIndigo
```

## Components

### Web experience

- [Site home](https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/index.html): `docs/index.html`
- [Map viewer](https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/mapviewer.html): `docs/mapviewer.html`
- [Map explorer](https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/explorer.js): `docs/explorer.js`
- [Data viewer](https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/dataviewer.html): `docs/dataviewer.html`

### Map content

- [Soil map assets](https://github.com/ajcecil/digital-soil-mapping/tree/main/docs/page_files/maps): `docs/page_files/maps`
- [Map tiles](https://github.com/ajcecil/digital-soil-mapping/tree/main/docs/page_files/maps/BPH/tiles): `docs/page_files/maps/BPH/tiles`

### Supporting content

- [Current data](https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/content/data/current_data.csv): `docs/content/data/current_data.csv`
- [Methods page](https://github.com/ajcecil/digital-soil-mapping/blob/main/docs/methods.html): `docs/methods.html`
- [Project articles](https://github.com/ajcecil/digital-soil-mapping/tree/main/docs/content): `docs/content`

### Other components

- **Site visitor**

## Connections

- Site visitor → Map viewer: views maps (evidence: `README.md`)
- Map viewer → Soil map assets: displays maps (evidence: `README.md`)