# homssalomssa/information-fusion-suite architecture

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

- Interactive diagram: https://gitdiagram.com/homssalomssa/information-fusion-suite
- Repository: https://github.com/homssalomssa/information-fusion-suite

## Overview

Possibility Fusion is an experimental QGIS Processing plugin that combines Sentinel-2 optical and Sentinel-1 radar change evidence into burned-area possibility maps. The user supplies pre/post rasters, acquisition dates, optional masks and scene parameters; the registered Processing algorithm prepares aligned inputs, derives sensor evidence, applies reliability and temporal handling, fuses evidence, and writes class and diagnostic rasters. The graph preserves documented optional masks and outputs. Algorithm-to-module links are supported by the source index; unsampled algorithm internals limit finer-grained call-flow claims.

Main entry points: [`possibility_fusion/algorithms/fuse_burned_area.py`](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/algorithms/fuse_burned_area.py) (Burned-area algorithm), [`possibility_fusion/core/possibility.py`](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/possibility.py) (Possibility fusion), [`possibility_fusion/plugin.py`](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/plugin.py) (Plugin lifecycle), [`possibility_fusion/provider.py`](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/provider.py) (Processing provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["QGIS entry"]
  node_plugin_lifecycle["Plugin lifecycle<br/>[plugin.py]"]
  node_provider["Processing provider<br/>[provider.py]"]
  node_algorithm["Burned-area algorithm"]
end

subgraph group_inputs["Input preparation"]
  node_acquisition["Acquisition metadata<br/>[acquisitions.py]"]
  node_sentinel["S2 calibration<br/>[sentinel.py]"]
  node_raster["Raster alignment and IO<br/>[raster.py]"]
  node_preprocessing["Mask and SAR prep<br/>[preprocessing.py]"]
  node_validation["Input validation<br/>[validation.py]"]
end

subgraph group_evidence["Evidence modeling"]
  node_indices["Optical dNBR<br/>[indices.py]"]
  node_memberships["Sensor memberships<br/>[memberships.py]"]
  node_temporal["Temporal reliability<br/>[temporal.py]"]
end

subgraph group_fusion["Fusion outputs"]
  node_possibility["Possibility fusion<br/>[possibility.py]"]
  node_result_rasters["Map and diagnostics"]
end

node_user(("QGIS user"))

node_user -->|"loads plugin"| node_plugin_lifecycle
node_plugin_lifecycle -->|"registers provider"| node_provider
node_provider -->|"registers algorithm"| node_algorithm
node_user -->|"runs processing"| node_algorithm
node_algorithm -->|"uses date detection"| node_acquisition
node_algorithm -->|"uses calibration"| node_sentinel
node_algorithm -->|"uses raster IO"| node_raster
node_algorithm -->|"uses preprocessing"| node_preprocessing
node_algorithm -.->|"validates inputs"| node_validation
node_algorithm -->|"derives optical change"| node_indices
node_algorithm -->|"forms sensor evidence"| node_memberships
node_algorithm -->|"applies temporal discount"| node_temporal
node_algorithm -->|"fuses evidence"| node_possibility
node_memberships -->|"normalizes memberships"| node_possibility
node_temporal -->|"discounts distributions"| node_possibility
node_algorithm -->|"writes result rasters"| node_result_rasters
node_result_rasters -->|"returns maps"| node_user

click node_plugin_lifecycle "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/plugin.py"
click node_provider "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/provider.py"
click node_algorithm "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/algorithms/fuse_burned_area.py"
click node_acquisition "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/acquisitions.py"
click node_sentinel "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/io/sentinel.py"
click node_raster "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/io/raster.py"
click node_preprocessing "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/preprocessing.py"
click node_validation "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/validation.py"
click node_indices "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/indices.py"
click node_memberships "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/memberships.py"
click node_temporal "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/temporal.py"
click node_possibility "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/possibility.py"
click node_result_rasters "https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/algorithms/fuse_burned_area.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_plugin_lifecycle,node_provider,node_algorithm,node_user toneBlue
class node_acquisition,node_sentinel,node_raster,node_preprocessing,node_validation toneAmber
class node_indices,node_memberships,node_temporal toneMint
class node_possibility,node_result_rasters toneRose
```

## Components

### QGIS entry

- [Plugin lifecycle](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/plugin.py): `possibility_fusion/plugin.py`
- [Processing provider](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/provider.py): `possibility_fusion/provider.py`
- [Burned-area algorithm](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/algorithms/fuse_burned_area.py): `possibility_fusion/algorithms/fuse_burned_area.py`

### Input preparation

- [Acquisition metadata](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/acquisitions.py): `possibility_fusion/core/acquisitions.py`
- [S2 calibration](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/io/sentinel.py): `possibility_fusion/io/sentinel.py`
- [Raster alignment and IO](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/io/raster.py): `possibility_fusion/io/raster.py`
- [Mask and SAR prep](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/preprocessing.py): `possibility_fusion/core/preprocessing.py`
- [Input validation](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/validation.py): `possibility_fusion/core/validation.py`

### Evidence modeling

- [Optical dNBR](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/indices.py): `possibility_fusion/core/indices.py`
- [Sensor memberships](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/memberships.py): `possibility_fusion/core/memberships.py`
- [Temporal reliability](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/temporal.py): `possibility_fusion/core/temporal.py`

### Fusion outputs

- [Possibility fusion](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/core/possibility.py): `possibility_fusion/core/possibility.py`
- [Map and diagnostics](https://github.com/homssalomssa/information-fusion-suite/blob/main/possibility_fusion/algorithms/fuse_burned_area.py): `possibility_fusion/algorithms/fuse_burned_area.py`

### Other components

- **QGIS user**

## Connections

- QGIS user → Plugin lifecycle: loads plugin
- Plugin lifecycle → Processing provider: registers provider (evidence: `possibility_fusion/plugin.py`)
- Processing provider → Burned-area algorithm: registers algorithm (evidence: `possibility_fusion/provider.py`)
- QGIS user → Burned-area algorithm: runs processing (evidence: `README.md`)
- Burned-area algorithm → Acquisition metadata: uses date detection (evidence: `possibility_fusion/algorithms/fuse_burned_area.py`)
- Burned-area algorithm → S2 calibration: uses calibration (evidence: `possibility_fusion/algorithms/fuse_burned_area.py`)
- Burned-area algorithm → Raster alignment and IO: uses raster IO (evidence: `possibility_fusion/algorithms/fuse_burned_area.py`)
- Burned-area algorithm → Mask and SAR prep: uses preprocessing (evidence: `possibility_fusion/algorithms/fuse_burned_area.py`)
- Burned-area algorithm → Input validation: validates inputs
- Burned-area algorithm → Optical dNBR: derives optical change (evidence: `possibility_fusion/algorithms/fuse_burned_area.py`)
- Burned-area algorithm → Sensor memberships: forms sensor evidence (evidence: `possibility_fusion/algorithms/fuse_burned_area.py`)
- Burned-area algorithm → Temporal reliability: applies temporal discount (evidence: `possibility_fusion/algorithms/fuse_burned_area.py`)
- Burned-area algorithm → Possibility fusion: fuses evidence (evidence: `possibility_fusion/algorithms/fuse_burned_area.py`)
- Sensor memberships → Possibility fusion: normalizes memberships (evidence: `possibility_fusion/core/memberships.py`)
- Temporal reliability → Possibility fusion: discounts distributions (evidence: `possibility_fusion/core/temporal.py`)
- Burned-area algorithm → Map and diagnostics: writes result rasters (evidence: `possibility_fusion/algorithms/fuse_burned_area.py`)
- Map and diagnostics → QGIS user: returns maps (evidence: `README.md`)
