From ee95a54e4f70fd7f911e8a2cacfb342c85213937 Mon Sep 17 00:00:00 2001
From: Guilhem Moulin <guilhem@fripost.org>
Date: Tue, 11 Jun 2024 19:28:10 +0200
Subject: config.yml: Add field comments.

(Commented out for now since Bookworm has only GDAL v3.6.)
---
 config.yml | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

(limited to 'config.yml')

diff --git a/config.yml b/config.yml
index eb59fb0..e82dce5 100644
--- a/config.yml
+++ b/config.yml
@@ -236,19 +236,24 @@ layers:
     create:
       geometry-type: MULTIPOLYGON
       fields:
+        # https://www.lantmateriet.se/globalassets/geodata/geodataprodukter/pb-topografi-250-nedladdning-vektor.pdf
+        # 5.1.5 (tabell 5)
         - name: objektidentitet
           type: String
           subtype: UUID
           unique: true
           #width: 36
+          #comment: globalt unik identitet för generaliserat objekt
         - name: skapad
           type: DateTime
           #tz: local
+          #comment: tidpunkt när objektet ändrades
         - name: lanskod
           type: Integer
           subtype: Int16
           unique: true
           nullable: false
+          #comment: tvåsiffrig kod för län
     source:
       # https://www.lantmateriet.se/sv/geodata/vara-produkter/produktlista/topografi-250-nedladdning-vektor/
       cache: administrativindelning_sverige.zip
@@ -269,19 +274,24 @@ layers:
     create:
       geometry-type: MULTIPOLYGON
       fields:
+        # https://www.lantmateriet.se/globalassets/geodata/geodataprodukter/pb-topografi-250-nedladdning-vektor.pdf
+        # 5.1.6 (tabell 7)
         - name: objektidentitet
           type: String
           subtype: UUID
           unique: true
           #width: 36
+          #comment: globalt unik identitet för generaliserat objekt
         - name: skapad
           type: DateTime
           #tz: local
+          #comment: tidpunkt när objektet ändrades
         - name: kommunkod
           type: Integer
           subtype: Int16
           unique: true
           nullable: false
+          #comment: fyrsiffrig kod för kommun
     source:
       # https://www.lantmateriet.se/sv/geodata/vara-produkter/produktlista/topografi-250-nedladdning-vektor/
       cache: administrativindelning_sverige.zip
@@ -401,58 +411,73 @@ layers:
     create:
       geometry-type: MULTIPOLYGON
       fields:
+        # https://www.skogsstyrelsen.se/globalassets/sjalvservice/karttjanster/geodatatjanster/produktbeskrivningar/yttre-granser-for-avverkningsanmalda-omraden---produktbeskrivning.pdf
+        # ”Ett urval görs så att endast de som är < 5 år och inte avverkade visas. Max 80 %.”
         - name: OBJECTID
           type: Integer
           unique: true
           nullable: false
+          #comment: unik identitet
         - name: Beteckn
           type: String
           width: 12
           unique: true
           nullable: false
+          #comment: ärendebeteckning
         - name: ArendeAr
           type: Integer
           subtype: Int16
           nullable: false
+          #comment: år anmälan/ansökan registrerades
         - name: Avverktyp
           type: String
           width: 254
           nullable: false
+          #comment: vad anmälan/ansökan gäller
         - name: Skogstyp
           type: String
           width: 254
           nullable: false
+          #comment: anger om avverkning är inom fjällnära skog eller normal skog
         - name: Inkomdatum
           type: Date
           nullable: false
+          #comment: anmälan/ansökan inkom datum
         - name: AnmaldHa
           # XXX convert to m²?
           type: Real
           subtype: Float32
           nullable: false
+          #comment: areal anmält (ha)
         - name: SkogsodlHa
           type: Real
           subtype: Float32
           nullable: false
+          #comment: areal plantering (ha)
         - name: NatforHa
           type: Real
           subtype: Float32
           nullable: false
+          #comment: areal naturlig föryngring (ha)
         - name: AvvSasong
           type: String
           width: 254
           nullable: false
+          #comment: avverkningssäsong
         - name: ArendeStat
           type: String
           width: 254
           nullable: false
+          #comment: ärendestatus
         - name: AvvHa
           type: Real
           subtype: Float32
+          #comment: avverkad areal (ha)
         - name: Avverkning
           type: String
           width: 254
           nullable: false
+          #comment: Avverkningsamalan/NyAvverkningsanmalan
     source:
       download:
         url: 'https://geodpags.skogsstyrelsen.se/geodataport/data/sksAvverkAnm.zip'
@@ -487,59 +512,74 @@ layers:
     create:
       geometry-type: MULTIPOLYGON
       fields:
+        # https://www.skogsstyrelsen.se/globalassets/sjalvservice/karttjanster/geodatatjanster/produktbeskrivningar/utforda-avverkningar---produktbeskrivning.pdf
         - name: OBJECTID
           type: Integer
           # XXX there are duplicates(!?)
           #unique: true
           nullable: false
+          #comment: unik identitet
         - name: Beteckn
           type: String
           width: 12
           #unique: true
           # TODO: map "Visas ej" to NULL
           nullable: false
+          #comment: ärendebeteckning
         - name: ArendeAr
           type: Integer
           subtype: Int16
           nullable: false
+          #comment: år anmälan/ansökan registrerades
         - name: Avverktyp
           type: String
           width: 254
           nullable: false
+          #comment: vad anmälan/ansökan gäller
         - name: Skogstyp
           type: String
           width: 254
           nullable: false
+          #comment: anger om avverkning är inom fjällnära skog, ädellövskog eller normal skog
         - name: AnmaldHa
           type: Real
           subtype: Float32
           #nullable: false
+          #comment: areal anmält (ha)
         - name: SkogsodlHa
           type: Real
           subtype: Float32
           nullable: false
+          #comment: areal plantering (ha)
         - name: NatforHa
           type: Real
           subtype: Float32
           nullable: false
+          #comment: areal naturlig föryngring (ha)
         - name: Avvdatum
           type: Date
           nullable: false
+          #comment: datum för avverkning
         - name: KallaDatum
           type: Date
+          #comment: ursprung för datum för avverkning (vid ”Uppgift saknas” är det vanligen Skogsstyrelsens personal som registrerat datumet)
         - name: KallaAreal
           type: String
           width: 62
+          #comment: ursprung för areal avverkning (vid ”Uppgift saknas” är det vanligen Skogsstyrelsens personal som registrerat datumet)
         - name: Forebild
           type: String
           width: 62
+          #comment: namnet på den gamla bilden i skillnadsanalysen
         - name: Efterbild
           type: String
           width: 62
+          #comment: namnet på den nya bilden i skillnadsanalysen
         - name: ArealHa
           type: Real
           subtype: Float32
           nullable: false
+          #comment: areal för ytan (ha)
 
     sources:
       - source:
-- 
cgit v1.2.3