geointel/docs/ANALYSIS_ENGINE.md

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

{
  "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

{
  "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