start => czsk => judt
Table of Contents

JÚDT: 4. Zpracování polygonu

V následujících příkladech si ukážeme jak zadat do therionu naměřené údaje a jak vyexportovat polygon do různých formátů.

Než začneme

Ještě než začneme, vytvořte si na disku adresář therion_sample a v něm adresáře data a output. Prostě nějak takto:

therion_sample
- data
- output

Do této struktury budeme naše data ukládat.

K editaci souborů *.th slouží okno Text editor v XTherionu (použít můžete také libovolný plain textový editor - vi, notepad atd.).

Spustíme si tedy Xtherion:

Po spuštění se otevře prázdné okno Compileru. Nenechte se zmást, stisknutím F1 nebo přes menu Window → Text editor se přepněte do Text editoru a v menu File vyberte New. V pravém sloupci ještě zvolte kódování pro soubor (pro češtinu/slovenštinu z důvodu přenositelnosti doporučuji iso8859-2 nebo utf-8).

Můžete si současně otevřít Therion Book, ve kterém najdete popis a vysvětlení ke všem příkazům a volbám. A jdeme na to...

První polygon - soubor hp.th

Každý datový objekt v Therionu (centerline, scrap atd.) musí patřit do tzv. survey. V survey také můžeme spojovat jiná survey v jeden celek (třeba dvě jeskyně). Survey musí být ukončen příkazem endsurvey.

Survey je specifikováno pomocí identifikátoru (v našem případě hp), který musí být unikátní v rozsahu nadřazeného survey (bude vysvětleno později). Zpětné lomítko slouží k odřádkování parametrů na samostatný řádek.

survey hp \
-title "Hlavní polygon" \ 
-declination [1996 2.1 1997 3.4 - 3 degrees]

Příkazem centerline (může být použito i centreline) začíná část týkající se polygonového tahu. Příkaz musí být ukončen příkazem endcenterline (příp. endcentreline).

centerline

Následují časové informace a informace o objevitelích a měřičích.

explo-team "Ladislav Blažek" # objevil

nebo

explo-team "ZO/ČSS 6-28 Babická speleologická skupina" # objevil
explo-date 1996-1997 # kdy bylo objeveno
team "Ladislav Blažek" # seznam měřičů
team "Zdenek Stloukal" # každý na samostatný řádek
date 1998 # kdy bylo změřeno

Všechny “týmy” jsou primárně určeny pro zadávání jmen osob ve tvaru jméno příjmení. Pokud chcete tak jako já zadávat místo jmen objevitelů třeba název jeskyňářského klubu, musíte první dvě slova oddělit lomítkem - jinak vám therion při kompilaci vyhodí chybu.

Časové údaje můžou být jak konkrétní data (např. 15.3.2005) tak časové intervaly (např. 1993-1997).

Teď přichází na řadu samotné měření. Nejprve therionu řekneme jak budeme data vkládat - příkazem data následovaným parametry určujícími způsob měření (normal, topofil, diving, cartesian, cylpolar atd.) a pořadí měřených hodnot. Pro tradiční měření vzdálenosti, azimutu a sklonu (normal) to bude asi takto:

data normal from to length compass clino # od do délka azimut sklon

Pokud neudáte jinak, délkové jednotky budou v metrech, úhlové ve stupních. V opačném případě nastavte dle libosti pomocí příkazu units následovaným typem měření a jednotkami.

# Pokud měříte azimut v grádech odkomentujete následující řádek.
#units compass grad

Obsahuje-li vaše měření fixní body (můžete jich mít libovolné množství), uveďte je pro přehlednost na začátku. Souřadnice jsou v UTM.

fix 0 575628 4476124 1250

Před záměry, kterých se to týká, máme možnost therionu říct aby na měření se sklonem ±90° neaplikoval korekce sklonu.

infer plumbs on

Samotná měření můžete zadávat buď přes pravé menu nebo normálním zápisem s oddělením hodnot mezerou či tabulátorem.

Důležité je vědět, že názvy měřičských bodů musí být unikátní pouze v rámci survey. Pokud tedy máte více survey, můžete v každém z nich číslovat body od nuly. Odkazovat se pak na ně budete takto: <bod_id>@<survey_id>

0 1 3.54 0 -90
1 2 6.06 325 -70
2 3 4.66 200 -81.5
3 4 4.45 141 -53
4 5 2.69 60 -32
5 6 1.14 110 -12
6 7 4.91 85 -7
7 8 6.7 350 -25
8 9 3.72 145 -50
9 10 5.23 165 -24
10 11 8.69 35 -71
11 12 4.23 271 -38.5
12 13 4.06 165 1.5
13 14 5.96 215 -15
14 15 4.02 181 -61.5

Všechno pak musíme pěkně ukončit.

endcenterline
endsurvey

Hotovo, zbývá jen naše dílko uložit (File → Save as) do podadresáře data jako hp.th. Celý soubor hp.th.

Polygon odbočky - soubor odbocka.th

Stejným způsobem si vytvoříme další datový soubor, který bude obsahovat polygon odbočky. Nazveme ho odbocka.th a uložíme do podadresáře data (v adresáři therion_sample).

Spojení polygonů - soubor index.th

Máme vytvořeny dva datové soubory popisující dva polygony a musíme tedy ještě Therionu sdělit jak spolu vlastně souvisí. K tomu využijeme “index” soubor - index.th, který vytvoříme opět v text editoru programu XTherion a který tentokrát uložíme přímo do adresáře therion_sample. Bude obsahovat jen definici vazeb mezi polygony.

Začneme jako v předchozích případech.

survey index \
-title "Naše obrovská jeskyně"

Nadefinujeme s kterými daty má Therion pracovat.

input data/hp # survey hp v adresáři data
input data/odbocka # survey odbocka v adresáři data

A jdeme na definici vazeb. Vše co se týká polygonu musí být mezi centerline a endcenterline.

centerline

Spojíme body.

equate 0@odbocka 11@hp # bod 0 v survey odbocka je totožný s bodem 11 v survey hp
equate 9@odbocka 14@hp # bod 9 v survey odbocka je totožný s bodem 14 v survey hp

A vše uzavřeme.

endcenterline
endsurvey

Celý soubor index.th.

Kompilace a export - soubor thconfig

Jakýkoliv výstup z Therionu dostaneme až po úspěšné kompilaci. K tomu potřebujeme soubory obsahující data z měření a konfigurační soubor, který si vytvoříme teď. Soubor bude pro tento případ velice jednoduchý, protože zatím máme údaje jen o polygonu.

V XTherionu se klávesou F3 nebo přes menu Window → Compiler přepněte do Compileru a v menu File zvolte New. Budete vyzváni k uložení konfiguračního souboru - uložte jej pod názvem thconfig do adresáře therion_sample.

Nejprve musíme specifikovat zdroj dat = soubor index.th.

source index.th

Sice máme zatím jen polygon, ale i tak se nám 2D mapa může hodit. Nadefinujeme si tedy jednoduchý layout, který slouží pro definici parametrů pro export. Pokud bychom chtěli exportovat jen 3D model není tento krok nutný.

layout polygon

  # hlavička
  map-header 0 0 on #hlavička bude v levém horním rohu
  legend off #vypnutí legendy - máme jen polygon

  # síť 1x1 m
  grid bottom
  grid-size 1 1 1 m
        
endlayout

Teď Therionu sdělíme jaký typ výstupu chceme a jaký má být výstupní formát. Výstup budeme směřovat do podadresáře output.

Výchozí formát pro export 2D mapy (map) je PDF

# export 2D planu jeskyne
export map -layout polygon -output output/plan.pdf

Můžeme ale exportovat i do SVG...

export map -format svg -layout polygon -output output/plan.svg

Z následujících příkazů pro export 3D modelu vyberte ten, pro který máte nainstalovaný prohlížeč. Jak už poznáte z parametru format, první příkaz je pro výstup do *.3d formátu programu Survex (prohlížeč Aven), druhý do formátu *.plt programu Compass (prohlížeč Compass nebo Aven), třetí soubor si můžete prohlédnout v zabudovaném prohlížeči, do kterého se přepnete klávesou F4 nebo přes menu Windows → Model viewer.

# export 3D modelu
#export model -format survex -output output/hp.3d
#export model -format compass -output output/hp.plt
export model -output output/hp.thm

Celý soubor thconfig.

Teď už stačí jen stisknout F9 a pokud je vše v pořádku, měl(y) by se vám v adresáři output objevit vygenerovaný(é) soubor(y). Průběh kompilace můžete sledovat ve spodní části obrazovky, kam vám therion vypisuje i případná chybová hlášení.

Po úspěšné kompilaci můžete v kompilátoru zjistit různé údaje o naší jeskyni (délka, hloubka atd.). Vše se nalézá v bočním menu XTherionu, stačí jen v Survey structure zvolit odpovídající část (survey) a v Survey info si přečíst informace.

Výsledek poslední kompilace najdete také v souboru therion.log, který se automaticky vytvoří ve stejném adresáři v jakém leží thconfig.

Dodatek: LRUD data

Máte měření obsahující data o levé, pravé stěně, stropu a dně (LRUD) a chcete tyto údaje využít?

Původní idea Therionu byla nenutit měřiče doměřovat LRUD informace. V měřítku nakreslené náčrtky už tyto informace obsahují a naskenováním a následnou vektorizací v XTherionu získáte vše potřebné pro vygenerování mapy a 3D modelu.

Pokud ovšem máte podklady z nějaké jeskyně bez náčrtků (tedy jen polygon s LRUD) pak je tu i pro vás řešení. Od verze 0.3.7 totiž přibyla možnost vygenerovat z polygonu podkladový obrázek obsahující měřičské body, polygon a LRUD informace a ten pak použít jako podklad místo naskenovaných náčrtků.

V survey stačí pozměnit příkaz data u vybrané centerline a zadat LRUD informace.

Původní zápis:

data normal from to length compass clino

A teď s podporou pro LRUD:

data normal from to length compass clino left right up down

FIXME Doplnit ukázková data s LRUD, upravy pro thconfig a export do xvi a 3D.