-
-
-
Evidence-first GeoAI voor België en de Belgische Noordzee.
- -GeoIntel is een kaartgerichte GeoAI-workbench waarin officiële databronnen, -ruimtelijke analyse, PyTorch-computervisie, QA/QC en export samenkomen. Het -platform bewaart niet alleen een resultaat, maar ook de bron, ruimtelijke -context, modelversie en het bewijs waarmee dat resultaat gecontroleerd kan -worden. - -De release ondersteunt heel België en de juridisch onderscheiden Belgische -Noordzeezones. Regionale bronnen blijven herkenbaar: GRB, PICC, UrbIS en -maritieme datasets worden niet voorgesteld alsof ze dezelfde semantiek, -resolutie of actualiteit hebben. - -> **Data → ruimtelijke verwerking → AI-resultaat → kwaliteitsbewijs → export** - - - -## Waarom GeoIntel? - -Veel geoportalen tonen lagen. GeoIntel ondersteunt een volledige, -controleerbare analyseketen: - -- selecteer een officiële grens of teken een eigen Area of Interest; -- combineer vector-, raster- en historische bronnen met expliciete dekking; -- voer GIS- en CUDA-versnelde beeldanalyse uit; -- vergelijk kandidaatresultaten met referentiedata; -- inspecteer false positives, false negatives, overlap en provenance; -- exporteer alleen wat als reproduceerbaar resultaat is vastgelegd. - -Mol en de Kempen blijven de gouden regressiegebieden. De productgrens is heel -België plus de juridisch benoemde Belgische maritieme zones. - -## Product in beeld - -De onderstaande screenshots zijn rechtstreeks vastgelegd op de actuele -Unraid-productieomgeving. De gastmodus toont een beperkte, alleen-lezen -demowerkruimte; operatorfuncties en nieuwe analyses blijven afgeschermd. - -### Interactieve projectketen - -De landingspagina vertaalt de technische keten naar vier interactieve -schakels. De illustratie reageert op selectie, bronnen, analyse en bewijs en -respecteert automatisch `prefers-reduced-motion`. - - - - - -### Kaart als werkruimte - -De kaart blijft het primaire werkblad. Thema, broncontext, selectie en -resultaten zijn vanuit dezelfde ruimtelijke context bereikbaar. - - - -### Kwaliteit vóór resultaat - -QA/QC is een eerste-klas workflow. Bewaarde controles koppelen scores aan -objectbewijs, kandidaat- en referentielagen en technische provenance. - - - -### Mobiele werkruimte - -Dezelfde kaartgerichte workflow blijft bruikbaar op een smal scherm. Thema's, -selectieacties en de kaart worden gestapeld zonder de actieve werkcontext te -verbergen. - - - -## Kernmogelijkheden - -| Domein | Mogelijkheden | -| --- | --- | -| Werkgebieden | Officiële grenzen, vrije AOI-selectie, clipping en buffering | -| Bronnen | GeoJSON, vector, raster, orthofoto, historische en regionale catalogi | -| GIS | CRS-normalisatie, spatial joins, rasterstatistiek, tile- en selectieanalyse | -| GeoAI | PyTorch, Ultralytics YOLO en SAM-compatibele abstrahering | -| Tijd | Immutable DatasetVersions en vergelijking van ruimtelijke snapshots | -| QA/QC | Precision, recall, F1, IoU, false-positive/-negative evidence en reviews | -| Export | Reproduceerbare GeoJSON- en artefactexports met provenance | -| Runtime | DockerMan-native Unraid-container met PostGIS, backend en frontend | - -## Architectuur - -```mermaid -flowchart LR - UI["React + MapLibre workbench"] --> API["FastAPI contracts"] - API --> GIS["GeoPandas / Shapely / Rasterio"] - API --> JOBS["Job-queue in PostgreSQL"] - JOBS --> AI["PyTorch / YOLO / SAM"] - GIS --> DB[("PostgreSQL + PostGIS")] - AI --> DB - DB --> QA["QA/QC + provenance"] - QA --> UI - QA --> EXPORT["GeoJSON / artifacts"] -``` - -De publieke endpoints volgen [docs/API_CONTRACTS.md](docs/API_CONTRACTS.md). -PostGIS en de persistentieregels volgen -[docs/DATABASE_IMPLEMENTATION_PLAN.md](docs/DATABASE_IMPLEMENTATION_PLAN.md). - -## Stack - -- **Frontend:** React 18, TypeScript, MapLibre GL, Lucide en Vite -- **Backend:** FastAPI en Python -- **Spatial:** GeoPandas, Shapely, Rasterio, PyProj en GDAL -- **AI:** PyTorch, Ultralytics YOLO en SAM-compatibele segmentatie -- **Data:** PostgreSQL/PostGIS, lokale artefactopslag en immutable versions -- **Jobs:** job-tabel in PostgreSQL met achtergrondworkers in het API-proces -- **Deployment:** één DockerMan-native Unraid-container - -## Lokaal starten - -Vereisten: Python 3.11+, Node 20.19+ of 22.12+ en PostgreSQL/PostGIS. - -```bash -python -m pip install -e backend/.[dev] -cd frontend -npm install -npm run start -``` - -Voor de volledige lokale stack: - -```bash -docker compose up --build -``` - -Open daarna `http://localhost:1202`. - -### Gastdemo - -Met `GEOINTEL_GUEST_ACCESS_ENABLED=true` biedt de toegangspagina een -kortlevende, alleen-lezen demosessie. Die toont uitsluitend het ingestelde -demoproject en bewaard kwaliteitsbewijs; dit is geen multi-user- of -tenantisolatie. - -## NVIDIA/CUDA - -Productie-AI gebruikt de NVIDIA GPU van de server. De runtime faalt gesloten -wanneer CUDA vereist maar niet beschikbaar is; ontbrekende modelconfiguratie -wordt als `not_configured` getoond en nooit als geslaagde inferentie. - -De actuele productieproef draait met een CUDA-build van PyTorch op een NVIDIA -GeForce RTX 4080 SUPER. Corpus-, kalibratie-, test- en pure-background-gates -blijven gescheiden: een experimentele label- of modelvariant wordt pas actief -nadat alle toepasselijke kwaliteitscontroles slagen. - -Controleer GPU-zichtbaarheid in de container met: - -```bash -docker exec geointel nvidia-smi -``` - - - -## Training en labelkwaliteit - -GeoIntel behandelt officiële gebouwgrondvlakken niet automatisch als perfecte -daklabels. Voor trainingsdata worden temporele geldigheid, ruimtelijke leakage, -bronklasse, zichtbaarheid en pure-background-gedrag afzonderlijk gecontroleerd. -Een directe polygon-overlay maakt bovendien zichtbaar of de officiële geometrie -op het bijbehorende luchtbeeld aansluit vóór omzetting naar YOLO-boxen. - -De huidige V66 Vlaamse uitbreiding blijft kandidaatdata. Automatische SAM2- en -edge-alignmentproeven zijn afgewezen omdat ze nog vegetatie, wegen of schaduwen -als dak konden selecteren. Die resultaten zijn dus niet getraind of gepromoveerd. - -## Portfolio case study - -De presentatieklare case study combineert productvraag, interface, PyTorch- en -NVIDIA-keten, architectuur en resultaten in één visueel document: - -- [GeoIntel case study PDF](output/pdf/geointel-case-study.pdf) -- [Donkere cover in hoge resolutie](frontend/public/portfolio/geointel-dark-case-study-cover.png) -- [Architectuurvisual](docs/assets/portfolio/geointel-architecture.png) - -De PDF kan reproduceerbaar opnieuw worden opgebouwd met: - -```bash -python scripts/create_portfolio_case_study.py -``` - -## Kwaliteitscontrole - -```bash -# Backend -python -m compileall backend/app -cd backend && python -m pytest - -# Frontend -cd frontend -npm run typecheck -npm run test:unit -npm run build -``` - -Een wijziging is pas afgerond wanneer de toepasselijke criteria uit -[docs/DEFINITION_OF_DONE.md](docs/DEFINITION_OF_DONE.md) aantoonbaar zijn -afgevinkt. - -## Tower / Unraid deploy - -De canonieke checkout op Tower staat in `/mnt/user/appdata/geointel`. Gebruik -de releasewrapper; de productiecontainer wordt niet met een alternatieve -Compose-checkout vervangen. - -```powershell -powershell -ExecutionPolicy Bypass -File scripts/deploy_tower.ps1 ` - -RemoteHost root@