KeyCom kaapeliformaatti

Yleistä KeyCom-formaatista
KeyCom-formaatti on KeyComin käyttämä rivimuotoinen formaatti. Vanhempi versio formaatista on Sonera-formaatti.
Vanha sonera-formaatti 11 kentällä.
Tiedostopääte .pih
Muunnin on tehty tukemaan Telian ohjeistusta ja koodausta.
Soveltuu myös muun kuin Telian koodauksen käyttöön.
KeyCom-formaatissa on ensin normaalit T1,T2,T3,T4,X,Y,Z sekä seuraavat kentät:
T8 Syvyys = Syvyystieto (m). Putken päältä mitattuna 0.
T9 Sijanititarkkuus (m) = Mittalaitteen antama tarkkusarvo tai oletuksena annettu tarkkuus.
T10 Korkeustarkkuus (m) = Mittalaitteen antama tarkkusarvo tai oletuksena annettu tarkkuus.
T11 Kommentti = Hajapisteellä tai viivapisteellä oleva ominaisuuden tunnuksen COMMENT-arvo, tekstiä.
Wiki-artikkelissa Trimble JobXML ominaisuudet on tarkemmin miten voidaan lukea 3D-Winiin GNSS-mittalaitteella mitatun kaapelikartoitustiedoston ominaisuudet T8,T9 ja T10 suoraan mittalaitteen tallentamina arvoina.
Telian ohjeesta tiedostoformaatti

Listattuna sallitut kartoitustiedoston koodit. KeyCom muunnin kirjoittaa myös muut kuin sallitut koodit .pih-tiedostoon mutta herjaa alempana olevan kuvan mukaisesti.

Mikäli kirjoitettavassa tiedostossa on ei sallittuja koodeja, herjaa tiedoston uloskirjoituksen yhteydessä.
Koodit kirjoitetaan .pih-tiedostoon herjasta huolimatta.

KeyCom kirjoitusmuunnin
Tiedosto - Formaatit -Kirjoita
Lisää vektoritiedoston muunninlistaan uusi funktio KeyCom.

KeyCom muuntimen asetuksissa Kysy asetukset tulee olla valittuna.

KeyCom-muuntimella voidaan lisätä oletusarvoiseti kaikille haja- ja viivapisteille syvyysarvo T8, vaakatarkkuus T9, korkeustarkkuus T10 ja kommentti T11 kenttiin. Arvot lisätään muuntimen oikeanpuoleisiin kenttiin.
Kartoitustiedostossa voi pisteillä olla ominaisuuksia, joiden arvo voidaan hakea kyseisestä ominaisuudesta tunnuksen avulla. Oletuksena muuntimen vasemmanpuoleisissa kentissä on esimerkkiominaisuuksien tunnukset:
KEYCOM:DEPTH ( Syvyys T8)
KEYCOM:HACC ( Vaakatarkkuus T9)
KEYCOM:VACC (Korkeustarkkuus T10)
COMMENT (Kommentti T11)
Matalan syvyyden raja
Jos tämä on jotain muuta kuin nolla, niin kirjoitettaessa näytetään varoitus jos viivalla on pisteitä jotka ovat matalammalla kuin tämä arvo ja viivan koodi ei ole 2112 tai 2512.
Viivan alkupiste eri koodilla
Käyttää nollaan päättyvää koodia putkien ja kaapelireittien (Koodit 211x, 251x, 252x) alkupisteille.
Avo-ojasta, maanpinnasta
Onko mittaukset avo-ojasta vai maanpinnasta. Tätä käytetään tallentaessa määrittelemään tiedostonimen loppuosa.

Ominaisuuksien tunnuksista:
Vasemmanpuoleisessa kentässä on ominaisuuden tunnuksen nimi (tulee olla kirjoitetu täysin samoin kuin pisteen ominaisuudessa, isot ja pienet kirjaimet!) Mikäli vastaava tunnus löytyy kartoitustiedoston haja- tai viivapisteeltä, kirjoitetaan tunnuksen arvo vastaavaan KeyCom-formaatin kenttään.
Mikäli tunnusta ei löydy, kirjoitetaan oikeanpuoleiseen kenttään lisätty arvo vastaavaan kenttään KeyCom-formaatissa.
Dialogi muistaa kirjoitetut ominaisuuksien tunnukset toiminnon uudelleen käynnistyksen yhteydessä.
Ilman kartoitustiedoston ominaisuuksia voidaan kirjoittaa KeyCom-formaattiin oikeanpuoleisen kentän arvot ilman, että poistaa vasemmanpuoleiset ominaisuuksien tunnukset muuntimesta!
Kommentin oikeanpuoleiseen kenttään lisätty arvo ei ylikirjoita olemassaolevia pisteiden kommentteja. Lisää annetun arvon kommentiksi kaikille muille pisteille.
Avo-ojasta kartoitetun kaapelitiedoston kirjoitus
Esimerkkitiedosto Kaapelikartoitus_avoin.xy.tdw on kartoitettu avo-ojasta suoraan suojaputken päältä. Tiedostossa ei ole pistekohtaisesti syvyystietoa (T8), sijaintitarkkuutta (T9) eikä korkeustarkkuutta (T10). Tarvittavat ominaisuudet lisätään oletusarvoisesti kaikille haja - ja viivapisteille KeyCom-muuntimen avulla.
Tiedostossa ei ole pisteillä data-välilehdellä ominaisuustietoja.

Tiedosto kannattaa numeroida viiva- ja pistenumeroiden osalta. Tiedostossa ei saa olla samoja pistenumeroita useampaan kertaan.

KeyCom-muuntimella lisätään oletusarvot tiedoston kaikille haja- ja viivapisteille:
Syvyystieto (T8)
0m putken päältä mitattu
Vaakatarkkuus (T9)
0.1m
Korkeustarkkuus (T10)
0.1m
Asetuksella Avo-ojasta lisätään tiedoston nimen loppuun _avo-ojasta.pih
Viivan alkupiste eri koodilla
Asetuksella lisätään uuden viivanumeron ensimmäiseksi koodiksi
2111->2110, 2511->2510 tai 2521->2520

Tiedoston nimen loppuun lisätään _avo-ojasta.pih.
Uusi viivanumero saa ensimmäiseksi koodiksi 2110, 2510 tai 2520
Tiedostossa näkyy T8-kentässä syvyys 0.000, T9-kentässä vaakatarkkuus 0.100 ja T10-kentässä korkeustarkkuuss 0.100

Maanpinnalta kartoitetun kaapelitiedoston kirjoitus
Esimerkkitiedosto Kaapelikartoitus_syvyys T5_peitetty.xy.tdw on kartoitettu peitetystä kaapeliojasta, kaapelin syvyys maanpinnasta on tutkattu ja tallennettu pistekohtaisesti tiedoston T5-ominaisuuteen. T5-ominaisuus siirretään KeyCom-muuntimella kaikille tiedoston haja - ja viivapisteille syvyystiedoksi (T8), oletusarvoisesti annetaan sijaintitarkkuus (T9) ja korkeustarkkuus (T10).
Tiedostossa on kaikilla haja- ja viivapisteillä peittosyvyys annettu T5-ominaisuuteen. Sijaintitarkuuksia ei ole kartoitusvaiheessa tallennettu pisteille.

Tiedosto numeroidaan, ei saa olla samoja piste- ja viivanumeroita useampaan kertaan.

KeyCom-muuntimen asetuksiin valitaan Maanpinnasta (kirjoittaa tiedoston nimen loppuun _maanpinnasta.pih).
Syvyystieto poimitaan kartoitustiedoston T5-kentästä ja kirjoitetaan T8-kenttään.
Vaaka- ja pystytarkkuus annetaan oletuksena kaikille pisteille, 0.1m
Kirjoitetaan T9 ja T10 kenttään.
Kommentteja ei lisätä esimerkissä.
Asetus Viivan alkupiste eri koodilla lisää uuden putkireitin alkuun ensimmäiseksi koodiksi 2111->2110, 2511->2510 tai 2521->2520.

Kirjoitetussa .pih-tiedostossa nimi on kartoitustiedosto, mihin on lisätty loppuun _maanpinnalta.pih
Syvyyskentässä T8 on kartoitustiedoston T5 arvo.
Sijaintitarkkuus T9 ja korkeustarkkuus T10 on oletuksena annetut arvot 0.1m

Esimerkkitiedostot:
File | Modified |
---|---|
File Telia.dat Telian koodit 3D-Winiin, ilman ominaisuuksia. |
Aug 19, 2025 |
File Kaapelikartoitus_avoin.xy.tdw Avo-ojasta kartoitus, ei mitään ominaisuustietoa. |
Aug 20, 2025 |
File Kaapelikartoitus_avoin_avo-ojasta.pih KeyCom-muuntimella kirjoitettu .pih esimerkkitiedosto. |
Aug 20, 2025 |
File Kaapelikartoitus_syvyys T5_peitetty.xy.tdw Maan pinnalta kartoitus, syvyystieto T5-kentässä. |
Aug 20, 2025 |
File Kaapelikartoitus_syvyys T5_peitetty_maan_pinnalta.pih KeyCom-muuntimella kirjoitettu .pih esimerkkitiedosto. |
Aug 20, 2025 |