Verzoek tot opnemen constraints (SDIMEV-37, Welt 215)

[PB-GNM]

Janne Verstappen merkt op dat er op dit moment geen constraints in IMEV staan zoals min en max waarde of aantallen getallen achter de komma.
Die zullen dus nog geïnventariseerd moeten worden en verwerkt in het model.

Ook moet daarna nog uitgezocht worden hoe die vervolgens in het Json schema terecht komen.

Bijvoorbeeld het attribuut vermogen bij Windturbine.
Dat heeft nu kW als eenheid en Real als type. Kan dus zijn 1 maar ook 1,2 of 1,2344 etc
https://docs.geostandaarden.nl/imev/imev/#detail_attribute_IMEVBasis_Windturbine_vermogen

[PalmJanssen]

Voor 1.2 kunnen we denk ik beginnen met de opname van een aantal bekende constraints. Dan is het format en aanpak duidelijk.
Belangrijke model constraints die er nu niet instaan zijn ... nog afmaken

[PB-GNM]

In Enterprise Architect is dit wel aan te geven bij attributen. Hieronder een voorbeeld uit IMgeluid:

[PalmJanssen]

Zou relevant kunnen zijn voor attributen als: afstand, oppervlakte, inhoud, aantal, lengte, massa etc.
Hoe gaan we daar nu mee om. Is het een probleem? Zijn daar regels voor? Bijvoorbeeld aantal cijfers achter komma, maximum, minimum?

In MIM is dit nog niet anders gestandaardiseerd dan met een (OCL) constraint.
Er is een MIM wijzigingsvoorstel hiervoor: Geonovum/MIM-Werkomgeving#109
Indien dit nodig is, dat voorstel volgen

[PalmJanssen]

Aanleiding wijziging

In IMEV staat bij numerieke waarden alleen aangegeven of de waarde een Integer (geheel getal) of een Real (decimaal getal) is. Er staan geen andere invulvoorschriften (of constraints) voor numerieke waarden. Zoals bijvoorbeeld minimumwaarde, maximumwaarde, aantal cijfers achter de komma. Er kan dus op dit moment niet gevalideerd worden op deze invulvoorschriften.

Voorgestelde wijziging

Neem bij de kenmerken waar dat nodig is invulvoorschriften op in de vorm van constraints als minimum, maximum, aantal decimalen etc.

Er zijn zo'n 6 integer en 40 real waarden in IMEV. Ze komen voor bij typische kenmerken als afstand, oppervlakte, inhoud, aantal, lengte, massa etc.

Impactanalyse

Geef hier een indicatie van de impact van de wijziging:

• Wie gaat er wat van merken? dataprovider, REV, Softwareleveranciers
• Veranderen definities van objecten in de standaard zodanig dat de wijziging impact heeft op de uit te wisselen gegevens? Nee
• Heeft het impact op het json-schema? Nog niet bekend. Waarschijnlijk niet. De invulvoorschriften kunnen met validatieregels gecontroleerd worden
• Het heeft mogelijk impact op foutieve uitschieters in de data.
• X-, Y- of Z-wijziging: X of Y

Prioriteit

laag

Toelichting

Er zijn zo'n 6 integer en 40 real waarden in IMEV. Ze komen voor bij typische kenmerken als afstand, oppervlakte, inhoud, aantal, lengte, massa etc.
Er zijn een aantal aspecten:

• tot nu toe heeft gebrek deze specificaties en validatie daarop nog weinig problemen opgeleverd. Tenminste er is hier niets over bekend.
• in de omzetting naar REV worden waarden omgezet zoals ze zijn. Zijn daar invulvoorschriften toegepast?
• het is relatief veel werk om voor alle kenmerken met een numerieke waarde dit te specificeren en in software af te dwingen.

[PB-GNM]

Expertgroep:
Wat levert het op: datakwaliteit.
Geen harde noodzaak, maar wel wenselijk.
Vooral de eenheden zijn belangrijk.
Voorstel: niet voor komende versie maar voorbereiden voor volgende, want inventarisatie door experts is nodig.

[PB-GNM]

In de expertgroep van 17 mei is besloten om te adviseren om te wachten tot de inventarisatie van het minimum, maximum en het aantal getallen achter de komma per numerieke waarde is gedaan.
MeA vraagt bij de expertgroep REV wie dit kan doen en wanneer het gedaan kan worden.
Eerst zal er echter budget voor beschikbaar moeten komen.

[PB-GNM]

Adviesgroep 13-9-2023 heeft besloten deze wijziging nog niet door te voeren voor versie 2.0.
Eerst moet de bovengenoemde inventarisatie uitgevoerd worden.

[PB-GNM]

Hieronder staat een voorstel t.a.v. de lengte, minimale waarde en maximale waarde voor alle numerieke attributen.
De voorstellen zijn gebaseerd op metingen in het REV middels de WFS. Met de voorgestelde waarden in het IMEV zou het huidige REV geen herlevering nodig hebben, omdat alle ingevulde waarden in het REV passen binnen de voorgestelde ranges.

attribuut	type	lengte	meeteenheid	voorstel min	voorstel max	min gemeten	max gemeten	missing value %	klasse
aantalAutobussen	Integer	3	aantal	0	999	8	101	99,92	TankenCNG
aantalPersonenauto	Integer	3	aantal	0	999	10	300	99,91	TankenCNG
aantalKoelinstallaties	Integer	2	aantal	0	99	leeg	leeg	100,00	Machinekamer
afstand	Real	4,2	m	0	9999,99	0	1500	0,36	AfstandOfGeometrieAandachtsgebied of PRcontour
bovenkantbuis	Real	4,0	cm	-9999	9999	-1443	2485	75,26	BuisleidingReferentie
maximaleWerkdruk	Real	5,0	kPa	0	99999	0	99999	24,12	BuisleidingReferentie
wanddikte	Real	4,2	mm	0	9999,99	0	9999,99		BuisleidingReferentie
diameter	Real	4,0	mm	0	9999	0	9999,99		BuisleidingReferentie
diameter	Real	4,0	mm	0	9999	0	9999	17,70	Leiding
dampspanning	Real	7,0	mbar	0	9999999	leeg	leeg	100,00	OpslagSevesoHoeveelheidBuitenSevesoInrichting
doorzetPerJaar	Real	3,0	m3	0	999	12	2000000	15,06	OpslagtankPropaanPropeen_VasteAfstandVergunningplicht
doorzetPerJaar	Real	4,0	m3	0	9999	249	2500	6,65	TankenLPG
hoeveelheidVuurwerk	Real	6,0	kg	0	999999	50	166000	54,35	OpslagVuurwerkF1F2F3T1T2 of F4
kookTemperatuur	Real	5,2	Kelvin	0	99999,99	leeg	leeg	100,00	OpslagSevesoHoeveelheidBuitenSevesoInrichting
kritischeTemperatuur	Real	5,2	Kelvin	0	99999,99	leeg	leeg	100,00	OpslagSevesoHoeveelheidBuitenSevesoInrichting
mediaanLetaleConcentratie	Real	6,0	ppm	0	999999	leeg	leeg	100,00	OpslagSevesoHoeveelheidBuitenSevesoInrichting
nettoExplosieveMassa	Real	4,0	kg	0	9999	2	1500		OpslagOntplofbaarADR1.1Civiel
nettoExplosieveMassa	Real	4,0	kg	0	9999	37	700		OpslagOntplofbaarADR1.3Civiel
ontwerpCapaciteit	Real	5,0	Nm3/u	0	99999	4000	87000	9,48	BehandelenRegelenMetenAardgas_VasteAfstandGeenVergunningplicht
werktemperatuur	Real	4,2	Celsius	-273,15	99,99	-26	-5	37,50	AmmoniakKoelinstallatie_TeBerekenenAfstand
werktemperatuur	Real	4,2	Celsius	-273,15	99,99	-47	-4	22,62	AmmoniakKoelinstallatie_VasteAfstandVergunningplicht
werkdruk	Real	5,0	kPa	0	99999	800	10000		BehandelenRegelenMetenAardgas_VasteAfstandGeenVergunningplicht
aantalWindturbines	Integer	1	aantal	1	2	1	2	0,00	Windturbine_TeBerekenenAfstandGeenVergunningplicht
aantalWindturbines	Integer	3	aantal	3	999	1	93	0,00	Windturbine_TeBerekenenAfstandVergunningplicht
ashoogte	Real	3,2	m	0	999,99	3,9	166	15,49	Windturbine
breedteGondel	Real	2,2	m	0	99,99	1,21	1,21	99,97	Windturbine
hoogteGondel	Real	2,2	m	0	99,99	1,18	1,18	99,97	Windturbine
lengteGondel	Real	2,2	m	0	99,99	2,32	2,32	99,97	Windturbine
massaGondel	Real	5,0	kg	0	99999	200	2000	99,95	Windturbine
maxWerpafstandNominaal	Real	3,0	m	0	999	16	454	27,33	Windturbine
maxWerpafstandOvertoeren	Real	4,0	m	0	9999	102	716	27,82	Windturbine
nominaalToerental	Real	3,0	Hz	0	999	4,8	175	99,92	Windturbine
rotordiameter	Real	5,0	cm	0	99999	3,7	12000	15,51	Windturbine
vermogen	Real	5,0	KW	0	99999	5	12000	20,38	Windturbine
zwaartepunt	Real	3,2	m	0	999,99	2,77	2,77	99,97	Windturbine
oppervlakteDeuropening	Real	2,0	m2	0	99	1	8	98,63	Bewaarplaats
inhoud	Real	5,0	m3	0	99999	0	36000	61,45	OpslagReferentie
oppervlakte	Real	4,0	m2	0	9999	2	2501	99,15	OpslagReferentie
exactAantal	Integer	3	aantal	0	999	0	5000	0,11	BevoorradingCategorieOfExactAantal
exactAantalSeconden	Integer	3	aantal	0	999	0	9999	99,99	ReactietijdNoodstopBooleanOfExact
exacteHoeveelheid_kpa	Real	3,0	kPa	0	999	0	99999	99,99	VoordrukBooleanOfExact
populatie	Real	5,0	aantal	0	99999	0	999999	100,00	KwetsbaarGebouw
populatie	Real	6,0	aantal	0	999999	0	999999	100,00	KwetsbareLocatie

Het verzoek is aan alle domeinexperts om deze voorgestelde waarden te beoordelen en hieronder eventueel betere voorstellen te doen. Deze lijst is aangepast op basis van de expertbijeenkomst van 1-7-2024.

[PB-GNM]

Hieronder staat een voorstel t.a.v. de patronen voor alle string-attributen voor zover ze niet volledig vrij zouden moeten zijn en voor zover ze niet al opgenomen zijn. Het formeel patroon is volgens de reguliere expressie standaard. De voorstellen zijn gebaseerd op de bevindingen in het REV zoals opgevraagd middels de WFS.

klasse	attribuut	voorgesteld patroon	voorgesteld formeel patroon	bevinding in REV
BKLActiviteit	basisVergunningNummer	Vrij in te vullen veld tot 50 karakters.	.{1,50}	nummer en/of strings tot 44 karakters komen voor
ExterneVeiligheidsObject	bronobjectID	Vrij in te vullen veld tot 50 karakters.	.{1,50}	komt nog niet voor
KwetsbaarGebouw	kadastraleAanduiding	Combinatie van de volgende subdomeinen: KadastraleGemeentecode: een code waarmee een kadastrale gemeente wordt geïdentificeerd. Formaat AN5 (AAANN). KadastraleSectie: een code waarmee een deel van een kadastrale gemeente wordt geïdentificeerd. Formaat AN...2. KadastraalPerceelnummer: de nummering van een kadastraal perceel. Formaat N...5. KadastraleOnroerendeZaakIndexLetter: een code waarmee het type kadastrale onroerende zaak wordt aangegeven. Domein: A: appartement; B: beklemobject; D: deelperceel; G: geheel perceel. Formaat AN1. KadastraleOnroerendeZaakIndexNummer: een unieke aanduiding binnen het kadastraal peceel. Bij index letter G komt alleen nummer ""0000"" voor. Bij index letter B en D komen nummers ""0001""- ""9999"" voor. Bij index letter A komen nummers ""0000""- ""9999"" voor. Domein 0000 - 9999. Formaat N4."	[A-Z]{3}\d{2}[A-I,K-Z]{1,2}\d{5}[G][0]{4}	([A,B,D]\d{4})
KwetsbareLocatie	kadastraleAanduiding	Combinatie van de volgende subdomeinen: KadastraleGemeentecode: een code waarmee een kadastrale gemeente wordt geïdentificeerd. Formaat AN5 (AAANN). KadastraleSectie: een code waarmee een deel van een kadastrale gemeente wordt geïdentificeerd. Formaat AN...2. KadastraalPerceelnummer: de nummering van een kadastraal perceel. Formaat N...5. KadastraleOnroerendeZaakIndexLetter: een code waarmee het type kadastrale onroerende zaak wordt aangegeven. Domein: A: appartement; B: beklemobject; D: deelperceel; G: geheel perceel. Formaat AN1. KadastraleOnroerendeZaakIndexNummer: een unieke aanduiding binnen het kadastraal peceel. Bij index letter G komt alleen nummer ""0000"" voor. Bij index letter B en D komen nummers ""0001""- ""9999"" voor. Bij index letter A komen nummers ""0000""- ""9999"" voor. Domein 0000 - 9999. Formaat N4."	[A-Z]{3}\d{2}[A-I,K-Z]{1,2}\d{5}[G][0]{4}	([A,B,D]\d{4})
Documentatie	link	Liefst beginnend met https en maximaal 2048 omdat veel browsers langer niet aan kunnen.	.{1,2048}	lengte 700 komt voor in REV en 2048 is maximale lengte in Chrome en Explorer
SpoorVervoer	trajectcode	Minimaal 2 cijfers en maximaal 3	[0-9]{2,3}
WaterVervoer	watervakcode	Minimaal 1 hoofdletter en maximaal 4	[A-Z]{1,4}
WegVervoer	wegvakcode	Vrij in te vullen veld min 2 karakters maximaal 8 en altijd beginnend met 1 hoofdletter.	[A-Z]{1}.{1,7}	O43/O118 is de langst ingevulde
ExterneVeiligheidsObject	Bronhoudercode	De afkortingen van de bronhouders uitgedrukt in hoofdletter, minimaal 3 en maximaal 6.	[A-Z]{3,6}
ExterneVeiligheidsObject	Bronhouder	De naam van de bronhouder volledig uitgeschreven, gebruik makend van grote en kleine letters en en leesteken (streepje).	[A-Z][a-z][-]{1,100}

Het verzoek is aan alle domeinexperts om deze voorgestelde waarden te beoordelen en hieronder eventueel betere voorstellen te doen.

[PB-GNM]

n.a.v. de buisleidingexpert bijeenkomst van 8 juli is de lengte van wanddikte van 4,0 naar 4,2 gezet, omdat in de praktijk wanddiktes ook met 2 cijfers achter de komma in mm worden opgegeven.