Handleiding

Hoofdstuk 4 — Aux-vensters

Naast het hoofdvenster (3D-Viewport plus Inspector) beheert RadianceKit drie andere vensters, die allemaal via het Help-menu worden geopend. Het menu heeft vijf items, van boven naar beneden: User Guide (⌘?), Keyboard Shortcuts (⌘/), Open Training Logs… (⇧⌘L), Open Exports Folder… en Manage Storage…. De twee „Open …"-items openen geen app-venster maar de Finder; daarom worden ze hier niet verder behandeld.

De drie eenvoudige vensters (User Guide, Keyboard Shortcuts, Manage Storage) en de twee map-menu-items (Open Training Logs / Open Exports Folder) krijgen per bedieningselement een kort item.

Aan het einde van het hoofdstuk staat een kruisverwijzing naar de Inspector van het hoofdvenster: wat je zinvol kunt aflezen in de live-loss-grafiek en de Gaussian-count-weergave tijdens een lopende training.

Gebruikershandleiding (W1–W4)

Gebruikershandleiding-venster met sidebar links en gerenderde Markdown-inhoud rechts
Gebruikershandleiding-venster met sidebar links en gerenderde Markdown-inhoud rechts

Wat het is: Een ingebouwd hulpvenster dat de bij de app meegeleverde guide_<sprache>.md rendert. De taal wordt afgeleid uit de Settings (tab General → Language) of, als daar „System" staat, uit de macOS-taalvoorkeuren. De layout is klassiek: links een sidebar met alle kopjes, rechts de doorlopende tekst.

Als je snel aan één enkel punt herinnerd wilt worden — dus als vervanging voor steekwoorden. De uitgebreide referentie is dit handboek; het ingebouwde hulpvenster is de kortere versie voor snel opzoeken. Het wordt bij elke app-release mee bijgewerkt, maar inhoudelijk oppervlakkiger gehouden.

W1NavigationSplitView (sidebar + detail)

WAAR

Help → User Guide (⌘?).

TECHNISCH

Layout met twee kolommen: een smalle sidebar (minstens 180 pt breed) voor de inhoudsboom en een scrollbaar detailgebied voor de eigenlijke Markdown-inhoud. Het venster heeft een minimumgrootte van 700 × 500 pt. Bij het eerste openen laadt het venster de bijbehorende guide_<lang>.md uit de app-bundle (fallback guide_en.md), parseert deze naar block-records (kopjes H1–H4, alinea's, lijsten, tabellen, scheidingslijnen) en extraheert apart de kopjesstructuur voor de sidebar. Inline-opmaak (vet, cursief, code-span) wordt gerenderd via de ingebouwde Markdown-engine. De taal wordt gelezen uit de app-instellingen, met het speciale geval Chinees (zh-Hans) en Braziliaans Portugees (pt-BR), die als volledige locale-tags worden behouden omdat deze varianten verschillen van zh respectievelijk pt.

W2List (kopjes-sidebar)

WAAR

Linkerkolom in het gebruikershandleiding-venster.

TECHNISCH

Lijst van alle H2- en H3-kopjes van het huidige Markdown-document. H2-items verschijnen zonder inspringing met medium lettergewicht, H3-items met 16 pt inspringing links en een verminderde voorgrondstijl. Alle andere niveaus — zowel H1 als H4 en dieper — verschijnen niet in de sidebar, omdat ze deze anders onoverzichtelijk zouden maken. Anker-ID's worden uit de kopjestekst gegenereerd door slugificatie (kleine letters + spaties naar streepjes + filtering op letters/cijfers/streepjes — hetzelfde algoritme dat GitHub gebruikt voor zijn Markdown-ankers, zodat ook externe URL's naar de documentatie mogelijk op hetzelfde anker zouden uitkomen). De lijst gebruikt de native macOS-stijl.

W3Button (kopje → anker-sprong)

WAAR

Per sidebar-regel een button.

TECHNISCH

Elk sidebar-item is een button die het huidige anker instelt, maar er visueel uitziet als een lijst-item. Een observer-variabele triggert vervolgens de scroll-sprong naar het bijbehorende anker met een vloeiende animatie over 0,3 s. Na de sprong wordt de ankerwaarde teruggezet, zodat de volgende klik op hetzelfde anker opnieuw afvuurt (anders zou de observer niet opnieuw triggeren, omdat de waarde niet is veranderd).

W4ScrollView (detail-inhoud)

WAAR

Rechterkolom.

TECHNISCH

Scrollbaar, verticaal gestapeld inhoudsgebied met lazy rendering, omdat langere gidsen gemakkelijk meer dan 200 Markdown-blokken kunnen hebben — een niet-lazy variant zou ze allemaal tegelijk instantiëren. Elk blok krijgt een eigen ID, ofwel het kopje-anker (dat krijgt elk kopje, ongeacht het niveau) of een index-plaatshouder. De maximale breedte is 720 pt, padding 32 horizontaal / 24 verticaal, zodat lange regels een goed leesbare layout behouden. Tabellen worden cel voor cel gerenderd met horizontale stacks en scheidingslijnen; inline-code door de ingebouwde Markdown-engine. Echte codeblokken worden momenteel als paragraaf behandeld — een bekende beperking van het hulpvenster.

Toetsenbord Sneltoetsen (W5–W6)

Keyboard Shortcuts Fenster — fünf Gruppen Navigation/Views/Capture/Editor/Training mit Hotkey-Spalte links und Beschreibung rechts
Toetsenbord Sneltoetsen-venster — vijf groepen Navigation/Views/Capture/Editor/Training met hotkey-kolom links en beschrijving rechts

Statische referentielijst in vijf secties. Navigation: Mouse Drag (Orbit/Fly), Shift+Drag/Right-Drag (Pan), Scroll (Zoom), WASD (Fly-Through-beweging), 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 (Spring naar 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 (Selectie verwijderen), Cmd-Z (Laatste verwijdering ongedaan maken), [ / ] (Penseelgrootte kleiner/groter), Esc (Selectie opheffen). Training: Option+Space (Training pauzeren/hervatten), Cmd+E (Scene exporteren). Meer staat hier niet — Start, Cancel en de verlengingen bereik je via het Training-menu (hoofdstuk 1).

Wat het is: Een simpel statisch overzicht van alle sneltoetsen — Navigation, Views, Capture, Editor, Training. De inhoud is vast ingebouwd en wordt niet uit een bestand nageladen.

Wanneer je op zoek bent naar de snelste manier om iets in de Viewport te doen. WASD-Fly-Through, R voor Camera-Reset, B voor Background-Cycling — ze staan allemaal hier.

W5ScrollView (inhoudsgebied)

WAAR

Help → Keyboard Shortcuts (⌘/).

TECHNISCH

Een eenvoudig scrollgebied met een verticale lijst erin. Padding 20 rondom, geen sidebar-navigatie-tree (de lijst is kort genoeg). Inhoud is in vijf secties gegroepeerd (Navigation, Views, Capture, Editor, Training). Per toetscombinatie een regel met vertaalbare tekst in beide kolommen. Linkerkolom (toetscode) vastgezet op 180 pt breedte, zodat de beschrijvingen rechts verticaal uitgelijnd blijven. Geen interactie behalve scrollen — klikken op een regel activeert niets, de sneltoetsen zijn echte toetsenbord-modifiers in het menu en op de Viewport.

W6VStack (sneltoets-secties)

WAAR

Binnen de ScrollView.

TECHNISCH

Links uitgelijnde, gestapelde secties met 16 pt tussenruimte. Binnen de vijf secties telkens een heading + reeks regels. Headings gebruiken een secundaire subheadline-stijl — bewust geen Title-formaat, omdat de secties niet navigeerbaar hoeven te zijn. Inhoud is bewust vlak (geen Disclosure, geen Search, geen Filter), zodat de component op elke macOS-versie ongewijzigd werkt en het bestand leesbaar blijft.

Manage Storage (W7–W12)

Manage Storage venster — Header toont „1,356 items · 55.1 GB total”, tabel met Export-PLY-bestanden gesorteerd op datum, telkens icoon + bestandsnaam + grootte + datum
Manage Storage venster — Header toont „1,356 items · 55.1 GB total", tabel met Export-PLY-bestanden gesorteerd op datum, telkens icoon + bestandsnaam + grootte + datum

Tabelweergave van alle bestanden die door RadianceKit worden beheerd. Header telt 1.356 items, 55,1 GB totale grootte. Toolbar bovenaan: „Show in Finder" + „Refresh". Elke rij: Export-icoon, bestandsnaam (bijv. training_20260718T194416Z.ply), export-datum, grootte (varieert hier van 7,8 MB tot 2,24 GB), loep-icoon (Reveal) en prullenbak-icoon (Move to Trash). Er wordt eerst gesorteerd op categorie en binnen een categorie op datum, nieuwste bovenaan. In deze opname domineren PLY-exports, omdat in deze opslaglocatie vooral trainingsresultaten zijn bewaard.

Wat het is: Een overzicht van het schijfgebruik voor alles wat RadianceKit onder ~/Documents/RadianceKit/ opslaat — logs, exports, scenes, capture-bundles (van de iOS-companion), imports (staging-kopieën van de invoerafbeeldingen). Per item een grootte in bytes en twee knoppen: „in Finder tonen" en „naar de prullenbak verplaatsen". Is GEEN automatisch opschonen — de app verwijdert zelf niets; jij beslist per item. Dit venster is vertaald: in het Nederlands heet het „Speicher verwalten" (Nederlandse app-vertaling), de beide kop-knoppen heten „Toon in Finder" en „Vernieuwen", de rij-knoppen „Toon in Finder" en „Naar de prullenbak". De Engelse namen in de items hieronder zijn de benamingen uit de Engelse versie.

Wanneer de schijf vol raakt. Vooral de logs stapelen zich op (een JSONL per trainingspoging, plus de _qualityMetrics.json); de exports natuurlijk ook (PLY 100% ruwe data, één per export). Ook handig na een crash, wanneer de imports-staging-map nog oude kopieën van de invoerafbeeldingen bevat.

W7Knop „Show in Finder"

WAAR

Header rechtsboven in het Storage Browser-venster.

TECHNISCH

Opent de RadianceKit-datamap in Finder — precies de map waarvan de inhoud in dit venster wordt weergegeven. Zo zie je de mapstructuur (Logs, Exports, Scenes, Captures, Imports) direct en kun je de bestanden ook zelf met Finder verplaatsen of kopiëren. De actie opent een nieuw Finder-venster; de lijst in het venster verandert daardoor niet mee — daarvoor is „Refresh" (W8) bedoeld.

W8Knop „Refresh"

WAAR

Header, naast de Finder-knop.

TECHNISCH

Start een achtergrond-scan die draait op een door de gebruiker gestarte asynchrone taak, zodat het scannen van grote mapstructuren de UI niet blokkeert. Het eigenlijke doorlopen gaat elke bekende submap (Logs, Exports, Scenes, Captures, Imports) langs en genereert per direct onderliggend item een storage-item. Per item wordt de recursieve grootte bepaald — bij voorkeur het werkelijke schijfgebruik (inclusief APFS-hardlinks-sharing) met terugval op de logische bestandsgrootte.

W9List (Storage-items)

WAAR

Hoofdinhoud onder de header.

TECHNISCH

Lijst met per rij deze indeling: categorie- specifiek SF Symbol-icoon (document voor Logs, upload-pijl voor Exports, kubus voor Scenes, iPhone voor Capture-bundels, tray voor Imports), naam + ondertitel (Kind-label + geformatteerde wijzigingsdatum), byte-teller rechts (rechts uitgelijnd, monospaced), Reveal-knop (loep-symbool), Trash-knop (prullenbak). Sortering: primair op Kind (Scenes eerst, dan Exports, Logs, Captures, Imports, Other), secundair op wijzigingsdatum aflopend (nieuwste bovenaan). Als de scan nog loopt, toont deze plek in plaats daarvan een „Scanning…"-voortgangsindicator. Als er niets gevonden is, verschijnt een lege-status-weergave met tray-icoon.

W10Rij-knop „Reveal in Finder"

WAAR

Per rij, loep-symbool rechts.

TECHNISCH

Opent Finder en selecteert het specifieke item (bestand of map). Verschil met W7: W7 opent de hoofdmap; W10 markeert precies dit ene item. Praktische workflow: identificeer een groot item, klik op de loep, kopieer het bijvoorbeeld daarna naar een extern volume.

W11Rij-knop „Move to Trash"

WAAR

Per rij, prullenbak-symbool rechts naast de loep.

TECHNISCH

Activeert het bevestigingsdialoogvenster (W12). Pas na bevestiging wordt de macOS-standaardactie „naar de prullenbak verplaatsen" uitgevoerd (dus omkeerbaar, geen directe verwijdering). Na succesvol verplaatsen naar de prullenbak wordt het item uit de lijst verwijderd en de totale byte-teller bijgewerkt. Bij fouten verschijnt een modaal foutdialoogvenster.

W12ConfirmationDialog (verwijderbevestiging)

WAAR

Wordt geactiveerd door W11, weergegeven als macOS-sheet.

TECHNISCH

Standaard bevestigingsdialoogvenster met dynamische titel „Delete <name>?" en een berichtregel die expliciet vermeldt dat het item in de prullenbak terechtkomt en van daaruit hersteld kan worden (totdat de prullenbak geleegd wordt). Twee knoppen: „Move to Trash" als destructieve actie (rood weergegeven) en „Cancel" met automatische Esc-koppeling. Het dialoogvenster is non-modaal in die zin dat het alleen dit venster blokkeert, niet de hele app — dat is macOS-standaard voor omkeerbare verwijderingen.

Hoofdvenster: verliesverloop en Gaussian-telling (I39–I41, kruisverwijzing)

Drie van de Inspector-weergaven in het hoofdvenster verdienen een eigen uitleg, omdat ze tijdens een lopende training voortdurend te zien zijn en er belangrijke vuistregels bestaan voor wanneer het verloop er gezond uitziet. De weergaven bevinden zich in de Inspector in de sectie Voortgang, in de uitklapbare groep Verliesverloop (zie hoofdstuk 2 — Inspector), en helpen de voortgang van de training te beoordelen.

Wanneer is de loss-curve gezond? Een gezonde loss-curve toont drie fasen: (1) Warmup — de eerste 200–500 iteraties daalt de loss steil van hoog (typisch 0.15–0.25 voor gecombineerde L1+SSIM, afhankelijk van de scène) naar ongeveer de helft. Als de loss in deze fase NIET daalt, is meestal de invoer fout (afbeeldingen beschadigd, SfM-poses slecht, aantal initiële Gaussians te klein). (2) Densification — tussen ~500 en densifyUntilIteration (klassiek 15K, MCMC tot 20K of 25K) daalt de loss verder, vaak met kleine sprongen omlaag wanneer densify-operaties nieuwe Gaussians invoegen en de optimizer ze benut. De Gaussian-telling stijgt in deze fase. (3) Refinement — daarna loopt de loss in een steeds vlakker wordende staart. Typische eindwaarden ter oriëntatie: een goed verlichte objectscène (bijvoorbeeld Tanks-&-Temples Truck met P4 Quality) komt uit op L1 ≈ 0.023, ruime buitenscènes zoals die van Mip-NeRF 360 blijven van nature daarboven (0.04–0.07).

Wat betekent een plateau? Een plateau (loss-curve verloopt horizontaal over meerdere duizenden iteraties) heeft twee interpretaties: (a) het model is geconvergeerd, verder trainen levert niets meer op — dat is het goede geval. (b) het model zit vast (lokaal minimum, slechte gradiëntinformatie, een cap op de buffer-limiet) — het slechte geval. Beide zien er in de grafiek identiek uit. Onderscheid: kijk naar de Gaussian-telling. Als die ook vlak is EN dicht bij de MCMC-cap zit (bijv. 150K van 150K bij preset P8 Quality (MCMC)), zit je aan de limiet — ofwel de cap verhogen ofwel het plateau accepteren. Als de Gaussian-telling nog groeit, maar de loss niet daalt, zit je vast.

Wanneer afbreken versus doortrainen? Vuistregel: 10K iteraties lang geen verbetering van de min-loss → afbreken, verdere iteraties zijn verspild. Daarvoor: via het Training-menu → Continue Training → „+5,000 iterations" kun je nog een verlenging toevoegen, mocht je een marginale verbetering zien (daarvoor bestaat geen sneltoets). Let op: bij MCMC is het plateau vaak echt — de cap is de natuurlijke grens.

Een plateau in de Gaussian-telling is GEEN „klaar"-signaal. Het betekent alleen dat MCMC de cap heeft bereikt of dat Classic Densification is uitgeput. De echte „klaar"-vraag wordt pas beantwoord door PSNR/SSIM/LPIPS op een onafhankelijke testset. De onafhankelijke testset laat ook zien of je camera-set een eerlijke verdeling in trainings- en testperspectieven toelaat.

PSNR/holdout is de waarheid, loss slechts een proxy. De loss is een relatieve metriek: hij daalt terwijl je model zich aanpast aan de trainingsviews. Een lage loss betekent echter niet automatisch een goed model — als het model de trainingsafbeeldingen uit zijn hoofd heeft geleerd (overfitting), zou de loss klein zijn, maar de PSNR op ongeziene views (holdout) slecht. Kijk daarom voor de uiteindelijke kwaliteitsbeoordeling altijd naar holdout-metrieken, niet alleen naar de eind-loss.

Vuistregel-vak

- User Guide en Keyboard Shortcuts zijn statische hulp — bij vragen over losse begrippen snel, voor diepgang dit voorliggende manual gebruiken. - Manage Storage openen zodra de schijf onder 10% vrije ruimte komt. Logs en Imports-staging zijn de gebruikelijke boosdoeners. - Loss-plateau en Gaussian-count-plateau moeten los van elkaar geïnterpreteerd worden. Cap-limiet is geen „klaar"-signaal. Echte kwaliteit meet je alleen aan Holdout-PSNR. - 10K iteraties zonder verbetering van de min-loss → training stoppen.