Kapitola 4 — Pomocná okna
Vedle hlavního okna (3D viewport plus Inspector) spravuje RadianceKit tři další okna, která se všechna otevírají přes menu Help. Menu má pět položek, seřazených shora dolů: User Guide (⌘?), Keyboard Shortcuts (⌘/), Open Training Logs… (⇧⌘L), Open Exports Folder…, Manage Storage…. Obě položky „Open …" neotevírají žádné okno aplikace, ale Finder; proto se jimi tato kapitola dál nezabývá.
Tři jednoduchá okna (User Guide, Keyboard Shortcuts, Manage Storage) a obě položky menu pro složky (Open Training Logs / Open Exports Folder) mají pro každý ovládací prvek krátký záznam.
Na konci kapitoly najdeš odkazový oddíl k Inspectoru hlavního okna: co si smysluplně můžeš přečíst z grafu Live Loss a z ukazatele počtu Gaussianů během probíhajícího trénování.
Uživatelská příručka (W1–W4)

Co to je: Vestavěné okno nápovědy, které vykresluje soubor guide_<sprache>.md dodávaný s aplikací. Jazyk se odvozuje z nastavení (záložka General → Language), nebo pokud je tam nastaveno „System", z jazykových preferencí macOS. Rozvržení je klasické: vlevo postranní panel se všemi nadpisy, vpravo souvislý text.
Když potřebuješ rychlou připomínku k jednomu konkrétnímu bodu — tedy jako náhradu za heslovité přehledy. Podrobnou referencí je tento manuál; vestavěné okno nápovědy je stručná verze pro rychlé nahlédnutí. Aktualizuje se s každým vydáním aplikace, ale obsahově zůstává povrchnější.
W1NavigationSplitView (postranní panel + detail)
KDE
Help → User Guide (⌘?).
TECHNICKY
Dvoususloupcové rozvržení s úzkým postranním panelem (minimálně 180 pt široký) pro strom obsahu a scrollovatelnou detailní oblastí pro samotný Markdown obsah. Okno má minimální velikost 700 × 500 pt. Při prvním otevření okno načte odpovídající guide_<lang>.md z balíčku aplikace (fallback guide_en.md), rozparsuje ji na blokové záznamy (nadpisy H1–H4, odstavce, seznamy, tabulky, oddělovací čáry) a odděleně extrahuje strukturu nadpisů pro postranní panel. Vnitřní formátování (tučné, kurzíva, kódový úsek) se vykresluje pomocí vestavěného Markdown enginu. Jazyk se čte z nastavení aplikace, se speciálním případem čínštiny (zh-Hans) a brazilské portugalštiny (pt-BR), které se ponechávají jako plné locale tagy, protože se tyto varianty liší od zh, resp. pt.
W2List (postranní panel s nadpisy)
KDE
Levý sloupec v okně uživatelské příručky.
TECHNICKY
Seznam všech nadpisů H2 a H3 v aktuálním Markdown dokumentu. Položky H2 se zobrazují bez odsazení se středním řezem písma, položky H3 s odsazením 16 pt vlevo a redukovaným stylem popředí. Všechny ostatní úrovně — H1 stejně jako H4 a hlubší — se v postranním panelu nezobrazují, protože by ho jinak činily nepřehledným. ID kotev se generují z textu nadpisu sluggifikací (malá písmena + mezery na pomlčky + filtrování na písmena/čísla/pomlčky — stejný algoritmus, jaký používá GitHub pro své Markdown kotvy, takže by i externí URL adresy na dokumentaci potenciálně mohly mířit na stejnou kotvu). Seznam používá nativní styl macOS.
W3Button (přeskok nadpis → kotva)
KDE
Jedno tlačítko na řádek v postranním panelu.
TECHNICKY
Každá položka postranního panelu je tlačítko, které nastaví aktuální kotvu, ale vizuálně vypadá jako položka seznamu. Pozorovací proměnná pak spustí posun scrollu na příslušnou kotvu s plynulou animací trvající 0,3 s. Po přeskoku se hodnota kotvy resetuje, aby další klik na stejnou kotvu opět zafungoval (jinak by se pozorovač znovu nespustil, protože se hodnota nezměnila).
W4ScrollView (obsah detailu)
KDE
Pravý sloupec.
TECHNICKY
Scrollovatelná, vertikálně skládaná oblast obsahu s líným (lazy) vykreslováním, protože delší příručky snadno mají přes 200 Markdown bloků — varianta bez lazy vykreslování by musela instanciovat všechny najednou. Každý blok dostane vlastní ID, buď kotvu nadpisu (tu dostane každý nadpis, bez ohledu na úroveň) nebo indexový zástupný symbol. Maximální šířka je 720 pt, odsazení 32 horizontálně / 24 vertikálně, takže dlouhé řádky mají dobře čitelné rozvržení. Tabulky se vykreslují po buňkách pomocí horizontálních stacků a oddělovacích čar; vnitřní kód pomocí vestavěného Markdown enginu. Skutečné bloky kódu se aktuálně zpracovávají jako odstavec — známé omezení okna nápovědy.
Klávesové zkratky (W5–W6)

Statický referenční seznam v pěti sekcích. Navigation: Mouse Drag (Orbit/Fly), Shift+Drag/Right-Drag (Pan), Scroll (Zoom), WASD (pohyb ve Fly-Through režimu), Q/E (nahoru/dolů), F (přepnutí Orbit/Fly), Double-click (nové vycentrování), Cmd+Scroll (úprava FoV). Views: R (reset kamery), T (automatická rotace), P (přehrávání kamery), B (přepínání pozadí), 0–9 (skok na tréninkovou kameru 1=10 %/5=50 %/0=poslední), šipka vlevo/vpravo (předchozí/další kamera). Capture: S (screenshot na plochu), V (turntable video), C (kopírovat informace o kameře). Editor: Tab (editační režim), Click/Drag (výběr malováním), Option+Click (zrušit výběr), X / Delete (smazat výběr), Cmd-Z (vrátit poslední smazání), [ / ] (menší/větší velikost štětce), Esc (zrušit výběr). Training: Option+Space (pozastavit/ pokračovat v tréninku), Cmd+E (exportovat scénu). Víc tu není — start, zrušení a prodloužení najdeš v menu Training (kapitola 1).
Co to je: Jednoduchý statický přehled všech klávesových zkratek — Navigation, Views, Capture, Editor, Training. Obsah je pevně zabudovaný a nenačítá se ze souboru.
Když hledáš nejrychlejší cestu, jak něco udělat ve Viewportu. WASD-Fly-Through, R pro reset kamery, B pro přepínání pozadí — vše je tady.
W5ScrollView (oblast obsahu)
KDE
Help → Keyboard Shortcuts (⌘/).
TECHNICKY
Jednoduchá scrollovací oblast s vertikálním seznamem uvnitř. Padding 20 kolem dokola, žádný postranní navigační strom (seznam je dost krátký). Obsah je seskupen do pěti sekcí (Navigation, Views, Capture, Editor, Training). Pro každou klávesovou kombinaci jeden řádek s přeložitelným textem v obou sloupcích. Levý sloupec (kód klávesy) má pevnou šířku 180 pt, takže popisy vpravo zůstávají vertikálně zarovnané. Žádná interakce kromě scrollování — kliknutí na řádek nic nespustí, klávesové zkratky jsou skutečné klávesové modifikátory v menu a ve Viewportu.
W6VStack (sekce zkratek)
KDE
Uvnitř ScrollView.
TECHNICKY
Sekce zarovnané doleva, naskládané na sebe s odstupem 16 pt. Uvnitř každé z pěti sekcí je nadpis a posloupnost řádků. Nadpisy používají sekundární styl Subheadline — záměrně žádný formát Title, protože sekce nemusí být navigovatelné. Obsah je záměrně plochý (žádné rozbalování, žádné vyhledávání, žádný filtr), aby komponenta fungovala beze změn na jakékoli verzi macOS a soubor zůstal čitelný.
Správa úložiště (W7–W12)

Tabulkový přehled všech souborů spravovaných aplikací RadianceKit. Hlavička zobrazuje 1 356 položek, celkovou velikost 55,1 GB. Panel nástrojů nahoře: „Show in Finder" + „Refresh". Každý řádek: ikona exportu, název souboru (např. training_20260718T194416Z.ply), datum exportu, velikost (v tomto záznamu se pohybuje od 7,8 MB do 2,24 GB), ikona lupy (Reveal) a ikona koše (Move to Trash). Řazeno je nejprve podle kategorie a v rámci kategorie podle data, nejnovější nahoře. Na tomto snímku dominují PLY exporty, protože v tomto úložišti byly ukládány především výsledky trénování.
Co to je: Přehled využití disku pro vše, co RadianceKit ukládá do ~/Documents/RadianceKit/ — logy, exporty, scény, capture-balíčky (z iOS doprovodné aplikace), importy (dočasné kopie vstupních obrázků). U každé položky velikost v bajtech a dvě tlačítka: „zobrazit ve Finderu" a „přesunout do koše". NENÍ to automatické čištění — aplikace sama nic nemaže, rozhoduješ se u každé položky sám. Toto okno je přeloženo: v češtině by se jmenovalo „Správa úložiště", obě tlačítka v hlavičce se jmenují „Zobrazit ve Finderu" a „Aktualizovat", tlačítka u řádků „Zobrazit ve Finderu" a „Přesunout do koše". Anglické názvy v položkách níže odpovídají označením z anglické verze.
Když se disk začne plnit. Nejvíc přibývá logů (jeden JSONL na pokus o trénování, plus _qualityMetrics.json); exporty samozřejmě také (PLY je 100% surová data, jeden na export). Užitečné i po pádu aplikace, kdy ve staging adresáři importů mohou ještě ležet staré kopie vstupních obrázků.
W7Tlačítko „Show in Finder"
KDE
Hlavička vpravo nahoře v okně storage prohlížeče.
TECHNICKY
Otevře datový adresář RadianceKit ve Finderu — přesně ten adresář, jehož obsah toto okno zobrazuje. Uvidíš tak přímo strukturu složek (Logs, Exports, Scenes, Captures, Imports) a soubory můžeš i sám přesouvat nebo kopírovat přímo ve Finderu. Akce otevře nové okno Finderu; seznam v tomto okně se tím nemění — k tomu slouží „Refresh" (W8).
W8Tlačítko „Refresh"
KDE
Hlavička, vedle tlačítka Finder.
TECHNICKY
Spustí sken na pozadí, který běží na uživatelem iniciovaném asynchronním úkolu, aby skenování velkých adresářových stromů neblokovalo UI. Vlastní procházení projde všechny známé podadresáře (Logs, Exports, Scenes, Captures, Imports) a pro každou přímou položku vytvoří záznam v úložišti. U každého záznamu se zjišťuje rekurzivní velikost — přednostně skutečná spotřeba místa na disku (včetně sdílení díky APFS hardlinkům) s fallbackem na logickou velikost souboru.
W9List (položky úložiště)
KDE
Hlavní obsah pod hlavičkou.
TECHNICKY
Seznam, u kterého má každý řádek toto rozvržení: kategorii odpovídající ikona SF Symbol (dokument pro logy, šipka nahoru pro exporty, kostka pro scény, iPhone pro capture-balíčky, přihrádka pro importy), název + podtitulek (popisek typu + formátované datum poslední změny), počítadlo bajtů vpravo (zarovnáno vpravo, neproporcionálním písmem), tlačítko Reveal (ikona lupy), tlačítko Trash (koš). Řazení: primárně podle typu (nejprve scény, pak exporty, logy, capture-balíčky, importy, ostatní), sekundárně podle data poslední změny sestupně (nejnovější nahoře). Pokud sken ještě běží, zobrazí se místo toho průběh „Scanning…". Pokud nic nebylo nalezeno, zobrazí se prázdný stav s ikonou přihrádky.
W10Tlačítko řádku „Reveal in Finder"
KDE
U každého řádku, ikona lupy vpravo.
TECHNICKY
Otevře Finder a vybere konkrétní položku (soubor nebo složku). Rozdíl oproti W7: W7 otevře kořenový adresář; W10 označí přesně jednu tuto položku. Praktický postup: najdi velkou položku, klikni na lupu, pak ji zkopíruj třeba na externí disk.
W11Tlačítko řádku „Move to Trash"
KDE
U každého řádku, ikona koše vpravo vedle lupy.
TECHNICKY
Vyvolá potvrzovací dialog (W12). Teprve po potvrzení proběhne standardní operace macOS „přesunout do koše" (tedy vratná, žádné přímé mazání). Po úspěšném přesunutí do koše se položka odstraní ze seznamu a aktualizuje se celkový počítadlo bajtů. Při chybě se zobrazí modální dialog s chybovou zprávou.
W12ConfirmationDialog (potvrzení smazání)
KDE
Vyvolá jej W11, zobrazí se jako sheet macOS.
TECHNICKY
Standardní potvrzovací dialog s dynamickým nadpisem „Delete <name>?" a řádkem se zprávou, která výslovně upozorňuje, že položka skončí v koši a lze ji odtud obnovit (dokud se koš nevyprázdní). Dvě tlačítka: „Move to Trash" jako destruktivní akce (zobrazena červeně) a „Cancel" s automatickou vazbou na klávesu Esc. Dialog je nemodální v tom smyslu, že blokuje jen toto okno, ne celou aplikaci — to je standardní chování macOS pro vratná mazání.
Hlavní okno: průběh loss funkce a počet Gaussianů (I39–I41, křížový odkaz)
Tři z zobrazení Inspectoru v hlavním okně si zaslouží vlastní vysvětlení, protože jsou během probíhajícího trénování neustále vidět a existují k nim důležitá pravidla, kdy průběh vypadá zdravě. Zobrazení se nacházejí v Inspectoru v sekci Průběh, v rozbalovací skupině Průběh loss funkce (viz kapitola 2 — Inspector), a pomáhají vyhodnotit průběh tréninku.
Kdy je křivka loss zdravá? Zdravá křivka loss ukazuje tři fáze: (1) Warmup — prvních 200–500 iterací klesá loss strmě z vysoké hodnoty (typicky 0.15–0.25 pro kombinaci L1+SSIM podle scény) zhruba na polovinu. Pokud loss v této fázi NEklesá, bývá obvykle chybný vstup (poškozené snímky, špatné SfM pózy, příliš malý počet Initial-Gaussians). (2) Densification — mezi ~500 a densifyUntilIteration (klasicky 15K, MCMC až 20K nebo 25K) loss dál klesá, často s malými skoky dolů, když operace densify vloží nové Gaussiany a optimizer je využije. Počet Gaussianů v této fázi roste. (3) Refinement — poté loss přechází do stále plošší koncové fáze (tail). Typické koncové hodnoty pro orientaci: dobře nasvícená scéna objektu (například Tanks-&-Temples Truck s P4 Quality) skončí na L1 ≈ 0.023, rozlehlé venkovní scény jako z Mip-NeRF 360 přirozeně zůstávají nad tím (0.04–0.07).
Co znamená plateau? Plateau (křivka loss probíhá vodorovně po několik tisíc iterací) má dvě interpretace: (a) model zkonvergoval, další trénování už nic nepřinese — to je dobrý případ. (b) model je zaseknutý (lokální minimum, špatná gradientní informace, dosažený strop bufferu) — to je špatný případ. Oba případy vypadají v grafu identicky. Rozlišení: podívej se na počet Gaussianů. Pokud je také plochý A blízko MCMC stropu (např. 150K ze 150K u presetu P8 Quality (MCMC)), jsi na limitu — buď strop zvýšíš, nebo plateau přijmeš. Pokud počet Gaussianů stále roste, ale loss neklesá, jde o zaseknutí.
Kdy přerušit a kdy trénovat dál? Základní pravidlo: pokud se minimální loss 10K iterací nezlepší → přeruš, další iterace jsou promarněné. Předtím: přes menu Training → Continue Training → „+5,000 iterations" můžeš ještě prodloužit trénování, pokud vidíš hraniční zlepšení (klávesová zkratka pro to neexistuje). Pozor: u MCMC je plateau často skutečné — strop je přirozená hranice.
Plateau počtu Gaussianů NENÍ signál „hotovo". Znamená pouze, že MCMC dosáhl stropu nebo že klasická densifikace je vyčerpaná. Skutečnou otázku „hotovo" zodpoví teprve PSNR/SSIM/LPIPS na nezávislé testovací sadě. Nezávislá testovací sada pak ověří, zda tvá sada kamer umožňuje férové rozdělení na trénovací a testovací úhly pohledu.
PSNR/Holdout je pravda, loss je jen proxy. Loss je relativní metrika: klesá, zatímco se tvůj model přizpůsobuje trénovacím pohledům. Nízký loss ale automaticky neznamená dobrý model — pokud se model naučil trénovací snímky nazpaměť (overfitting), byl by loss malý, ale PSNR na neviděných pohledech (holdout) by byla špatná. Proto: pro finální hodnocení kvality se vždy dívej na metriky holdout, ne jen na koncový loss.
Pravidlo palce
- User Guide a Keyboard Shortcuts jsou statická nápověda — rychlé pro dotazy na konkrétní pojmy, pro hloubku použij tento manuál. - Otevři Manage Storage, jakmile disk klesne pod 10 % volného místa. Logy a Imports-Staging jsou obvyklí viníci. - Loss-plateau a plateau počtu Gaussianů je třeba interpretovat odděleně. Cap-limit není signál „hotovo". Skutečnou kvalitu měří pouze Holdout-PSNR. - 10K iterací bez zlepšení min-loss → trénink zastavit.