verwerken issues over documentatie

docs/code_documentation/h/5.md

@@ -290,10 +290,6 @@ waarbij:
 
 3. In principe bestaat een lijnstijl voor een OBJECT met de STATUS V (Vervallen) uit het standaard lijnstijl voor dat OBJECT met een dubbele schrap ( // ) daar doorheen getekend.
 
-
-4. NLCS bevat een basisset lijnstijlen. Gebruikers, softwareontwikkelaars of toeleveranciers kunnen desgewenst eigen lijnstijl(-bibliotheken) toevoegen. Om te bewerkstelligen dat deze eigen lijnstijlen worden herkend door, en op de juiste wijze kunnen worden geplaatst met NLCS CAD-applicaties, moet de naamgeving ervan worden opgebouwd als in deze paragraaf is beschreven. De NLCS voorziet niet in het uitwisselen van eigen bibliotheken, houdt dan ook rekening met de mogelijke beperkingen in het uitwisselen van eigen bibliotheken tussen verschillende software applicaties. Bronbestanden dienen beschikbaar gesteld te worden indien eigen lijnstijlen buiten de organisatie toegepast dienen te worden.
-
-5. Lijnstijlen dienen herkenbaar te zijn volgens het uitgangspunt 5cm bij een plotschaal van 1:200, dit komt overeen met een objectlengte van 10m. 
 
 
 

docs/functionalspecification/h/3.md

@@ -1,71 +1,17 @@
-# Releases
+# Functionele werking NLCS
 
-### Release 4.0
-Op 1 november 2014 is release 4.0 van NLCS verschenen. Twee belangrijke toevoegingen rechtvaardigen deze release: 
-
-1.  de standaard is uitgebreid met ca. 400 lagen voor de Discipline PLANVORMING;
-2.  er is een koppeling gemaakt tussen de NLCS en de IMGEO-standaard, waardoor het mogelijk is geworden om een NLCS-tekening om te zetten naar een tekening conform de BGT (Basiskaart Grootschalige Topografie).
-
-#### Planvorming
-De NLCS is in eerste instantie ontwikkeld voor de ondersteuning van ontwerp en engineering van civiele projecten. Maar voordat er sprake is van een project, produceren onder andere gemeenten al veel tekenwerk. Zij maken bijvoorbeeld exploitatieplannen, verkavelingsplannen, matenplannen en inrichtingsplannen, veelal als nadere uitwerkingen of invullingen van bestemmingsplannen. Tot dusver werd dit type tekenwerk niet door NLCS ondersteund. Een belangrijke oorzaak daarvan is dat planvormingstekeningen doorgaans ‘vlakkentekeningen’ zijn, terwijl ontwerp- en engineeringstekeningen vooral worden opgebouwd als ‘lijnentekeningen’. Daarnaast worden in de planvormingsfase dikwijls andere objecten getekend dan in de ontwerp- en engineeringsfase van projecten. De NLCS voorzag daar nog niet in. De NLCS Werkgroep Planvorming, bestaande uit onder anderen vertegenwoordigers van de gemeenten Rotterdam, Hoorn, Zuidplas en Breda, heeft de standaard voor release 4.0 daarom uitgebreid met ruim 400 nieuwe lagen, die het maken van de genoemde planvormingstekeningen ondersteunen. De lagen zijn zodanig ingericht, dat er vlakkentekeningen mee kunnen worden gemaakt. Aanvullend kunnen planvormers gebruik maken van reeds bestaande lagen, symbolen en arceringen van de NLCS.
-
-Zeer veel van de toegevoegde objecten/lagen zijn verwant aan objecten/lagen die al in diverse Hoofdgroepen van NLCS waren opgenomen. Mede om doublures te voorkomen (objecten die op verschillende plaatsen voorkomen in de NLCS) zijn de nieuwe ‘planvormingslagen’ niet ondergebracht in een aparte Hoofdgroep, maar zijn ze ingepast in de reeds bestaande Hoofdgroepen. Met name de Hoofdgroep ONDERGRONDEN (OG) is hierdoor flink uitgebreid. Maar ook in diverse andere Hoofdgroepen zijn ‘planvormingslagen’ toegevoegd. Bijlage 2 van deze Formele Beschrijving NLCS biedt een overzicht van de lagen uit de diverse Hoofdgroepen die kunnen worden gebruikt binnen de Discipline PLANVORMING. 
-
-#### NLCS-IMGEO
-Nadat een project in de buitenruimte is afgerond, moet de gerealiseerde, nieuwe situatie worden verwerkt in de Basiskaart Grootschalige Topografie (BGT) volgens het IMGEO protocol. Dit is een wettelijke verplichting. De gebruikelijke werkwijze hiervoor is dat landmeters de nieuwe situatie ‘in het veld’ opmeten en de meetresultaten worden gedocumenteerd in een GIS-formaat dat geschikt is voor de BGT. In release 4.0 is in overleg met Geonovum (ontwikkelaar en beheerder van de IMGeo standaard) een aantal voorzieningen ingebouwd die het mogelijk maken om een NLCS-tekening as built automatisch om te zetten naar een volgens IMGeo/BGT opgebouwde objectenkaart. In bijlage 3 van deze Formele Beschrijving NLCS is beschreven hoe dit in zijn werk gaat en hoe een NLCS-tekening hierop moet worden voorbereid.
-
-Met deze toevoegingen in release 4.0 zijn de toepassingsmogelijkheden van de NLCS in de levenscyclus van civiele objecten fors uitgebreid, zoals is gevisualiseerd in de onderstaande figuur. 
-
-De NLCS is primair ontwikkeld voor het ontwerp, de engineering en de realisatie van civiele projecten tot en met het vervaardigen van as built tekeningen. In release 4.0 is daar aan de voorkant de ondersteuning van de Planvorming aan toegevoegd. Aan de achterkant is ondersteuning van de registratie van de as built situatie conform IMGEO/BGT toegevoegd. Hiermee is de NLCS tevens op verschillende detailniveaus toepasbaar voor ondersteuning van het beheer van objecten in de buitenruimte. Daarmee is de cirkel gesloten. 
-
-
-<figure>
-<img src="./h/media/levenscyclus.PNG" alt="NLCS ingetekend in de levenscuclus. Planvorming: toegevoegd in 4.0; Ontwerp & Engineering: Primaire domein NLCS; Registratie conform IMGEO/BGT: toegevoegd in 4.0; Beheer: NLCS toepasbaar voor ondersteuning">
-<figcaption>Toepasbaarheid van NLCS in de levenscyclus van objecten in de buitenruimte</caption>
-</figure>
-
-### Release 4.1
-Belangrijkste aanpassing in release 4.1 is, dat in diverse Hoofdgroepen in totaal enkele tientallen lagen, symbolen, arceringen en lijntypen zijn toegevoegd, die een nóg betere aansluiting mogelijk maken van de NLCS op IMGeo/BGT. Basis voor deze aanvulling is een grondige analyse die de gemeente Amsterdam heeft gemaakt ten behoeve van de mapping van de NCLS aan de BGT. De Projectgroep NLCS bedankt 
-Amsterdam voor de waardevolle input!
-
-Kleinere aanvullingen en wijzigingen zijn:
-  *  toevoeging van een STATUS ‘R’ (Revisie);
-  *  toevoeging van de Discipline ‘METEN’, voor bijvoorbeeld het verwerken van inmeet gegevens.
-  *  schrappen van de term ‘TOPOLOGIE’ in een groot deel van de laagnamen in de Hoofdgroep ONDERGROND;
-  *  aanvullingen en wijzigingen in de benamingen van maatvoering- en tekststijlen.
-
-Daarnaast zijn kleine onvolkomenheden in release 4.0 verholpen.
-
-
-Toelichting bij release 4.2
-Ten opzichte van release 4.1 zijn geen functionaliteiten toegevoegd. Wel zijn er foutjes in de database hersteld en zijn er verbeteringen doorgevoerd:
-*  doublures (objecten die twee keer in de database stonden) zijn verwijderd;
-*  een aantal symbolen is schaalbaar gemaakt;
-*  ontbrekende symbolen zijn toegevoegd en andere symbolen zijn aangepast.
-
-### Release 5.0
-In release 5.0 is de mapping met de BGT herzien en opgenomen in de database, zodat het importeren van BGT datasets een uniform resultaat opleveren. Hiervoor zijn onder andere ook lagen, symbolen, arceringen en lijntypen toegevoegd in de desbetreffende hoofdgroepen zodat de mapping van de BGT op NLCS gerealiseerd kon worden. Om deze mapping mogelijk te maken is zijn tevens de hoofdgroep IE en de bijbehorende symbolenbibliotheek op elkaar afgestemd. Dit heeft tot gevolg dat onderandere de bibliotheek voor borden, kasten, masten, palen, putten en sensoren zijn aangepast, daarnaast zijn ook generieke BGT symbolen opgenomen in de NLCS. 
-
-Naast de mapping met de BGT is ook een mapping tussen het GWSW (GegevensWoordenboek Stedelijk Water) en NLCS opgenomen in release 5.0. Vanuit Stichting Rioned wordt het thema Stedelijk Water op PDOK ontsloten. Eind 2021 zijn reeds 151 gemeenten en 6 waterschappen aangesloten op het GWSW. 
-Om deze mapping mogelijk te maken is tevens de hoofdgroep riolering afgestemd op het GWSW. Dit heeft op hoofdlijnen de volgende wijzingen tot gevolg: 
-*  AWZI wordt RWZI
-*  VWA wordt DWA
-*  SWA (Schoon Water Afvoer) vervallen 
-*  Onderscheid tussen rioolleiding en transportleiding (geen aansluitingen)
-*  Duikers toegevoegd
-
-Daarnaast zijn kleine onvolkomenheden in release 5.0 verholpen. Dit heeft geresulteerd in een kwaliteitslag met betrekking tot de bibliotheken  (arceringen, lijstijlen en symbolen). Hierbij is gecontroleerd op opbouw van de bronbestanden in de bibliotheek, volledigheid en juistheid van de toegepaste schaal. Om in de toekomst het versiebeheer van deze bibliotheken in goede banen te leiden is de database uitgebreid met definities van arceringen en lijnstijlen. Daarbij is het ook mogelijk om vanuit de database de bibliotheken te genereren zodat vanuit de bron de bestanden gegenereerd kunnen worden. 
-
-Naast de aanpassingen op de database en de bibliotheken is ook de Formele Beschrijving op een aantal vlakken aangepast. Op hoofdlijnen zijn de volgende wijzigingen doorgevoerd: 
-*  RD Stelsel 28992 gebruiken, let op sinds Autodesk release 2022 is een foute definitie van het EPSG: 28992 opgelost. Oudere versies van de software gebruiken tot op heden nog de foutieve definitie; 
-*  Aanpassingen hoofdgroepen in afstemming met de database. Daarnaast zijn ook de hoofdgroepen tbv beoogde uitbreiding Stedelijk Spoor (Installaties spoor, verkeerskunde spoor en Spoorbaan) meegenomen; 
-*  Uitgangspunt voor symbolen, lijnstijlen en arceringen standaard definities, indien afwijkend worden aanvullende definities voor de statussen B en V toegepast; 
-*  Naamgeving lijnstijlen aangepast in lijn met de andere bibliotheken;  
-*  Er zijn lijnstijlen met varianten opgenomen om zo bijvoorbeeld het onderscheid te kunnen maken tussen verschillende trottoirbanden in een tekening. Aangezien we nooit volledig kunnen zijn in lijn met catalogi van producenten en/of leveranciers hebben we gekozen voor het ondersteunen van varianten. Zo kan op de tekening altijd duidelijk onderscheid gemaakt worden tussen de verschillende objecten, zonder dat de afstemming met de NLCS noodzakelijk is. Zie bijlage 4 voor een overzicht van de voorkomende lijnstijl varianten. 	
-*  Eisen voor het opzetten van uitbreidingen van de standaard NLCS bibliotheken opgenomen;
 
+## Harmonicamodel
+NLCS geeft de mogelijkheid, om verschillende objecttypen samen op een laag te zetten, of om objecten per type op een laag te zetten.
 
 
+## Eigen bibliotheken
 
+### Eigen objecten
+NLCS bevat een basisset laagnemen om objecten te tekenen. Gebruikers, softwareontwikkelaars of toeleveranciers kunnen desgewenst eigen objecten(-bibliotheken) toevoegen. 
 
+### Eigen symbolen
+NLCS bevat een basisset symbolen. Gebruikers, softwareontwikkelaars of toeleveranciers kunnen desgewenst eigen symbolen(-bibliotheken) toevoegen. 
 
+### Eigen arceringen
+NLCS bevat een basisset arceringen. Gebruikers, softwareontwikkelaars of toeleveranciers kunnen desgewenst eigen arceringen(-bibliotheken) toevoegen. 

docs/functionalspecification/h/4.md

@@ -1,17 +1,71 @@
-# Licenties
+# Releases
 
+### Release 4.0
+Op 1 november 2014 is release 4.0 van NLCS verschenen. Twee belangrijke toevoegingen rechtvaardigen deze release: 
 
-## NLCS gegevens
-Alle data in de ontologie van NLCS worden uitgegeven onder de CC BY 4.0 licentie.
+1.  de standaard is uitgebreid met ca. 400 lagen voor de Discipline PLANVORMING;
+2.  er is een koppeling gemaakt tussen de NLCS en de IMGEO-standaard, waardoor het mogelijk is geworden om een NLCS-tekening om te zetten naar een tekening conform de BGT (Basiskaart Grootschalige Topografie).
+
+#### Planvorming
+De NLCS is in eerste instantie ontwikkeld voor de ondersteuning van ontwerp en engineering van civiele projecten. Maar voordat er sprake is van een project, produceren onder andere gemeenten al veel tekenwerk. Zij maken bijvoorbeeld exploitatieplannen, verkavelingsplannen, matenplannen en inrichtingsplannen, veelal als nadere uitwerkingen of invullingen van bestemmingsplannen. Tot dusver werd dit type tekenwerk niet door NLCS ondersteund. Een belangrijke oorzaak daarvan is dat planvormingstekeningen doorgaans ‘vlakkentekeningen’ zijn, terwijl ontwerp- en engineeringstekeningen vooral worden opgebouwd als ‘lijnentekeningen’. Daarnaast worden in de planvormingsfase dikwijls andere objecten getekend dan in de ontwerp- en engineeringsfase van projecten. De NLCS voorzag daar nog niet in. De NLCS Werkgroep Planvorming, bestaande uit onder anderen vertegenwoordigers van de gemeenten Rotterdam, Hoorn, Zuidplas en Breda, heeft de standaard voor release 4.0 daarom uitgebreid met ruim 400 nieuwe lagen, die het maken van de genoemde planvormingstekeningen ondersteunen. De lagen zijn zodanig ingericht, dat er vlakkentekeningen mee kunnen worden gemaakt. Aanvullend kunnen planvormers gebruik maken van reeds bestaande lagen, symbolen en arceringen van de NLCS.
+
+Zeer veel van de toegevoegde objecten/lagen zijn verwant aan objecten/lagen die al in diverse Hoofdgroepen van NLCS waren opgenomen. Mede om doublures te voorkomen (objecten die op verschillende plaatsen voorkomen in de NLCS) zijn de nieuwe ‘planvormingslagen’ niet ondergebracht in een aparte Hoofdgroep, maar zijn ze ingepast in de reeds bestaande Hoofdgroepen. Met name de Hoofdgroep ONDERGRONDEN (OG) is hierdoor flink uitgebreid. Maar ook in diverse andere Hoofdgroepen zijn ‘planvormingslagen’ toegevoegd. Bijlage 2 van deze Formele Beschrijving NLCS biedt een overzicht van de lagen uit de diverse Hoofdgroepen die kunnen worden gebruikt binnen de Discipline PLANVORMING. 
+
+#### NLCS-IMGEO
+Nadat een project in de buitenruimte is afgerond, moet de gerealiseerde, nieuwe situatie worden verwerkt in de Basiskaart Grootschalige Topografie (BGT) volgens het IMGEO protocol. Dit is een wettelijke verplichting. De gebruikelijke werkwijze hiervoor is dat landmeters de nieuwe situatie ‘in het veld’ opmeten en de meetresultaten worden gedocumenteerd in een GIS-formaat dat geschikt is voor de BGT. In release 4.0 is in overleg met Geonovum (ontwikkelaar en beheerder van de IMGeo standaard) een aantal voorzieningen ingebouwd die het mogelijk maken om een NLCS-tekening as built automatisch om te zetten naar een volgens IMGeo/BGT opgebouwde objectenkaart. In bijlage 3 van deze Formele Beschrijving NLCS is beschreven hoe dit in zijn werk gaat en hoe een NLCS-tekening hierop moet worden voorbereid.
+
+Met deze toevoegingen in release 4.0 zijn de toepassingsmogelijkheden van de NLCS in de levenscyclus van civiele objecten fors uitgebreid, zoals is gevisualiseerd in de onderstaande figuur. 
+
+De NLCS is primair ontwikkeld voor het ontwerp, de engineering en de realisatie van civiele projecten tot en met het vervaardigen van as built tekeningen. In release 4.0 is daar aan de voorkant de ondersteuning van de Planvorming aan toegevoegd. Aan de achterkant is ondersteuning van de registratie van de as built situatie conform IMGEO/BGT toegevoegd. Hiermee is de NLCS tevens op verschillende detailniveaus toepasbaar voor ondersteuning van het beheer van objecten in de buitenruimte. Daarmee is de cirkel gesloten. 
+
+
+<figure>
+<img src="./h/media/levenscyclus.PNG" alt="NLCS ingetekend in de levenscuclus. Planvorming: toegevoegd in 4.0; Ontwerp & Engineering: Primaire domein NLCS; Registratie conform IMGEO/BGT: toegevoegd in 4.0; Beheer: NLCS toepasbaar voor ondersteuning">
+<figcaption>Toepasbaarheid van NLCS in de levenscyclus van objecten in de buitenruimte</caption>
+</figure>
+
+### Release 4.1
+Belangrijkste aanpassing in release 4.1 is, dat in diverse Hoofdgroepen in totaal enkele tientallen lagen, symbolen, arceringen en lijntypen zijn toegevoegd, die een nóg betere aansluiting mogelijk maken van de NLCS op IMGeo/BGT. Basis voor deze aanvulling is een grondige analyse die de gemeente Amsterdam heeft gemaakt ten behoeve van de mapping van de NCLS aan de BGT. De Projectgroep NLCS bedankt 
+Amsterdam voor de waardevolle input!
+
+Kleinere aanvullingen en wijzigingen zijn:
+  *  toevoeging van een STATUS ‘R’ (Revisie);
+  *  toevoeging van de Discipline ‘METEN’, voor bijvoorbeeld het verwerken van inmeet gegevens.
+  *  schrappen van de term ‘TOPOLOGIE’ in een groot deel van de laagnamen in de Hoofdgroep ONDERGROND;
+  *  aanvullingen en wijzigingen in de benamingen van maatvoering- en tekststijlen.
+
+Daarnaast zijn kleine onvolkomenheden in release 4.0 verholpen.
+
+
+Toelichting bij release 4.2
+Ten opzichte van release 4.1 zijn geen functionaliteiten toegevoegd. Wel zijn er foutjes in de database hersteld en zijn er verbeteringen doorgevoerd:
+*  doublures (objecten die twee keer in de database stonden) zijn verwijderd;
+*  een aantal symbolen is schaalbaar gemaakt;
+*  ontbrekende symbolen zijn toegevoegd en andere symbolen zijn aangepast.
+
+### Release 5.0
+In release 5.0 is de mapping met de BGT herzien en opgenomen in de database, zodat het importeren van BGT datasets een uniform resultaat opleveren. Hiervoor zijn onder andere ook lagen, symbolen, arceringen en lijntypen toegevoegd in de desbetreffende hoofdgroepen zodat de mapping van de BGT op NLCS gerealiseerd kon worden. Om deze mapping mogelijk te maken is zijn tevens de hoofdgroep IE en de bijbehorende symbolenbibliotheek op elkaar afgestemd. Dit heeft tot gevolg dat onderandere de bibliotheek voor borden, kasten, masten, palen, putten en sensoren zijn aangepast, daarnaast zijn ook generieke BGT symbolen opgenomen in de NLCS. 
+
+Naast de mapping met de BGT is ook een mapping tussen het GWSW (GegevensWoordenboek Stedelijk Water) en NLCS opgenomen in release 5.0. Vanuit Stichting Rioned wordt het thema Stedelijk Water op PDOK ontsloten. Eind 2021 zijn reeds 151 gemeenten en 6 waterschappen aangesloten op het GWSW. 
+Om deze mapping mogelijk te maken is tevens de hoofdgroep riolering afgestemd op het GWSW. Dit heeft op hoofdlijnen de volgende wijzingen tot gevolg: 
+*  AWZI wordt RWZI
+*  VWA wordt DWA
+*  SWA (Schoon Water Afvoer) vervallen 
+*  Onderscheid tussen rioolleiding en transportleiding (geen aansluitingen)
+*  Duikers toegevoegd
+
+Daarnaast zijn kleine onvolkomenheden in release 5.0 verholpen. Dit heeft geresulteerd in een kwaliteitslag met betrekking tot de bibliotheken  (arceringen, lijstijlen en symbolen). Hierbij is gecontroleerd op opbouw van de bronbestanden in de bibliotheek, volledigheid en juistheid van de toegepaste schaal. Om in de toekomst het versiebeheer van deze bibliotheken in goede banen te leiden is de database uitgebreid met definities van arceringen en lijnstijlen. Daarbij is het ook mogelijk om vanuit de database de bibliotheken te genereren zodat vanuit de bron de bestanden gegenereerd kunnen worden. 
+
+Naast de aanpassingen op de database en de bibliotheken is ook de Formele Beschrijving op een aantal vlakken aangepast. Op hoofdlijnen zijn de volgende wijzigingen doorgevoerd: 
+*  RD Stelsel 28992 gebruiken, let op sinds Autodesk release 2022 is een foute definitie van het EPSG: 28992 opgelost. Oudere versies van de software gebruiken tot op heden nog de foutieve definitie; 
+*  Aanpassingen hoofdgroepen in afstemming met de database. Daarnaast zijn ook de hoofdgroepen tbv beoogde uitbreiding Stedelijk Spoor (Installaties spoor, verkeerskunde spoor en Spoorbaan) meegenomen; 
+*  Uitgangspunt voor symbolen, lijnstijlen en arceringen standaard definities, indien afwijkend worden aanvullende definities voor de statussen B en V toegepast; 
+*  Naamgeving lijnstijlen aangepast in lijn met de andere bibliotheken;  
+*  Er zijn lijnstijlen met varianten opgenomen om zo bijvoorbeeld het onderscheid te kunnen maken tussen verschillende trottoirbanden in een tekening. Aangezien we nooit volledig kunnen zijn in lijn met catalogi van producenten en/of leveranciers hebben we gekozen voor het ondersteunen van varianten. Zo kan op de tekening altijd duidelijk onderscheid gemaakt worden tussen de verschillende objecten, zonder dat de afstemming met de NLCS noodzakelijk is. Zie bijlage 4 voor een overzicht van de voorkomende lijnstijl varianten. 	
+*  Eisen voor het opzetten van uitbreidingen van de standaard NLCS bibliotheken opgenomen;
 
 
-## NLCS Documentatie
-De inhoud van GitHub met alle documentatie, de laagtabellen en de bestanden voor symbolen, arceringen en lijntypes  wordt uitgegeven onder de CC BY 4.0 licentie.
 
 
 
-## NLCS Query's
-De (voorbeeld) query's worden uitgegeven onder de MIT licentie.
 
-## NLCS Randsoftware
-De randsoftware (zoals de viewer) wordt uitgegeven onder de MIT licentie.