====== JÚDT: 3 Začínáme ======








===== 3.1 Programový balík Therion =====

Součástí programového balíku Therion je:

  * **Therion** - program pro příkazovou řádku. Je to jádro či motor celého balíku. Parametrem na vstupu je pro něj konfigurační soubor s informací jaké datové soubory (části jeskyně) má zpracovat a jaká má být podoba výstupu. Výstupem jsou pak hotové mapy a 3D modely. Spouští se příkazem: ''therion [parametry]''
  * **XTherion** - grafické rozhraní usnadňující vytváření vstupních dat tj. vektorizaci náčrtků a vytváření datových souborů. Z XTherionu se také dá přímo spouštět Therion takže v praxi vidí uživatel z Therionu jen okno s hlášeními v průběhu kompilace. Spouští se příkazem: ''xtherion''
  * **Loch** - prohlížeč 3D modelů. Spouští se příkazem: ''loch''





===== 3.2 Jak Therion funguje =====

Princip fungování vychází z postupu jakým jsou data získána. Po měřičské akci většinou máme v ruce měřičský zápisník s údaji o polygonu a několik milimetráků s náčrtky. Polygon zadáme (''centerline''), náčrtky naskenujeme a zvektorizujeme (''scrap'') a v místech měřičských bodů svážeme s polygonem. U náčrtků pak také řekneme jak na sebe navazují (''join'') a seskupíme je do logických celků (''map''). To vše je výsledkem našeho měření (''survey''). Pak už nám jen zbývá říct co na právě generované mapě požadujeme.















===== 3.3 Datové soubory =====

Therion k vygenerování mapy či modelu potřebuje:

  - **měření** (''survey'') obsahující údaje o polygonu (''centerline''), informace o spojeních (''join'') mezi vektorovými náčrtky (''scrap''), jejich rozdělení do map (''map'') a informace o vložených souborech (''input'')
  - samotné **vektorové náčrtky jeskyně** (''scrap''), které mohou vzniknout:
    * naskenováním a vektorizováním papírových náčrtků jeskyně v XTherionu
    * nebo přímým zakreslením v XTherionu s využitím polygonu a staničení (LRUD) jako podkladu (XVI soubor jako podklad místo nascanovaného obrázku).
  - poslední částí skládačky jsou **parametry pro kompilaci** - tedy specifikace toho co chceme obdržet.

Tyto části jsou odděleny do tří typů souborů:

  * měření -> **survey data file (*.th)**
  * vektorové náčrtky jeskyně -> **map data file (*.th2)**
  * parametry pro kompilaci -> **thconfig** (výchozí jméno, ve skutečnosti se může jmenovat libovolně, thconfig by mělo být součástí jména)







===== 3.4 Datová struktura =====

V praxi budou podklady pro delší jeskyně obsahovat několik různých měření a scrapů, velké systémy můžou být rozděleny na části a podčásti a tím pádem mít vše jen ve třech souborech jak bylo uvedeno výše by bylo nepřehledné. Na to bylo autory programu samozřejmě pamatováno a tak souborů .th či .th2 můžete mít libovolné množství a můžete je hierarchicky spojovat. Aby ovšem nevznikl chaos je dobré popřemýšlet nad nějakou strukturou. Teď uvedu co se osvědčilo mně:

    * pro každou měřičskou akci vytvářím v podadresáři ''data'' samostatný *.th soubor obsahující údaje o polygonu. Název souboru volím stejný jako identifikátor (id) pro survey. Jednotlivé soubory pak linkuji do jednoho "index" souboru, ve kterém definuji spojení jednotlivých objektů a jejich zařazení do map.
    * naskenované náčrtky částí jeskyně ukládám v podadresáři ''img''.
    * při vektorizaci naskenovaných obrázků vytvářím jednotlivé scrapy tak, aby byly co nejjednodušší a dobře se spojovaly. Je důležité si uvědomit, že scrapy jsou naprosto nezávislé na vašich *.th souborech s jednotlivými částmi polygonu a proto se nesnažte rozdělit mapu do scrapů podle nich, ale v __nejjednodušších__ místech. :!: Jednotlivé scrapy také nesmí samy sebe překrývat a neměly by obsahovat více než 100 m chodeb. Soubory se scrapy opět ukládám do podadresáře ''data''. 

Pro dlouhé a komplikované systémy je dobré si se strukturou pohrát a rozčlenit jednotlivé části do souvisejících skupin v samostatných adresářích a postupně je spojovat.









===== 3.5 První spuštění =====

Po vysvětlení základních principů Therionu je dobrý nápad vyzkoušet ukázková data.

  * Stáhněte si ukázková data ze sekce [[http://therion.speleo.sk/download.php|Download]] na stránkách Therionu a rozbalte je někam na pevný disk vašeho počítače.
  * Spusťte XTherion (pod Unixem a MacOSX napsáním ''xtherion'' na příkazovém řádku, pod Windows poklepáním na zástupce v menu Start).
  * V okně **Kompilátor** ({{:czsk:judt:xth_komp_icon.png|:czsk:judt:xth_komp_icon.png}}, **Okno** -> **Kompilátor**) otevřete soubor ''thconfig'' (**Soubor** -> **Otevřít...**) z adresáře obsahujícího stažená ukázková data.
  * Stiskněte //F9// nebo tlačítko **Kompilovat**. Následně se vám zobrazí hlášení o průběhu kompilace od programů therion, METAPOST a TeX.
  * Vytvořené PDF mapy a 3D model nejdete v adresáři s ukázkovými daty.

Dále můžete otevřít datové soubory s měřením (''*.th'') v okně **Text editor** ({{:czsk:judt:xth_te_icon.png|:czsk:judt:xth_te_icon.png}}, **Okno** -> **Text editor**) a datové soubory obsahující mapy (''*.th2'') v okně **Mapový editor** ({{:czsk:judt:xth_me_icon.png|:czsk:judt:xth_me_icon.png}}, **Okno** -> **Mapový editor**). Datové soubory obsahující mapy (''*.th2'') je možné otevřít i v okně **Text editor** a podívat se co vlastně obsahují. Nedoporučuje se je zde však jakkoliv měnit.

Přestože datový formát může v prvním okamžiku vypadat složitě, vše bude vysvětleno v následujících kapitolách.