Kamil Nešetřil

Geodata, informace, modely, software

Uživatelské nástroje

Nástroje pro tento web


Konfigurační soubor

Specifikace

↩ Zpět

Každá skupina grafů je definována v jediném konfiguračním souboru ve formátu YAML.
Hodnota auto vždy reprezentuje výchozí hodnotu. U logických hodnot lze zadávat volně např.: yes, Yes, true, True.

title

Určuje hlavní nadpis celého výstupu (celého obrázku).

Podporuje zápis matematických výrazů pomocí LaTeX syntaxe (uzavřené mezi $$), která je standardem v Matplotlib

Pokud položka není zadána, nadpis se nezobrazí.

Příklad: title: $^{79}Se$ ve vodě

maximize

Zobrazí maximalizované okno (pokud je window: True)

Výchozí hodnota: no

Příklad: maximize: yes

time_label

Popisek časové osy

Pokud položka není zadána, popisek se nezobrazí.

Příklad: time_label: "Čas [roky]"

time_range

Rozsah časové osy

Výchozí hodnota: auto

Příklad: time_range: [100000, 1700000]

time_major_step

Hlavní dělení osy – časový krok (major ticks)

Výchozí hodnota: auto

Příklad: time_major_step: 1e5

time_format

Formát čísel na časové ose (osa x). Tento formát určuje, jak budou hodnoty času zobrazeny v popiscích osy — například jako běžné číslo, ve vědeckém zápisu nebo s pevně daným počtem desetinných míst.

Možnosti:

  • Ggeneral (obecný formát, např. 123456 nebo 0.00123 dle velikosti čísla)
  • Eexponential (vědecký zápis, např. 1.23E+05)
    • 4E – dtto se 4 desetinnými místy (např. 1.2345E+05)
  • Ffixed (pevný počet desetinných míst, např. 123456.0000)
    • 2F – dtto se 2 desetinnými místy (např. 123456.00)

Výchozí hodnota: auto

Příklad: time_format: 3F

global_time_formula

Vzorec transformující hodnotu času. Pokud je zadaná, tak se time_formula neaplikuje.

Příklad: global_time_formula: t / 1000

outputs

Definuje možnosti výstupu:

  • zobrazení výsledného grafu v okně,
  • vytvoření souboru (např. PNG).

window

Určuje, zda se má po vykreslení grafu zobrazit interaktivní okno Matplotlib (GUI okno).

Možnosti:

  • True – otevře se okno s grafem (výchozí hodnota)
  • False – graf se pouze uloží do souboru a okno se nezobrazí (vhodné pro dávkové zpracování)

Příklad: window: False

image_file_name

Jméno obrázku (vždy jen jeden).

Možnosti: eps, jpeg, jpg, pdf, png, ps, raw, svg, svgz, tif, webp

Příklad: image_file_name: simple.svg

axes

Jednotlivé dílčí grafy (pografy) ve skupině grafů se společnou časovou osou.

values_label

Popisek svislé osy (osy y), který se zobrazuje vedle každého podgrafu.

Podporuje formátování v Matplotlib:

  • LaTeX syntaxi uzavřenou mezi znaky $…$
    • Příklad: values_label: "c [kg/m$^{3}$]"
  • Unicode znaky (jako ³)
    • Příklad: values_label: "c [kg/m³]"

Výchozí hodnota: prázdný řetězec

values_range

Výběr intervalu hodnot.

Výchozí hodnota auto odpovídá [min, max].

Příklad: values_range: [0, 10]

values_major_step

Rozestup hlavních značek (major ticks) na svislé ose (osa y).

Příklad: values_major_step: 0.0001

values_format

Formát číselných hodnot na svislé ose (osa y, osa hodnot). Syntaxe viz time_format.

Příklad: values_format: G

legend_on

Určuje, zda se má v podgrafu zobrazit legenda (vysvětlivky k jednotlivým časovým řadám).

Výchozí hodnota: Yes

Příklad: legend_on: No

grid_on

Určuje, zda se má v podgrafu vykreslit mřížka (vodicí čáry podél os).

Možnosti:

  • yes – zobrazí mřížku v pozadí grafu (výchozí hodnota)
  • no – mřížka nebude zobrazena

Příklad: grid_on: no

title

Název konkrétního podgrafu.

Příklad: title: Kontejner

series

Seznam časových řad, které se zobrazí v daném podgrafu.

input_file

Cesta ke vstupnímu souboru ve formátu CSV, ze kterého se načítá časová řada.

Příklad: input_file: u_r_05.csv

separators

Určuje formát vstupního CSV souboru – konkrétně oddělovač desetinné čárky a sloupců.

Možnosti:

Hodnota Desetinný oddělovač Oddělovač sloupců
dec._col, . ,
dec._col; . ;
dec._colTAB . tabulátor
dec._colSPACE . mezera
dec,_col; , ;
dec,_colTAB , tabulátor
dec,_colSPACE , mezera

Výchozí hodnota: dec,_col;

Příklad: separators: dec,_col;

time_column

Název sloupce v CSV souboru, který obsahuje časové hodnoty.

Příklad: time_column: time_1000yr

time_formula

Vzorec transformující hodnotu času. Jako global_time_formula, ale má nižší prioritu.

Výchozí hodnota: t

Příklad: time_formula: t / 100000

value_column

Název sloupce v CSV souboru, který obsahuje hodnoty časové řady (osa y). Tyto hodnoty se vykreslí jako křivka v grafu. Pro každý řádek je hodnota přiřazena k odpo­vída­jícímu času ze sloupce time_column.

Příklad: value_column: se79_cont_water

value_formula

Vzorec transformující hodnotu.

Výchozí hodnota: v (tj. původní hodnota)

Příklad: value_formula: v * 1000

corner

Pozice os

Možnosti

  • No: Rozsah osy y přesně odpovídá rozsahu hodnot.
  • Yes: Rozsah osy y je zvětšen o 5 %.

Výchozí hodnota: Yes

Příklad: corner: no

legend

Text, který se zobrazí v legendě grafu u dané časové řady. Pokud není zadáno, použije se název sloupce z value_column.

Výchozí hodnota: auto

Příklad: legend: Here is time series name

time_frame

Omezuje zobrazený časový interval pro danou časovou řadu. Umožňuje „oříznout“ jen část z delší časové řady.

Zadává se jako dvojice hodnot: [začátek, konec].

Výchozí hodnota: [0, inf]

Příklad: time_frame: [200000, 1500000]

line_width

Tloušťka čáry, kterou je časová řada vykreslena v grafu.

Výchozí hodnota: 1

Příklad: line_width: 2.5

color

Barva čáry, kterou se vykreslí časová řada.

Lze zadat název barvy podle standardu Matplotlib: List of named colors | CSS – např. red, green, blue, yellow, orange, gray, brown, purple, pink

Výchozí hodnota: auto

Příklad: color: black

line_style

Styl čáry použité pro vykreslení časové řady.

Možnosti (viz Matplotlib Linestyles):

Hodnota Styl čáry
Anglicky Česky
"-" solid nepřerušovaná čára
":" dotted tečkovaná čára
"--" dashed čárkovaná čára
"-." dashdot čerchovaná čára

Výchozí hodnota: -

Příklad: line_style: ":"



Toto je speficikace. Příklady konkrétních konfiguračních souborů YAML jsou na samostatných stránkách:

Poslední úprava: