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í |
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
Regularizace. Doplněna Tikhonovova regularizace Laplaceovým operátorem,
[A; αD] x = [b; 0](parametrsmoothing, výchozí 10; 0 = klasický SIRT).Neznámé ve všech buňkách uvnitř obvodu. Vyhlazení vyplní i buňky bez paprsků.
Počáteční model. Homogenní model (průměrná pomalost
Σt/ΣL) místo nuly.Meze rychlosti z dat. Výchozí meze
0,5 × min(nejméně 340 m/s, rychlost zvuku ve vzduchu) amaxnaměřené rychlosti paprsků, místo pevných 300–1300 m/s.Řízení iterací. Parametry
iterations,relaxation,tol.Korekce anizotropie volitelně (
fix_velocity_EBSI_function), v GUI přes přepínač anizotropie.Ří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, |
0,045 |
hladké, hvězdice podél paprsků |
tlusté paprsky 12 %, |
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=Truese 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 vt.sirt_report.Widgety v registru (
streamlit/widgets/__init__.py), každý s nápovědou, co dělá:widget
výchozí
význam
sirt_smoothing10
váha vyhlazení, 0 = klasický SIRT
sirt_ray_width12
šířka tlustého paprsku v % průměru, 0 = tenké paprsky
sirt_iterations2000 (do listopadu 2026 500)
počet iterací
sirt_relaxation1,5 (do listopadu 2026 1,0)
velikost kroku iterace (0,1–1,9)
sirt_speed_min,sirt_speed_max0
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.yamla 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.pyzatím SIRT neporovnává s referenčním tomogramem.