# Metoda SIRT: oprava a napojení do GUI Stav k 2026-10-16, větev `dev`. Shrnuje commity `71a4a01` (regularizovaný SIRT s tlustými paprsky v knihovně) a `eea4cf1` (stránka SIRT v GUI). Matematiku metody popisuje [methods.md](methods.md#sirt-method), klíče do `config.yaml` [config_file.md](config_file.md). Podrobný výklad metody a její implementace je v [sirt.md](sirt.md). ## 1. Problém Původní `Tomo.do_SIRT_method` dávala na reálných datech nerealistický tomogram (ukázka: 12 senzorů, 66 paprsků, mřížka 60×60): - šachovnice rychlých a pomalých buněk, velké skoky mezi sousedy, - prázdná místa: buňky, kterými neprochází žádný paprsek, neměly hodnotu. Diagnostika: | zjištění | hodnota | |---|---| | rovnic (paprsků) / neznámých (buněk) | 66 / 1658 | | buněk protnutých jediným paprskem | 786 | | buněk oříznutých na výchozí `speed_max = 1300 m/s` | 701 (42 %) | | naměřené rychlosti paprsků | 567–1859 m/s | | prázdných buněk mřížky | 1823 | Soustava je silně podurčená. Buňka, kterou protíná jeden paprsek, může mít libovolnou hodnotu a SIRT do ní rozhodí reziduum, z toho vzniká šachovnice. ## 2. Co chybělo oproti obvyklým implementacím SIRT 1. **Regularizace.** Doplněna Tikhonovova regularizace Laplaceovým operátorem, `[A; αD] x = [b; 0]` (parametr `smoothing`, výchozí 10; 0 = klasický SIRT). 2. **Neznámé ve všech buňkách uvnitř obvodu.** Vyhlazení vyplní i buňky bez paprsků. 3. **Počáteční model.** Homogenní model (průměrná pomalost `Σt/ΣL`) místo nuly. 4. **Meze rychlosti z dat.** Výchozí meze `0,5 × min` (nejméně 340 m/s, rychlost zvuku ve vzduchu) a `max` naměřené rychlosti paprsků, místo pevných 300–1300 m/s. 5. **Řízení iterací.** Parametry `iterations`, `relaxation`, `tol`. 6. **Korekce anizotropie** volitelně (`fix_velocity_EBSI_function`), v GUI přes přepínač anizotropie. 7. **Řídké matice** (`scipy.sparse`). ## 3. Tlusté paprsky I s regularizací zůstávaly hvězdicové artefakty podél paprsků. Napěťová vlna ve dřevě není tenká čára: doba průletu závisí na Fresnelově zóně kolem přímky (šířka zhruba `√(λL)`, pro dřevo λ ≈ 0,25–0,6 m). Tlustý paprsek rozdělí svou délku do okolních buněk s Gaussovou vahou `exp(-(d/w)²)` podle vzdálenosti `d` středu buňky od paprsku. Součet řádku matice zůstává rovný délce paprsku, takže homogenní strom vyjde přesně. Výchozí šířka `ray_width='auto'` je 12 % průměru kmene (`ray_width_ratio`), `None` = tenké paprsky. Srovnání na ukázce (průměr kmene 54 cm): | varianta | reziduum | vzhled | |---|---|---| | tenké paprsky, bez vyhlazení (původní klasický SIRT) | 0,0001 | šachovnice, prázdná místa | | tenké paprsky, `smoothing=10` | 0,045 | hladké, hvězdice podél paprsků | | tlusté paprsky 12 %, `smoothing=10` (výchozí) | 0,107 | pomalé jádro, zdravý prstenec u kůry | Klasický SIRT splní naměřené časy téměř přesně, a přesto dává nesmyslný obraz: přizpůsobuje se šumu měření. Cenou tlustých paprsků je nižší rozlišení, malé defekty (pod ~10 cm) se rozmažou. ## 4. Opravené chyby - Při `fix_reaction_time=True` se reakční čas ořezával na meze pomalosti. (Od listopadu 2026 je reakční čas společné nastavení všech metod, `reconstruct(reaction_time=…)`, viz [sirt.md](sirt.md#8-reakční-čas-přístroje).) - Dělení nulou u paprsků rovnoběžných s osou mřížky, segmenty nulové délky. - Výsledek obcházel `_update_cell_velocity`: ignorovala se maska obvodu a buňky bez paprsku si nechávaly hodnoty z předchozí metody. - Pomalé přiřazování rychlostí segmentům (smyčka buňky × segmenty). ## 5. GUI - Menu Tomograph → **SIRT method** (za ERSM). - `analysis.reconstruct(method='SIRT', sirt_smoothing=…, sirt_ray_width=…, sirt_iterations=…, sirt_relaxation=…, sirt_speed_min=…, sirt_speed_max=…)`; report metody je v `t.sirt_report`. - Widgety v registru (`streamlit/widgets/__init__.py`), každý s nápovědou, co dělá: | widget | výchozí | význam | |---|---|---| | `sirt_smoothing` | 10 | váha vyhlazení, 0 = klasický SIRT | | `sirt_ray_width` | 12 | šířka tlustého paprsku v % průměru, 0 = tenké paprsky | | `sirt_iterations` | 2000 (do listopadu 2026 500) | počet iterací | | `sirt_relaxation` | 1,5 (do listopadu 2026 1,0) | velikost kroku iterace (0,1–1,9) | | `sirt_speed_min`, `sirt_speed_max` | 0 | meze rychlosti v buňce, 0 = automaticky | - Parametry a report jsou v panelu „SIRT method parameters“, ukládají se tlačítkem „💾 Save to file“ do `config.yaml` a přežijí přepnutí stránky. - Snippet „Reproduce in Jupyter“ obsahuje SIRT parametry jen na stránce SIRT; test ověřuje, že dá stejný tomogram jako stránka. - Binární tomogram, měření, srovnání s fotkou a kalibrace rychlosti přijímají SIRT tomogram. - Úprava „Rescale speeds“ (post-processing) se pro SIRT nenabízí. ## 6. Testy - `tests/test_sirt.py`: homogenní rychlost, žádné prázdné buňky uvnitř obvodu, nalezení pomalého středu, odhad reakčního času, klasický SIRT, součty řádků tlustých paprsků, automatická šířka, `reconstruct` = přímé volání `do_SIRT_method`. - `tests/streamlit/test_all_pages_smoke.py`: stránka SIRT ve všech variantách vykreslení, barevná škála snippetu, widgety s nápovědou, změna parametrů se projeví v tomogramu i snippetu. ## 7. Co zbývá - Zakřivené paprsky (ray bending) nejsou implementované, metoda počítá s přímými paprsky. - Zdravý prstenec u kůry je spíš horní odhad: buňky tam často dosáhnou horní meze (nejrychlejší naměřený paprsek). - `tests/test_reproducibility.py` zatím SIRT neporovnává s referenčním tomogramem.