# Analysis Engine

De Analysis Engine bevat alle reproduceerbare berekeningen. AI mag interpretaties schrijven, maar de cijfers komen uit deze engine.

## 1. BuildingAnalyzer

### Input

- gebouwpolygonen uit GRB, OSM of detecties
- analysegebied

### Output metrics

```json
{
  "building_count": 123,
  "building_area_total_m2": 45678.9,
  "building_density_per_km2": 87.2,
  "average_building_area_m2": 371.4,
  "built_ratio": 0.23
}
```

## 2. RoadAnalyzer

### Input

- wegvectoren
- analysegebied

### Output

- totale weglengte
- wegendichtheid
- verdeling per wegtype
- nabijheid tot hoofdwegen

## 3. RasterAnalyzer

### Input

- rasterdataset
- analysegebied

### Output

- metadata
- bounds
- resolutie
- bandstatistieken
- histogram
- nodata-percentage

## 4. VegetationAnalyzer

### Input

- NDVI-raster of vegetatiesegmentatie

### Output

- vegetatieoppervlakte
- vegetatiepercentage
- gemiddelde NDVI
- lage vegetatiegebieden
- hoge vegetatiegebieden

## 5. WaterAnalyzer

### Input

- waterpolygonen of NDWI-raster

### Output

- wateroppervlakte
- waterpercentage
- afstand tot water
- waterverandering later

## 6. DetectionAnalyzer

### Input

- detecties
- analysegebied

### Output

- aantal per klasse
- gemiddelde confidence
- confidence distributie
- oppervlakte per klasse indien polygonen beschikbaar
- detectiedichtheid

## 7. SegmentationAnalyzer

### Input

- mask/polygon segmentaties

### Output

- oppervlakte per klasse
- segment count
- gemiddelde confidence
- dekking binnen analysegebied

## 8. QAAnalyzer

### Input

- AI-output
- referentielaag
- IoU threshold

### Output

```json
{
  "true_positives": 100,
  "false_positives": 8,
  "false_negatives": 12,
  "precision": 0.9259,
  "recall": 0.8928,
  "f1": 0.9090,
  "mean_iou": 0.71
}
```

### Regels

- Een detectie matcht met een referentieobject als IoU >= threshold.
- Meerdere detecties op één referentieobject moeten gededupliceerd worden.
- Niet-gematchte detecties zijn false positives.
- Niet-gematchte referentieobjecten zijn false negatives.

## 9. ChangeAnalyzer

### Input

- analysis run A
- analysis run B

### Output

- added objects
- removed objects
- changed objects
- changed area
- change density

## 10. ScoreEngine later

Scores zijn niet de primaire focus voor de vacaturegerichte versie, maar kunnen later worden toegevoegd:

- Open Space Pressure Score
- Urban Expansion Score
- Nature Connectivity Score
- Water Resilience Score