Kapitel 4 — Aux-Fenster
Neben dem Hauptfenster (3D-Viewport plus Inspector) verwaltet RadianceKit drei weitere Fenster, die alle über das Help-Menü geöffnet werden. Das Menü hat fünf Einträge, von oben nach unten: User Guide (⌘?), Keyboard Shortcuts (⌘/), Open Training Logs… (⇧⌘L), Open Exports Folder…, Manage Storage…. Die beiden „Open …"-Einträge öffnen kein App-Fenster, sondern den Finder; deshalb sind sie hier nicht weiter behandelt.
Die drei einfachen Fenster (User Guide, Keyboard Shortcuts, Manage Storage) und die beiden Ordner-Menüpunkte (Open Training Logs / Open Exports Folder) bekommen pro Steuerelement einen kurzen Eintrag.
Am Ende des Kapitels gibt es einen Querverweis-Abschnitt zum Inspector des Hauptfensters: was du im Live-Loss-Chart und in der Gaussian-Count-Anzeige während eines laufenden Trainings sinnvoll ablesen kannst.
User Guide (W1–W4)

Was es ist: Ein eingebautes Hilfefenster, das die bei der App mitgelieferte guide_<sprache>.md rendert. Die Sprache wird aus den Settings (Tab General → Language) oder, wenn dort „System" steht, aus den macOS-Sprachpräferenzen abgeleitet. Layout ist klassisch: links Sidebar mit allen Überschriften, rechts der Fließtext.
Wenn du eine schnelle Erinnerung an einen einzelnen Punkt brauchst — also als Stichwort-Ersatz. Die ausführliche Referenz ist dieses Manual; das eingebaute Hilfefenster ist die Kurzfassung zum schnellen Nachschlagen. Es wird bei jedem App-Release mit aktualisiert, aber inhaltlich oberflächlicher gehalten.
W1NavigationSplitView (Sidebar + Detail)
WO
Help → User Guide (⌘?).
TECHNISCH
Zweispalt-Layout mit schmaler Sidebar (mindestens 180 pt breit) für den Inhaltsbaum und einem scrollbaren Detail-Bereich für den eigentlichen Markdown-Inhalt. Das Fenster hat eine Mindestgröße von 700 × 500 pt. Beim ersten Öffnen lädt das Fenster die passende guide_<lang>.md aus dem App-Bundle (Fallback guide_en.md), parst sie in Block-Records (Überschriften H1–H4, Absätze, Listen, Tabellen, Trennlinien) und extrahiert separat die Überschriften-Struktur für die Sidebar. Inline-Formatierung (Bold, Italic, Code-Span) wird über die eingebaute Markdown-Engine gerendert. Die Sprache wird aus den App-Einstellungen gelesen, mit dem Spezialfall Chinesisch (zh-Hans) und Brasilianisches Portugiesisch (pt-BR), die als volle Locale-Tags behalten werden, weil sich diese Varianten von zh bzw. pt unterscheiden.
W2List (Heading-Sidebar)
WO
Linke Spalte im User-Guide-Fenster.
TECHNISCH
Liste über alle H2- und H3-Überschriften des aktuellen Markdown-Dokuments. H2-Einträge erscheinen ohne Einrückung mit Medium-Schriftgewicht, H3-Einträge mit 16 pt Einrückung links und reduziertem Foreground-Style. Alle anderen Ebenen — H1 ebenso wie H4 und tiefer — erscheinen nicht in der Sidebar, weil sie sie sonst unübersichtlich machen würden. Anker-IDs werden aus dem Heading-Text per Slugifizierung erzeugt (lowercase + Spaces zu Dashes + Filterung auf Letters/Numbers/Dashes — derselbe Algorithmus, den GitHub für seine Markdown-Anker verwendet, sodass auch externe URLs zur Doku potenziell auf denselben Anker landen würden). Die Liste verwendet den nativen macOS-Stil.
W3Button (Heading → Anchor-Sprung)
WO
Pro Sidebar-Zeile ein Button.
TECHNISCH
Jeder Sidebar-Eintrag ist ein Button, der den aktuellen Anker setzt, optisch aber wie ein Listeneintrag aussieht. Eine Beobachter-Variable triggert dann den Scroll-Sprung zum entsprechenden Anker mit einer weichen Animation über 0,3 s. Nach dem Sprung wird der Anker-Wert zurückgesetzt, damit der nächste Klick auf denselben Anker wieder feuert (sonst würde der Beobachter nicht erneut auslösen, weil sich der Wert nicht geändert hat).
W4ScrollView (Detail-Inhalt)
WO
Rechte Spalte.
TECHNISCH
Scrollbarer, vertikal-stapelnder Inhaltsbereich mit Lazy-Rendering, weil längere Guides leicht über 200 Markdown-Blöcke haben können — eine nicht-lazy Variante würde alle gleichzeitig instanziieren. Jeder Block bekommt eine eigene ID, entweder den Heading-Anker (den bekommt jede Überschrift, unabhängig von der Ebene) oder einen Index-Platzhalter. Maximalbreite ist 720 pt, Padding 32 horizontal / 24 vertikal, sodass lange Zeilen ein gut lesbares Layout behalten. Tabellen werden zellenweise mit horizontalen Stacks und Trennlinien gerendert; Inline- Code durch die eingebaute Markdown-Engine. Echte Codeblöcke werden aktuell als Paragraph behandelt — eine bekannte Einschränkung des Help-Fensters.
Keyboard Shortcuts (W5–W6)

Statische Referenz-Liste in fünf Sektionen. Navigation: Mouse Drag (Orbit/Fly), Shift+Drag/Right-Drag (Pan), Scroll (Zoom), WASD (Fly-Through-Bewegung), Q/E (Up/Down), F (Toggle Orbit/Fly), Double-click (Re-center), Cmd+Scroll (FoV-Adjust). Views: R (Reset Camera), T (Auto-Rotation), P (Camera Playback), B (Background-Cycle), 0–9 (Springe zu Training-Cam 1=10%/5=50%/0=last), Left/Right Arrow (Prev/Next Cam). Capture: S (Screenshot to Desktop), V (Turntable-Video), C (Copy Camera Info). Editor: Tab (Edit-Modus), Click/Drag (Paint-Select), Option+Click (Deselect), X / Delete (Selektion löschen), Cmd-Z (Letzte Löschung rückgängig), [ / ] (Pinselgröße kleiner/größer), Esc (Selektion aufheben). Training: Option+Space (Training pausieren/fortsetzen), Cmd+E (Szene exportieren). Mehr steht hier nicht — Start, Cancel und die Verlängerungen erreichst du über das Training-Menü (Kapitel 1).
Was es ist: Eine simple statische Übersicht aller Tastenkürzel — Navigation, Views, Capture, Editor, Training. Der Inhalt ist fest eingebaut und wird nicht aus einer Datei nachgeladen.
Wenn du nach dem schnellsten Weg suchst, etwas im Viewport zu tun. WASD-Fly-Through, R für Camera-Reset, B fürs Background-Cycling — alle stehen hier.
W5ScrollView (Inhaltsbereich)
WO
Help → Keyboard Shortcuts (⌘/).
TECHNISCH
Ein einfacher Scroll-Bereich mit einer vertikalen Liste drin. Padding 20 rundherum, kein Sidebar-Navigations-Tree (die Liste ist kurz genug). Inhalte sind in fünf Sektionen gruppiert (Navigation, Views, Capture, Editor, Training). Pro Tastenkombination eine Zeile mit übersetzbarem Text in beiden Spalten. Linke Spalte (Tastencode) fixiert auf 180 pt Breite, sodass die Beschreibungen rechts vertikal aligned bleiben. Keine Interaktion außer Scrollen — Klicken auf eine Zeile löst nichts aus, die Tastenkürzel sind echte Tastatur-Modifier im Menü und auf dem Viewport.
W6VStack (Shortcut-Sektionen)
WO
Innerhalb des ScrollView.
TECHNISCH
Linksbündig gestapelte Sektionen mit 16 pt Abstand. Innerhalb der fünf Sektionen jeweils Heading + Zeilen-Folge. Headings nutzen einen sekundären Subheadline-Stil — bewusst kein Title-Format, weil die Sektionen nicht navigierbar sein müssen. Inhalt ist bewusst flach (kein Disclosure, kein Search, kein Filter), damit die Komponente auf jeder macOS-Version unverändert läuft und die Datei lesbar bleibt.
Manage Storage (W7–W12)

Tabellen-Ansicht aller von RadianceKit verwalteten Files. Header zählt 1.356 Items, 55,1 GB Gesamtgröße. Toolbar oben: „Show in Finder" + „Refresh". Jede Zeile: Export-Icon, Dateiname (z.B. training_20260718T194416Z.ply), Export-Datum, Größe (variiert hier von 7,8 MB bis 2,24 GB), Lupen-Icon (Reveal) und Papierkorb-Icon (Move to Trash). Sortiert wird zuerst nach Kategorie und innerhalb einer Kategorie nach Datum, neueste oben. In dieser Aufnahme dominieren PLY-Exports, weil in dieser Ablage vor allem Trainings-Ergebnisse gesichert wurden.
Was es ist: Eine Disk-Usage-Übersicht für alles, was RadianceKit unter ~/Documents/RadianceKit/ ablegt — Logs, Exports, Scenes, Capture-Bundles (vom iOS-Begleiter), Imports (Staging-Kopien der Eingabe-Bilder). Pro Eintrag eine Größe in Bytes und zwei Buttons: „im Finder anzeigen" und „in den Papierkorb verschieben". Ist KEIN automatisches Aufräumen — die App löscht selbst nichts; du entscheidest pro Eintrag. Dieses Fenster ist übersetzt: auf Deutsch heißt es „Speicher verwalten", die beiden Kopfzeilen-Knöpfe heißen „Im Finder anzeigen" und „Aktualisieren", die Zeilen-Knöpfe „Im Finder anzeigen" und „In den Papierkorb legen". Die englischen Namen in den Einträgen unten sind die Bezeichnungen aus der englischen Fassung.
Wenn die Platte voll wird. Vor allem die Logs sammeln sich (eine JSONL pro Trainingsversuch, plus die _qualityMetrics.json); die Exports natürlich auch (PLY 100% rohe Daten, einer pro Export). Auch nützlich nach einem Absturz, wenn das Imports-Staging-Verzeichnis noch alte Kopien der Eingangsbilder herumliegen hat.
W7Button „Show in Finder"
WO
Header oben rechts im Storage-Browser-Fenster.
TECHNISCH
Öffnet den RadianceKit-Datenordner im Finder — genau das Verzeichnis, dessen Inhalt dieses Fenster auflistet. Damit siehst du die Ordnerstruktur (Logs, Exports, Scenes, Captures, Imports) direkt und kannst die Dateien auch mit dem Finder selbst verschieben oder kopieren. Die Aktion öffnet ein neues Finder-Fenster; die Liste im Fenster ändert sich dadurch nicht mit — dafür ist „Refresh" da (W8).
W8Button „Refresh"
WO
Header, neben dem Finder-Button.
TECHNISCH
Triggert einen Hintergrund-Scan, der auf einem nutzer-initiierten asynchronen Task läuft, damit das Scannen großer Verzeichnisbäume die UI nicht blockiert. Das eigentliche Walken geht jeden bekannten Unterordner (Logs, Exports, Scenes, Captures, Imports) durch und erzeugt pro direktem Kind einen Storage-Eintrag. Pro Eintrag wird die rekursive Größe ermittelt — bevorzugt der tatsächliche Plattenverbrauch (inklusive APFS-Hardlinks-Sharing) mit Fallback auf die logische Dateigröße.
W9List (Storage-Einträge)
WO
Hauptinhalt unter dem Header.
TECHNISCH
Liste mit pro Zeile diesem Layout: kategorie- spezifisches SF-Symbol-Icon (Dokument für Logs, Upload-Pfeil für Exports, Würfel für Scenes, iPhone für Capture-Bundles, Tray für Imports), Name + Untertitel (Kind-Label + formatiertes Modifications-Datum), Bytes-Counter rechts (rechtsbündig, monospaced), Reveal-Button (Lupe-Symbol), Trash-Button (Papierkorb). Sortierung: primär nach Kind (Scenes zuerst, dann Exports, Logs, Captures, Imports, Other), sekundär nach Modifikationsdatum absteigend (neueste oben). Wenn der Scan noch läuft, zeigt die Stelle stattdessen einen „Scanning…"-Fortschritt. Wenn nichts gefunden wurde, eine Empty-State-Anzeige mit Tray-Icon.
W10Row-Button „Reveal in Finder"
WO
Pro Zeile, Lupe-Symbol rechts.
TECHNISCH
Öffnet den Finder und selektiert das spezifische Item (Datei oder Ordner). Unterschied zu W7: W7 öffnet das Root-Verzeichnis; W10 markiert genau diesen einen Eintrag. Praktischer Workflow: identifiziere einen großen Eintrag, klick auf die Lupe, kopiere ihn dann zum Beispiel auf ein externes Volume.
W11Row-Button „Move to Trash"
WO
Pro Zeile, Papierkorb-Symbol rechts neben der Lupe.
TECHNISCH
Löst die Bestätigungs-Dialog-Box (W12) aus. Erst nach Bestätigung läuft die macOS-Standard-Operation „in den Papierkorb verschieben" (also reversibel, kein direktes Löschen). Nach erfolgreichem Trash wird der Eintrag aus der Liste entfernt und der Gesamtbyte-Counter aktualisiert. Bei Fehlern wird ein modaler Fehler-Dialog eingeblendet.
W12ConfirmationDialog (Lösch-Bestätigung)
WO
Wird durch W11 ausgelöst, dargestellt als macOS-Sheet.
TECHNISCH
Standard-Bestätigungsdialog mit dynamischem Titel „Delete <name>?" und einer Message-Zeile, die explizit darauf hinweist, dass der Eintrag im Papierkorb landet und von dort wiederherstellbar ist (bis der Papierkorb geleert wird). Zwei Buttons: „Move to Trash" als destruktive Aktion (rot dargestellt) und „Cancel" mit automatischer Esc-Bindung. Der Dialog ist non-modal in dem Sinne, dass er nur dieses Fenster blockiert, nicht die ganze App — das ist macOS-Standard für reversible Löschungen.
Hauptfenster: Verlustverlauf und Gaussian-Count (I39–I41, Querverweis)
Drei der Inspector-Anzeigen im Hauptfenster verdienen eine eigene Erklärung, weil sie während eines laufenden Trainings ständig zu sehen sind und es wichtige Faustregeln gibt, wann der Verlauf gesund aussieht. Die Anzeigen sitzen im Inspector im Abschnitt Fortschritt, in der aufklappbaren Gruppe Verlustverlauf (siehe Kapitel 2 — Inspector) und ordnen den Trainingsfortschritt ein.
Wann ist die Loss-Kurve gesund? Eine gesunde Loss-Kurve zeigt drei Phasen: (1) Warmup — die ersten 200–500 Iterationen fällt der Loss steil von hoch (typisch 0.15–0.25 für L1+SSIM-kombiniert je nach Szene) auf etwa die Hälfte. Wenn der Loss in dieser Phase NICHT fällt, ist meist die Eingabe falsch (Bilder kaputt, SfM-Posen schlecht, Anzahl Initial-Gaussians zu klein). (2) Densification — zwischen ~500 und densifyUntilIteration (klassisch 15K, MCMC bis 20K oder 25K) fällt der Loss weiter, oft mit kleinen Sprüngen nach unten wenn Densify-Operationen neue Gaussians einfügen und der Optimizer sie ausnutzt. Der Gaussian-Count steigt in dieser Phase. (3) Refinement — danach läuft der Loss in einen flacher werdenden Tail. Typische End-Werte zur Orientierung: eine gut ausgeleuchtete Objekt-Szene (etwa Tanks-&-Temples Truck mit P4 Quality) landet bei L1 ≈ 0.023, weiträumige Außenszenen wie die von Mip-NeRF 360 bleiben naturgemäß darüber (0.04–0.07).
Was bedeutet ein Plateau? Ein Plateau (Loss-Kurve verläuft horizontal über mehrere Tausend Iterationen) hat zwei Interpretationen: (a) das Modell hat konvergiert, weiteres Training bringt nichts mehr — das ist der gute Fall. (b) das Modell ist stuck (lokales Minimum, schlechte Gradient-Information, ein Cap am Buffer-Limit) — der schlechte Fall. Beide sehen im Chart identisch aus. Unterscheidung: schau dir den Gaussian-Count an. Wenn er auch flach ist UND dem MCMC-Cap nahe (z.B. 150K von 150K beim Preset P8 Quality (MCMC)), bist du am Limit — entweder Cap erhöhen oder Plateau akzeptieren. Wenn der Gaussian-Count noch wächst, aber der Loss nicht fällt, ist das stuck.
Wann abbrechen vs weitertrainieren? Faustregel: 10K Iterationen lang keine Verbesserung des Min-Loss → abbrechen, weitere Iterationen sind verschwendet. Davor: über das Training-Menü → Continue Training → „+5,000 iterations" kannst du noch eine Verlängerung anhängen, falls du grenzwertige Verbesserung siehst (ein Tastenkürzel gibt es dafür nicht). Achtung: bei MCMC ist das Plateau oft echt — das Cap ist die natürliche Grenze.
Gaussian-Count-Plateau ist KEIN „fertig"-Signal. Es bedeutet nur, dass MCMC das Cap erreicht hat oder dass Classic Densification ausgereizt ist. Die echte „fertig"-Frage beantworten erst PSNR/SSIM/LPIPS auf einem unabhängigen Test-Set. Das unabhängige Test-Set zeigt auch, ob dein Kamera-Satz eine faire Aufteilung in Trainings- und Test-Blickwinkel zulässt.
PSNR/Holdout ist die Wahrheit, Loss nur Proxy. Der Loss ist eine relative Metrik: er fällt während dein Modell sich an die Trainings-Views anpasst. Ein niedriger Loss heißt aber nicht automatisch gutes Modell — wenn das Modell die Trainings-Bilder auswendig gelernt hat (Overfitting), wäre der Loss klein, aber die PSNR auf ungesehenen Views (Holdout) wäre schlecht. Deshalb: für die finale Qualitätsbewertung immer auf Holdout-Metriken schauen, nicht auf End-Loss allein.
Faustregel-Box
- User Guide und Keyboard Shortcuts sind statische Hilfe — bei Stichwort-Fragen schnell, für Tiefe das hier vorliegende Manual nutzen. - Manage Storage öffnen, sobald die Platte unter 10% freien Speicher fällt. Logs und Imports-Staging sind die üblichen Sünder. - Loss-Plateau und Gaussian-Count-Plateau sind getrennt zu interpretieren. Cap-Limit ist kein „fertig"-Signal. Echte Qualität misst nur Holdout-PSNR. - 10K Iterationen ohne Min-Loss-Verbesserung → Training stoppen.