===== Vykreslenie polygónu =====

Po spustení Therionu sa najprv objaví okno pre interpretáciu dát - //therion kompilátor// (ikonka s malým zubatým kolieskom hore v lište). To budeme potrebovať, až keď nejaké dáta budeme mať k dispozícii.

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_01.png|{{therion:czsk:xtherion_01_thumb.png}}]]

Prepneme preto na okno pre zadávanie a úpravu textových dát - //therion textový editor// (ikonka s ceruzkou, klávesa [F1] alebo položka //Textový editor// v menu //Okno//)

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_02.png|{{therion:czsk:xtherion_02_thumb.png}}]] 
[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_03.png|{{therion:czsk:xtherion_03_thumb.png}}]]

Z menu //Súbor// zvolíme položku //Nový// alebo klikneme na ikonku nového dokumentu. Čo ktorá ikonka znamená sa zobrazuje na spodku okna v stavovom riadku. V ľavom hornom rohu čiernej polochy sa objaví textový kurzor. Súbor uložte - napríklad ako //nova_jaskyna.th// do zložky //nova_jaskyna//. ''Poznámka: nedoporučuje sa používať v názvoch súborov znaky s akcentami.''

Koncovka //.th// je vyhradená pre súbory therionu, ktoré obsahujú meračské dáta. 

Všetky dáta v therione sú časťou tzv. //survey//, v preklade snáď //meranie//. V najjednoduchšom prípade to je jedna meračská akcia, ale môžu to byť aj všetky meračské akcie na jednej lokalite, alebo meračské akcie za určité časové obdobie, alebo meračské akcie na určitom krasovom území. Jeden //survey// môže obsahovať niekoľko vložených //surveyov//. Celá táto štruktúra pozdejšie slúži ako akýsi archív jednotlivých meraní.

Začneme tým najjednoduchším prípadom - jedinou meračskou akciou - jediným //survey//.

Každý //survey// začína príkazom ''survey'' a končí príkazom ''endsurvey''. Všetko, čo je medzi týmito dvomi príkazmi, je súčasťou daného //survey//.

Príklad prázneho //survey// nájdete vo wiki v sekcii [[:faq#How to enter centreline?|FAQ:How to enter centreline?]].

  survey ... -title "..."
    centreline
      team "..."
      team "..."
      date ...
      units clino compass grad
      data normal from to compass clino length
        ... ... ... ... ...
    endcentreline
  endsurvey

Pre náš príklad si vystačíme s prvým a posledným riadkom, riadkami ''centerline'' a ''endcenterline'' a riadkom, ktorý začína ''data''.

  survey ... 
    centreline
      data normal from to compass clino length
        ... ... ... ... ...
    endcentreline
  endsurvey

Ostatné riadky doplníme pozdejšie, ich úloha je zrejmá.

Viacriadkový príkaz ''centreline'' - ''encentreline'' bude obsahovať vlastné zmerané údaje.

Príkaz ''data'' popisuje poradie, v ako budeme namerané dáta vkladať. Je úplne jedno, v akom poradí budú, therion ich správne rozpozná práve podľa tohoto riadku. Je možné každý jednotlivý polygón zadávať v inom poradí, vždy však musí predchádzať riadok s ''data'' v správnom poradí. Parameter ''normal'' označuje normálne meranie, keď meriame vzdialenosť, sklom a azimut. Therion pozná mnoho ďaľších spôsobov merania, tým sa však teraz nebudeme zaoberať. Merania budeme zapisovať v poradí: označenie bodu z ktorého meriame (nemusí to byť iba číslo, therion akceptuje akýkoľvek reťazec znakov), označenie bodu na ktorý meriame (opäť lubovoľný reťazec znakov, ktorý nemusí mať nič spoločné s predchádzajúcim bodom), azimut, sklon a dĺžku. Ako východzie sú nastavené merania v stupňoch (360 °) a dĺžka v metroch. I tieto parametre je možné meniť pre každé meranie zvlášť.


V našom prípade doplníme namiesto bodiek za príkaz ''survey'' text "nova_jaskyna". Tento ''survey'' sa bude teda nazývať ''nova_jaskyna''. Vymažeme bodky za riadkom ''data''.

  survey nova_jaskyna 
    centreline
      data normal from to compass clino length
       
    endcentreline
  endsurvey

Kurzor umiestnime do riadku s ''data'' a v pravej časti okna klikneme na tlačítko ''Nájdi formát dát''. Týmto vytvoríme tabuľku presne odpovedajúcu formátu merania tak ako je uvedená v príkaze ''data''.

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_04.png|{{therion:czsk:xtherion_04_thumb.png}}]]

Kurzor presunieme do voľného riadku pod ''data''. Teraz môžeme pohodlne vložiť zmerané dáta. Používame desatinnú bodku, therion desatinnú čiarku nepozná. Stupne a minúty oddeľujeme dvojbodkou. Každé číslo potvrdíme klávesou [Enter], to nás zároveň posunie o riadok nižšie. Keď odentrujeme posledný riadok, meranie sa zapíše do ''survey'' a čísla bodov ''from'' a ''to'' sa zväčšia automaticky o jednu. 

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_05.png|{{therion:czsk:xtherion_05_thumb.png}}]]
[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_06.png|{{therion:czsk:xtherion_06_thumb.png}}]]

Polygónové merania je možné zapisovať i priamo do textu v ľavej časti okna. Jednotlivé položky oddeľujú jedna alebo viac medzier. 

Zo zapísaných dát potrebujeme vygenerovať súbor, z ktorého bude možné vytlačiť polygónový ťah. Prepneme preto do okna //therion kompilátor// (ikonka s malým zubatým kolieskom hore v lište alebo klávesa [F3]). Vytvoríme nový súbor a uložíme ho pod menom ''nova_jaskyna.thconfig''. Do okna napíšeme meno súboru, z ktorého má kompilátor čítať informácie a inštrukciu, čo má s dátami urobiť. V našom prípade vygenerovať mapu.

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_07.png|{{therion:czsk:xtherion_07_thumb.png}}]]

Stlačíme ikonku s veľkým zubatým kolieskom, alebo klávesu [F9], prípadne vyberieme položku //Kompilovať// z menu //Súbor//. Therion začne interpretovať dáta zo súboru ''nova_jaskyna.th'' a vygeneruje mapu s názvom ''cave.pdf''. 

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_08.png|{{therion:czsk:xtherion_08_thumb.png}}]]

Výstup z interpretácie dát sa zobrazuje v spodnej ľavej časti okna. Obsahuje užitočné informácie týkajúce sa chýb pri vyrovnávaní, speleometrické dáta apod. Kompletný výpis z kompilácie ''nova_jaskyna.th'' je tu: [[czsk:tpj:therion_log]]

Po kompilácii sa aktivujú tlačítka v pravej časti okna - napríklad štruktúru ''surveyov''. Táto informácia môže byť veľmi dôležitá pri kompletácii zložitých jaskynných systémov.

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_09.png|{{therion:czsk:xtherion_09_thumb.png}}]]

Súbor ''cave.pdf'' je možné otvoriť v programe Adobe Reader a vytlačiť ho, prípadne v programe Adobe Illustrator, Xara, CorelDraw a použiť ako podklad pre kreslenie mapy.

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_10.png|{{therion:czsk:xtherion_10_thumb.png}}]]
[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_11.png|{{therion:czsk:xtherion_11_thumb.png}}]]

Pre kreslenie mapy je zbytočné, aby vygenerovaný PDF súbor obsahoval hlavičku, naopak by mohol obsahovať metrovú sieť, prípadne celé spojnice bodov. Doplnením konfiguračného súboru ''nova_jaskyna.thconfig'' o príslušné príkazy podľa [[:examples|stránky s príkladmi]] získame nasledujúci PDF súbor. Upravený konfiguračný súbor:

    source nova_jaskyna.th
    
    layout nova_jaskyna
    
          #vypnutie hlavicky
          
          map-header 0 0 off
          legend off
        
          #siet 1x1 m
          
          grid bottom
          grid-size 1 1 1 m
          
          #spojnice bodov
          
          code metapost
          def l_survey_cave (expr p) =
                draw p withpen PenD withcolor (0.0,0.0,0.0);
          enddef;
        
        endlayout
        
        export map -layout nova_jaskyna 

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_12.png|{{therion:czsk:xtherion_12_thumb.png}}]]

Doplníme ďaľšie body a úpravíme konfiguračný súbor tak, aby sa vygeneroval okrem mapy aj pozdĺžny rez a body mali odpovedajúce čísla.

Upravený konfiguračný súbor:

    source nova_jaskyna.th
    
    layout nova_jaskyna
    
        #cisla bodov
        debug station-names
        
        #vypnutie hlavicky
          
        map-header 0 0 off
        legend off
        
        #siet 1x1 m
          
        grid bottom
        grid-size 1 1 1 m
          
        #spojnice bodov
          
        code metapost
        def l_survey_cave (expr p) =
            draw p withpen PenD withcolor (0.0,0.0,0.0);
        enddef;
        
        endlayout
        
        export map -output mapa.pdf -layout nova_jaskyna
        export map -output profil.pdf -projection extended -layout nova_jaskyna

V tomto prípade sa vygeneruje súbor ''mapa.pdf'' s polygónom pre mapu, bez hlavičky, s metrovou sieťou a očíslovanými bodmi a tiež súbor ''profil.pdf'' s polygónom pre rozvinutý rez.

[[http://wiki.speleo.cz/therion/media/therion/czsk/xtherion_13.png|{{therion:czsk:xtherion_13_thumb.png}}]]
 mapa.pdf 
[[http://wiki.speleo.cz/therion/media/therion/czsk/mapa.png|{{therion:czsk:mapa_thumb.png}}]]
 profil.pdf 
[[http://wiki.speleo.cz/therion/media/therion/czsk/profil.png|{{therion:czsk:profil_thumb.png}}]]