# pacificclimate/pdp-next architecture

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

- Interactive diagram: https://gitdiagram.com/pacificclimate/pdp-next
- Repository: https://github.com/pacificclimate/pdp-next

## Overview

PDP-Next replaces the Pacific Climate Data Portal with a THREDDS-backed interactive climate-data viewer and portal metadata preparation workflow. Users choose a portal and dataset, explore mapped layers and time, then optionally draw a spatial selection and download a subset. Separately, operational scripts prepare portal metadata from NetCDF files and min/max ranges for the viewer. The source excerpts show the viewer’s main orchestration and metadata-builder calls; some service wiring and unsampled implementation details are supported only by the README or are omitted.

Main entry points: [`viewer/js/app.js`](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/app.js) (Viewer bootstrap), [`portal_meta_builder/builder.py`](https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/builder.py) (Metadata builder), [`viewer/js/subsetting.js`](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting.js) (Subset controller), [`viewer/js/events.js`](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/events.js) (Viewer interactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_viewer["Interactive Viewer"]
  node_app["Viewer bootstrap<br/>[app.js]"]
  node_config["Portal and URL config<br/>[config.js]"]
  node_dom["Viewer DOM and status<br/>[dom.js]"]
  node_datasets["Dataset selection<br/>[datasets.js]"]
  node_menu["Dataset menu<br/>[menu.js]"]
  node_map["Map and rendering<br/>[controller.js]"]
  node_events["Viewer interactions<br/>[events.js]"]
  node_time["Time controls<br/>[ui.js]"]
  node_timeparse["Time parsing<br/>[parse.js]"]
  node_timemetadata["Time metadata<br/>[metadata.js]"]
  node_timeentry["Time controller<br/>[time.js]"]
  node_openlayers["OpenLayers adapter<br/>[openlayers.js]"]
end

subgraph group_subset["Subset Downloads"]
  node_subsetentry["Subset controller<br/>[subsetting.js]"]
  node_draw["Spatial drawing<br/>[draw.js]"]
  node_indexes["Subset indexes<br/>[indexes.js]"]
  node_download["Subset download jobs<br/>[download.js]"]
  node_logging["Subset logging<br/>[logging.js]"]
end

subgraph group_metadata["Metadata Preparation"]
  node_ops["Metadata update script"]
  node_builder["Metadata builder<br/>[builder.py]"]
  node_netcdf["NetCDF metadata reader<br/>[metadata.py]"]
  node_minmax["Min-max lookup<br/>[minmax.py]"]
  node_portals["Portal menu rules<br/>[portals.py]"]
  node_io["Metadata file I/O<br/>[io_utils.py]"]
  node_minmaxscript["Min-max calculation"]
end

subgraph group_prep["Portal Inputs"]
  node_patterns["Portal file patterns"]
  node_query["ModelMeta query<br/>[min_max_query.sql]"]
  node_portalprep["Preparation workflow<br/>[README.md]"]
end

node_user(("Portal user"))
node_thredds["THREDDS data service"]
node_partitioner["ncpartitioner service"]
node_visitor(("Portal data visitor"))

node_user -->|"uses"| node_app
node_app -->|"reads config"| node_config
node_app -->|"creates controller"| node_timeentry
node_app -->|"creates controller"| node_datasets
node_app -->|"loads module"| node_menu
node_app -->|"loads module"| node_map
node_app -->|"loads module"| node_events
node_app -->|"loads module"| node_subsetentry
node_app -->|"uses controls"| node_dom
node_app -->|"uses adapter"| node_openlayers
node_timeentry -->|"imports helpers"| node_timeparse
node_timeentry -->|"imports helpers"| node_timemetadata
node_timeentry -->|"imports UI"| node_time
node_events -->|"invokes map actions"| node_map
node_events -->|"invokes download"| node_subsetentry
node_events -->|"builds portal URL"| node_config
node_events -->|"updates status"| node_dom
node_menu -.->|"selects dataset"| node_datasets
node_datasets -.->|"fetches portal data"| node_thredds
node_map -.->|"requests map layers"| node_thredds
node_subsetentry -->|"uses drawing"| node_draw
node_subsetentry -->|"uses indexes"| node_indexes
node_subsetentry -->|"uses logging"| node_logging
node_subsetentry -->|"uses controller"| node_download
node_download -->|"submits jobs"| node_partitioner
node_download -.->|"downloads files"| node_thredds
node_visitor -->|"runs preparation"| node_portalprep
node_portalprep -->|"uses definitions"| node_patterns
node_portalprep -->|"exports ranges"| node_query
node_portalprep -->|"calculates ranges"| node_minmaxscript
node_portalprep -->|"builds metadata"| node_ops
node_ops -->|"invokes builder"| node_builder
node_builder -->|"loads and fingerprints"| node_io
node_builder -->|"reads metadata"| node_netcdf
node_builder -->|"selects ranges"| node_minmax
node_builder -.->|"derives menu fields"| node_portals
node_minmaxscript -->|"uses exported ranges"| node_query
node_builder -.->|"publishes viewer metadata"| node_thredds

click node_app "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/app.js"
click node_config "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/core/config.js"
click node_dom "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/core/dom.js"
click node_datasets "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/portal/datasets.js"
click node_menu "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/portal/menu.js"
click node_map "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/map/controller.js"
click node_events "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/events.js"
click node_time "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/time/ui.js"
click node_timeparse "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/time/parse.js"
click node_timemetadata "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/time/metadata.js"
click node_timeentry "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/time.js"
click node_openlayers "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/core/openlayers.js"
click node_subsetentry "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting.js"
click node_draw "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting/draw.js"
click node_indexes "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting/indexes.js"
click node_download "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting/download.js"
click node_logging "https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting/logging.js"
click node_ops "https://github.com/pacificclimate/pdp-next/blob/main/scripts/update-portal-meta.py"
click node_builder "https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/builder.py"
click node_netcdf "https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/metadata.py"
click node_minmax "https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/minmax.py"
click node_portals "https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/portals.py"
click node_io "https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/io_utils.py"
click node_minmaxscript "https://github.com/pacificclimate/pdp-next/blob/main/scripts/calculate-portal-minmax.py"
click node_patterns "https://github.com/pacificclimate/pdp-next/tree/main/portal-prep/portal-file-patterns"
click node_query "https://github.com/pacificclimate/pdp-next/blob/main/portal-prep/min_max_query.sql"
click node_portalprep "https://github.com/pacificclimate/pdp-next/blob/main/portal-prep/README.md"

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_app,node_config,node_dom,node_datasets,node_menu,node_map,node_events,node_time,node_timeparse,node_timemetadata,node_timeentry,node_openlayers,node_user toneBlue
class node_subsetentry,node_draw,node_indexes,node_download,node_logging toneAmber
class node_ops,node_builder,node_netcdf,node_minmax,node_portals,node_io,node_minmaxscript toneMint
class node_patterns,node_query,node_portalprep toneRose
class node_thredds,node_partitioner,node_visitor toneIndigo
```

## Components

### Interactive Viewer

- [Viewer bootstrap](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/app.js): `viewer/js/app.js`
- [Portal and URL config](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/core/config.js): `viewer/js/core/config.js`
- [Viewer DOM and status](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/core/dom.js): `viewer/js/core/dom.js`
- [Dataset selection](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/portal/datasets.js): `viewer/js/portal/datasets.js`
- [Dataset menu](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/portal/menu.js): `viewer/js/portal/menu.js`
- [Map and rendering](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/map/controller.js): `viewer/js/map/controller.js`
- [Viewer interactions](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/events.js): `viewer/js/events.js`
- [Time controls](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/time/ui.js): `viewer/js/time/ui.js`
- [Time parsing](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/time/parse.js): `viewer/js/time/parse.js`
- [Time metadata](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/time/metadata.js): `viewer/js/time/metadata.js`
- [Time controller](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/time.js): `viewer/js/time.js`
- [OpenLayers adapter](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/core/openlayers.js): `viewer/js/core/openlayers.js`

### Subset Downloads

- [Subset controller](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting.js): `viewer/js/subsetting.js`
- [Spatial drawing](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting/draw.js): `viewer/js/subsetting/draw.js`
- [Subset indexes](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting/indexes.js): `viewer/js/subsetting/indexes.js`
- [Subset download jobs](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting/download.js): `viewer/js/subsetting/download.js`
- [Subset logging](https://github.com/pacificclimate/pdp-next/blob/main/viewer/js/subsetting/logging.js): `viewer/js/subsetting/logging.js`

### Metadata Preparation

- [Metadata update script](https://github.com/pacificclimate/pdp-next/blob/main/scripts/update-portal-meta.py): `scripts/update-portal-meta.py`
- [Metadata builder](https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/builder.py): `portal_meta_builder/builder.py`
- [NetCDF metadata reader](https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/metadata.py): `portal_meta_builder/metadata.py`
- [Min-max lookup](https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/minmax.py): `portal_meta_builder/minmax.py`
- [Portal menu rules](https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/portals.py): `portal_meta_builder/portals.py`
- [Metadata file I/O](https://github.com/pacificclimate/pdp-next/blob/main/portal_meta_builder/io_utils.py): `portal_meta_builder/io_utils.py`
- [Min-max calculation](https://github.com/pacificclimate/pdp-next/blob/main/scripts/calculate-portal-minmax.py): `scripts/calculate-portal-minmax.py`

### Portal Inputs

- [Portal file patterns](https://github.com/pacificclimate/pdp-next/tree/main/portal-prep/portal-file-patterns): `portal-prep/portal-file-patterns`
- [ModelMeta query](https://github.com/pacificclimate/pdp-next/blob/main/portal-prep/min_max_query.sql): `portal-prep/min_max_query.sql`
- [Preparation workflow](https://github.com/pacificclimate/pdp-next/blob/main/portal-prep/README.md): `portal-prep/README.md`

### Other components

- **Portal user**
- **THREDDS data service**
- **ncpartitioner service**
- **Portal data visitor**

## Connections

- Portal user → Viewer bootstrap: uses (evidence: `README.md`)
- Viewer bootstrap → Portal and URL config: reads config (evidence: `viewer/js/app.js`)
- Viewer bootstrap → Time controller: creates controller (evidence: `viewer/js/app.js`)
- Viewer bootstrap → Dataset selection: creates controller (evidence: `viewer/js/app.js`)
- Viewer bootstrap → Dataset menu: loads module (evidence: `viewer/js/app.js`)
- Viewer bootstrap → Map and rendering: loads module (evidence: `viewer/js/app.js`)
- Viewer bootstrap → Viewer interactions: loads module (evidence: `viewer/js/app.js`)
- Viewer bootstrap → Subset controller: loads module (evidence: `viewer/js/app.js`)
- Viewer bootstrap → Viewer DOM and status: uses controls (evidence: `viewer/js/app.js`)
- Viewer bootstrap → OpenLayers adapter: uses adapter (evidence: `viewer/js/app.js`)
- Time controller → Time parsing: imports helpers (evidence: `viewer/js/time.js`)
- Time controller → Time metadata: imports helpers (evidence: `viewer/js/time.js`)
- Time controller → Time controls: imports UI (evidence: `viewer/js/time.js`)
- Viewer interactions → Map and rendering: invokes map actions (evidence: `viewer/js/events.js`)
- Viewer interactions → Subset controller: invokes download (evidence: `viewer/js/events.js`)
- Viewer interactions → Portal and URL config: builds portal URL (evidence: `viewer/js/events.js`)
- Viewer interactions → Viewer DOM and status: updates status (evidence: `viewer/js/events.js`)
- Dataset menu → Dataset selection: selects dataset
- Dataset selection → THREDDS data service: fetches portal data (evidence: `README.md`)
- Map and rendering → THREDDS data service: requests map layers (evidence: `README.md`)
- Subset controller → Spatial drawing: uses drawing (evidence: `viewer/js/subsetting.js`)
- Subset controller → Subset indexes: uses indexes (evidence: `viewer/js/subsetting.js`)
- Subset controller → Subset logging: uses logging (evidence: `viewer/js/subsetting.js`)
- Subset controller → Subset download jobs: uses controller (evidence: `viewer/js/subsetting.js`)
- Subset download jobs → ncpartitioner service: submits jobs (evidence: `viewer/js/subsetting/download.js`)
- Subset download jobs → THREDDS data service: downloads files (evidence: `README.md`)
- Portal data visitor → Preparation workflow: runs preparation (evidence: `README.md`)
- Preparation workflow → Portal file patterns: uses definitions (evidence: `README.md`)
- Preparation workflow → ModelMeta query: exports ranges (evidence: `README.md`)
- Preparation workflow → Min-max calculation: calculates ranges (evidence: `README.md`)
- Preparation workflow → Metadata update script: builds metadata (evidence: `README.md`)
- Metadata update script → Metadata builder: invokes builder (evidence: `scripts/update-portal-meta.py`)
- Metadata builder → Metadata file I/O: loads and fingerprints (evidence: `portal_meta_builder/builder.py`)
- Metadata builder → NetCDF metadata reader: reads metadata (evidence: `portal_meta_builder/builder.py`)
- Metadata builder → Min-max lookup: selects ranges (evidence: `portal_meta_builder/builder.py`)
- Metadata builder → Portal menu rules: derives menu fields (evidence: `portal_meta_builder/builder.py`)
- Min-max calculation → ModelMeta query: uses exported ranges (evidence: `README.md`)
- Metadata builder → THREDDS data service: publishes viewer metadata (evidence: `README.md`)
