# roshni-07/weavia-adaptive-multi-model-weather-intelligence architecture

> Architecture diagram of the GitHub repository roshni-07/weavia-adaptive-multi-model-weather-intelligence, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence
- Repository: https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence

## Overview

WEAVIA is a weather-forecast intelligence product: it normalizes multiple forecast sources, learns context-sensitive trust, blends forecasts, estimates uncertainty, provides extreme-weather indicators, and verifies results against observations. The main user path is the command-center dashboard requesting forecast products through the API. The graph includes documented product capabilities and substantial indexed modules; edges for unsampled relationships are limited to README statements or source-index references, so it does not imply an unshown processing sequence.

Main entry points: [`backend/weavia/pipeline.py`](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/pipeline.py) (Forecast Pipeline), [`backend/weavia/api/main.py`](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/api/main.py) (Forecast API), [`weavia-frontend/components/Command.tsx`](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Command.tsx) (Command Center), [`backend/weavia/extremes.py`](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/extremes.py) (Extreme Products)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Forecast Inputs"]
  node_provider_contract["Provider Contract<br/>[base.py]"]
  node_openmeteo["Open-Meteo<br/>[openmeteo.py]"]
  node_synthetic_provider["Synthetic Provider<br/>[synthetic.py]"]
  node_synthetic_world["Synthetic Atmosphere<br/>[world.py]"]
  node_model_specs["Synthetic Model Specs<br/>[model_specs.py]"]
end

subgraph group_science["Forecast Science"]
  node_pipeline["Forecast Pipeline<br/>[pipeline.py]"]
  node_harmonize["Unit Harmonization<br/>[harmonize.py]"]
  node_features["Context Features<br/>[features.py]"]
  node_regime["Regime Detection<br/>[regime.py]"]
  node_trust["Adaptive Trust<br/>[trust.py]"]
  node_uncertainty["Forecast Uncertainty<br/>[uncertainty.py]"]
  node_verification["Verification<br/>[verify.py]"]
  node_imd["IMD Criteria<br/>[imd_criteria.py]"]
  node_locations["Stations and Regions<br/>[locations.py]"]
end

subgraph group_service["API and Products"]
  node_forecast_api["Forecast API<br/>[main.py]"]
  node_artifact_store[("Artifact Store<br/>[store.py]")]
  node_explanation["Explanation Builder<br/>[explain.py]"]
  node_extreme_products["Extreme Products<br/>[extremes.py]"]
  node_autopsy["Forecast Autopsy<br/>[autopsy.py]"]
end

subgraph group_interface["Dashboard"]
  node_dashboard["Command Center<br/>[Command.tsx]"]
  node_globe["Trust Globe<br/>[Globe.tsx]"]
  node_why["Forecast Reasons<br/>[Why.tsx]"]
  node_regime_ui["Regime View<br/>[Regime.tsx]"]
  node_models_ui["Model Skill<br/>[Models.tsx]"]
  node_extremes_ui["Extreme Guidance<br/>[Extremes.tsx]"]
  node_lab_ui["Weight Lab<br/>[Lab.tsx]"]
  node_ui_shared["Shared UI<br/>[ui.tsx]"]
  node_api_client["API Client<br/>[api.ts]"]
end

node_operator(("Forecaster"))

node_operator -->|"explores forecasts"| node_dashboard
node_dashboard -->|"requests products"| node_api_client
node_api_client -.->|"calls API"| node_forecast_api
node_forecast_api -->|"reads artifacts"| node_artifact_store
node_forecast_api -->|"builds reasons"| node_explanation
node_forecast_api -->|"serves indicators"| node_extreme_products
node_forecast_api -->|"serves autopsy"| node_autopsy
node_dashboard -->|"renders map"| node_globe
node_dashboard -->|"uses controls"| node_ui_shared
node_dashboard -->|"opens reasons"| node_why
node_operator -->|"inspects regimes"| node_regime_ui
node_operator -->|"reviews skill"| node_models_ui
node_operator -->|"checks extremes"| node_extremes_ui
node_operator -->|"tries weights"| node_lab_ui
node_pipeline -->|"creates synthetic data"| node_synthetic_world
node_synthetic_provider -->|"reads forecasts"| node_synthetic_world
node_synthetic_world -->|"uses error specs"| node_model_specs
node_pipeline -->|"fetches inputs"| node_synthetic_provider
node_pipeline -->|"uses provider interface"| node_provider_contract
node_openmeteo -->|"implements contract"| node_provider_contract
node_pipeline -->|"normalizes inputs"| node_harmonize
node_pipeline -->|"builds features"| node_features
node_pipeline -->|"detects regimes"| node_regime
node_pipeline -->|"learns weights"| node_trust
node_pipeline -->|"estimates uncertainty"| node_uncertainty
node_pipeline -->|"verifies forecasts"| node_verification
node_extreme_products -->|"applies criteria"| node_imd
node_extreme_products -->|"uses verification"| node_verification
node_extreme_products -->|"uses station regions"| node_locations
node_explanation -->|"explains weights"| node_trust
node_explanation -->|"reads artifacts"| node_artifact_store
node_forecast_api -->|"serves stations"| node_locations
node_openmeteo -.->|"fetches external data"| node_operator

click node_dashboard "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Command.tsx"
click node_globe "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Globe.tsx"
click node_why "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Why.tsx"
click node_regime_ui "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Regime.tsx"
click node_models_ui "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Models.tsx"
click node_extremes_ui "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Extremes.tsx"
click node_lab_ui "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Lab.tsx"
click node_ui_shared "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/ui.tsx"
click node_api_client "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/lib/api.ts"
click node_forecast_api "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/api/main.py"
click node_artifact_store "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/store.py"
click node_explanation "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/explain.py"
click node_extreme_products "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/extremes.py"
click node_autopsy "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/autopsy.py"
click node_pipeline "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/pipeline.py"
click node_provider_contract "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/providers/base.py"
click node_openmeteo "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/providers/openmeteo.py"
click node_synthetic_provider "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/providers/synthetic.py"
click node_synthetic_world "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/synthetic/world.py"
click node_model_specs "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/synthetic/model_specs.py"
click node_harmonize "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/harmonize.py"
click node_features "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/features.py"
click node_regime "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/regime.py"
click node_trust "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/trust.py"
click node_uncertainty "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/uncertainty.py"
click node_verification "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/verify.py"
click node_imd "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/imd_criteria.py"
click node_locations "https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/locations.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_provider_contract,node_openmeteo,node_synthetic_provider,node_synthetic_world,node_model_specs toneBlue
class node_pipeline,node_harmonize,node_features,node_regime,node_trust,node_uncertainty,node_verification,node_imd,node_locations toneAmber
class node_forecast_api,node_artifact_store,node_explanation,node_extreme_products,node_autopsy toneMint
class node_dashboard,node_globe,node_why,node_regime_ui,node_models_ui,node_extremes_ui,node_lab_ui,node_ui_shared,node_api_client toneRose
class node_operator toneIndigo
```

## Components

### Forecast Inputs

- [Provider Contract](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/providers/base.py): `backend/weavia/providers/base.py`
- [Open-Meteo](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/providers/openmeteo.py): `backend/weavia/providers/openmeteo.py`
- [Synthetic Provider](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/providers/synthetic.py): `backend/weavia/providers/synthetic.py`
- [Synthetic Atmosphere](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/synthetic/world.py): `backend/weavia/synthetic/world.py`
- [Synthetic Model Specs](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/synthetic/model_specs.py): `backend/weavia/synthetic/model_specs.py`

### Forecast Science

- [Forecast Pipeline](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/pipeline.py): `backend/weavia/pipeline.py`
- [Unit Harmonization](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/harmonize.py): `backend/weavia/harmonize.py`
- [Context Features](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/features.py): `backend/weavia/features.py`
- [Regime Detection](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/regime.py): `backend/weavia/regime.py`
- [Adaptive Trust](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/trust.py): `backend/weavia/trust.py`
- [Forecast Uncertainty](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/uncertainty.py): `backend/weavia/uncertainty.py`
- [Verification](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/verify.py): `backend/weavia/verify.py`
- [IMD Criteria](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/imd_criteria.py): `backend/weavia/imd_criteria.py`
- [Stations and Regions](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/locations.py): `backend/weavia/locations.py`

### API and Products

- [Forecast API](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/api/main.py): `backend/weavia/api/main.py`
- [Artifact Store](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/store.py): `backend/weavia/store.py`
- [Explanation Builder](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/explain.py): `backend/weavia/explain.py`
- [Extreme Products](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/extremes.py): `backend/weavia/extremes.py`
- [Forecast Autopsy](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/backend/weavia/autopsy.py): `backend/weavia/autopsy.py`

### Dashboard

- [Command Center](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Command.tsx): `weavia-frontend/components/Command.tsx`
- [Trust Globe](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Globe.tsx): `weavia-frontend/components/Globe.tsx`
- [Forecast Reasons](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Why.tsx): `weavia-frontend/components/Why.tsx`
- [Regime View](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Regime.tsx): `weavia-frontend/components/Regime.tsx`
- [Model Skill](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Models.tsx): `weavia-frontend/components/Models.tsx`
- [Extreme Guidance](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Extremes.tsx): `weavia-frontend/components/Extremes.tsx`
- [Weight Lab](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/Lab.tsx): `weavia-frontend/components/Lab.tsx`
- [Shared UI](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/components/ui.tsx): `weavia-frontend/components/ui.tsx`
- [API Client](https://github.com/roshni-07/weavia-adaptive-multi-model-weather-intelligence/blob/main/weavia-frontend/lib/api.ts): `weavia-frontend/lib/api.ts`

### Other components

- **Forecaster**

## Connections

- Forecaster → Command Center: explores forecasts (evidence: `README.md`)
- Command Center → API Client: requests products (evidence: `weavia-frontend/components/Command.tsx`)
- API Client → Forecast API: calls API (evidence: `README.md`)
- Forecast API → Artifact Store: reads artifacts (evidence: `backend/weavia/api/main.py`)
- Forecast API → Explanation Builder: builds reasons (evidence: `backend/weavia/api/main.py`)
- Forecast API → Extreme Products: serves indicators (evidence: `backend/weavia/api/main.py`)
- Forecast API → Forecast Autopsy: serves autopsy (evidence: `backend/weavia/api/main.py`)
- Command Center → Trust Globe: renders map (evidence: `weavia-frontend/components/Command.tsx`)
- Command Center → Shared UI: uses controls (evidence: `weavia-frontend/components/Command.tsx`)
- Command Center → Forecast Reasons: opens reasons (evidence: `README.md`)
- Forecaster → Regime View: inspects regimes (evidence: `README.md`)
- Forecaster → Model Skill: reviews skill (evidence: `README.md`)
- Forecaster → Extreme Guidance: checks extremes (evidence: `README.md`)
- Forecaster → Weight Lab: tries weights
- Forecast Pipeline → Synthetic Atmosphere: creates synthetic data (evidence: `backend/weavia/pipeline.py`)
- Synthetic Provider → Synthetic Atmosphere: reads forecasts (evidence: `backend/weavia/providers/synthetic.py`)
- Synthetic Atmosphere → Synthetic Model Specs: uses error specs (evidence: `backend/weavia/synthetic/world.py`)
- Forecast Pipeline → Synthetic Provider: fetches inputs (evidence: `backend/weavia/pipeline.py`)
- Forecast Pipeline → Provider Contract: uses provider interface (evidence: `backend/weavia/pipeline.py`)
- Open-Meteo → Provider Contract: implements contract (evidence: `backend/weavia/providers/openmeteo.py`)
- Forecast Pipeline → Unit Harmonization: normalizes inputs (evidence: `backend/weavia/pipeline.py`)
- Forecast Pipeline → Context Features: builds features (evidence: `backend/weavia/pipeline.py`)
- Forecast Pipeline → Regime Detection: detects regimes (evidence: `backend/weavia/pipeline.py`)
- Forecast Pipeline → Adaptive Trust: learns weights (evidence: `README.md`)
- Forecast Pipeline → Forecast Uncertainty: estimates uncertainty (evidence: `README.md`)
- Forecast Pipeline → Verification: verifies forecasts (evidence: `backend/weavia/pipeline.py`)
- Extreme Products → IMD Criteria: applies criteria (evidence: `backend/weavia/extremes.py`)
- Extreme Products → Verification: uses verification (evidence: `backend/weavia/extremes.py`)
- Extreme Products → Stations and Regions: uses station regions (evidence: `backend/weavia/extremes.py`)
- Explanation Builder → Adaptive Trust: explains weights (evidence: `backend/weavia/explain.py`)
- Explanation Builder → Artifact Store: reads artifacts (evidence: `backend/weavia/explain.py`)
- Forecast API → Stations and Regions: serves stations (evidence: `backend/weavia/api/main.py`)
- Open-Meteo → Forecaster: fetches external data
