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.