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, klíče do config.yaml config_file.md. Podrobný výklad metody a její implementace je v 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.)

  • 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.