KVAKK Brukerveiledning

Transkript

1 KVAKK Brukerveiledning Kvalitetskontroll av kartdata på SOSI-format 1-november-1999 Gyldig fra program versjon 2.2-F STATENS KARTVERK

2 Om brukerveiledningen Statens kartverk, IT-tjenestens dokument nr.: IT-R-0015/Rev. 2, 1-november-1999 Utgitt av Statens kartverk i samarbeid med Høgskolen i Gjøvik Sevicebox 15 N-3504 HØNEFOSS Telefon: Telefaks: Alle referanser til SOSI-standarden gjelder boken som Statens kartverk har laget i forbindelse med SOSI 2.2. Denne heter SOSI Et standardformat for digitale geodata versjon

3 IT-R-0015/Rev. 1 Side: i Innholdsfortegnelse Innholdsfortegnelse...i 1.Kort om KVAKK Hensikten med KVAKK Hva KVAKK gjør og ikke gjør KVAKK prosjektet Tilbakemeldinger Tillegg og endringer i versjonene Versjon 2.2-D Versjon 2.2-D Versjon 2.2-C Versjon 2.2-B KVAKK KVAKK Nye tester Ny filliste for definisjonsfiler Nytt i objektdefinisjonsfilene Diverse KVAKK SOSI 2.0/objektdefinisjoner Nye tester Bedre rapportering Fillister Brukerstyring OS/ Brukerønsker Installering Installasjon av 32-bits versjon Innkopiering av filer for 16-bits versjon... 8

4 IT-R-0015/Rev. 1 Side: ii 3.3 Filer som er kopiert inn Katalog for definisjonsfiler Minneshåndtering Oversikt over KVAKK Programmet Definisjonsfiler Kontroller Rapportering Rapportfil Logfil SOSI-rapport Bruk av kommandolinje Kommandolinjen Innfil Filliste Hvordan lage fillister Utfil Parameter brytere Formell formatsjekk Hodekontroll (Test 1.1) Multiple hoder (Test 1.2) Tegnsettkontroll (Test 1.3) Sluttkontroll (Test 1.4) Gruppevis Innholdssjekk Serienummer (Test 2.1) Område (Test 2.2) SOSI-nivå (Test 2.3) Nøyaktighet/enhet (Test 2.4) Høydeinformasjon (Test 2.5) SOSI-syntaks (Test 2.7) Knutepunktskontroll... 44

5 IT-R-0015/Rev. 1 Side: iii 8.1 Knutepunkt/noder (Test 3.1) Grupper som kan slås sammen (Test 3.2) Knyttbare punkter (Test 3.3) Flatekontroll Referanser (Test 4.1) Flater (Test 4.2) Representasjonspunkt (Test 4.3) Objektkontroll Objektkontroll (Test 5.1) Statistikk Objekter (Test 6.1.1) Antall punkt pr. linje/kurve (Test 6.1.2) Gjennomsnitt linjelengder (Test 6.1.3) Punkttetthet (Test 6.1.4) Punkter spesifisert på temakoder (Test 6.2.1) Kvalitetskoder (Test 6.3.1) Brukerdefinert statistikk (Test 6.3.2) Rapporter Hva er en rapportfil? Testrapport (*.txt) Lograpport (*.log) SOSI-rapport (*.s) Definisjonsfiler Hva er en definisjonsfil? Hvorfor definisjonsfiler? Definisjonsfilene til KVAKK Syntaksfiler (*.S??) Kodefiler (KODER.B??) Utvalgsregelfiler (UTVALG.R??) Objektdefinisjonsfiler (OBJEKTER.B??) Definisjonsfil-lister... 84

6 IT-R-0015/Rev. 1 Side: iv 14. Krav til maskinvare Vanlige feil på SOSI-filer Tegnsettfeil Ukjent gruppeinfo Koordinater Sære SOSI-filer Referanser "Gale" feilmeldinger SOSI-nivå Manglende koordinater Appendix A: Feilmeldinger/Advarsler Fatale feil (avbryter kontrollen) Feil Advarsler Programfeil under kjøring Appendix B: Eksempel på SOSI-fil Appendix C: FYBA SOSI-tolk Appendix D : Tilbakemeldings-blankett Appendix E : Kort om SOSI syntaks

7 IT-R-0015/Rev. 1 Side: 1 1.Kort om KVAKK 1.1 Hensikten med KVAKK KVAKK er en forkortelse for KVAlitets Kontroll av digitale Kartdata. Programmet kontrollerer digitale kartdata lagret på SOSI-formatet. Kontrollen består av feilkontroll (eks. syntakssjekk) og diverse statistikker. SOSI-formatet har etterhvert blitt mye brukt som utvekslingsformat mellom forskjellige kartsystemer. Dessuten benytter Statens kartverk SOSI som sitt primære lagringsformat. I takt med utbredelsen til SOSI-formatet har behovet for kvalitetskontroll meldt seg. På grunn av formatets frie form og avanserte muligheter inneholder SOSI-filer ofte feil. I tillegg er det viktig for kjøpere og leverandører av kartdata å kontrollere produktene ved kjøp og salg. Leverandør Kvalitets sikring Kvalitets kontroll Kunde 1.2 Hva KVAKK gjør og ikke gjør KVAKK kan pr. i dag teste SOSI-filer av versjon 1.4, 2.0, 2.1 og 2.2. I tillegg til en syntakssjekk kontrollerer programmet knutepunkter, flater/referanser og objekter/tema. Det er også inkludert en del statistikker slik at brukeren skal kunne få et inntrykk av hvilke data som filen inneholder. KVAKK kontrollerer ikke stedfestingsnøyaktighet internt/eksternt. Det finnes andre programmer på markedet som kan gjøre dette. NB! Dersom KVAKK ikke gir feilmeldinger, betyr det at det ikke finnes feil av de typene KVAKK tester mot. Selv om KVAKK "vet" om og kontrollerer mange typer feil, kan det tenkes at det slippes ting igjennom som burde ha vært påpekt. Vi håper på et godt samarbeide med brukerne med tanke på å gjøre kontrollene til KVAKK så fullstendige som mulig. KVAKK er tenkt som et rent kontroll program, og retter derfor ikke SOSI-filer. Brukeren kan selv rette SOSI-filer på grunnlag av testrapportene KVAKK lager hvis det er ønskelig.

8 IT-R-0015/Rev. 1 Side: KVAKK prosjektet Programmet utvikles og vedlikeholdes av Statens kartverk i samarbeide med Høgskolen i Gjøvik. KVAKK er den fjerde versjonen av programmet som er gjort tilgjengelig for brukerne. KVAKK startet som et FOU-prosjekt ved, den gang Gjøvik Ingeniørhøgskole høsten-91. Versjon 1.0 ble utviklet som hovedoppgave våren-92 av studentene Ole Gunnar Eggen, Jenni R. Olason og Lars Tungen. Veiledere var Hilding Sponberg og Erling Onstein. Sommeren og høsten-92 ble Lars Tungen engasjert som programmerer for å lage versjon 2.0 av programmet, sammen med Erling Onstein som veileder. Det videre arbeidet rundt KVAKK har vært organisert av Statens kartverk i samarbeid med en egen styringsgruppe. Styringsgruppa har bestått av personell fra Kartverket og Høgskolen i Gjøvik. Selve programmeringsarbeidet er gjort av PUMATEC A/S, mens arbeidet med parameterfilene er gjort av SOSI-sekretariatet. I forbindelse med utgivelsen av SOSI 2.2 og på grunnlag av tilbakemeldinger fra brukere er KVAKK versjon utviklet. Forbedringene er beskrevet i de enkelte kapitler utover. 1.4 Tilbakemeldinger Under utviklingen av KVAKK har en rekke personer hjulpet til med å teste programmet, og kommet med forslag til forbedringer og endringer. Vi håper på et fortsatt samarbeide med brukere av KVAKK. Forslag til forbedringer vil bli tatt hensyn til så langt det lar seg gjøre. For å påpeke feil/mangler i KVAKK, vennligst fyll ut blankett i appendiks D bak i denne boka, og legg gjerne ved utskrift av rapporter og evt. SOSI-filen på diskett. Ønsker og kommentarer sendes pr. post/telefax til: Statens kartverk SOSI-sekretariatet Kartverksveien HØNEFOSS

9 IT-R-0015/Rev. 1 Side: 3 Fax nr.: Tlf nr.:

10 IT-R-0015/Rev. 1 Side: 4 2.Tillegg og endringer i versjonene Dette avsnittet gir en oversikt over de tillegg og endringer som er kommet i de ulike versjonene av KVAKK, fra og med versjon 2.0. fillister logfil topologi knutep. Sosi 2.0 OS/2 2.1 Versjon 2.2-F Denne versjonen tolerer filer med SOSI-versjon 3.1, dvs. filene går i gjennom, men vil ikke bli sjekket mot standarden. Forøvrig er tegnsetthåndtering forbedret, se under. Noen av rapportene er blitt mer komprimerte. Se ellers statuslisten. 2.2 Versjon 2.2-D Denne versjonen tolerer filer med SOSI-versjon 3.0, dvs. filene går i gjennom, men vil ikke bli sjekket mot standarden. Forøvrig er tegnsetthåndtering forbedret, se under. NB! Når tegnsett ikke er gitt i fil-hodet, benyttes ISO (standard windows), og egendefinerte definisjonsfiler må være skrevet i dette tegnsettet. 2.3 Versjon 2.2-C Versjonen ble etablert fordi KVAKK 2.2-B ikke hånderte bruk av filliste. 2.4 Versjon 2.2-B Denne versjonen støtter SOSI-versjoner til og med versjon I tillegg er en del feil rettet, ref. statuslisten.

11 IT-R-0015/Rev. 1 Side: KVAKK KVAKK er oppdatert til å teste data produsert etter SOSI-versjon 2.2. Til dette er det laget et nytt sett med definisjonsfiler. KVAKK støtter nå Windows 3.1/3.11 og Windows 95/NT. MS/DOS er ikke lenger støttet av KVAKK p.g.a minnebegrensingene i MS/DOS. Det er laget et eget skallprogram for Windows versjonene, kalt KVAKKWIN. Dette programmet letter bruken av programmet for en vanlig bruker. Det inneholder et utplukk av opsjoner som kan gis inn til KVAKK. For en mer avansert bruker, må opsjonen settes på kommandolinjen til KVAKK som tidligere. I tillegg er følgende egenskaper er lagt inn: FKB-kontroll er endret til objektkontroll. Dette betyr at kommandolinje-parameteret "/fkb" er endret til "/obj" og at en del utskrifter til skjerm og rapporter er endret. Ny feilmelding: "2030 <element> er et ulovlig element for denne SOSI-versjonen" KVAKK sjekker ikke lenger navn på innfil for å skille mellom filliste og SOSI-fil. Benytt "@" foran innfil for å angi filliste. Dette er gjort for å unngå at fillister må ha filnavnforlengelsen ".fil". Installerings prosedyren er endret (se brukerveiledningen). Feil som gjorde at enhet ble skrevet ut som 0.0 på rapportfila er rettet. Feil som gjorde at programmet krasjet hvis SOSI-fila inneholdt store serienummer er rettet. Programmet avslutter nå med en feilmelding. 2.6 KVAKK 2.1 KVAKK kan nå også teste data produsert etter SOSI-versjon 2.1. Til dette er det laget et nytt sett med definisjonsfiler Nye tester Høydetesten (test 5.1) er omarbeidet, og ny test er lagt inn under høydekontroll, slik at KVAKK nå tester på negative høyder (ny test 2.5.4) og gir ut statistikk på hvor mange objekter som har negativ høyde. Det er lagt inn en ny statistikk-rutine med summering av objekter på grunnlag av brukerspesifiserte attributter (ny test 6.3.2). Attributt som det ønskes statistikk over, angis med kommandobryter /klassginfo, se kap 5.6.

12 IT-R-0015/Rev. 1 Side: Ny filliste for definisjonsfiler Det er nå mulighet for å dele objektdefinisjoner (*.Bxx), utvalgsregler (*.Rxx), kodedefinisjoner (*.Bxx) og syntaksdefinisjoner (*.Sxx) på flere filer. Navnene på disse filene skal legges inn i filene DEFFILER.L22 (SOSI 2.2), DEFFILER.L21 (SOSI 2.1), DEFFILER.L20 (SOSI 2.0) eller DEFFILER.L14 (SOSI 1.4). Se ellers kap Nytt i objektdefinisjonsfilene To nye basiselement er lagt inn (..ALIASNAVN og..inkluder). Se nærmere beskrivelse kap KVAKK 2.1 kontrollerer gruppeinformasjon mot KAN-definisjoner, og ikke bare mot MÅ-definisjoner som tidligere. Dette fører til at objektdefinisjonsfilene også må være fullstendige med hensyn på hvilke egenskaper objektene kan inneholde Diverse KVAKK vil nå som standard spesifisere feilmeldinger på serienummer. Hvis man vil redusere omfanget av feilmeldingene kan man isteden få summert sammen feilmeldingene ved å benytte kommandobryter /noref. Det er også lagt inn en ny bryter for å kunne slå på tester, /p. Dette gjør at en har bedre muligheter til å kjøre enkelt-tester. For nærmere forklaring, se kap KVAKK SOSI 2.0/objektdefinisjoner Den største nyheten i KVAKK 2.0 er at programmet nå kan teste SOSI 2.0 filer. Dette innebærer at programmet også kan håndtere de nye SOSI-objektene. Objektdefinisjoner var en av de store nyhetene i SOSI 2.0, og det ble derfor lagt vekt på at KVAKK skulle kunne håndtere disse tidligst mulig Nye tester En del nye tester har kommet til i KVAKK 2.0. Disse går i hovedsak på SOSI-nivå 3 (knutepunkt) og SOSI-nivå 4 (flater). Disse kontrollene er en blanding mellom feilkontroll og statistikk, og de vil kunne gi et inntrykk av hvor godt data på filen er knyttet sammen Bedre rapportering Rapporteringsdelen av KVAKK har også blitt forbedret. I tillegg til den vanlige rapportfilen vil programmet nå lage en kortfattet rapportfil (logg fil), der bare de alvorligste feil vil bli

13 IT-R-0015/Rev. 1 Side: 7 nevnt. Det er også en mulighet for å få generert en kommentert SOSI-fil som inneholder underkjente grupper og en del oversikter. Denne muligheten kan være god å ha i de tilfeller der det er vanskelig å få hentet SOSI-filen opp i en editor Fillister KVAKK godtar nå fillister som innfil. En filliste er en tekstfil der navnene på filer som skal testes er oppgitt, ett navn på hver linje. Fillister gjør det mulig å teste flere filer i en kjøring av programmet (batch kjøring). NB! Det har vært noe problem med minneshåndteringen ved bruk av fillister. Det er derfor å anbefale heller å bruke operativsystemets muligheter til å sette opp kommandofiler. I ei slik kommandofil kan en legge inn så mange KVAKK-kjøringer en ønsker Brukerstyring Muligheten for å spesifisere hvilke tester som skulle utføres på SOSI-fila var begrenset i versjon 1.0. Dette er nå blitt endret. Brukeren kan nå styre dette med nye parameter-brytere på kommandolinja OS/2 KVAKK tilgjengelig for OS/ Brukerønsker Tilbakemeldinger fra brukere har ført til en del mindre endringer av programmet. En del feil fra versjon 1.0 er rettet, og tester har blitt omgruppert eller flyttet på.

14 IT-R-0015/Rev. 1 Side: 8 3.Installering 3.1 Installasjon av 32-bits versjon Installer CD en eller diskett enn og kjør programmet SETUP.EXE. Programmet pakker ut alle filer til tilhørende kataloger og oppdaterer nødvendige programstier. 3.2 Innkopiering av filer for 16-bits versjon For å kunne teste SOSI-filer av normal størrelse, må KVAKK installeres på en harddisk (platelager). Dette gjøres ved å opprette en katalog på harddisken og kopiere filene fra distribusjonsdisketten til katalogen. På installasjons disketten ligger følgende filer: Filnavn DEFFILER.TXT LESMEG.TXT Kommentar ASCII tekstfil som inneholder informasjon om definisjonsfilene som er levert med. ASCII tekstfil som inneholder informasjon om installasjon av programmer og definisjonsfiler. EXEW16.ZIP Exe-fil for Windows 3.1/3.11 KVAKK.ZIP KVAKK filer som er felles for alle operativsystemene som KVAKK støtter. Eksempel på installasjon av KVAKK for Windows 3.1/3.11 fra kommandolinje: C:\>MD KVAKK C:\>CD KVAKK C:\KVAKK>PKUNZIP a:exew16 C:\KVAKK>PKUNZIP -d a:kvakk

15 IT-R-0015/Rev. 1 Side: Filer som er kopiert inn Når KVAKK er installert vil følgende filer ligge i programkatalogen og dens underkataloger: Filnavn KVAKK.EXE KVAKKWIN.EXE KVAKKWIN.HLP KVAKKWIN.INI DOC\VEILEDN.DOC DOC\DEFFILER.TXT DOC\STATUS.DOC ENV\KVAKK.BAT ENV\KVEG3S22.BAT Selve kontrollprogrammet. Kommentar Windows skall program for KVAKK (gjelder bare Windows versjonene) Hjelp fil for KVAKKWIN (gjelder bare Windows versjonene) Initialiseringsfil for KVAKKWIN. For 32-bits versjonen blir denne kopiert direkte inn på C:\WINDOWS, mens dette må gjøres manuelt for 16-bits versjonen. Det herværende dokument på Word-format. ASCII tekstfil som inneholder informasjon om definisjonsfilene som er levert med. KVAKK statusliste på Word format. Eksempel på.bat-fil for kjøring direkte under MS/DOSprompt. Eksempel på.bat-fil for kjøring direkte under MS/DOSprompt. Denne satsfilen viser bruk av alternative definisjoner og opsjonsbrytere for å slå av og på forskjellige delkontroller. For Windows versjonene av KVAKK følger det med et skall program, KVAKKWIN som gjør programmet enklere å bruke. Hvis du ønsker at dette programmet skal være tilgjengelig fra skrivebordet i Windows må du legge inn ikonet i en program gruppe. Se i Windows dokumentasjonen om hvordan du skal gjøre dette. 3.4 Katalog for definisjonsfiler Alle definisjonsfilene (se kap 13 - Definisjonsfiler) kan om ønskelig legges på en annen katalog enn \KVAKK. Hvilken katalog programmet skal lete etter definisjonsfiler på, bestemmer en med variabelen "KVAKKSTI". Denne må defineres før programmet starter. Dersom en alltid bruker de samme definisjonsfilene, kan en definere KVAKKSTI i oppstartprosedyren for maskinen en arbeider med.

16 IT-R-0015/Rev. 1 Side: 10 Dersom KVAKKSTI ikke blir definert, vil programmet lete etter definisjonsfiler på den katalogen programmet startes fra. For 32-bits versjon under Windows 95 og NT defineres dette automatisk i I System i Kontrollpanelet ved kjøring av installasjonsprogrammet. For 16-bits versjonen må denne defineres ved å legge inn: SET KVAKKSTI = C:\KVAKK\DEF i AUTOEXEC.BAT. KVAKK da alltid lete etter definisjonsfiler på katalog \KVAKK\DEF. 3.5 Minneshåndtering Det er gjort en god del forbedringer med dette etter versjon 2.0. KVAKK tilordner minne fra primærområdet (de første 640kB) etter hvert som det behøves. En kan derfor oppleve at programmet etter lengre tids kjøring, stopper med feilmelding For lite minne. Avslutter. Dersom en får denne feilmeldingen, bør en prøve å frigjøre mer minne før en prøver på nytt. KVAKK leser inn en og en gruppe i minnet. Ved store SOSI-grupper kan dette gi problem, i alle fall under DOS. Versjon 2.1 er testet med grupper på over 5000 koordinater uten å stoppe. (5000 koordinater pr SOSI-gruppe bør være vesentlig over det som er normalt) Under objektkontrollen leses utvalgsfila inn i minnet, men feilmeldinger blir lagt ut på temporær-filer under kjøring. I Statistikkdelen trengs også utvalgsfila i minnet, samtidig som summeringstabellene ligger "inne". Dette kan gi problem dersom en har stor utvalgsfil og mange forskjellige objekttyper (gir lange statistikk-tabeller). Se ellers kap 14. Krav til maskinvare og beskrivelse av "Programfeil under kjøring" sist i Appendix A.

17 IT-R-0015/Rev. 1 Side: Oversikt over KVAKK 4.1 Programmet KVAKK er som tidligere nevnt et program for å teste SOSI-filer. Det finnes både Windows versjoner og en OS/2 versjon, men funksjonen er lik for alle versjonene. Programmet startes på operativsystemets klarmelding/kommandolinje ved å skrive KVAKK <evt. parametere> <ENTER>. Forklaring til lovlige parametere og deres bruk finner du i kapittel 5. Bruk av kommandolinje. Skjermen kan f.eks se slik ut når programmet startes: KVALITETSKONTROLL AV DIGITALE KARDATA versjon Des for Win NT/ Statens kartverk i samarbeide med Høgskolen i Gjøvik Definisjonsfiler leses fra C:\KVAKK\DEF\ <filnavn> FORMELL FORMATSJEKK 20.0% utført. (Gruppe: 0) Inn og ut av KVAKK:

18 IT-R-0015/Rev. 1 Side: 12 Tekstdatabaser Sosifil parameter fra brukeren Inn KVAKK Logfil Rapport Sosirap. Ut 4.2 Definisjonsfiler For at KVAKK skal være fleksibelt benytter programmet seg av en del definisjonsfiler. En definisjonsfil er en tekstfil som inneholder definisjoner som KVAKK benytter seg av under kontroll av SOSI-filer. Du kan redigere disse filene i en teksteditor og dermed tilpasse programmet til dine behov. Men vær forsiktig da søppel inn vil gi søppel ut. Les mer om definisjonsfiler i kapittel 13. Definisjonsfiler. 4.3 Kontroller Kontrollene som KVAKK utfører er delt inn i grupper og gitt hvert sitt nummer. Programmet vil lese igjennom SOSI-fila en gang for hver testgruppe. Inndeling av tester: Formell Formatsjekk Gruppevis innholdssjekk Knutepunkt kontroll Flate-kontroll Objekt-/egenskapskontroll (FKB/objektkatalog) Statistikk

19 IT-R-0015/Rev. 1 Side: Rapportering Når programmet er ferdig vil resultatet av kontrollen bli lagt på forskjellige tekstfiler. De to viktigste rapportene er rapportfilen og logfilen. I tillegg kan du velge om du vil ha ut en kommentert SOSI-fil, også kalt for SOSI-rapport. For å se på resultatet kan du enten skrive ut filene på en skriver, eller hente filene opp i en teksteditor. 4.5 Rapportfil Rapportfilen er den komplette testrapporten som inneholder både feilmeldinger, oversikter og statistikker. Denne filen vil ha samme navn som SOSI-filen, men med endelsen.txt dersom brukeren ikke har spesifisert noe annet. Les mer om rapportfilen i kapittel 12. Rapporter. 4.6 Logfil En logfil er en kortfattet fil som inneholder et utdrag av rapportfilen. Dersom du bare har testet 1 fil, vil lograpporten bli lagt på slutten av filen KVAKK.LOG. Har du testet flere filer blir den lagt på en fil med samme navn som fillisten (se. kapittel 5. Bruk av kommandolinje) men med endelsen.log. Bare feilmeldinger og advarsel havner i denne rapporten. Dersom logfilen ikke inneholder noen feilmeldinger eller advarsler, kan du regne med at SOSI-filen er Ok. Finnes det feilmeldinger/advarsel vil du finne mer detaljert informasjon i rapportfilen. Logfilen er kjekk å ha når man tester mange filer om gangen. Les mer om logfilen i kapittelet 12. Rapporter. 4.7 SOSI-rapport SOSI-rapport er en SOSI-fil som inneholder grupper fra SOSI-filen som er kontrollert. Denne filen vil ha samme navn som den kontrollerte SOSI-filen, men med endelsen.s. Grupper som ikke er godkjent vil havne i denne filen sammen med kommentarer..hode gruppen på filen vil være en kopi av den original filen. Denne filen vil også inneholde en oversikt over knutepunkter/noder i originalfilen (.SVERM gruppe). SOSI-rapporten kan benyttes når du ikke kan hente originalfilen opp i en editor p.g.a størrelsen e.l. Les mer om SOSI-rapporten i kapittelet 12. Rapporter.

20 IT-R-0015/Rev. 1 Side: Bruk av kommandolinje 5.1 Kommandolinjen KVAKK har et kommandolinje grensesnitt. Denne typen brukergrensesnitt er valgt av flere grunner. De aller fleste kjenner til kommandolinje grensesnittet fra operativsystemet de bruker. Det er enkelt å programmere, noe som gjør at ressursene som blir spart kan brukes til andre ting. KVAKK er dessuten et program som ikke har noen dialog med brukeren unntatt ved oppstart av programmet. Grensesnittet fungerer på den måten at brukeren oppgir parametere når programmet startes. For eksempel vil brukeren oppgi navnet på SOSI-filen som skal testes, som et parameter. I stedet for menyer har brukeren mulighet for å benytte seg av parameterbrytere. En parameterbryter er en spesiell kommando som brukes til å styre programmets funksjon. Formatet på kommandolinjen til KVAKK er slik: KVAKK [@] <innfil> [<utfil>] [/bryter] Det som står inne i klammer ([...]) er opsjoner. Dersom du bare starter KVAKK uten parametere vil det komme opp et skjermbilde som viser en oversikt over ulike parametere og parameterverdier. Skjermen vil da se slik ut: KVALITETSKONTROLL AV DIGITALE KARDATA versjon Des for Win NT/ Statens kartverk i samarbeide med Høgskolen i Gjøvik Bruk: KVAKK [@] <innfil> [<rapportfil>] [<bryter>] Parameter brytere: /form : Formatsjekk /saveidx : ikke slett indekser laget av fyba /grupp : Innholdssjekk /def:<navn> : Spesifiser filnavn for def.filliste /knut : Knutepunkt /tol:n : toleranse i n meter ("nøy"=nøyakt.)

21 IT-R-0015/Rev. 1 Side: 15 /flate : Flatekontroll /sosi : sosifil med feilmeldinger /obj : Objektkontroll /noref : feilmeld. ikke spesifisert på grupper /stat : Statistikk /maxpkt:n : max antall punkt for flater. /p[testnr] : Slå på test. /u[testnr] : Slå av test. /klassginfo:"..<element>"[,"..<element>"]: ginfo det skal lages stat. over <innfil> kan være en sosifil (.sos) eller en filliste (.fil). Hvis «@» er angitt foran <innfil> tolkes filen som en filliste. Trykk linjeskift...

22 IT-R-0015/Rev. 1 Side: 16 Hvis du trykker linjeskift, vil det komme opp en oversikt over de ulike testene som KVAKK kan utføre på SOSI-fila: FORMATSJEKK GRUPPEVIS KNUTEPUNKTER OBJEKTER 1.1 Hode 2.1 Serienummer 3.1 Nodefordeling 5.1 Objektkontroll 1.2 Flere hoder 2.2 Område 3.2 Gruppesammensl. 1.3 Tegnsett 2.3 Sosinivå 3.3 knyttbare pkt. STATISTIKK 1.4 Sluttmerke 2.4 Nøyaktighet Temakoder pr.linje Kvalitetskoder 2.5 Høyde FLATEKONTROLL Punkt Statistikk 4.1 Referanser Linjelengder D/3D 4.2 Overganger Punkttetthet Målemetode 4.3 Repres.punkt Punkttema Negative Z Syntaks (6.3.2 Ginfoverd.stat) Kommentarer, feilmeldinger eller ønsker rettes til: Statens kartverk SOSI-sektretariatet 3500 HØNEFOSS tlf Innfil <innfil> kan enten være navnet på en SOSI-fil eller en filliste. Dersom <innfil> er en SOSI-fil trenger du ikke å oppgi filnavnforlengelsen (.SOS) fordi KVAKK automatisk antar at <innfil> er en SOSI-fil. Dersom <innfil> er en filliste derimot må du angi krøllalfa, «@», foran filnavnet for at KVAKK skal tolke filen som en filliste.

23 IT-R-0015/Rev. 1 Side: Filliste En filliste er en tekstfil der navnene på de SOSI-filene som skal testes er oppgitt. KVAKK forventer et filnavn for hver linje i fillisten. Som opsjon kan du også oppgi navn på utfil bak SOSI-filnavnet. En filliste vil f.eks se slik ut: kart1.sos kart2.sos kart3.sos rap.txt Hvis fillista er lagret på filen kart.fil skriver du følgende på kommandolinjen: KVAKK vil nå teste alle de tre SOSI-filene, og generere tre rapportfiler med navnene kart1.txt, kart2.txt og rap.txt. Vanligvis vil SOSI-filer som skal testes ligge i en annen filkatalog enn der KVAKK programmet befinner seg. For at programmet skal kunne lokalisere SOSI-filene må filstien oppgis. Dette kan gjøres på to måter. Et alternativ er at filnavnene i fillisten inneholder filsti. eks. c:\sosi\kart1.sos c:\sosi\kart2.sos c:\sosi\kart3.sos Dersom filnavnene i fillisten ikke inneholder filsti, vil KVAKK lete etter SOSI-filene i den samme katalogen som fillisten befinner seg. eks.

24 IT-R-0015/Rev. 1 Side: 18 kart.fil: kart1.sos kart2.sos kart3.sos kommando: C:\>KVAKK c:\sosi\kart.fil I dette tilfellet vil KVAKK lete etter SOSI-filene i katalogen c:\sosi. 5.4 Hvordan lage fillister Det er flere måter å lage fillister på. En metode er å benytte seg av en tekst editor som f.eks EDIT (MS/DOS) eller NOTEPAD (Windows). Skriv inn et filnavn på hver linje og lagre filen med filnavnforlengelsen.fil. En annen metode som er mye enklere, tar i bruk operativsystemets mulighet for redigering av data. Ved å benytte seg av operativsystem kommandoen DIR og redigering lager man skreddersydde fillister på et øyeblikk. eks. for MS/DOS C:\>DIR C:\SOSI\*.SOS /B > C:\SOSI\KART.FIL Her vil KVAKK teste alle SOSI-filene i katalogen c:\sosi. NB! Husk å benytte /B parameteret for DIR kommandoen slik at unødvendig informasjon blir fjernet.

25 IT-R-0015/Rev. 1 Side: Utfil <utfil> kan du oppgi dersom du ønsker et annet utfilnavn en det som KVAKK automatisk genererer. Men <utfil> vil ha forskjellig betydning avhengig av hvilken type innfil er. Dersom <innfil> er en SOSI-fil og <utfil> er oppgitt som parameter, vil testrapporten bli lagt på <utfil>. Hvis <innfil> er en filliste og <utfil> er oppgitt, vil lograpporten bli lagt på <utfil>. eks. Kommando Rapportfil Logfil KVAKK CJ0682.SOS CJ0682.TXT KVAKK.LOG KVAKK CJ0682.SOS RAP.TXT RAP.TXT KVAKK.LOG KVAKK KART.FIL *.TXT KART.LOG KVAKK KART.FIL LOG.TXT *.TXT LOG.TXT 5.6 Parameter brytere Dersom du vil spesifisere hvordan programmet skal utføre kontrollen av SOSI-filer, kan du benytte deg av parameter brytere. En parameter bryter angis på formen /<bryter>. I KVAKK 2.2 er følgende brytere tilgjengelig: /form Slår på testene som tilhører formell formatsjekk (test 1.1 til 1.4). /grupp Slår på testene som tilhører gruppevis innholdssjekk (test 2.1 til 2.6). /knut Slår på testene som tilhører knutepunktkontroll (test 3.1 til 3.3). /flate Slår på testene som tilhører flatekontroll (test 4.1 til 4.3). /obj Slår på objektkontroll (test 5.1). /stat Slår på alle statistikker (test til 6.3.1). /u[nnn] Slår av tester fra og med gitt nivå. Eks. /u slår av alle tester, /u1 slår av alle tester som ligger under punkt 1 (formell formatsjekk, 1.1, 1.2, 1.3, og 1.4).

26 IT-R-0015/Rev. 1 Side: 20 /p[nnn] Slår på tester fra og med gitt nivå. Eks /p2 slår på alle tester som ligger under punkt 2 (gruppevis innholdssjekk). /tol:n Toleranse i knutepunktskontroll skal være n meter. Dersom toleranse ikke er spesifisert, benyttes nøyaktigheten som toleranse. Dette parameteret har innvirkning på test 3.1 og 3.3. /def:<filnavn> Spesifiserer filnavn for filliste som inneholder navnene på definisjonsfiler som skal benyttes. /sosi Fører til at KVAKK vil lage en SOSI-fil som inneholder grupper som ble underkjent av gruppevis innholdssjekk sammen med kommentarer. I tillegg vil filen inneholde en.sverm gruppe med alle knutepunkter på filen. /saveidx Ikke slett indekser laget av FYBA. For brukere som har tenkt å benytte SOSI-filen(e) i FYSAK, er det ønskelig at indeksene over gruppeelementene på SOSI-filen ikke slettes. /noref Feilmeldinger blir ikke angitt for hver gruppe på SOSI-fila, men summert sammen i en tabell. /maxpkt:n Setter en toleransegrense for max antall punkt grensene til en flate kan inneholde. Antall flater som har flere punkter enn angitt med "maxpkt" blir summert sammen i flatekontrollen. /klassginfo:"" Angir hvilket basiselement det skal lages statistikk over parameterverdi for under test Eks. /klassginfo="..kvalitet#2","..kvalitet#3" medfører at det i blir laget en tabell over MÅLEMETODE og en tabell over SYNBARHET. /feillinjer:n En del av testene gir som default 40 grupper med en eller annen feil. Ønskes flere eller alle grupper med en bestemt feil f. eks. alle grupper med koordinater utenfor område, kan n settes til et høyt tall 1000, eller lignende. /tell Slår på test nr 7, fxtell, som gir 3 filer med oversikt over forekomster av gruppenavn og koder (Filene har extension.l1,.l2 og.l3.) /no_tast En del abortmeldinger etterfølges av Trykk en tast for å fortsette. Dette er for å være sikker på at brukeren ser abortmeldingen. Denne parameteren gjør at nevnte tekst ikke kommer. Det kan være ønskelig for eksempel i batch-kjøringer. Alle parameterbrytere kan benyttes i kombinasjon med hverandre. eks.

27 IT-R-0015/Rev. 1 Side: 21 C:\>KVAKK CJ0682.SOS /U /FORM /GRUPP /U22 /SOSI Denne kommandoen fører til at KVAKK utfører formell formatsjekk (/form) og gruppevis innholdssjekk (/grupp) unntatt test 2.2 (/u22) på filen cj0682.sos. I tillegg vil KVAKK lage en SOSI-fil cj0682.s som inneholder underkjente grupper sammen med kommentarer (/sosi). Legg merke til at man må benytte /u for å slå av alle tester før man slå på igjen enkelte tester ved hjelp av /form og /grupp. Dersom du ikke oppgir noen parameterbrytere, vil alle tester bli utført, men det vil ikke bli laget noen SOSI-rapportfil. Toleranse i knutepunktskontroll vil være satt til 0 meter. I enkelte tilfeller vil resultatet av noen kontroller påvirke senere kontroller. Dette vil for eksempel gjelde for filer der tegnsett-informasjon er feil. Dersom en SOSI-fil er definert med feil tegnsett vil test 1.3 (tegnsett kontroll) avbryte programmet, fordi videre testing vil kunne få programmet til å låse seg. Andre tilfeller vil være manglende opplysninger i.hode gruppen på filen, som gjør at det blir vanskelig å tolke annen informasjon på SOSI-filen. Dersom du utfører full kontroll av SOSI-filen, vil slike spesielle feil håndteres av KVAKK på en forsvarlig måte. Hvis du i stedet utfører noen utvalgte tester ved hjelp av parameterbrytere, vil slike filer kunne gi problemer. Enten ved at rapporten vil gi gal informasjon eller at programmet rett og slett låser seg.

28 IT-R-0015/Rev. 1 Side: Formell formatsjekk Formell formatsjekk er en samling enkle kontroller som sjekker at filen oppfyller de mest elementære krav til en SOSI-fil, f.eks at det finnes en hodegruppe og en sluttgruppe. Dersom filen ikke tilfredsstiller kravene til en SOSI-fil blir filen avvist av programmet, og testen avbrytes. Minstekrav til en SOSI-fil:.HODE <div.hodeinformasjon>.slutt SOSI-filen må inneholde en hodegruppe og en slutt gruppe. Hodegruppen må inneholde en del opplysninger om dataene på filen (se test 1.1). 6.1 Hodekontroll (Test 1.1) Dette er en meget viktig kontroll. Derfor blir den utført uansett hvilken test som blir kjørt. Hodegruppen er den viktigste gruppen på hele SOSI-filen. Det kreves at den står som første gruppe på fila, og at den inneholder en del informasjon. Informasjon som er oppgitt i hodegruppen gjelder for alle andre grupper på fila, men en del kan overstyres på gruppenivå av andre grupper. Hodekontroll gjør følgende: Skriver ut hodegruppen på rapportfilen med en del kommentarer til enkelte opplysninger. Sjekker at hodegruppen inneholder en del obligatorisk informasjon. Sjekker at syntaksen på hodeinformasjonen er korrekt. Sjekker at det ikke er benyttet udefinerte basiselement. Sjekker om enkelte tester må kobles ut p.g.a ufullstendig hodeinformasjon. Sjekker at oppgitt SOSI-nivå er lovlig (1-4).

29 IT-R-0015/Rev. 1 Side: 23 Eksempel på rapport: DELKONTROLL 1.1: HODEKONTROLL HODE gruppe finnes på SOSI-filen..HODE gruppen på fila:.hode 0..TRANSPAR...KOORDSYS 3...ORIGO-NØ ENHET OMRÅDE...MIN-NØ MAX-NØ KVALITET KARTID..DATO KVALITET Forklaringer på noe av hodeinformasjonen: TRANSPAR: KOORDSYS: NGO-akse III (Sone C) KVALITET: MÅLEMETODE : Stereoinstrument: Autograf - vanlig registrering NØYAKTIGHET: Middelfeil: 2.00m Målestokk: 1:5000 Feil/manglende obligatorisk hodeinfo: Feil 2000: SOSI-VERSJON mangler. Feil 2000: SOSI-NIVÅ mangler. Syntakssjekk: Feil 2016:..DATO Ulovlig tegn i heltall. Hodeopplysninger som blir kommentert: Koordsys Målemetode

30 IT-R-0015/Rev. 1 Side: 24 Nøyaktighet Synbarhet Tegnsett Oversikt over lovlige koder til disse elementene er angitt i SOSI-standarden i kapittelet Kodeliste/Objektliste. Obligatoriske opplysninger som kreves i hodegruppen: Origo-nø Koordsys Område Sosi-versjon Kvalitet For en nærmere forklaring til disse parameterene henvises det til kapittelet Hodet på SOSI-fila i SOSI-standarden. Når det gjelder syntakssjekken er dette den samme sjekken som utføres på de andre SOSIgruppen i test 2.6 (Gruppevis innholdssjekk). Se kapittelet 7. Gruppevis Innholdssjekk for en nærmere beskrivelse av syntakssjekken. Tester som kan bli koblet ut: Dersom TRANSPAR opplysninger eller OMRÅDE opplysninger er mangelfulle vil testene 2.2, 2.4, 3.1, 3.2, 3.3, 4.1, 4.2, 4.3, 5.1, 6.1.1, 6.1.2, 6.1.3, 6.1.4, og bli koblet ut. Dette blir gjort fordi alle koordinater på fila vil bli meningsløse når TRANSPAR og/eller OMRÅDE er feil/manglende definert. Dersom SOSI-nivået skulle vise seg å være lavere en 3 (test 2.3), vil knutepunktsstatistikk (test 3.1) og sjekking på grupper som kan slås sammen (test 3.2) ikke bli utført. Dette p.g.a at SOSI-filer på nivå 1 eller 2 ikke har definerte knutepunkter. Mulige feilmeldinger: Fatal 1002 : Ukjent SOSI-NIVÅ definert i HODE. Fatal 1003 : Feil eller manglende definisjon av TRANSPAR i HODE.

31 IT-R-0015/Rev. 1 Side: 25 Fatal 1004 : Feil eller manglende definisjon av OMRÅDE i HODE. Feil 2011 :... - Teksten avsluttes ikke med apostrof. (syntakssjekk) Feil 2012 :... - Teksten er for lang. (syntakssjekk) Feil 2015 : n - For mange siffer i heltall. (syntakssjekk) Feil 2016 : n - Ulovlig tegn i heltall. (syntakssjekk) Feil 2017 : n.n - For mange siffer i desimaltall. (syntakssjekk) Feil 2019 : n.n - Ulovlig tegn i desimaltall. (syntakssjekk) Advarsel 3003 :... - Ukjent (udefinert) gruppeinfo. (syntakssjekk) 6.2 Multiple hoder (Test 1.2) Dette er en meget enkel kontroll som bare sjekker om det finnes flere hodegrupper på fila. Det skal kun være en hodegruppe på fila, og hvis det skulle finnes flere tyder det på alvorlige feil. Eksempel på rapport: DELKONTROLL 1.2: HODEKONTROLL, MULTIPLE HODER Feil 2020: 1 ekstra.hode grupper funnet. Ekstra HODE-grupper er funnet på følgende posisjoner: linjenr: 43 Mulige feilmeldinger: Feil 2020: n ekstra.hode grupper funnet. Liste med posisjoner for ekstra hodegrupper. 6.3 Tegnsettkontroll (Test 1.3) SOSI-formatet benyttes i mange ulike miljøer og sammenhenger. Formatet er maskinuavhengig i den forstand at det støtter forskjellige tegnsett som er tilgjengelig for ulike maskintyper. Følgende miljøer er støttet pr. SOSI 2.2:

32 IT-R-0015/Rev. 1 Side: 26 Intel (MS/DOS - OS/2) Norsk Data (SINTRAN) Digital (VAX/VMS) Dette har resultert i at følgende tegnsett er lovlige: DOSN8 ND7 DECN7 DECM8 ANSI ISO8859 (MS/DOS 8-bits tegnsett) (Norsk Data 7 bits norsk tegnsett) (DEC 7 bits norsk tegnsett, identisk med ND7) (DEC 8 bits multinasjonalt tegnsett) I SOSI-standarden er det i kodelisten oppgitt ANSI som kode for Windows tegnsett. Hvilket tegnsett som er benyttet på filen må oppgis som hodeinformasjon ved hjelp av basiselementet..tegnsett. Dersom tegnsett ikke er oppgitt er det DOSN8 som skal gjelde. (se kap. 15. Vanlige feil på SOSI-filer). Det som skiller de ulike tegnsettene fra hverandre er i grove trekk de norske tegnenes (Æ,Ø,Å) plassering. I tillegg er noen 7-bits (128 tegn) mens andre er 8-bits (256 tegn). Det som er viktig i SOSI sammenheng er de norske tegnenes koder, da det benyttes norske tegn i basiselementer (eks...sosi-nivå og..nøh). Om tegnsettet er 7-bits eller 8-bits har liten betydning fordi SOSI ikke benytter tegn med kode høyere enn 127, bortsett fra nasjonale tegn. Norske tegn i de forskjellige tegnsettene: Tegnsett Æ Ø Å æ ø å DOSN DECM DECN ND ANSI

33 IT-R-0015/Rev. 1 Side: 27 Tegnsettkontroll gjør følgende: Kontrollerer at oppgitt/gjeldende tegnsett stemmer med innhold på fila. Kontrollerer om det finnes ulovlige tegn på fila. Skriver ut de opptil 10 første underkjente tegn sammen med posisjonen de er på. Foreslår alternativt tegnsett dersom det gjeldende ikke synes å passe. Avbryter videre testing dersom fila ikke passerer kontrollen. Eksempel på rapport: DELKONTROLL 1.3: TEGNSETTKONTROLL Benyttet tegnsett:..tegnsett mangler, benytter DOSN8. Antall tegn i hele fila: Antall tegn som er godkjent: Tegn som ikke er godkjent: Linje nr. 23 Tegn nr. 1 Ascii 8 Tegn: Linje nr. 23 Tegn nr. 2 Ascii 193 Tegn: Á Linje nr. 23 Tegn nr. 3 Ascii 240 Tegn: ð Linje nr. 23 Tegn nr. 4 Ascii 4 Tegn: Linje nr. 23 Tegn nr. 5 Ascii 1 Tegn: Linje nr. 23 Tegn nr. 6 Ascii 161 Tegn: Linje nr. 23 Tegn nr. 7 Ascii 249 Tegn: ù Linje nr. 23 Tegn nr. 8 Ascii 194 Tegn: Â Linje nr. 23 Tegn nr. 10 Ascii 252 Tegn: ü Linje nr. 23 Tegn nr. 14 Ascii 126 Tegn: ~ I alt 556 ikke godkjente tegn. Fatal 1011 : Oppgitt tegnsett er feil. Mulig tegnsett kan være ND7 KVAKK finner ut om tegnsettet er korrekt på grunnlag av de norske tegnene. F.eks hvis det finnes tegn med kode 92 (stor norsk Ø i ND7) på fila vil tegnsettet sannsynligvis være ND7 eller DECN7. Det går ikke an å lage en feilfri metode for å bestemme hvilket tegnsett som er benyttet, men KVAKK håndterer de fleste situasjoner.

34 IT-R-0015/Rev. 1 Side: 28 Å avgjøre om et tegn er lovlig eller ulovlig vil ofte være en vurderingssak. KVAKK godtar i dag alle tall, bokstaver pluss en del skilletegn som linjeskift og komma. Hvis et tegn befinner seg mellom apostrofer ("<tegn>" eller '<tegn>') vil alle koder godtas, bare det ikke er i konflikt med bitlengden til tegnsettet (ikke lov med koder over 127 i 7-bits tegnsett). I en del filer risikerer man å finne usynlige styrekoder slik som tabulator (kode 9). Slike tegn vil ofte lage trøbbel når man leser SOSI-filen. KVAKK kan lese slike filer korrekt, men godkjenner ikke tabulatortegn. KVAKK kan foreslå et alternativt tegnsett dersom det gjeldende ikke stemmer med innholdet på fila. Dersom oppgitt/gjeldende tegnsett ikke er korrekt, vil KVAKK avbryte videre testing, fordi innholdet på fila ikke vil gi noen mening for senere tester. Hvis KVAKK har funnet flere enn 20 underkjente tegn vil kontrollen også bli avbrutt. Det ligger ingen andre vurderinger bak tallet 20 enn at mange ulovlige tegn vil kunne skape problemer for leserutinene KVAKK benytter. Mulige feilmeldinger: Fatal 1009 : Tegnsettet er ikke lovlig for denne SOSI-versjonen. Fatal 1011 : Oppgitt tegnsett er feil. Feil 2021 : n ikke godkjente tegn er funnet. 6.4 Sluttkontroll (Test 1.4) Dette er en kontroll som går på SOSI-filens konsistens. Hvis sluttmerket (.SLUTT) skulle mangle på en SOSI-fil, tyder det på en alvorlig feil som f.eks at filen har blitt delt. En SOSIfil uten sluttmerke er pr. definisjon ikke en SOSI-fil, og vil kunne skape problemer for en del programmer som leser SOSI-filer. Dersom en slik feil oppdages vil kontrollen bli avbrutt, men det er fritt opp til brukeren å legge til et slikt merke selv (ingen KVAKK-kommando for dette) for så å teste filen på nytt. Det er viktig å skille mellom to typer sluttmerker. SOSI-formatet definerer.slutt som det logiske sluttmerket for dataene på fila. Eventuell informasjon etter dette merket blir ikke regnet som en del av dataene. I tillegg til det logiske filsluttmerket som SOSI definerer, finnes det et fysisk sluttmerke satt av operativsystemet. Dette merket kalles ofte for EOF (End Of File) og representerer slutten på selve fila.

35 IT-R-0015/Rev. 1 Side: 29 Sluttkontroll gjør følgende: Finner posisjonen for.slutt dersom merket finnes. Sjekker om det finnes informasjon mellom logisk sluttmerke (.SLUTT) og fysisk sluttmerke (End Of File). Eksempel på rapport: DELKONTROLL 1.4: SLUTTKONTROLL Feil 1008:.SLUTT er ikke funnet på filen. For å finne sluttmerket leser KVAKK hele filen igjennom til.slutt blir funnet eller EOF blir nådd. Når.SLUTT evt. er funnet sjekker programmet hvor mange linjer med informasjon som finnes mellom.slutt og EOF. Informasjon er linjer som ikke er tomme eller inneholder kommentarer (!<kommentar>). Mulige feilmeldinger: Fatal 1008 :.SLUTT er ikke funnet på filen. Advarsel 3005 : n linjer mellom.slutt og filslutt.

36 IT-R-0015/Rev. 1 Side: Gruppevis Innholdssjekk Gruppevis innholdssjekk består i å kontrollere innholdet i gruppene. Dette er en samling varierte kontroller som leter etter feil på SOSI-fila. 7.1 Serienummer (Test 2.1) Alle gruppene på en SOSI-fil kan tildeles et serienummer. Et serienummer er et heltall som angis etter gruppenavnet med et kolon bak. Eks..LINJE 100:!Linjen har serienummer 100 Et serienummer må være unikt for filen gruppen ligger på. Det vil si at to grupper på en SOSIfil, ikke kan ha det samme serienummeret. Serienummer-kontrollen avdekker serienummer som er benyttet av flere grupper. Serienummer behøver ikke opptre i stigende rekkefølge på filen, og grupper som mangler serienummer får automatisk tildelt serienummer 0. Det eneste kravet er at serienummeret skal være unikt. Serienummer benyttes i forbindelse med referanser (SOSI-nivå 4), men det er normalt å tildele alle grupper et serienummer uansett SOSI-nivå. KVAKK betrakter serienummer som obligatorisk, og vil gi feilmelding ("serienummer 0 benyttet flere ganger") dersom gruppene på fila mangler serienummer. Serienummer spiller en vesentlig rolle for referering til lokaliserte feil på fila. Serienummer kontroll gjør følgende: Kontrollerer at alle gruppene på SOSI-filen har unike serienummer. Skriver ut evt. oversikt over hvilke serienummer som forekommer flere ganger. Finner det høyeste serienummeret på filen. Kontrollen utføres ved at hele filen leses gruppe for gruppe, mens KVAKK tar vare på alle serienummer.

37 IT-R-0015/Rev. 1 Side: 31 Eksempel på rapport: DELKONTROLL 2.1: SERIENUMMER 20 grupper er gjennomlest og kontrollert. Høyeste serienummer som er funnet: 9999: Feil 2022: Det er funnet grupper med like serienummer. Serienummer som forekommer flere ganger: Serienr Antall 2: 2 Mulige feilmeldinger: Feil 2022 : Det er funnet grupper med like serienummer. 7.2 Område (Test 2.2) Alle kart dekker et definert område. Dette gjelder både papirkart og digitale kartdata slik som SOSI-data. I SOSI-formatet er det påkrevd å oppgi området som dataene på fila dekker som en opplysning i.hode. Dette gjøres ved å benytte basiselementet..område. Eks...OMRÅDE...MIN-NØ MAX-NØ Denne kontrollens oppgave er å finne ut om disse opplysningene stemmer overens med dataene på fila. Opplagte feil er f.eks koordinater som er utenfor området definert i.hode. Område kontroll gjør følgende: Finner max/min nord/øst koordinater på fila.

38 IT-R-0015/Rev. 1 Side: 32 Sjekker om det finnes koordinater utenfor området definert i.hode. Beregner areal av område oppgitt i.hode og areal som filen dekker. Beregner utstrekning av område oppgitt i.hode og utstrekning som filen dekker. Sjekker at område opplysninger ikke er oppgitt speilvend. (max < min). Kobler ut videre testing dersom område opplysninger skulle vise seg å være speilvendte. Alle koordinater på fila leses inn etter tur og blir testet mot område opplysningene i.hode. Samtidig oppdateres max/min verdiene for området som koordinatene på fila befinner seg innenfor. Eksempel på rapport: DELKONTROLL 2.2: OMRÅDE OMRÅDE BESKRIVELSE I HODE: MIN ØST: MAX ØST: MIN NORD: MAX NORD: AREAL: 20.5 km 2 UTSTREKNING: OMRÅDE DATA I FILA DEKKER: MIN ØST: MAX ØST: MIN NORD: 0.0 MAX NORD: AREAL: km 2 UTSTREKNING: Grupper som har koordinater utenfor området: Ref.nr Navn Antall : LINJE 1 1: LINJE Totalt 2 koordinater utenfor område.

39 IT-R-0015/Rev. 1 Side: 33 Mulige feilmeldinger: Fatal 1010 : OMRÅDE opplysninger i.hode er speilvendt. Feil 2004 : n koordinater utenfor område. 7.3 SOSI-nivå (Test 2.3) SOSI-nivået oppgis i.hode ved hjelp av basiselementet..sosi-nivå. Lovlige nivå er 1-4. Kort om de ulike SOSI-nivåene: 1. På en slik fil kan hver gruppe ha bare 1 egenskapsopplysning pr. grafisk element. Ubrukbar for kartdata, og er stort sett ikke i bruk. 2. Her er det lov med flere egenskaper pr. grafisk element, og dette nivået dekker alt som har med koding av data å gjøre. Dataene på fila er ikke knyttet sammen eller bearbeidet noe særlig. Brukes for å utveksle rådata. 3. Her er knutepunkter implementert. Grafiske elementer knyttes sammen ved hjelp av definerte knutepunkter. Mye brukt. 4. Brukes for de mest bearbeidede dataene. Her er det lov med grafiske objekter som består av flere grafiske element, f.eks flater. Dette gjøres ved hjelp av referanser, noe som krever at alle grupper har serienummer. NB! Et nivå dekker også alle lavere nivå! For en bruker av kartdata er det interessant å kunne undersøke om en fil virkelig tilfredsstiller det SOSI-nivået som..sosi-nivå oppgir. SOSI-nivå kontroll gjør følgende: Finner ut hvilket SOSI-nivå som er oppgitt i.hode Undersøker hvilket SOSI-nivå filen tilfredsstiller Forekomster av "...KP" tilsier SOSI-nivå 3. Finnes referanser ".. :x :xx" tilsier det SOSI-nivå 4. Kobler ut test 3.1 og 3.2 (knutepunktskontroller) dersom SOSI-nivå skulle vise seg å være lavere enn 3. Kobler ut test 4.1,4.2,4.3 (flatekontroller) dersom SOSI-nivå skulle vise seg å være lavere enn 4.

40 IT-R-0015/Rev. 1 Side: 34 Eksempel på rapport: DELKONTROLL 2.3: BESTEMME SOSI-NIVÅ Oppgitt sosi-nivå i hodet: 4 Data tilfredsstiller sosi-nivå: 3 Mulige feilmeldinger: Feil 2024 : Oppgitt SOSI-NIVÅ i.hode stemmer ikke med innhold på fila. 7.4 Nøyaktighet/enhet (Test 2.4) Det vil være mange ulike syn på hvilke krav man skal stille til forholdet mellom nøyaktighet og enhet. Det får være opp til brukeren å vurdere om kravet synes rimelig eller ikke. P.g.a usikkerheten omkring kravet, gir denne testen bare advarsler. Kravet KVAKK stiller til forholdet mellom nøyaktighet og enhet er som følger: 0.01 * nøyaktighet <= enhet <= 2 x nøyaktighet Nøyaktighet/enhet kontroll gjør følgende: Kontrollerer at nøyaktighet og enhet oppfyller kravet spesifisert ovenfor. Eksempel på rapport: DELKONTROLL 2.4: NØYAKTIGHET KONTRA ENHET Enhet oppgitt i HODE: Nøyaktighet oppgitt i HODE: 200 Benyttet test: 0.01 * nøyaktighet <= enhet <= 2 x nøyaktighet Advarsel 3006: Det er misforhold mellom nøyaktighet og enhet i.hode. Kombinasjoner av nøyaktighet og enhet der det er misforhold:

41 IT-R-0015/Rev. 1 Side: Nøyaktighet Enhet Totalt 12 grupper. Mulige feilmeldinger: Advarsel 3006 : Det er misforhold mellom nøyaktighet og enhet i.hode. Advarsel 3007 : n grupper med misforhold mellom nøyaktighet og enhet. 7.5 Høydeinformasjon (Test 2.5) Når man skal beskrive et punkts plassering i terrenget kan man velge om man vil ta med høyde i tillegg til nord og øst. Ikke alle standarder krever høydeverdier for grafiske elementer, og mange målemetoder kan ikke brukes til å registrere høyder. Det er også forskjellige måter å angi høydeverdier på. f.eks for en høydekurve vil alle punkter i kurven ha den samme høydeverdien, mens en veg som følger terrenget vil ha varierende høydeverdier i forløpet. Eks: Høydekurve Linje m/høyde Linje u/høyde.kurve.linje.linje..høyde NØH..NØ..NØ Koordinater er her angitt på formen <nord> <øst> <høyde> slik SOSI definerer det. Det er interessant for en kartbruker å kunne skaffe seg et bilde over hvordan høydeinformasjonen på filen er sammensatt, og hvordan den står i forhold til målemetoden som er benyttet. Høydekontroll gjør følgende:

42 IT-R-0015/Rev. 1 Side: 36 Lager statistikk over høydeinformasjon på grunnlag av gruppene på fila. Påviser grupper der det finnes kombinasjoner av..nø og/eller..nøh og/eller..høyde. Påviser data uten høydeverdier, men som er registrert med måleinstrument som kan gi høydeverdier. Påviser data med høydeverdier, men som mangler nord og øst koordinater. I KVAKK versjon 2.1 er høydekontrollen (tidligere test 2.5) delt opp i følgende delkontroller: Høydeinformasjon Kombinasjoner av 2D og 3D koordinater Målemetode i forhold til koordinater Grupper med negative høydeverdier.

43 IT-R-0015/Rev. 1 Side: 37 Eksempel på rapport: DELKONTROLL : HØYDEINFORMASJON Forskjellige kombinasjoner: Målemet Gruppe Antall Høydeangivelse Type NØH NØ+HØYDE NØ NØ+NØH (3D) KURVE (3D) KURVE (2D) KURVE (2D) PUNKT (2D) KURVE (2D) KURVE (2D) KURVE (2D) KURVE (2D) KURVE Total : DELKONTROLL : KOMBINASJONER AV 2D OG 3D KOORDINATER Ikke godkjente grupper: Ref.nr Kommentar Advarsel 3002: Det finnes både NØ og NØH koordinater Advarsel 3002: Det finnes både NØ og NØH koordinater Totalt 2 grupper ikke godkjent. DELKONTROLL : MÅLEMETODE I FORHOLD TIL KOORDINATER Ikke godkjente grupper: Ref.nr Kommentar Advarsel 3009: 3D måling uten HØYDE/NØH Advarsel 3009: 3D måling uten HØYDE/NØH Totalt 2 grupper ikke godkjent.

44 IT-R-0015/Rev. 1 Side: 38 DELKONTROLL : GRUPPER MED NEGATIVE HØYDEVERDIER Ikke godkjente grupper: Ref.nr Kommentar Advarsel 3010: Negativ høydeverdi Totalt 1 grupper ikke godkjent.

45 IT-R-0015/Rev. 1 Side: 39 Mulige feilmeldinger: Feil 2007 : Bare HØYDE, ingen koordinater. Feil 2008 : Det finnes både NØH og HØYDE. Feil 2009 : Det finnes NØ, NØH og HØYDE. Advarsel 3002 : Det finnes både NØ og NØH koordinater. Advarsel 3009 : 3D måling uten HØYDE/NØH. Advarsel 3010 : Negativ høydeverdi. 7.6 SOSI-syntaks (Test 2.6) Kjernen i SOSI-formatet er måten data representeres og struktureres på. Dette kalles for syntaks. Selv om SOSI er et ganske fritt format, er det en del regler for hvordan en SOSI-fil skal bygges opp og hva de enkelte grupper skal bestå av. eks. syntaksen til basiselementet KVALITET:.DEF..KVALITET *...MÅLEMETODE H2...NØYAKTIGHET H5...SYNBARHET H2 Denne definisjonen forteller hva basiselementet KVALITET består av. H betyr heltall, og sifferet bak hver H forteller hvor mange siffer heltallet kan bestå av. Kvalitet kan derfor angis på denne måten:...kvalitet En naturlig oppgave for en syntakssjekk vil bestå i at dataene på fila passer til slike definisjoner som denne. Grupper har også sin spesielle syntaks. F.eks kreves det at en linje må ha minst to punkter, eller at en sirkel må ha oppgitt radius i tillegg til et punkt (sentrum). Brukere av SOSI-formatet, står fritt til å definere sine egne basiselementer. Den vanlige måten å gjøre dette på er å inkludere definisjonene mellom hodegruppen og resten av fila. I

46 IT-R-0015/Rev. 1 Side: 40 mange tilfeller kan dette være upraktisk, og man ønsker å gjøre en del definisjoner permanente. For å lage KVAKK mest mulig fleksibelt, er alle basiselement definisjoner lagt ut på tekstfiler (SOSISTD.Sxx), en for hver versjon av SOSI. Denne filen kan redigeres i en teksteditor hvis det er ønskelig. Syntaksen på definisjonene er den samme som den som er benyttet i SOSI-standarden. Hvis man ønsker at standard definisjonsfilen skal være urørt, kan man lage seg en ekstra definisjonsfil, og inkludere navnet på denne filen i tekstfilen DEFFILER.Lxx. Se kap. 13. Definisjonsfiler for mer informasjon om syntaksfiler. Syntaks kontroll gjør følgende: Sjekker at alle basiselementer på SOSI-filen er brukt i henhold til definisjonen. Sjekker at alle gruppelementer på SOSI-filen er brukt i henhold til definisjonen. Avslører om det er brukt ukjente basiselementer på fila. Avslører om det er brukt ulovlige gruppenavn på fila. Lager statistikk over forskjellige gruppeelementer på fila. Lager statistikk over basiselementer brukt på gruppenivå (gruppeinformasjon). Lager statistikk over basiselementer brukt på punktnivå (punktinformasjon). Eksempel på rapport: DELKONTROLL 2.6 : SOSI SYNTAKS Godkjente grupper: Gruppetype Antall PUNKT 1 LINJE 15 KURVE SUM: 17 Benyttet gruppeinfo: NØ LTEMA KVALITET PTEMA SKOG NØH

47 IT-R-0015/Rev. 1 Side: 41 Benyttet punktinfo: KP KVALITET PTEMA Ikke godkjente grupper: Ref.nr Gruppetype LINJE Advarsel 3000: Temakode mangler. Feil 2016:..NØ 32( Ulovlig tegn i heltall. 1 LINJE Advarsel 3003:...SKOG- Ukjent (udefinert) gruppeinfo. Feil 2016:..NØ 32( Ulovlig tegn i heltall. Feil 2016:...KP X - Ulovlig tegn i heltall. 2 LINJE Advarsel 3003:..TILSTANN - Ukjent (udefinert) gruppeinfo. I alt 3 grupper ikke godkjent. Når KVAKK sjekker basiselementene på fila, benytter den definisjoner fra syntaksfilene som er spesifisert under "[SyntaksDefinisjoner]" i filen DEFFILER.Lxx. Hvis det på SOSI-filen er definert nye elementer ved hjelp av.def blir disse tatt med også. Hvis filen bruker basiselementer som ikke er definert i syntaksfilene som KVAKK benytter, eller på SOSI-filen selv, vil dette gi en feilmelding Det er ikke mulig for brukeren å definere sine egne gruppeelementer, eller endre på definisjonen av eksisterende. Derfor er definisjonen av disse lagt inn i koden til KVAKK. I tabellen på neste side vises de definisjonene som er lagt inn i koden til KVAKK.

48 IT-R-0015/Rev. 1 Side: 42 Gruppeelemen t Tema Min. antall punkt Max antall punkt Obligatoriske basiselement HODE 0 0 TRANSPAR KOORDSYS ORIGO-NØ ENHET OMRÅDE SOSI-VERSJON SOSI-NIVÅ KVALITET PUNKT PTEMA 1 1 SVERM PTEMA 2 LINJE LTEMA 2 KURVE LTEMA 2 BUE LTEMA 2 2 RADIUS BUEP LTEMA 3 3 SIRKEL LTEMA 1 1 RADIUS SIRKELP LTEMA 3 3 KLOTOIDE LTEMA 2 2 KLOTRAD1 KLOTRAD2 KLOTPAR TRASE LTEMA 0 0 Referanse (..) FLATE FTEMA 1 1 Referanse (..) TEKST TTEMA 1 RASTER 1 5 BILDE PIXEL-STØRR STRUKTUR DEF 0 0 SLUTT 0 0

49 IT-R-0015/Rev. 1 Side: 43 Kommentar: KVAKK vil gi en advarsel dersom en gruppe mangler temakode. Temakode er ikke obligatorisk for gruppelementer, men det er vanlig at alle grupper får tildelt minst 1 temakode. Mulige feilmeldinger: Feil 2001 : Inneholder punkt. Feil 2002 : n punkt mangler. Feil 2003 : n punkt for mange. Feil 2010 :... er et ulovlig gruppenavn. Feil 2011 :... - Teksten avsluttes ikke med apostrof. Feil 2012 :... - Teksten er for lang. Feil 2015 : n - For mange siffer i heltall. Feil 2016 : n - Ulovlig tegn i heltall. Feil 2017 : n.n - For mange siffer i desimaltall. Feil 2019 : n.n - Ulovlig tegn i desimaltall. Advarsel 3000 : Temakode mangler. Advarsel 3003 :... - Ukjent (udefinert) gruppeinfo.

50 IT-R-0015/Rev. 1 Side: Knutepunktskontroll Knutepunktskontroll blir foretatt på SOSI-filer av SOSI-nivå 3 eller 4. For at en SOSI-fil skal ha SOSI-nivå tre må den inneholde knutepunkter. Men SOSI-nivå 3 sier bare at det finnes knutepunkter på fila, det sier ikke hvor mange og hvordan de fordeler seg. En fil med f.eks bare ett knutepunkt eller bare blindnoder må kunne sies å ikke være "ekte" nivå 3 fil. Knutepunktskontrollene setter derfor opp oversikter over knutepunktene og nodene på fila. Linje 1 Knutepunkt (2'er node) Linje 2 Linje 1 Knutepunkt (4'er node) Linje 4 Linje 2 Linje Knutepunkt/noder (Test 3.1) SOSI-filer av SOSI-nivå 3 vil inneholde knutepunkter. Et knutepunkt er et punkt som deles av flere grafiske elementer. D.v.s at hvis to linjer går igjennom det samme punktet, vil dette være et knutepunkt. Slike punkt skal i følge SOSI markeres med basiselementet...kp og plasseres i et knutepunktslag. De fleste knutepunkt vil befinne seg i linjeender. Knutepunkter kan plasseres i forskjellige knutepunktslag. En slik lagdeling har hittil ikke vært så mye brukt, så de fleste SOSI-filer har alle knutepunkter i knutepunktslag 1. Statens kartverk plasserer knutepunkt som ligger på kartbladskanten i et eget knutepunktslag (eks....kp 999). Et knutepunkt kalles også for en node. Nodens grad vil avhenge av hvor mange grafiske elementer som er koblet til knutepunktet. Hvis tre elementer er koblet til et knutepunkt, kalles knutepunktet for en 3'er node. For å kunne få en oversikt over hvor godt filens grafiske elementer er knyttet sammen med knutepunkter, er det nyttig med en statistikk som kan vise knutepunktsfordelingen i tabellmessig form. Denne statistikken er et forsøk på å gi brukeren et grunnlag til å vurdere kvaliteten på dataene som befinner seg på en SOSI-fil. KVAKK drar ingen konklusjoner, så det er opp til brukeren å tolke statistikken selv. Knutepunkt statistikk gjør følgende:

51 IT-R-0015/Rev. 1 Side: 45 Lager en statistikk over punkter markert med...kp på den aktuelle SOSI-filen. Grupperer nodene i knutepunktslag. Grupperer knutepunkter i noder. Grupperer punkter i forskjellige kategorier. (se nedenfor) Sjekker om blindnoder befinner seg på områdekant. (blindnode : 1'er node).

52 IT-R-0015/Rev. 1 Side: 46 Eksempel på rapport: DELKONTROLL 3.1: KNUTEPUNKT STATISTIKK Knutepunktlag Nodetype Antall 3D 2D 2D ulik H 2D/3D er er er er Antall knutepunkt: 33 Antall blindnoder: 15 hvorav 2 på område kant. (omr.kant +/- nøyaktighet) Antall punkt på fila: 229 Forklaring til tabell: Kolonne Knutepunktlag Nodetype Antall 3D 2D 2D ulik H 2D / 3D Forklaring Knutepunktslag. Lag n omfatter punkt markert med...kp n Hvor mange grafiske elementer som er knyttet til punktet. Summering av kolonnene 3D+2D+2D ulik H+2D/3D Punkter med like verdier for nord, øst og høyde. Punkter med like verdier for nord og øst og som ikke har høyde. Punkter med like verdier for nord og øst, men ulik høyde. Punkter med like verdier for nord og øst, men noen har høyde. Punkter som havner i de to siste kategoriene, kan egentlig ikke kalles for knutepunkt, men kan forekomme. F.eks vil et knutepunkt mellom vannlinje og bryggekant kunne ha ulike høydeverdier. Kommentar: P.g.a programtekniske årsaker omfatter knutepunktsstatistikken bare de første knutepunktene. Mulige feilmeldinger: Advarsel 3001 : Det er funnet n blindnoder (1-er noder) på filen.

53 IT-R-0015/Rev. 1 Side: Grupper som kan slås sammen (Test 3.2) Ved digitalisering av kartdata hender det ofte at grafiske elementer blir splittet opp av ulike årsaker, f.eks hvis en person blir avbrutt i digitaliseringen av en lang kurve. Dette fører til at et grafiske element blir liggende som to gruppeelement med like egenskaper på SOSI-fila. Disse to gruppene vil ofte bli knyttet sammen med et knutepunkt. Slik oppsplitting vil avtegne seg som 2'er noder på fila dersom brudd-punktet er markert som knutepunkt. KVAKK benytter seg av informasjonen fra test 3.1 og undersøker elementer med 2'er noder om de har like egenskaper. Resultatet blir en liste med grupper som i teorien kan slås sammen til en større gruppe. Nodefordeling gjør følgende: Undersøker alle 2'er noder og SOSI-grupper der disse inngår om de har like egenskaper. Presenterer en liste over grupper som kan slås sammen til en gruppe. Eksempel på rapport: DELKONTROLL 3.2: GRUPPER SOM KAN SLÅES SAMMEN 2'er noder med lik gruppe informasjon: Gruppe 1 Gruppe LINJE 8 LINJE 7 LINJE 11 LINJE 12 LINJE 9 LINJE 10 LINJE 11 LINJE 10 LINJE 6 LINJE Mulige feilmeldinger: Ingen feilmeldinger.

54 IT-R-0015/Rev. 1 Side: Knyttbare punkter (Test 3.3) Et knyttbart punkt er et punkt som deles av flere grafiske elementer, men som ikke er markert med...kp n. På filer som ikke er noe særlig bearbeidet etter registreringen/digitaliseringen av dataene, vil det som oftest være mange grupper som kan knyttes sammen med knutepunkter. Hvis en SOSI-fil har mange knyttbare punkter tyder det på at filen inneholder rådata. Det vil være aktuelt å stille forskjellige krav til toleranser når man skal knytte sammen punkter. Mange ganger er det hensiktsmessig å ha et +/- krav når et punkt sammenlignes med et annet. n P1 P2 Her vil punktene P1 og P2 kunne gjøres om til et knutepunkt p.g.a at toleransen er n meter. Toleranse = n meter I utgangspunktet benytter KVAKK 0 meter som toleranse, hvis ikke noe annet spesifisert. Du kan oppgi toleranse som parameter når du starter KVAKK, (tol=n, der n betyr meter). Da vil det bli laget tabeller med 0-3 x den oppgitte toleransen. Knyttbare punkter statistikk gjør følgende: Lager en statistikk over punkter som kan gjøres om til knutepunkter markert med..kp. Benytter forskjellige toleranser.

55 IT-R-0015/Rev. 1 Side: 49 Eksempel på rapport: DELKONTROLL 3.3: KNYTTBARE PUNKTER Det er totalt 229 punkt på fila. Toleranse = 1 x nøyaktighet Nodefordeling: Nodetype Antall 3D 2D 2D ulik H 2D/3D er er er Antall mulige knutepunkt: 27 Forklaring til tabellen nodefordeling se test 3.1. Mulige feilmeldinger: Ingen feilmeldinger.

56 IT-R-0015/Rev. 1 Side: Flatekontroll Flatekontrollen sjekker grupper som inneholder referanser, og da spesielt flater. En fil som inneholder flater vil være på SOSI-nivå 4. En SOSI-fil på nivå 4 vil inneholde grupper som har referanser. En slik gruppe kalles også for et grafisk objekt. Flatekontrollen brukes til å se om filene holder det hode-informasjonen lover. Merk: Flater kalles også for polygoner. eks på en flate:.linje 1:..NØ x1 y1...kp 1..NØ x2 y2...kp 1.LINJE 2:..NØ x2 y2...kp 1..NØ x3 y3...kp 1.LINJE 3:..NØ x3 y3...kp 1...NØ x1 y1...kp 1 Linje 1 x2, y2 x4, y4 x1, y1 Linje 3 Linje 2 x3, y3.flate 4:..NØ x4 y4!representasjonspunkt.. :1 :2 :3!Trekant flate avgrenset av tre linjer. 9.1 Referanser (Test 4.1) En referanse er en mekanisme for å knytte sammen flere grafiske elementer. F.eks vil en flate bestå av flere linjer.

57 IT-R-0015/Rev. 1 Side: 51 Ved bruk av referanser er det viktig at gruppene det refereres til virkelig finnes på fila. Hvis refererte grupper mangler vil dette være en alvorlig feil, som tyder på at det mangler data på fila. Referanse kontroll gjør følgende: Kontrollerer at refererte grupper finnes på fila. Eksempel på rapport: DELKONTROLL 4.1: ULOVLIGE REFERANSER Grupper som inneholder referanser til grupper som ikke finnes: Snr Gruppenavn Refererer til : FLATE 153: 46: FLATE 65: Mulige feilmeldinger: Feil 2005 : Det er funnet grupper som refererer til ukjente grupper. 9.2 Flater (Test 4.2) En flate er en spesiell type grafisk objekt. En flate må være avgrenset av linjer/kurver/buer. Det er viktig at linjer som avgrenser en flate er knyttet sammen i endene, og da helst med bruk av...kp.

58 IT-R-0015/Rev. 1 Side: 52 Gap i overgang Flate Ikke...KP Denne kontrollen skal avsløre flater der sidene av flaten ikke henger i sammen, eller at endepunktene ikke er markert med...kp. Flatekontroll gjør følgende: Kontrollerer at flategrenser henger sammen med identiske endepunkter. Påpeker grenser som ikke henger sammen i punkt markert med...kp. Teller antall flater som har flere enn 2000 punkter i grensene, og skriver ut serienummer til flaten med flest punkter. Toleransegrensen på 2000 kan endres med kommandolinje bryteren /MAXPKT=<tol.grense>. Eksempel på rapport: DELKONTROLL 4.2: FLATEKONTROLL Sammenheng mellom referanser: Snr Gruppenavn Ref 1 Ref 2 Kommentar : FLATE -22: -100: Ikke...KP 46: FLATE -100: 36: Gap i overgang Det er funnet 3 flater som har mer enn 2000 punkter. Flaten 101: har flest punkter (4500 stk). Mulige feilmeldinger:

59 IT-R-0015/Rev. 1 Side: 53 Feil 2028: Det er funnet n feil i flatereferanser. 9.3 Representasjonspunkt (Test 4.3) Alle flater må ha et representasjonspunkt. Dette punktet kalles også for flatens sentralpunkt. Det som kreves av et slikt punkt er at det befinner seg innenfor flatens utstrekning. Representasjonspunkt kontroll gjør følgende: Kontrollerer at flatens representasjonspunkt befinner seg innefor flatens grenser. Hvis flaten mangler representasjonspunkt, er dette en feil som blir avslørt i syntakskontrollen (Test 2.6). Eksempel på rapport: DELKONTROLL 4.3: REPRESENTASJONSPUNKT Følgende flater har representasjonspunkt utenfor sine grenser: 46:

60 IT-R-0015/Rev. 1 Side: Objektkontroll Objektkontrollen er en kontroll på om SOSI-filer oppfyller kodingsreglene som er definert i objektkatalogen i SOSI standarden. For SOSI-filer av versjon 1.4 er disse reglene knyttet til temakoder Objektkontroll (Test 5.1) I SOSI-versjon 1.4 var det temakoden som bestemte hvilke tilleggsegenskaper et gruppeelement skulle ha. Fra versjon 2.0 og videre er det innført objekter. I praksis betyr dette at et objekt identifiseres på grunnlag av temakode og evt. egenskaper. Objektkontroll gjør følgende: Klassifiserer gruppeelementene på SOSI-fila i objektklasser (2.0/2.1/2.2) eller temakoder (1.4) og skriver ut en statistikk. Gir feilmelding dersom et gruppeelement ikke gir tilslag på noen objektklasse. Teller antall gruppeelementer som har tilslag på flere enn 1 objektklasse. Kontrollerer at objektene inneholder obligatoriske basiselementer. Kontrollerer at basiselementer har lovlige verdier. Kontrollerer at basiselementer bare forekommer en gang i gruppeelementet, hvis ikke egenskapen er definert som multippel. Kontrollerer at objektene ikke inneholder ulovlige basiselementer i henhold til objektdefinisjonene. Eksempel på rapport: OBJEKTKONTROLL ============== DELKONTROLL 5.1: Objektkontroll Antall grupper med flere tilslag: 0 Antall grupper med ingen tilslag: 0 Objekter:

61 IT-R-0015/Rev. 1 Side: Objektnavn FKBData Antall KOMMUNEGRENSE ABAS 16 RIKSGRENSE ABAS 2 TRKTRKJRRVEGMIDT SIT 2 UKLASSIFISERT UKJENT 15 SNTRLINVANLIGVEG VBASE 1857 VEGBOM VBASE Total 1911 Ikke godkjente grupper: Ref.nr Gruppetype Objektklasse KURVE SNTRLINVANLIGVEG Feil 2000:...VEGNUMMER mangler. Feil 2000:...SYNBARHET mangler. Denne kontrollen benytter seg av to definisjonsfiler. Den ene filen er en utvalgs-regel fil som brukes til å klassifisere gruppeelementene i objektklasser (standard FYSAK kommandofil). Den andre filen inneholder en grundigere definisjon av objektet som gruppelementet kontrolleres mot. klassifiser objektet (utvalgs fil) kontroller objektet (definisjonsfil) Et gruppeelement kan havne i flere objektklasser. Det hersker uenighet om hvordan slike tilfeller skal håndteres. Det finnes tre måter å takle slike situasjoner: 1. Det første tilslaget gjelder.

62 IT-R-0015/Rev. 1 Side: Det siste tilslaget gjelder. 3. Alle tilslag gjelder, d.v.s et gruppeelement kan være flere objekter. KVAKK benytter framgangsmåte 3. Mulige feilmeldinger: Feil 2000 :... mangler. Feil 2006 :... er et ulovlig basiselement for objektet. Feil 2025 :... forekommer flere ganger. Feil 2029 :... har ulovlig verdiparameter. Advarsel 3004 : Har ikke tilslag på noen objekttype.

63 IT-R-0015/Rev. 1 Side: Statistikk For å kunne få en oversikt over dataene på fila, deres sammensetting og egenskaper, er det laget en del statistikker som prøver å gi et bilde av filens innhold. KVAKK gjør ingen forsøk på å tolke innholdet av disse statistikkene, og det er derfor opp til brukeren å dra konklusjoner Objekter (Test 6.1.1) De aller fleste gruppeelementene på en SOSI-fil tilhører en objektklasse. En objektklasse kan f.eks være høydekurve. Det er viktig å være klar over forskjellen mellom SOSI-versjon 1.4 og 2.x på dette området. I versjon 1.4 var det temakoden som identifiserte objektet, mens det i versjon 2.0 og senere også kan være egenskaper i tillegg til temakoden. Hvis filen er en SOSI 2.x fil, vil objektene ha navn, mens det for versjon 1.4 benyttes temakode. Objekt statistikk gjør følgende: Klassifiserer alle gruppelementene på SOSI-fila i objektklasser. Eksempel på rapport: DELKONTROLL 6.1.1: DATAGRUPPER SPESIFISERT PÅ OBJEKTER Antall Objektnavn Kvalitet grupper FM Fastmerke HDB Høydekurve Terrenglinje Terrengpunkt KYST Kystkontur TEXT Symbol Tekst Tekst

64 IT-R-0015/Rev. 1 Side: 58 Forklaring til tabellen: Kolonne Objektnavn Kvalitet Antall grupper Kommentar Forklaring 2.x : Objektklassen (navnet på objektet); 1.4 : Temakode Kvalitetsopplysninger Hvor mange grupper som tilfredsstiller denne objektklassen 2.x : Evt. kommentar fra definisjonsfil; 1.4 temakode oversettelse 11.2 Antall punkt pr. linje/kurve (Test 6.1.2) Eksempel på rapportfil: DELKONTROLL 6.1.2: ANTALL PUNKT PR LINJE/KURVE Antall Antall st Objektnavn Kvalitet grupper punkt snitt avvik max min HDB Høydekurve Terrenglinje KYST Kystkontur Forklaring til tabellen: Kolonne Objektnavn / Tema Kvalitet Antall grupper Antall punkt snitt st.avvik Forklaring 2.x : Navnet på objektklassen; 1.4 : Temakoden Kvalitetsopplysninger Antall gruppeelement i objektklassen Totalt antall punkt i gruppeelementene Gjennomsnittlig antall punkt i gruppeelementene Standard avviket for antall punkt i gruppeelementene

65 IT-R-0015/Rev. 1 Side: 59 max min Den høyeste antall punkt i et gruppeelement Det laveste antall punkt i et gruppeelement 11.3 Gjennomsnitt linjelengder (Test 6.1.3) Mange brukere av digitale kartdata har behov for en statistikk der man får ut linjelengder fordelt på objektklasser/temakoder. F.eks kan det være interessant å vite hvor mange kilometer veg som finnes på en SOSI-fil. Eksempel på rapport: DELKONTROLL 6.1.3: GJENNOMSNITT LINJELENGDER Antall Total st Objektnavn Kvalitet grupper lengde snitt avvik max min HDB Høydekurve Terrenglinje KYST Kystkontur Linjelengder beregnet med bare N og Ø koordinater (grunnriss) Alle avstander meter.

66 IT-R-0015/Rev. 1 Side: 60 Forklaring til tabell: Kolonne Objektnavn / Tema Kvalitet Antall grupper Total lengde snitt st.avvik max min Forklaring 2.x : Navnet på objektklassen; 1.4 : Temakoden Kvalitetsopplysninger. Antall gruppeelementer i objektklassen. Totalt lengde av linjer/kurver i objektklassen. Gjennomsnittlig lengde av linjer/kurver i objektklassen. Standard avviket for lengde av linjer/kurver i objektklassen. Lengden på den lengste linjen/kurven i objektklassen. Lengden på den korteste linjen/kurven i objektklassen Punkttetthet (Test 6.1.4) Denne statistikken prøver å gi et bilde av punkttettheten til de grafiske elementene på SOSIfila. Ved å gå igjennom avstanden mellom punkt i linjer/kurver, blir det laget en statistikk over den gjennomsnittlige punktavstanden for de ulike grafiske elementene på fila. Formel som benyttes: gj.sn.punktavstand = tot.lengde / (tot.ant.punkt - antgrupper) Eksempel på rapport: DELKONTROLL 6.1.4: PUNKTTETTHET Total Antall st Objektnavn Kvalitet lengde punkt snitt avvik max min HDB Høydekurve Terrenglinje KYST Kystkontur Linjelengder beregnet med bare N og Ø koordinater (grunnriss)

67 IT-R-0015/Rev. 1 Side: 61 Alle avstander meter. Forklaring til tabell: Kolonne Objektnavn / Tema Kvalitet Total lengde Antall punkt snitt st.avvik max min Forklaring 2.x : Navnet på objektklassen; 1.4 : Temakoden Kvalitetsopplysninger. Totalt lengde av linjer/kurver i objektklassen. Totalt antall punkt i linjer/kurver i objektklassen. Gjennomsnittlig punktavstand for linjer/kurver i objektklassen. Standard avviket for punktavstanden i objektklassen. Største punktavstand som forekommer i objektklassen. Minste punktavstand som forekommer i objektklassen Punkter spesifisert på temakoder (Test 6.2.1) SOSI-filer som har SOSI-nivå 3 eller høyere kan inneholde punkt informasjon, d.v.s at et punkt i f.eks en linje kan tildeles ekstra egenskaper i tillegg til gruppe-egenskapene. Slike egenskaper kan f.eks være kvalitetsopplysninger eller temakoder. Denne statistikken lager en tabell over punkter som har angitt temakoder på punktnivå (punktinformasjon). Eksempel på rapport: DELKONTROLL 6.2.1: PUNKTINFORMASJON SPESIFISERT PÅ TEMAKODER Antall Tema Gruppetype Kvalitet punkt Kommentar LINJE Forklaring til tabell: Kolonne Forklaring

68 IT-R-0015/Rev. 1 Side: 62 Tema Temakode angitt som punktinformasjon. Gruppetype Hvilket gruppeelement type punktene er i. Kvalitet Kvalitetsopplysninger. (Gjeldende, ikke nødvendigvis punktinfo) Antall punkt Antall punkt som har denne temakoden angitt som punktinfo. Kommentar Eventuell oversettelse til temakoden Kvalitetskoder (Test 6.3.1) På mange SOSI-filer vil kvalitetsopplysningene til de forskjellige grafiske elementene være ulike. Denne statistikken vil gi en tabell over forskjellige kombinasjoner av kvalitetsopplysninger på SOSI-filen. Kvalitetskoder gjør følgende: Teller opp hvor mange grupper som har de forskjellige kvalitetsopplysningene. Skriver ut en oversikt over forskjellige kombinasjoner av kvalitetsopplysninger, sammen med forklaringer til kodene.

69 IT-R-0015/Rev. 1 Side: 63 Eksempel på rapport: DELKONTROLL 6.3.1: KVALITETSKODER Gjennomgang av kvalitetskoder: Kvalitetskode fra hode: KVALITET Målemetode : Digital. på bord fra strek-kart: Papirkopi Nøyaktighet: Middelfeil: 2.00m Målestokk: 1:5000 Antall : 5 grupper. Andre benyttede koder: KVALITET Målemetode : Dig. på bord fra strek-kart: Transparent film - god kvalitet Nøyaktighet: Middelfeil: 2.00m Målestokk: 1:5000 Antall : 11 grupper. KVALITET Målemetode : Stereoinstrument: Analytisk plotter Nøyaktighet: Middelfeil: 2.00m Målestokk: 1:5000 Antall : 1 grupper. KVALITET * * 3 Synbarhet : Dårlig/ikke synlig i flybilde/modell. Antall : 1 grupper. KVALITET 81 0 Målemetode : Frihåndstegning: Digitalisert fra krokering på kart Nøyaktighet: Middelfeil: 0.00m Antall : 2 grupper Brukerdefinert statistikk (Test 6.3.2) Ved hjelp av denne testen kan brukeren definere spesielle SOSI-egenskaper som skal brukes som grunnlag ved statistikkberegning. Testen slås på og styres av parameterbryter /klassgifo, se kap 5.6. Parameterbrytere. Testen gjør følgende :

70 IT-R-0015/Rev. 1 Side: 64 Teller opp objekter med lik verdi for brukerspesifiserte attributter. Attributter som det ønskes statistikk over, angis med parameterbryter /klassginfo Eks. KVAKK TEST.SOS /KLASSGINFO="..KVALITET#3" Dette gir en statistikk over ulike målemetoder brukt i datagruppene.

71 IT-R-0015/Rev. 1 Side: Rapporter 12.1 Hva er en rapportfil? Resultatene av kontrollene KVAKK gjør på SOSI-fila blir lagt på rapportfiler. En rapportfil er en tekstfil der testresultatene er gitt som klartekst eller tabeller. Tekstfilen kan hentes opp i en teksteditor for redigering eller utskrift. KVAKK genererer 3 typer rapportfiler: Testrapport. Dette er den mest omfattende rapporten. Den inneholder alle feilmeldinger, statistikker og oversikter. Lograpport. Kortfattet rapport som inneholder bare feilmeldinger og advarsler. SOSI-rapport. SOSI-fil som inneholder hodegruppen fra originalfilen, i tillegg til underkjente grupper fra GRUPPEVIS INNHOLDSSJEKK sammen med kommentarer. Hvis det utført KNUTEPUNKTSKONTROLL, vil alle knutepunkter på originalfilen bli lagt i en.sverm gruppe på denne rapportfilen sammen med kommentarer om nodetype. Det vil alltid bli laget en testrapport og en lograpport. SOSI-rapport er en opsjon som angis på kommandolinjen når KVAKK startes Testrapport (*.txt) Dette er den største og mest omfattende rapporten som KVAKK lager. I tillegg til feilmeldinger inneholder den statistikker og oversikter. Testrapporten er inndelt i seksjoner. Hvis det er utført en full kontroll av SOSI-filen, vil rapportfilen ha følgende seksjoner: Diverse informasjon. (Testdato, versjon av KVAKK o.s.v) Formell formatsjekk (rapporter fra testene 1.1 til 1.4) Gruppevis innholdssjekk (rapporter fra testene 2.1 til 2.6) Knutepunkt kontroll (rapporter fra testene 3.1 til 3.3)

72 IT-R-0015/Rev. 1 Side: 66 Flate kontroll (rapporter fra testene 4.1 til 4.3) Objektkontroll (test 5.1) Statistikker (test til 6.3.1) For en nærmere beskrivelse av de enkelte seksjoner henvises det til kapitlene I toppen av rapportfilen vil det være en del informasjon. Den øverste linjen vil inneholder datoen testen ble utført og hvilken versjon av KVAKK som har laget rapporten. De neste linjene vil inneholde følgende informasjoner om SOSI-filen: filens navn filens størrelse (i bytes) datoen for når filens sist ble oppdatert / endret. Når KVAKK kontrollerer syntaksen til en SOSI-filen benytter programmet seg av noen definisjonsfiler som kalles for syntaksfiler. Navnet på definisjonsfilene som blir benyttet vil bli listet ut sammen med en del tilleggs informasjon. Informasjon som blir skrevet ut om SOSI-syntaks definisjonsfiler (syntaksfiler): Navnet på syntaksfilen. En kort kommentar til hva slags definisjoner syntaksfilen inneholder. Hvis et basiselement er definert flere ganger, vil det bli gitt beskjed om dette. Toppen av rapportfilen vil se slik ut: KVAKK 2.1 Testrapport pr.28/ Filnavn: SOSI\BE SOS Størrelse: Sist oppdatert: 11/ Tester som er slått av: Benyttede definisjonsfiler:

73 IT-R-0015/Rev. 1 Side: 67 SOSISTD.S21 Syntaksdefinisjoner 09/ bytes. KODER.B21 Kodeoversettelser 25/ bytes. OBJEKTER.B21 Objektdefinisjoner 04/ bytes. UTVALG.R21 Utvalgsregler 03/ bytes. NB! Dersom FYBA SOSI-tolk må avbryte programmet, vil feilmeldinger som FYBA gir ikke komme på testrapporten. Disse feilmeldingene vil bli skrevet ut på skjermen og til lograpporten Lograpport (*.log) Når man tester mange filer om gangen, er det upraktisk å lese igjennom mange testrapporter for å se etter feil. Ofte er man ikke interessert i statistikker og oversikter, men vil heller undersøke om SOSI-filen inneholder feil eller mangler. Lograpporten vil da være et alternativ. En lograpport vil bare inneholde feilmeldinger/advarsler, og det kan bli lagt mange lograpporter på en og samme fil. En lograpport for en typisk SOSI-fil, vil ta 5 til 15 linjer avhengig av hvor mange feil filen har. Som tidligere nevnt, vil det bli lagt flere lograpporter på en og samme fil. Lograpportene blir adskilt med en linje av streker ( ). Hvilken fil lograpporten blir lagt på avhenger av hvordan testen utføres. Se kapittelet 5.5 Utfil for en nærmere forklaring om dette. Eksempel på en lograpport: KVAKK 2.1 Lograpport pr.31/ Filnavn: SOSI\SOSISYD.SOS Størrelse: Sist oppdatert: 27/ Tester som er slått av: Benyttede definisjonsfiler: SOSISTD.S21 Syntaksdefinisjoner 29/ bytes. KODER.B21 Kodeoversettelser 25/ bytes. OBJEKTER.B21 Objektdefinisjoner 29/ bytes.

74 IT-R-0015/Rev. 1 Side: 68 UTVALG.R21 Utvalgsregler 03/ bytes. Feilmeldinger: Feil 2026: 10 grupper tilfredsstiller er ikke godkjent i objektkontrollen Merk at toppen på lograpporten vil inneholde den samme informasjonen som testrapporten (se kapittelet foran) SOSI-rapport (*.s) Mange SOSI-filer er ganske store, ofte flere megabytes. På slike filer kan det være vanskelig for brukeren å lokalisere feil som er kommentert på testrapporten, f.eks fordi teksteditoren ikke klarer å laste inn filen. For å unngå slike problemer kan KVAKK lage en SOSI-rapport som egentlig er en SOSI-fil med grupper fra filen som blir testet. Hodegruppen vil være den samme som for originalfilen, men SOSI-rapporten vil bare inneholde gruppeelementer som ikke ble godkjent i Gruppevis Innholdssjekk, i tillegg til en.sverm gruppe med alle knutepunkter på originalfilen. Feilmeldingene fra Gruppevis Innholdssjekk vil bli lagt etter gruppeelementet som feilmeldingene gjelder. De blir skrevet som kommentarer (!blabla). Eksempel på en SOSI-rapport:! Dette er en sosifil som inneholder grupper fra filen TEST.SOS! sammen med kommentarer.! Feilmeldinger og kommentarer er gitt slik: "!kommentar".hode 0..TRANSPAR...KOORDSYS 3...ORIGO-NØ ENHET HØYDE 10..OMRÅDE

75 IT-R-0015/Rev. 1 Side: 69...MIN-NØ MAX-NØ KVALITET SOSI-VERSJON 2.0..SOSI-NIVÅ 4.LINJE 500..NØ ( ! Feil 2004: 1 koordinater er utenfor området definert i.hode! Advarsel 3000: Temakode mangler.! Feil 2016:..NØ 32( Ulovlig tegn i heltall..linje 1..LTEMA KVALITET NØ KP 1...KVALITET...MÅLEMETODE 6...NØYAKTIGHET 6...SYNBARHET 6...BALUBA..NØ ( KP X! Feil 2004: 1 koordinater er utenfor området definert i.hode! Advarsel 3003:...BALUBA - Ukjent (udefinert) gruppeinfo.! Feil 2016:..NØ 32( Ulovlig tegn i heltall.! Feil 2016:...KP X - Ulovlig tegn i heltall..sverm 10000:!Alle knutepunkter på fila...nø! 1-er node på knutepunktslag ! Gruppe nr 3:..NØ! 5-er node på knutepunktslag ! Gruppe nr 2: ! Gruppe nr 2: ! Gruppe nr 2: ! Gruppe nr 3: ! Gruppe nr 2:..NØ! 1-er node på knutepunktslag ! Gruppe nr 15:

76 IT-R-0015/Rev. 1 Side: 70..NØ! 1-er node på knutepunktslag ! Gruppe nr 15:..NØ! 3-er node på knutepunktslag ! Gruppe nr 2: ! Gruppe nr 2: ! Gruppe nr 17:..NØ! 1-er node på knutepunktslag ! Gruppe nr 4:..NØ! 1-er node på knutepunktslag ! Gruppe nr 4:..NØ! 1-er node på knutepunktslag ! Gruppe nr 17:..NØ! 1-er node på knutepunktslag ! Gruppe nr 7:..NØ! 2-er node på knutepunktslag ! Gruppe nr 8: ! Gruppe nr 7:..NØ! 1-er node på knutepunktslag ! Gruppe nr 8:..NØ! 1-er node på knutepunktslag ! Gruppe nr 12:..NØ! 1-er node på knutepunktslag ! Gruppe nr 1:..NØ! 2-er node på knutepunktslag ! Gruppe nr 11: ! Gruppe nr 12:..NØ! 2-er node på knutepunktslag ! Gruppe nr 9: ! Gruppe nr 10:..NØ! 1-er node på knutepunktslag ! Gruppe nr 9:..NØ! 2-er node på knutepunktslag ! Gruppe nr 11:

77 IT-R-0015/Rev. 1 Side: ! Gruppe nr 10:..NØ! 1-er node på knutepunktslag ! Gruppe nr 6:..NØ! 1-er node på knutepunktslag ! Gruppe nr 13:..NØ! 2-er node på knutepunktslag ! Gruppe nr 6: ! Gruppe nr 13:..NØ! 1-er node på knutepunktslag ! Gruppe nr 19:..NØ! 1-er node på knutepunktslag ! Gruppe nr 19:.SLUTT

78 IT-R-0015/Rev. 1 Side: Definisjonsfiler 13.1 Hva er en definisjonsfil? En definisjonsfil er en tekstfil som inneholder definisjoner av ulike elementer som KVAKK benytter under kontroll av SOSI-filer. Definisjonsfiler kan hentes opp i en teksteditor og redigeres hvis det er ønskelig. Definisjonene på slike filer vil følge en spesiell syntaks, og vil variere fra ulike typer definisjonsfiler. Syntaksen til de ulike definisjonsfilene er beskrevet senere i dette kapittelet Hvorfor definisjonsfiler? Forskjellige brukere har forskjellige behov. For å gjøre KVAKK fleksibelt, og legge tingene til rette for brukertilpasning, er bruken av definisjonsfiler innført. For brukere av FYSAK vil bruken av slike filer ikke være helt ukjent, der det f.eks benyttes kommandofiler med utvalgsregler og tegneregler. Definisjonsfiler gjør det mulig for brukeren å skreddersy KVAKK til sitt formål. Det går også an å gjøre mindre oppdateringer av KVAKK uten å endre selve programkoden. NB! Det er viktig at de som benytter mulighetene med definisjonsfiler, vet hva de gjør. KVAKK utfører ingen syntakssjekk på definisjonsfilene, og skulle det være noe galt på slike filer kan man oppleve at KVAKK krasjer Definisjonsfilene til KVAKK KVAKK benytter seg av fire typer definisjonsfiler: Syntaksfiler. Inneholder definisjoner av basiselementer. Kodefiler. Inneholder lovlige koder til en del basiselementer, samt en forklaring/oversettelse til kodene. Utvalgsregelfiler. Inneholder klassifiseringsregler til objekter.

79 IT-R-0015/Rev. 1 Side: 73 Objektdefinisjonsfiler. Inneholder definisjoner til objekter. Filnavnene vil variere, men felles for dem alle er at filer som inneholder definisjoner til SOSI 1.4 vil ende med 14, SOSI 2.0 filer vil ende med 20 og SOSI 2.1 filer vil ende med 21. NB! Dersom SOSI-VERSJON skulle mangle eller være galt definert i HODE gruppen, vil KVAKK teste SOSI-filen mot SOSI versjon 2.2, og derfor benytte definisjonsfiler med endelsen "22" Syntaksfiler (*.S??) En syntaksfil inneholder definisjoner av basiselementer. Definisjonene skal skrives på samme måte som det er gjort i SOSI-standarden. Syntaksen til definisjonen av et basis element er som følger:

80 IT-R-0015/Rev. 1 Side: 74 Dette er sakset fra SOSI-standard kapittel om Syntaks <verdistørrelse>::= <tom> <positivt heltall> <positivt heltall>.<positivt heltall> <verditype>::=h<verdistørrelse> D<verdistørrelse> T<verdistørrelse> DATO REF SNR <ikke-verdi> <tom> <basisdefinisjon>::= <elementnavn> <verditype> <brukerdefinisjon>::= <nivå n> <basisdefinisjon> <nivå n> <elementnavn> * <niva n+1> <brukerdefinisjon> <definisjonsgruppe>::=.def <brukerdefinisjon># <definisjonsliste>::= <definisjonsgruppe># Basiselementer defineres på samme måte som brukerdefinerte basiselementer defineres på en SOSI-fil. Eksempel fra SOSISTD.S20:.DEF..TRANSPAR *...KOORDSYS H2...ORIGO-NØ *...ORIGO-N H8...ORIGO-Ø H8

81 IT-R-0015/Rev. 1 Side: 75...ENHET D6 Følgende syntaksfiler følger med KVAKK 2.2: SOSISTD.S14 - SOSI-standard basiselementer for SOSI-versjon 1.4. Inneholder alle definisjoner fra SOSI-standard 1.4. SOSISTD.S20 - SOSI-standard basiselementer for SOSI-versjon 2.0. Inneholder alle definisjoner fra SOSI-standard 2.0. SOSISTD.S21 - SOSI-standard basiselementer for SOSI-versjon 2.1. Inneholder alle definisjoner fra SOSI-standard 2.1. SOSISTD.S22 - SOSI-standard basiselementer for SOSI-versjon 2.2. Inneholder alle definisjoner fra SOSI-standard 2.2. Hvis det er ønskelig å definere sine egne syntaksfiler, i tillegg til de som er standard, er det bare å lage en syntaksfil i en vanlig teksteditor. Men for å gjøre KVAKK oppmerksom på nye syntaksfiler, må navnene på disse legges inn i en eller flere av filene DEFFILER.Lxx. I disse tre filene skal navnene på de syntaksfilene KVAKK benytter være oppgitt. Når KVAKK tester SOSI-filer av SOSI-versjon 1.4 benyttes syntaksfilene oppgitt i DEFFILER.L14, for SOSI-versjon 2.0 benyttes DEFFILER.L20, for SOSI-versjon 2.1 benyttes DEFFILER.L21 of for SOSI-versjon 2.2 benyttes DEFFILER.L22. Filene DEFFILER.L?? er vanlige tekstfiler som kan redigeres i en teksteditor. Dersom et basiselement er definert flere ganger på en eller over flere syntaksfiler, vil det bli gitt beskjed om dette i toppen av testrapporten. Se kapittel 12.2 Testrapport Kodefiler (KODER.B??) I mange tilfeller trenger KVAKK å oversette en del koder som er angitt som parametere til et basiselement. F.eks i test 1.1 der en del av HODE-informasjonen skal kommenteres. I filene KODER.Bxx er det lagt en del oversettelser for en del koder til noen vanlige basiselementer. Basiselementer hvis koder det finnes oversettelse til: MÅLEMETODE (KVALITET)

82 IT-R-0015/Rev. 1 Side: 76 NØYAKTIGHET (KVALITET) SYNBARHET (KVALITET) KOORDSYS (TRANSPAR) TEGNSETT Syntaksen for en slik kodeoversettelse er slik:.kode..<basiselement>-<kodeverdi>...betydning "<oversettelse>" "...BETYDNING" er et skjult basiselement, og skal ikke skrives. Eksempel fra KODER.B20:.KODE..TEGNSETT-DOSN8 "MS-DOS 8-bits tegnsett" For MÅLEMETODE er syntaksen litt annerledes:.kode..målemetode-<kodeverdi>...betydning "<oversettelse>"...dimm 2D 3D Opplysningen DIMM angir om målemetoden gir høydeverdier (3D) eller ikke (2D). Denne opplysningen benyttes i test 2.5. "...DIMM" er et skjult basiselement, og skal ikke skrives. Eksempel fra KODER.B20:.KODE..MÅLEMETODE-23 "Stereoinstrument: Autograf - vanlig registrering" 3D.KODE..MÅLEMETODE-30 "Scannet fra kart" 2D

83 IT-R-0015/Rev. 1 Side: Utvalgsregelfiler (UTVALG.R??) I objektkontrollen og i statistikkene har KVAKK behov for å plassere gruppeelementene på SOSI-fila i objektklasser. Dette gjøres ved hjelp av en utvalgsregelfil. En utvalgsregelfil inneholder regler som brukes til å klassifisere gruppeelementer i objektklasser. Hver objektklasse har hver sin utvalgsregel. En bru-vegkant f.eks har denne utvalgsregelen:.gruppe-utvalg Bru-vegkant..VELG "..LTEMA" = OG "..MEDIUM" = L..BRUK-REGEL Bru-vegkant Dette betyr at for at et gruppeelement skal klassifiseres som en bru-vegkant, må gruppeelementet ha basiselementet LTEMA med verdi lik 7002, samt basiselementet MEDIUM med verdi lik L (L betyr LUFT). De som har brukt FYSAK vil kjenne igjen syntaksen da KVAKK bruker FYSAK kommandofiler for å klassifisere gruppeelementer i objektklasser. Den generelle syntaksen kan formuleres slik:.gruppe-utvalg <objektklasse>..velg <utvalgskriterier>..bruk-regel <objektklasse> Utvalgskriterier: Kommando Parametere Forklaring

84 IT-R-0015/Rev. 1 Side: 78..VELG <sosinavn> <utvalgsmetode> <min> <max> <typekode> <feltnr> <pos i felt> Denne kommandoen definerer selve utvalgskriteriet. Første parameter er utvalgsmetode (se egen tabell under). De to neste parameterene definerer min og max verdi til det SOSI-navnet som velges. Dersom utvalgsmetoden er slik at dette ikke er noe interval oppgis bare en verdi...og <sosinavn> <utvalgsmetode> <min> <max> <typekode> <feltnr> <pos i felt> Typekoden går på hva slags type verdien til SOSI-navnet har. Kommandoen har samme parametere som..velg og benyttes for å lage logisk og i utvalget. Har en brukt..velg og..og i et utvalg må alle kriterier i både..velg og i..og være oppfylt for at utvalget skal slå til...eller <sosinavn> <utvalgsmetode> <min> <max> <typekode> <feltnr> <pos i felt> En kan ha flere..og i samme utvalgsregel. Kommandoen har samme parametere som..velg og benyttes for å lage logisk eller i utvalget. Har en brukt..velg og..eller i et utvalg er det nok at kriteriet i..velg eller kriteriet i..eller er oppfylt for at utvalget skal slå til...eller kan også brukes i kombinasjon med..og. Dette er sakset fra Brukerhåndboken til FYSAK. Definerte utvalgsmetoder: Utvalgsmetode = Forklaring med eksempel..velg "..LTEMA" = 4011 LIK Alle datagrupper som har SOSI-navn..LTEMA og verdi 4011 blir valgt.

85 IT-R-0015/Rev. 1 Side: 79!= IKKE LIK (Bare tilslag når den valgte verdien av SOSI-navn og verdi kombinasjon ikke finnes. Bare GINFO.)..VELG "..LTEMA"!= 4011 Alle datagrupper som ikke inneholder..ltema 4011 blitt valgt. <>..VELG "..LTEMA" <> FRA - TIL Alle datagrupper som inneholder SOSI-navnet..LTEMA og som samtidig har verdi fra og med 4011 til og med 4017 blir valgt. ><..VELG "..LTEMA" >< UTENFOR Alle datagrupper som har SOSI-navnet LTEMA og som har verdier som ikke er i intervallet fra og med 4011 til og med 4017 blir valgt. (Grupper som ikke har SOSI-navnet..LTEMA blir ikke valgt) <..VELG "..LTEMA" < 4011 MINDRE-ENN Alle datagrupper som har SOSI-navnet LTEMA og verdi mindre enn 4011 blir valgt. (Grupper som ikke har SOSI-navnet LTEMA blir ikke valgt.) >..VELG "..LTEMA" > 4011 STØRRE-ENN Alle datagrupper som har SOSI-navnet LTEMA og verdi større enn 4011 blir valgt. (Grupper som ikke har SOSI-navnet LTEMA blir ikke valgt.)

86 IT-R-0015/Rev. 1 Side: 80 /..VELG "..HØYDE" / 25 DELELIG MED Alle datagrupper med SOSI-navnet HØYDE og verdier som er delelige med 25 blir valgt. (Grupper som ikke har SOSI-navnet HØYDE blir ikke valgt.)!/..velg "..HØYDE"!/10 IKKE-DELELIG-MED Alle datagrupper med SOSI-navnet..HØYDE og verdier som ikke er delelige med 10 blir valgt. (Grupper som ikke har SOSI-navnet HØYDE blir ikke valgt.) ()..VELG "..STRENG" () SKAA INNEHOLDER AL Alle datagrupper med SOSI-navnet..STRENG og verdier som inneholder "SKAA" vil bli valgt. (Grupper som ikke inneholder..streng vil ikke bli valgt). (Dette er standard utvalgsmetode) ALLE..VELG "..LTEMA" AL Alle datagrupper som inneholder SOSI-navnet LTEMA vil bli valgt.! (Tilslag når SOSI-navnet ikke finnes) IKKE..VELG "..LTEMA"! Alle datagrupper som ikke inneholder SOSInavnet LTEMA blir valgt.

87 IT-R-0015/Rev. 1 Side: 81 IV IKKE VALGT (Tilslag når gruppen ikke er valgt ennå. Kombineres med SOSI-navnet "..*". Bør ligge sist av utvalgene...velg "..*" IV Alle grupper som ikke er valgt før (tegnet) blir valgt. Dette er sakset fra brukerhåndboken for FYSAK. Eksempler på en del utvalgsregler fra UTVALG.R20:.GRUPPE-UTVALG Usikker-høydekurve..VELG "..LTEMA" = OG "..KVALITET#3" = 3..BRUK-REGEL Usikker-høydekurve.GRUPPE-UTVALG Brønnlokk/adkomst-Tunneladkomst..VELG "..PTEMA" = ELLER "..LTEMA" = BRUK-REGEL Brønnlokk/adkomst-Tunneladkomst.GRUPPE-UTVALG Tekst-Navn-på-et-fjellparti..VELG "..TTEMA" = OG "..STRENG"..OG "..DIM" AL..BRUK-REGEL Tekst-Navn-på-et-fjellparti 13.7 Objektdefinisjonsfiler (OBJEKTER.B??) Når et gruppeelement er plasser i en objektklasse ved hjelp av utvalgsregler, må objektet kontrolleres mot en mer omfattende definisjon. Disse definisjonene ligger på objektdefinisjonsfilene OBJEKTER.Bxx.

88 IT-R-0015/Rev. 1 Side: 82 Syntaksen på en objektdefinisjon er som følger:.def..objekttype *...TYPENAVN T16...ALIASNAVN T16...KOMMENTAR T80...INKLUDER T16...FKB-DATA T8...EGENSKAP *...EGE-NAVN T16...EGE-TYPE T8...SOSINAVN T16...SOSITYPE T4...FOREKOMST T1...LOVOPER T2...LOVINTERV T32...STD-VERDI T32...OPERATOR T2! Objekttype m/ like egenskapsnavn.! Navn på objekttype.! Navn på objekttype hvis dette avviker fra TYPENAVN. Det er dette navnet som fremkommer i statistikkene på rapportfilene. Denne egenskapen er frivillig.! Kommentar til objektet. Frivillig egenskap.! Brukes til å inkludere andre objektdefinisjoner. Frivillig egenskap. (Kan ha flere parametre).! Tilhørighet til FKB-kapitel.! Faste egenskaper defineres.! Navn på fast egenskap. (DB)! Datatype (DB)! SOSI-navn, evt. m/ verdinr.! SOSI-datatype (H/D/T + ant tegn)! Antall forekomster lovlig.! Operator for lovlig intervall.! Lovlig intervall for verdi.! Standardverdi hvis ingen verdi.! Lovlige operatorer ved seleksjon. Maksimalt 160 tegn pr. Linje i objektdefinisjonsfilene. Noen av disse definisjonsfeltene trenger en ekstra kommentar: Typenavn : Kommentar: Navnet på objektklassen objektet tilhører. Eventuelle kommentarer OBJEKTER.B14 : temakodens betydning. OBJEKTER.B20 : kommentarer fra objekttabell i SOSI-standarden del 3, kode og objektliste. OBJEKTER.B21 : kommentarer fra objekttabell i SOSI-standarden del 3, objekter og kodelister.

89 IT-R-0015/Rev. 1 Side: 83 FKB-data: Hvilken FKB-del/kapittel objektklassen hører inn under. Ege-navn: Benyttes ikke av KVAKK. Ege-type: Benyttes ikke av KVAKK. Sosinavn: Basiselement. Sositype: Datatypen til basiselementet, f.eks H10 (heltall med max 10 siffer). Forekomst: E: Enkel (bare en gang pr. gruppelement). M : Multippel (kan opptre flere ganger med ulike verdier i et gruppelement.) Lovoper: <> : Innenfor interval. >< : Utenfor interval. =: Lik Lovinterv: Lovlig interval som angis enten som (<verdi1>,<verdi2>) eller bare <verdi>. Lovoper bestemmer hvordan intervallet skal tolkes. Stdverdi: Standardverdi må enten være en verdi, MÅ (obligatorisk) eller -1 (opsjon). Dersom standardverdi er en verdi blir dette oppfattet av KVAKK som at egenskapen er obligatorisk. Operator: Ikke benyttet av KVAKK. Eksempel på en objektdefinisjon:.objekttype..typenavn Global..EGENSKAP **************** ******** "..KVALITET#1" H2 E <> (10,82) -1..EGENSKAP **************** ******** "..KVALITET#2" H5 E <> (13,99999) -1.OBJEKTTYPE..TYPENAVN Fastmerke_spesial..ALIASNAVN Fastmerke..INKLUDER Global..KOMMENTAR "FMHREF bare hvis ulik FMSREF"..FKB-DATA FM..EGENSKAP **************** ******** "..PTEMA" H4 E = (1000) EGENSKAP **************** ******** "..FMTYPE" T1 E = (S,T,P,F,N,G) MÅ..EGENSKAP **************** ******** "..FMID" T4 E >< () MÅ..EGENSKAP **************** ******** "..FMSREF" T2 E = (TB,FB,TR,FR,TV,FV,BH,SP,TL) MÅ..EGENSKAP **************** ******** "..FMHREF" T2 E = (TB,FB,TR,FR,TV,FV,SP,TL) -1..EGENSKAP **************** ******** "..HOB" D10 E >< () MÅ

90 IT-R-0015/Rev. 1 Side: Definisjonsfil-lister. Navn på alle definisjonsfilene som skal benyttes i en bestemt KVAKK-kjøring, legges inn på en definisjonsfil-liste. Objektdefinisjoner (*.Bxx), utvalgsregler (*.Rxx), kodedefinisjoner (*.Bxx) og syntaksdefinisjoner (*.Sxx) kan deles på flere definisjonsfiler. Navnene på disse filene skal legges inn i filene DEFFILER.L22 (SOSI 2.2), DEFFILER.L21 (SOSI 2.1), DEFFILER.L20 (SOSI 2.0) eller DEFFILER.L14 (SOSI 1.4). Filen har følgende format: [SyntaksDefinisjoner] SOSISTD.S21 <evt. andre syntaksfiler> [KodeForklaringer] KODER.B21 <evt. andre kodedefinisjonsfiler> [UtvalgsRegler] UTVALG.R21 <evt. flere utvalgsregelfiler> [ObjektDefinisjoner] OBJEKTER.B21 <evt. flere objektdefinisjoner> Man kan angi navn på fillisten for definisjonsfiler på kommandolinjen,ved å bruke kommandobryteren /def:<filnavn>. Hvis denne bryteren ikke er angitt vil KVAKK lete etter filen DEFFILER.L2x eller DEFFILER.L14 avhengig av SOSI-versjon.

91 IT-R-0015/Rev. 1 Side: Krav til maskinvare PC: IBM kompatibel med minimum Intel prosessor (AT type) Operativsystem: Windows 3.1/3.11/95/NT eller OS/2 (fra ver. 1.2) Diskplass: ca. 1 MB. Hukommelse: 4 MB Annet: En diskcache øker ytelsen på programmet dramatisk. eks. smartdrive (windows) eller hyperdisk (shareware). Hvis maskinen har en matteprosessor (80x87 eller 486) vil ytelsen bli bedre. Operativsystemet må tillate KVAKK å ha minst 40 filer åpne samtidig. Dersom dette ikke er tilfellet, stopper programmet med en feilmelding. Se i operativsystemets brukermanual om hvordan grensen for antall åpne filer samtidig kan endres. Eksempel for MS/DOS: Legg inn linjen: FILES=40 i filen CONFIG.SYS. For store filer vil enkelte kontroller ta meget lang tid. Dette gjelder spesielt for Knutepunktskontroll. Ved å benytte seg av fillister testes flere filer etter hverandre når PC'en er ledig, f.eks om natten.

92 IT-R-0015/Rev. 1 Side: Vanlige feil på SOSI-filer Under utviklingen av KVAKK har vi kommet over en del feil på SOSI-filer som synes å gå igjen. Mange av disse er veldig alvorlige, og de fleste av dem er unødvendige. Vi håper at KVAKK vil være med på å bedre denne situasjonen. Dersom du vet om feil som SOSI-filer ofte har, men som KVAKK ikke oppdager, tar vi gjerne i mot forslag til nye kontroller (se kap. 1.4 Tilbakemeldinger) Tegnsettfeil Riktig definisjon av tegnsett er noe det slurves mye med. Problemet synes å følge de filer som er produsert på utstyr fra Norsk Data, d.v.s at de benytter tegnsettet ND7 uten å oppgi det som hodeinformasjon. Feilen rettes enkelt ved å sette inn linjen "..TEGNSETT ND7" i hodet på filen, eller rett og slett ved å oversette filen til DOSN8 tegnsett. De fleste norske kartsystemer vil kunne lese SOSI-filer med galt tegnsett, og det går som oftest bra for tall/koordinatdelen av kartadataene, men en kan ikke være sikker på resultatet av tekst-konverteringen. Derfor: TEGNSETT skal være med i SOSI-hodet dersom det avviker fra standarden (DOSN8). Noen filer har mange ulovlige tegn. Dette fører til tap av informasjon eller i verste fall at filen blir ubrukelig. Dette er en feil som kan være vanskelig eller umulig å rette. Det synes som det finnes produksjonsmaskiner med en "bad sector" ett eller annet sted i Norge. I mange filer opptrer det store blokker med ulovlige tegn der blokkene er like lange og tegnene de samme Ukjent gruppeinfo Du vil ofte få feilmeldingen "..xxxxx er ukjent (udefinert) gruppeinfo.". Dette skyldes at mange definerer sine egne elementer, og at det stadig blir definert nye. Følgelig vil definisjonsfilene til KVAKK bli hengende etter. Du kan selv legge til nye definisjoner i definisjonsfilene. Les mer om dette i kapittel 13. Definisjonsfiler Koordinater Mange SOSI-filer inneholder koordinatfeil. Dette er i hovedsak filer som har koordinater utenfor området definert i hodet på fila. Ingen alvorlig feil, men det er en enkel sak å rette opp feilen. På mange filer vil du få advarselen "Misforhold mellom nøyaktighet og enhet". Denne kontrollen baserer seg på at enheten som gjelder bør være mindre enn nøyaktigheten for koordinaten, samtidig som enheten bør være større enn nøyaktigheten/100. Du må altså være enig i formelen for å bry deg om advarselen.

93 IT-R-0015/Rev. 1 Side: Sære SOSI-filer SOSI er et fleksibelt format der det meste kan synes å være lov. Men her er det viktig å skille mellom teori og praksis. Selv om en SOSI-fil kan være syntaksmessig teoretisk korrekt, kan den være ubrukelig i mange kartsystemer. Med SOSI 2.x har denne situasjonen bedret seg da man i tillegg til definisjoner har fått eksempler på hvordan definisjonene skal brukes. eksempel: teoretisk korrekt men allikevel feil: praksis:..kvalitet..kvalitet MÅLEMETODE 55...NØYAKTIGHET 200 KVAKK håndterer begge tilfellene ovenfor, men det er viktig å være oppmerksom på at mange kartsystemer bare godtar den kompakte formen. Slike særheter vil derfor ikke gi seg utslag i feilmeldinger, da syntaksen strengt tatt er lovlig. Men har du SOSI-filer som får kartsystemet til å oppføre seg rart kan slike ting være en årsak Referanser Det kan synes noe merkelig at referanser ikke følger standard SOSI- tradisjon med et definert gruppeelement som f.eks..referanse. I stedet angis referanser på formen ".. :nnn (:nnn)". I noen SOSI-filer er referanser gitt på formen ".. :(nnn)" noe som er galt. Det er også viktig å huske på at i SOSI 1.4 er det lov med bare en referanse mellom paranteser, mens det i SOSI 2.x kan være flere "Gale" feilmeldinger I SOSI er det lov å gjenta parametere for et og samme gruppe element. Dette benyttes ofte for koordinater.

94 IT-R-0015/Rev. 1 Side: 88 eks. Effektivt Omstendelig..NØ x1 y1 x2 y2..nø x1 y1..nø x2 y2 Dette kan føre til at du enkelte ganger kan få underlige feilmeldinger. Tenk deg følgende tilfelle der produsenten har glemt "..NØ" foran koordinatene:.linje..ltema o.s.v Her vil koordinat verdiene ganske korrekt bli tolket av KVAKK som temakoder, siden det var det siste elementet på nivå 2. Feilmeldingen som blir gitt er da "For mange siffer i heltall" siden temakoder skal ha max 4 siffer SOSI-nivå SOSI-nivået til en fil er ment å gi opplysning om hva slags informasjon som finnes på fila og hvor godt den er knyttet sammen. Ofte lyver SOSI-nivå opplysningen i hodet. En SOSI-fil trenger f.eks bare ett knutepunkt for kalle seg nivå 3, og bare en flate for nivå 4. KVAKK har en del statistikker som avslører slike filer, f.eks. Antall flater (kap. 7.6 SOSI-syntaks) og Antall knutepunkt (kap. 8 Knutepunktskontroll) Manglende koordinater Du vil ofte komme ut for grupper der det mangler koordinater. For eksempel linjer med bare ett punkt eller flater uten representasjonspunkt. Slike grupper kan lokaliseres ut i fra rapportfilen KVAKK lager.

95 IT-R-0015/Rev. 1 Side: 89 Appendix A: Feilmeldinger/Advarsler Dette kapittelet inneholder en oversikt over alle feilmeldinger/advarsler som KVAKK gir, i tillegg til en forklaring til hver enkelt melding. Fatale feil (avbryter kontrollen) Med fatale feil menes det feil som fører til at kontrollen av filen må avbrytes. Kontrollen må avbrytes p.g.a at feilen som er avdekket gjør at kontrollen ikke vil forløpe som normalt. Fatale feil blir skrevet ut på skjerm i tillegg til testrapport og logfil. Fatal 1000 : HODE-gruppe finnes ikke på filen. KVAKK har ikke funnet.hode gruppen på filen. Fatal 1001 : HODE-gruppen er ikke i starten på filen. Det finnes informasjon foran.hode gruppen. Blanke linjer eller kommentarer regnes ikke som informasjon. Fatal 1002 : Ukjent SOSI-nivå definert i HODE. SOSI-NIVÅ er oppgitt i.hode, men det er ikke 1,2,3 eller 4. Fatal 1003 : Feil eller manglende definisjon av TRANSPAR i HODE. KVAKK har ikke funnet alle parameterene til..transpar i.hode gruppen, eller de kan være ulovlige. Hvis TRANSPAR informasjonen ikke er fullstendig kan KVAKK ikke tolke dataene på SOSI-filen. Fatal 1004 : Feil eller manglende definisjon av OMRÅDE i HODE. OMRÅDE opplysningene er enten oppgitt galt eller ikke oppgitt i det hele tatt. Fatal 1005 : For mangle ulovlige tegn. Det er funnet flere enn 20 ulovlige tegn på fila. Fatal 1006 : FYBA SOSI-tolk stoppet programmet.

96 IT-R-0015/Rev. 1 Side: 90 Det har oppstått en feil når FYBA har lest SOSI-filen. Eventuelle feilmeldinger som FYBA har gitt er skrevet ut til logfilen. Fatal 1007 :... er en ukjent SOSI-versjon! (Dette programmet tester ver. 1.4, 2.0 og 2.1) SOSI-VERSJONEN som er oppgitt i.hode er ikke 1.4, 2.0 eller 2.1. Hvis SOSI- VERSJON ikke er oppgitt antar KVAKK at det er versjon 2.1. Fatal 1008 :.SLUTT er ikke funnet på filen. Filen mangler.slutt. Det tyder på at det mangler data på filen, eller at filen er ødelagt. Fatal 1009 : Tegnsettet er ikke lovlig for denne SOSI-versjonen. ANSI tegnsettet er benyttet på en fil som har SOSI-versjon 1.4. Fatal 1010 : OMRÅDE opplysninger i.hode er speilvendt. Minimumsverdier er større enn maksimumsverdier i område opplysninger. Fatal 1011 : Oppgitt tegnsett er feil. De norske tegnene på fila passer ikke med tegnsettet som enten er oppgitt i.hode eller gjelder som standard. Fatal 1012 : Ekstra.HODE-gruppe funnet Det er funnet flere forekomster av.hode på filen. Fatal 1013 : Linje lenger enn 150 tegn. Test 2 aborterer Kvakk hvidet finnes linjer med mer enn 150 tegn. Dette er av hensyn til FYBA. Feil Dette er meldinger om ting som er feil i følge definisjonen av SOSI-formatet. Disse feilene vil vanligvis ikke skape problemer for forløpet av kontrollen. Feil 2000 :... mangler.

97 IT-R-0015/Rev. 1 Side: 91 Et obligatorisk basiselement er ikke funnet i gruppelementet. Testene 1.1, 2.6 og 5.1 kan gi denne feilmeldingen. Feil 2001 : Inneholder punkt. Det er funnet koordinater i et gruppeelement som ikke kan inneholde koordinater. Feil 2002 : n punkt mangler. Et gruppeelement har for få punkt i forhold til det definisjonen sier. F.eks en LINJE med bare et punkt. Feil 2003 : n punkt for mange. Et gruppeelement har for mange punkt i forhold til det definisjonen sier. F.eks en FLATE med flere enn 1 punkt. Feil 2004 : n koordinater utenfor område. Det er funnet koordinater som ligger utenfor de max/min - verdiene som er angitt i HODE-gruppen ved hjelp av basiselementet OMRÅDE. Feil 2005 : Det er funnet grupper som refererer til ukjente grupper. Grafiske objekter som inneholder referanser til gruppeelementer som ikke finnes på fila. Feil 2006 :... er et ulovlig basiselement for objektet. Et gruppeelement inneholder et basiselement, som ikke forekommer i objektdefinisjonen som gruppen fikk tilslag på. Feil 2007 : Bare HØYDE, ingen koordinater. Basiselementet HØYDE er benyttet i et gruppeelement som ikke har koordinater. Feil 2008 : Det finnes både NØH og HØYDE. Basis elementene NØH og HØYDE er benyttet i det samme gruppeelementet. Da begge disse basiselementene angir høydeverdier fører dette til en konflikt mellom de to. Feil 2009 : Det finnes både NØ, NØH og HØYDE. Det finnes en blanding av punkter med og uten høydeverdier, i tillegg til problemet angitt i feil 2008.

98 IT-R-0015/Rev. 1 Side: 92 Feil 2010 : Ulovlig gruppeelement navn. Gruppeelementet er ulovlig. Lovlige navn kan f.eks være LINJE, PUNKT o.s.v. Feil 2011 :... - Teksten avsluttes ikke med apostrof. En tekst som begynner med " eller ' er ikke avsluttet med et tilsvarende tegn. Feil 2012 :... - Teksten er for lang. En tekst er for lang i forhold til definisjonen av basiselementet som teksten er et parameter til. Feil 2013 : Avsluttende parantes mangler i referanse. En øyreferanse mangler den avsluttende parantesen. Feil 2014 : Referanse begynner ikke med ':'. Et grafisk objekt inneholder en referanse som ikke har et kolon foran serienummeret til gruppeelementet det refereres til. Feil 2015 : n - For mange siffer i heltall. Et heltall er for stort i forhold til definisjonen av basiselementet som heltallet er et parameter til. Feil 2016 : n - Ulovlig tegn i heltall. Det finnes andre tegn enn tall og ledende + eller - i et heltall. Feil 2017 : n.n - For mange siffer i desimaltall. Bredden til et desimaltall er for stor i forhold til definisjonen av basiselementet som desimaltallet er et parameter til. Feil 2018 : n.n - For mange desimaler i desimaltall. Det er for mange tall bak komma i et desimaltall i forhold til definisjonen av basiselementet som desimaltallet er et parameter til. Feil 2019 : n.n - Ulovlig tegn i desimaltall. Det finnes andre tegn enn tall, komma, E, D, + eller - i et desimaltall.

99 IT-R-0015/Rev. 1 Side: 93 Feil 2020 : n ekstra HODE grupper funnet. Filen har flere enn 1 HODE gruppe. Feil 2021 : n ikke godkjente tegn funnet. Filen inneholder tegn som ikke er lovlige for det aktuelle tegnsettet. Feil 2022 : Det er funnet grupper med like serienummer. To eller flere grupper har det samme serienummeret. Et serienummer må være unikt. Feil 2023 : n grupper har syntaksfeil. Dersom et gruppeelement ikke inneholder obligatoriske basiselementer, inneholder ulovlige basiselementer eller har basiselementer med ulovlige parametere, kalles det for en syntaksfeil. Feil 2024 : Oppgitt SOSI-nivå stemmer ikke med innhold på fila. Det oppgitte SOSI-nivå i HODE-gruppen er ikke det samme som det virkelige SOSInivå som filen tilfredsstiller. Feil 2025 :... forekommer flere ganger i gruppen. Det er funnet flere forekomster av et basiselement som bare skal forekomme en gang for hvert gruppelement. Feil 2026 : n grupper tilfredsstiller er ikke godkjent i objektkontroll. Gruppeelementer som ikke tilfredsstiller kodingsregelene spesifisert i del 3 av SOSIstandarden. Feil 2027 : n flater har repr.punkt utenfor sine grenser. En flates sentralpunkt/representasjonspunkt skal ligge innenfor flatens grenser. Feil 2028 : Det er funnet n feil i flatereferanser. Flater som har grenser som ikke går helt i sammen, eller som ikke har endepunktene definert som knutepunkt. Feil 2029 :... har ulovlig verdiparameter.

100 IT-R-0015/Rev. 1 Side: 94 Parameterverdien til et basiselement er ikke innenfor det lovlige interval av parameterverdier. Feil 2030:... er et ulovlig gruppeelement for denne SOSI-versjonen. Gruppeelementer som er gjelder for noen SOSI-versjoner, f.eks er.struktur ulovlig fra og med SOSI versjon 2.2. Feil 2031: Serienummer avsluttes ikke med ":". Gruppeelementer med serienummer som mangler kolon (:) bak heltallet i serienummeret. Feil 2032: Serienummer mangler. Gruppeelementer som mangler serienummer. Feil 2033:... er en ulovlig dato. Dato som tilfredsstiller kravet til et 8 sifferet heltall, men som likevel gir en ulovlig dato, som f.eks (30.Februar 1994). Advarsler Dette er meldinger om ting som ikke er bra, men som heller ikke er ulovlige. Ofte vil dette være ting som det hersker uenighet om det er lovlig eller ulovlig. Advarsel 3000 : Temakode mangler. Gruppeelementet inneholder ingen temakode, slik som LTEMA eller PTEMA. Advarsel 3001 : Det er funnet n blindnoder (1-er noder) på filen. En blindnode er et knutepunkt som tilhører bare 1 grafisk element, og som derfor ikke er noe reelt knutepunkt. Advarsel 3002 : Det finnes både NØ ognøh koordinater. Det finnes en blanding av koordinater med og uten høydeverdier i gruppeelementet. Advarsel 3003 :... - Ukjent (udefinert) gruppeinfo.

101 IT-R-0015/Rev. 1 Side: 95 Gruppeelementet inneholder et basiselement som ikke er definert i tilgjengelige baser/definisjonsfiler. Advarsel 3004 : Har ikke tilslag på noen objekttype. Gruppeelementet faller ikke inn under noen objektklasse definert i objektkatalogen. (SOSI 1.4 : gruppeelementet har ikke noen temakode) Advarsel 3005 : n linjer mellom.slutt og filslutt. Det finnes informasjon mellom.slutt og den posisjonen der filen tar fysisk slutt i følge operativsystemet. Tomme linjer eller kommentarer regnes ikke som informasjon. Advarsel 3006 : Det er misforhold mellom nøyaktighet og enhet i HODE. Kvalitetsopplysningene i HODE tilfredsstiller ikke forholdet mellom enhet og nøyaktighet beskrevet i kapittel 7.4. Advarsel 3007 : n grupper med misforhold mellom nøyaktighet og enhet. Kvalitetsopplysningene i gruppeelementet tilfredsstiller ikke forholdet mellom enhet og nøyaktighet beskrevet i kapittel 7.4. Advarsel 3008 : n grupper med misforhold mellom målemetode og høydedata. Antall gruppeelementer som har fått en eller flere av feilmeldingene 2006, 2007, 2008, 2009 eller Advarsel 3009: 3D måling uten HØYDE/NØH. Et gruppeelement som er registrert med et instrument som gir høyde verdier, har punkter som mangler høydeverdier. Advarsel 3010: Negativ høydeverdi. Gruppeelement som har punkt(er) med negativ høyde (z-verdi). Advarsel 3011 : n grupper med blanding av 2D og 3D koordinater. Antall gruppeelementer som har fått feilmeldingen 3002.

102 IT-R-0015/Rev. 1 Side: 96 Programfeil under kjøring Noen ganger kan det oppstå programfeil. Slike feil skyldes ikke feil på SOSI-filen, men oppståtte situasjoner som gjør at kontrollen ikke kan fortsette. Slike situasjoner kan være: For lite minne. Hvis det er for lite intern hukommelse vil dette føre til at KVAKK kan avslutte med feilmeldingen "For lite minne! avslutter...". Store SOSI-filer krever mer intern hukommelse enn mindre. Vi anbefaler at KVAKK får ca Kb hukommelse ledig. Programmet får ikke åpnet en fil. Hvis KVAKK ikke får åpnet en fil vil programmet avslutte med feilmeldingen "Får ikke åpnet filen <filnavn>! avslutter...". Dette kan f.eks skje ved at du har oppgitt navnet til en SOSI-fil som ikke finnes, eller at KVAKK ikke finner en av definisjonsfilene som trengs for å gjennomføre kontrollen.

103 IT-R-0015/Rev. 1 Side: 97 Appendix B: Eksempel på SOSI-fil.HODE 0:..TRANSPAR...KOORDSYS 3...ORIGO-NØ ENHET HØYDE 10..OMRÅDE...MIN-NØ MAX-NØ KVALITET SOSI-VERSJON 1.4..SOSI-NIVÅ 4.LINJE 500:..NØ ( LINJE 1:..LTEMA KVALITET NØ KP ( KP 1.PUNKT 7000:..PTEMA PTEMA NØ

104 IT-R-0015/Rev. 1 Side: 98.LINJE 9999:..LTEMA NØ LINJE 9998:..LTEMA NØ LINJE 2:..LTEMA KVALITET NØ KP 1..NØ KP 1..NØ KP 1.LINJE 3:..LTEMA KVALITET NØ KP 1..NØ

105 IT-R-0015/Rev. 1 Side: KP 1.LINJE 4:..LTEMA KVALITET NØ KP 1..NØ KP 1.LINJE 6:..LTEMA KVALITET * * 3..NØ KP 1..NØ KP 1.LINJE 7:..LTEMA KVALITET NØ KP 1..NØ KP 1.LINJE 8:..LTEMA 4011

106 IT-R-0015/Rev. 1 Side: 100..KVALITET NØ PTEMA KP 1..NØ PTEMA KP 1.LINJE 9:..LTEMA KVALITET NØ KP 1..NØ KP 1.LINJE 10:..LTEMA KVALITET NØ KP 1..NØ KP 1.LINJE 11:..LTEMA 4011

107 IT-R-0015/Rev. 1 Side: 101..KVALITET NØ PTEMA KP 1..NØ PTEMA NØ PTEMA NØ PTEMA NØ PTEMA NØ PTEMA NØ PTEMA KP 1.LINJE 12:..LTEMA KVALITET NØ KP 1..NØ KP 1.LINJE 13:..LTEMA KVALITET NØ KP 1..NØ KP 1.LINJE 15:

108 IT-R-0015/Rev. 1 Side: 102..LTEMA NØ KP 1..NØ KP 1.LINJE 19:..LTEMA KVALITET NØ KP 1..NØ KP 1.SLUTT

109 IT-R-0015/Rev. 1 Side: 103 Appendix C: FYBA SOSI-tolk KVAKK benytter seg av FYBA SOSI-tolk fra Statens kartverk. Dette er Kartverkets egen programvare for å operere mot SOSI-filer, og den benyttes av FYSAK programvaren fra Kartverket. Det følger både fordeler og ulemper med at KVAKK benytter seg av FYBA. Fordelene er at FYBA's raske lese rutiner og kraftige søkefunksjoner gjør det mulig å lage avanserte kontrollrutiner. Dessuten vil enhver forbedring av FYBA også bety en forbedring av KVAKK. I stedet for å finne opp hjulet på nytt, kunne vi heller konsentrere oss om de forskjellige kontrollrutinene. Til tross for fordelene ved FYBA, er det viktig å være klar over en del ulemper. FYBA er laget som et generelt bibliotek av lese, skrive og søke funksjoner, og FYBA's primære bruksområde tilsier at hastighet er en viktig faktor. Derfor gjør ikke FYBA noen utstrakt kontroll av SOSI-filen som det jobbes mot. På grunn av dette vil enkelte SOSI-filer med feil kunne krasje FYBA og dermed også KVAKK. KVAKK vil ikke starte FYBA dersom programmet finner feil som kan skape problemer, men i stedet skrive ut en feilmelding. FYBA benyttes fra knutepunktskontroll og utover. Dersom du hopper over formell formatsjekk og/eller gruppevis innholdssjekk ved hjelp av parameterbrytere, vil du kunne få problemer med enkelte filer. Utfør en full kontroll av slike filer. FYBA startes opp før knutepunktskontroll og benyttes i alle etterfølgende kontroller. Men før programmet kan operere mot SOSI-filen, må alle SOSI-gruppene indekseres. Du vil få en melding på skjermen når dette gjøres. Siden indekseringen foregår i to omganger, vil prosentindikatoren telles opp til 100% to ganger. Vanligvis vil KVAKK slette disse indeksene når kontrollen er ferdig, men hvis du benytter FYSAK programvare mot den samme filen vil der være ønskelig å ikke slette disse indeksene. Ved å benytte parameterbryteren /saveidx, vil du hindre KVAKK i å slette indeksene.

110 IT-R-0015/Rev. 1 Side: 104 Appendix D : Tilbakemeldings-blankett Utfylles og sendes til: Statens kartverk, SOSI-sekretariatet, Kartverksveien HØNEFOSS Bruker Navn/firma: Kontaktperson: Adresse: Postnr/sted: Telefonnr: KVAKK Versjon: Versjonsdato: Operativsystem O Windows 3.1/3.11 O Windows 95/NT O OS/2 SOSI-fil Navn: Størrelse (bytes): SOSI-versjon: SOSI-nivå: Tegnsett: Produsent: O Filen er vedlagt på diskett. Problem O Programmet avsluttet med feilmeldingen:

111 IT-R-0015/Rev. 1 Side: 105 O Programmet låste seg uten noen feilmelding. O Programmet avsluttet normalt, men rapportene var ikke riktige. O Annet: Kommentar: O Rapportutskrifter vedlagt. Dato: Underskrift:

112 IT-R-0015/Rev. 1 Side: 106 Appendix E : Kort om SOSI syntaks For en utdyping av det som står her, henvises til SOSI-standard, del 1 - Generell del og Praktisk bruk. Gruppelement En SOSI-fil består av gruppeelementer. Et gruppeelement kan være et grafisk element, f.eks en LINJE eller et PUNKT, eller et grafisk objekt f.eks FLATE. Det viktigste gruppelementet på en SOSI-fil er hodegruppen. Denne inneholder informasjon som gjelder for alle de andre gruppeelementene på fila. Basiselement Et gruppeelement gis egenskaper ved å benytte basiselementer. Et basiselement kan f.eks være kvalitetsopplysninger eller en temakode. Koordinater angis med basiselementene NØ (uten høyde) eller NØH (med høyde). Et basiselement består av et basiselement-navn og en kode/verdi. Eks:..LTEMA 5001 <elementnavn><kodeverdi> Prikksyntaks SOSI benytter en form for prikksyntaks for å angi forskjellige nivåer. En prikk tilsvarer 1 nivå. Gruppelementer angis på nivå 1 (eks.linje). Basis elementer angis på nivå 2 eller høyere. Grafiske elementer Et grafisk element inneholder koordinater og aktuell egenskapsinformasjon i form av basiselementer. Eksempler på grafiske elementer er LINJE, KURVE eller PUNKT. Grafiske objekter Et grafisk objekt består av ett eller flere grafiske elementer. Dette gjøres ved at det grafiske objektet refererer til de grafiske elementene ved hjelp av referanser.

113 IT-R-0015/Rev. 1 Side: 107 Basiselement Mange En Grafisk element Mange Mange Gruppelement Grafisk objekt.hode..<basiselementer som gjelder for alle gruppeelementer>.linje 1:!grafisk element..<basiselementer>...<basiselementer>...o.s.v....flate 2:!grafisk objekt..<basiselementer>.. :1 :3 :4 :5! referanser til grafiske elementer