# „Rescale speeds“: analýza, oprava a korekce zpětnou projekcí Stav k 2026-10-17, větev `dev`. Shrnuje analýzu post-processingu „Rescale speeds“ u EBSI a ERSM (`Tomo.optimize_back_tomogram`, `classes/_tomo_analysis.py`), jeho opravu a novou korekci zpětnou projekcí (`Tomo.correct_with_FBP`). Princip zpětné projekce popisuje [backprojection.md](backprojection.md), metodu SIRT [sirt_report.md](sirt_report.md). ## 1. Co „Rescale speeds“ dělá Hledá dvě čísla `k` a `q` a všechny rychlosti v buňkách přepočte jednou lineární funkcí $$v' = \max(340,\; k\,v + q).$$ Konstanty minimalizují součet čtverců rozdílů mezi naměřenými dobami průletu a dobami vypočtenými z tomogramu (rychlosti se vzorkují podél každého paprsku). Mez 340 m/s je rychlost zvuku ve vzduchu. Ve výchozím stavu je volba zapnutá. ## 2. Zjištění (stav před opravou) 1. **Chybná fyzika modelu.** Doba průletu se počítala jako `L / průměr(v)` (aritmetický průměr rychlostí). Správně je to integrál pomalosti, `L · průměr(1/v)` (harmonický průměr). Aritmetický průměr je vždy větší nebo roven harmonickému, nejvíc u paprsků přes pomalou oblast. Model proto doby průletu přes dutinu podceňoval a optimalizace to dohnala roztažením kontrastu (`k` 1,7–4,3, `q` −1200 až −4700). Dutiny vycházely přehnané. 2. **Shoda s naměřenými časy se většinou zhoršila.** Podle vlastního (chybného) měřítka se vždy zlepšila, podle správného měřítka se zhoršila v 9 ze 14 případů, u ERSM v 6 ze 7. 3. **Ořez na 340 m/s** se týkal až 15 % buněk (Jičín_14, ERSM) – projev přehnaného kontrastu. 4. **Přepisuje naměřené rychlosti paprsků a segmentů** (`r.speed`, `s.speed`), až o 2431 m/s. Zobrazení „rays only“, barevná škála paprsků (`tomogram.py`) a filtry „Minimal/Maximal ray speed to be included“ pak pracují s přeškálovanými hodnotami místo měření. 5. **Jen dva parametry pro celý řez.** Lineární funkce mění kontrast, ne tvar ani polohu defektů. 6. **Nepřesná nápověda:** varovala před „large slowdown“ (výpočet trvá 0,03–0,05 s) a mluvila o časech „ze segmentovaných paprsků“, ale počítaly se z buněk. 7. **Numerika v pořádku:** optimalizace (Nelder–Mead) konvergovala ve všech případech. ## 3. Oprava (body 1 a 6) - Doba průletu se počítá jako integrál pomalosti, `L · průměr(1/v)` přes body vzorkované na paprsku (vektorizovaně, stále setiny sekundy). - Nápověda přepínače a vysvětlení na stránce („Tomogram TOF“) odpovídají skutečnému výpočtu. - Referenční data `tests/test_reproducibility.py` (pole ERSM v `tests/data/jicin_05_tomograms.npz`, počítané s rescale) jsou přegenerovaná; Rays a EBSI beze změny. Stejně se změní výsledky každého datasetu s `rescale: true`. - Bod 4 (přepisování rychlostí paprsků) zatím zůstává. ## 4. Korekce zpětnou projekcí (nová volba) Výsledek EBSI nebo ERSM je výchozí model $x_0$ (pomalosti; buňky bez hodnoty dostanou průměrnou pomalost) a jeden krok filtrované zpětné projekce ho přizpůsobí naměřeným časům: $$x = x_0 + A^T (A A^T + \mu I)^{-1} (b - A x_0), \qquad \mu = \lambda\,\frac{\operatorname{tr}(AA^T)}{m}.$$ - Mění každou buňku zvlášť, takže opraví i tvar a polohu defektu, ne jen kontrast. - Kde data nic neříkají, zůstane výsledek EBSI/ERSM. - Paprsky a úseky ERSM se nemění; naměřené časy se berou z `ray.time`, takže korekce funguje i po „Rescale speeds“ (ten přepisuje rychlosti paprsků). - Tlusté paprsky (12 % průměru), tlumení λ (výchozí 1), rychlosti ořezané na interval 0,5 × nejpomalejší (nejméně 340 m/s) až nejrychlejší naměřený paprsek. - Aplikace: „✨ Post-processing settings“ → **Correct by back projection** a tlumení; knihovna: `Tomo.correct_with_FBP(damping=...)`, `analysis.reconstruct(fbp_correction=True, fbp_correction_damping=...)`; `config.yaml`: `fbp_correction`, `fbp_correction_damping`. ## 5. Srovnání ### Syntetické stromy 12 senzorů na kruhu o poloměru 30 cm, přesné doby průletu po přímkách, mřížka 40×40. Skutečnost: dutina 500 m/s, zdravé dřevo 1500 m/s. Hodnoty jsou průměry v dutině / ve zdravém dřevě v m/s. | varianta | centrální dutina r = 10 cm | mimostředová dutina r = 8 cm | |---|---|---| | EBSI | 1023 / 1437 | 1137 / 1446 | | EBSI + rescale (původní) | 364 / 1447 | 389 / 1510 | | EBSI + rescale (opravený) | 591 / 1392 | 659 / 1491 | | ERSM | 943 / 1352 | 1038 / 1410 | | ERSM + rescale (původní) | **340** / 1492 | **340** / 1522 | | ERSM + rescale (opravený) | 524 / 1479 | 492 / 1528 | | ERSM + korekce zpětnou projekcí | 532 / 1479 | 524 / 1465 | | ERSM + rescale (opravený) + korekce | 465 / 1493 | 491 / 1469 | | SIRT (výchozí) | 561 / 1473 | 595 / 1486 | | FBP (výchozí) | 557 / 1464 | 549 / 1462 | Hodnota 340 je spodní mez: původní rescale by dutinu udělal ještě pomalejší. ### Shoda s naměřenými časy Relativní chyba dob průletu ‖t_model − t_naměřený‖ / ‖t_naměřený‖, kde t_model je integrál pomalosti podél paprsku. Datasety ze `streamlit_data` s výchozím nastavením aplikace (mřížka 41×41, korekce anizotropie, obvod spline); `temp/sirt.py` odpovídá Jičín_14. | případ | bez rescale | původní rescale | opravený rescale | |---|---|---|---| | centrální dutina, EBSI | 0,200 | 0,150 | 0,088 | | centrální dutina, ERSM | 0,159 | **0,293** | 0,039 | | mimostředová dutina, EBSI | 0,172 | **0,202** | 0,094 | | mimostředová dutina, ERSM | 0,154 | **0,225** | 0,054 | | Jičín_05, EBSI | 0,162 | 0,100 | 0,078 | | Jičín_05, ERSM | 0,120 | 0,093 | 0,071 | | Jičín_08, EBSI | 0,252 | 0,228 | 0,139 | | Jičín_08, ERSM | 0,195 | **0,256** | 0,124 | | Jičín_14, EBSI | 0,332 | 0,225 | 0,100 | | Jičín_14, ERSM | 0,242 | **0,298** | 0,095 | | Jičín_15, EBSI | 0,254 | **0,272** | 0,056 | | Jičín_15, ERSM | 0,172 | **0,334** | 0,027 | Tučně: původní rescale shodu zhoršil. Opravený rescale ji zlepší ve všech případech. ### Konstanty a ořez | případ | původní k, q | % buněk na 340 m/s | opravený k, q | |---|---|---|---| | centrální dutina, ERSM | 3,48; −3216 | 10,0 | 2,33; −1677 | | mimostředová dutina, ERSM | 4,02; −4142 | 4,7 | 2,78; −2395 | | Jičín_05, ERSM | 2,32; −1721 | 0,0 | 2,14; −1453 | | Jičín_08, ERSM | 2,37; −1641 | 3,7 | 2,00; −1142 | | Jičín_14, ERSM | 2,28; −1561 | 15,1 | 1,96; −1033 | | Jičín_15, ERSM | 2,54; −1926 | 8,3 | 2,02; −1186 | ## 6. Doporučení - Pro EBSI a ERSM používat opravený rescale nebo korekci zpětnou projekcí. Korekce je přesnější v poloze a tvaru defektu, rescale jen dorovná kontrast. - Zbývá: rescale by neměl přepisovat naměřené rychlosti paprsků (bod 4); po opravě by „rays only“ dál ukazovalo měření. ## 7. Testy - `tests/test_rescale.py`: doby průletu jako integrál pomalosti, rescale zlepší shodu a nepřežene dutinu, korekce přiblíží dutinu skutečnosti, zachová paprsky a homogenní strom, funguje i po rescale. - `tests/streamlit/test_all_pages_smoke.py`: korekce u ERSM v GUI změní tomogram a snippet „Reproduce in Jupyter“ dá stejný výsledek. - `tests/test_reproducibility.py`: přegenerovaná reference ERSM.