GeoDMS configuratie

GeoDMS-configuratie

De GeoDMS-kant van deze repo doet twee dingen die los van elkaar staan:

1. Spatial variabelen — de NVM-transactietabel inlezen, verrijken met omgevingskenmerken (bereikbaarheid, aantrekkelijkheid, groen) en weer als CSV exporteren voor de R-pipeline.
2. Regiokarakteristieken — uit diezelfde transacties afstandsgewogen gemiddelde woningkenmerken per woningtype berekenen, als 25m-rasters.

De geocodering zelf (adres → x/y + BAG-attributen) zit niet hier maar in de BAG-Tools-config (cfg/Geocode.dms aldaar).

Configstructuur

main.dms                        rootcontainer + ModelParameters + includes
main/
  Units.dms                     eenheden (meter, eur, min, jaar, *_t valuetypes)
  geography.dms                 rdc_5m/10m/25m/100m griddomains + afstandsmatrices
    Geography/Create_GridDomain_T.dms
    Geography/Distmatrices.dms
    Geography/ngr_layer.dms
  Classifications.dms           WP2/WP3/WP4/WP5, HouseCharacteristics, BAG-statussen
    Classifications/CBSKlasse2020.dms
    Classifications/LGNKlasse.dms
  SourceData.dms                includes van alle bronnen
    SourceData/NVM.dms          <- inlezen, verrijken, exporteren, regiokarakteristieken
    SourceData/Diversen.dms     UAI, reistijden
    SourceData/LGN.dms          groenfracties (natuur/landbouw/stadsgroen/water)
    SourceData/BGT.dms          BGT-groenfractie
    SourceData/BBG.dms          bodemgebruik, d_groennabij
    SourceData/RegioIndelingen.dms  CBS-gebiedsindelingen per jaar
    SourceData/bag.dms          BAG-domeinen en -jaren
  Analyse.dms                   (leeg; placeholder)
  ExportSettings.dms            metadata-XML naast elke export (git-hash, versies)
  ConfigSettings.dms            machineafhankelijke datamappen

main/Analyse.dms is bewust leeg — de analyse zit in de R-pipeline.

ModelParameters

Bovenin main.dms. Dit zijn de knoppen die je per run zet:

parameter	betekenis
nvm_filedate	versietag van de NVM-levering; moet gelijk zijn aan cfg$tag in R/00_config.R. Bepaalt de in- en outputbestandsnamen.
Regio_jaar	vintage van de CBS-gebiedsindelingen
LGN_year	LGN-vintage voor de groenfracties
BGT_file_date	BGT-vintage voor fr_groen_*
BAG_RecentYear, BAG_file_date	BAG-vintage
Hoogbouwgrens	15 m — grens waarboven een woongebouw hoogbouw heet (expert judgement PBL)

Het meest gemaakte foutje: nvm_filedate niet meeverhogen na een nieuwe R-run. Dan leest GeoDMS de vorige slim-CSV en koppelt R het resultaat op obsid's die niet meer bestaan.

Griddomains

geography.dms definieert Nederland (RD, EPSG:28992, x 0–280.000, y 300.000–625.000) op vier resoluties: rdc_5m, rdc_10m, rdc_25m, rdc_100m. Elke bron leeft op zijn eigen resolutie en de transacties koppelen erop via geometry[rdc_25m] e.d. (rdc_25m_rel, rdc_100m_rel, rdc_10m_rel in SourceData/NVM/Result).

Afstandsmatrices staan klaar per straal (pot100m … pot20250m) voor 25m en 100m: Geography/Distmatrices_25m/pot500m/Flat2 (gelijk gewicht binnen de straal) en .../rev_dist_scaled (afstandsverval). Die worden gebruikt door potential(...) in de groenfracties en de regiokarakteristieken.

Machineafhankelijke paden

Twee plekken zijn niet machine-onafhankelijk en moeten je per werkplek bijstellen:

• main/ConfigSettings.dms — RSo_DataDir (rasters uit RSopen) en PrivDataDir (output regiokarakteristieken). De OVSRV06-variant staat uitgecommentarieerd naast de OVSRV08-variant.
• main/SourceData/NVM.dms — dir, de OneDrive-map EnhancedData waar de slim-CSV in- en uitgaat. Ook hier staat de tweede machine als commentaar.

Draaien

Interactief in de GeoDMS GUI (main.dms openen), of headless per item:

GeoDmsRun.exe main.dms /SourceData/NVM/export_spatial/bestand

De belangrijkste items om te draaien:

item	levert
/SourceData/NVM/export_spatial/bestand	spatial-CSV voor de R-pipeline
/SourceData/NVM/RegionalAverages/per_WP_type/WP4/MakeRegionalAvgCharacteristics	20 regiokarakteristieken-tifs
/SourceData/NVM/RegionalAverages/per_WP_type/WP4/MakeNationalAvgCharacteristics	nationale gemiddelden (.fss)
/SourceData/LGN/Checks/rapport	celtellingen per groencategorie (sanity-check)
/SourceData/BGT/Checks/rapport	totalen BGT-groenoppervlak (sanity-check)

De checks schrijven naar %LocalDataDir%/PriceIndices/*.txt en zijn bedoeld om na een nieuwe LGN/BGT-vintage te bevestigen dat de klasse-indices nog kloppen (NL-land is ~54M cellen op 25m; landbouw ~50%, natuur ~15%, stadsgroen ~2-3%).

Metadata bij exports

ExportSettings.dms schrijft naast elke export een XML met GeoDMS-versie, gebruiker, machine, nvm_filedate én de git-status/-hash van de config (via git.txt in de projectmap). Dat is de manier om achteraf te achterhalen met welke configversie een raster is gemaakt.