Obsah
Konfigurační soubor
Specifikace
Každá skupina grafů je definována v jediném konfiguračním souboru ve formátu YAML.
Hodnotaautovž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
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:
G– general (obecný formát, např.123456nebo0.00123dle velikosti čísla)E– exponential (vědecký zápis, např.1.23E+05)4E– dtto se 4 desetinnými místy (např.1.2345E+05)
F– fixed (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 odpovídají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: