Kapitel 4 — Aux-vinduer
Ud over hovedvinduet (3D-viewport plus inspector) administrerer RadianceKit tre yderligere vinduer, som alle åbnes via Hjælp-menuen. Menuen har fem punkter, fra top til bund: User Guide (⌘?), Keyboard Shortcuts (⌘/), Open Training Logs… (⇧⌘L), Open Exports Folder…, Manage Storage…. De to „Open …"-punkter åbner ikke et app-vindue, men Finder; derfor bliver de ikke yderligere behandlet her.
De tre enkle vinduer (User Guide, Keyboard Shortcuts, Manage Storage) og de to mappe-menupunkter (Open Training Logs / Open Exports Folder) får et kort afsnit pr. betjeningselement.
I slutningen af kapitlet er der et krydshenvisningsafsnit til inspectoren i hovedvinduet: hvad du med fordel kan aflæse i live-loss-diagrammet og Gaussian-count-visningen under en igangværende træning.
Brugervejledning (W1–W4)

Hvad det er: Et indbygget hjælpevindue, der viser den guide_<sprog>.md, som følger med appen. Sproget udledes fra indstillingerne (fanen General → Language) eller, hvis der står „System", fra macOS' sprogpræferencer. Layoutet er klassisk: til venstre en sidebjælke med alle overskrifter, til højre selve teksten.
Når du hurtigt skal genopfriske et enkelt punkt — altså som stikordserstatning. Den udførlige reference er denne manual; det indbyggede hjælpevindue er kortversionen til hurtigt opslag. Det opdateres ved hver app-udgivelse, men holdes indholdsmæssigt mere overfladisk.
W1NavigationSplitView (sidebjælke + detalje)
HVOR
Help → User Guide (⌘?).
TEKNISK
To-kolonne-layout med en smal sidebjælke (mindst 180 pt bred) til indholdstræet og et rullende detaljeområde til selve Markdown-indholdet. Vinduet har en minimumsstørrelse på 700 × 500 pt. Ved første åbning indlæser vinduet den relevante guide_<lang>.md fra app-bundlet (fallback guide_en.md), parser den til blok-records (overskrifter H1–H4, afsnit, lister, tabeller, skillelinjer) og udtrækker separat overskriftsstrukturen til sidebjælken. Inline-formatering (fed, kursiv, kode-span) rendres via den indbyggede Markdown-motor. Sproget læses fra app-indstillingerne, med specialtilfældene kinesisk (zh-Hans) og brasiliansk portugisisk (pt-BR), som bevares som fulde locale-tags, fordi disse varianter adskiller sig fra hhv. zh og pt.
W2List (overskrifts-sidebjælke)
HVOR
Venstre kolonne i brugervejledningsvinduet.
TEKNISK
Liste over alle H2- og H3-overskrifter i det aktuelle Markdown-dokument. H2-elementer vises uden indrykning med medium skrifttykkelse, H3-elementer med 16 pt indrykning til venstre og reduceret forgrundsstil. Alle andre niveauer — H1 såvel som H4 og dybere — vises ikke i sidebjælken, da de ellers ville gøre den uoverskuelig. Anker-ID'er genereres fra overskriftsteksten via slugificering (lowercase + mellemrum til bindestreger + filtrering til bogstaver/tal/bindestreger — samme algoritme, som GitHub bruger til sine Markdown-ankre, så eksterne URL'er til dokumentationen potentielt også ville lande på det samme anker). Listen bruger den native macOS-stil.
W3Button (overskrift → anker-hop)
HVOR
Én knap pr. sidebjælke-linje.
TEKNISK
Hvert sidebjælke-element er en knap, der sætter det aktuelle anker, men visuelt ligner et listeelement. En observer-variabel udløser derefter scroll-hoppet til det tilsvarende anker med en blød animation over 0,3 s. Efter hoppet nulstilles ankerværdien, så det næste klik på samme anker udløses igen (ellers ville observeren ikke udløse igen, fordi værdien ikke har ændret sig).
W4ScrollView (detalje-indhold)
HVOR
Højre kolonne.
TEKNISK
Rullende, vertikalt stablende indholdsområde med lazy rendering, fordi længere guides let kan have over 200 Markdown-blokke — en ikke-lazy variant ville instantiere alle samtidig. Hver blok får sit eget ID, enten overskrifts-ankeret (det får hver overskrift, uanset niveau) eller en indeks-pladsholder. Maksimal bredde er 720 pt, padding 32 horisontalt / 24 vertikalt, så lange linjer bevarer et letlæseligt layout. Tabeller rendres celle for celle med horisontale stacks og skillelinjer; inline-kode via den indbyggede Markdown-motor. Rigtige kodeblokke behandles i øjeblikket som afsnit — en kendt begrænsning i hjælpevinduet.
Tastaturgenveje (W5–W6)

Statisk referenceliste i fem sektioner. Navigation: Mouse Drag (Orbit/Fly), Shift+Drag/Right-Drag (Pan), Scroll (Zoom), WASD (Fly-Through-bevægelse), Q/E (Up/Down), F (Toggle Orbit/Fly), Double-click (Re-center), Cmd+Scroll (FoV-justering). Views: R (Reset Camera), T (Auto-Rotation), P (Camera Playback), B (Background-Cycle), 0–9 (Spring til 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 (Slet markering), Cmd-Z (Fortryd seneste sletning), [ / ] (Pensel mindre/større), Esc (Ophæv markering). Training: Option+Space (Sæt træning på pause/genoptag), Cmd+E (Eksportér scene). Mere står der ikke her — Start, Cancel og forlængelserne finder du i menuen Training (kapitel 1).
Hvad det er: Et enkelt statisk overblik over alle tastaturgenveje — Navigation, Views, Capture, Editor, Training. Indholdet er fast indbygget og hentes ikke fra en fil.
Når du leder efter den hurtigste vej til at gøre noget i viewporten. WASD-Fly-Through, R til Camera-Reset, B til Background-Cycling — alle står her.
W5ScrollView (indholdsområde)
HVOR
Help → Keyboard Shortcuts (⌘/).
TEKNISK
Et simpelt scroll-område med en vertikal liste indeni. Padding på 20 rundtomkring, intet sidebar-navigationstræ (listen er kort nok). Indholdet er grupperet i fem sektioner (Navigation, Views, Capture, Editor, Training). Pr. tastekombination en linje med oversætbar tekst i begge kolonner. Venstre kolonne (tastekode) er fastlåst til 180 pt bredde, så beskrivelserne til højre forbliver vertikalt justeret. Ingen interaktion udover scrolling — klik på en linje udløser intet, tastaturgenvejene er rigtige tastatur-modifikatorer i menuen og på viewporten.
W6VStack (genvejssektioner)
HVOR
Inde i ScrollView.
TEKNISK
Venstrejusterede stablede sektioner med 16 pt mellemrum. Inden for de fem sektioner hver en overskrift + række-sekvens. Overskrifterne bruger en sekundær subheadline-stil — bevidst ikke title-format, fordi sektionerne ikke behøver at være navigerbare. Indholdet er bevidst fladt (ingen disclosure, ingen search, ingen filter), så komponenten kører uændret på enhver macOS-version, og filen forbliver læsbar.
Manage Storage (W7–W12)

Tabelvisning af alle filer, som RadianceKit administrerer. Header tæller 1.356 elementer, 55,1 GB samlet størrelse. Værktøjslinje øverst: „Show in Finder" + „Refresh". Hver række: eksport-ikon, filnavn (f.eks. training_20260718T194416Z.ply), eksportdato, størrelse (varierer her fra 7,8 MB til 2,24 GB), forstørrelsesglas-ikon (Reveal) og papirkurv-ikon (Move to Trash). Sorteringen sker først efter kategori og inden for en kategori efter dato, nyeste øverst. På denne optagelse dominerer PLY-eksporter, fordi der i denne mappe primært er blevet gemt træningsresultater.
Hvad det er: En disk-forbrugs-oversigt over alt, hvad RadianceKit gemmer under ~/Documents/RadianceKit/ — logs, eksporter, scener, capture-bundles (fra iOS-følgeappen), imports (staging-kopier af inputbillederne). Pr. post en størrelse i bytes og to knapper: „vis i Finder" og „flyt til papirkurven". Er IKKE automatisk oprydning — appen sletter ikke selv noget; du beslutter pr. post. Dette vindue er oversat: på dansk hedder det „Administrer lagerplads", de to knapper i headeren hedder „Vis i Finder" og „Opdater", rækkeknapperne „Vis i Finder" og „Flyt til papirkurven". De engelske navne i posterne nedenfor er betegnelserne fra den engelske udgave.
Når disken bliver fuld. Især logfilerne samler sig (en JSONL pr. træningsforsøg, plus _qualityMetrics.json); eksporterne naturligvis også (PLY er 100% rå data, en pr. eksport). Også nyttigt efter et nedbrud, hvor imports-staging-mappen stadig ligger med gamle kopier af inputbillederne.
W7Knappen „Show in Finder"
HVOR
Header øverst til højre i storage-browser-vinduet.
TEKNISK
Åbner RadianceKit-datamappen i Finder — netop den mappe, hvis indhold dette vindue viser. Dermed ser du mappestrukturen (logs, eksporter, scener, captures, imports) direkte og kan også selv flytte eller kopiere filerne med Finder. Handlingen åbner et nyt Finder-vindue; listen i vinduet ændrer sig ikke af den grund — det er derfor „Refresh" findes (W8).
W8Knappen „Refresh"
HVOR
Header, ved siden af Finder-knappen.
TEKNISK
Udløser en baggrundsscanning, der kører på en brugerinitieret asynkron opgave, så scanning af store mappetræer ikke blokerer UI'et. Selve gennemgangen går alle kendte undermapper (logs, eksporter, scener, captures, imports) igennem og opretter en storage-post pr. direkte underelement. For hver post beregnes den rekursive størrelse — fortrinsvis det faktiske diskforbrug (inklusive APFS-hardlinks-deling) med fallback til den logiske filstørrelse.
W9List (storage-poster)
HVOR
Hovedindhold under headeren.
TEKNISK
Liste med dette layout pr. række: kategori- specifikt SF Symbol-ikon (dokument for logs, upload-pil for eksporter, terning for scener, iPhone for capture-bundles, bakke for imports), navn + undertekst (kind-label + formateret ændringsdato), byte-tæller til højre (højrestillet, monospaced), reveal-knap (forstørrelsesglas-ikon), papirkurv-knap. Sortering: primært efter kind (scener først, derefter eksporter, logs, captures, imports, andet), sekundært efter ændringsdato faldende (nyeste øverst). Hvis scanningen stadig kører, viser stedet i stedet en „Scanning…"-fremdriftsindikator. Hvis intet blev fundet, vises en tom-tilstand med bakke-ikon.
W10Række-knappen „Reveal in Finder"
HVOR
Pr. række, forstørrelsesglas-ikon til højre.
TEKNISK
Åbner Finder og markerer det specifikke element (fil eller mappe). Forskel til W7: W7 åbner rodmappen; W10 markerer netop denne ene post. Praktisk workflow: identificer en stor post, klik på forstørrelsesglasset, kopiér den derefter for eksempel til et eksternt drev.
W11Række-knappen „Move to Trash"
HVOR
Pr. række, papirkurv-ikon til højre for forstørrelsesglasset.
TEKNISK
Udløser bekræftelsesdialogen (W12). Først efter bekræftelse køres macOS' standardhandling „flyt til papirkurven" (altså reversibel, ikke direkte sletning). Efter en vellykket flytning til papirkurven fjernes posten fra listen, og den samlede byte-tæller opdateres. Ved fejl vises en modal fejldialog.
W12ConfirmationDialog (sletningsbekræftelse)
HVOR
Udløses af W11, vises som et macOS-sheet.
TEKNISK
Standard-bekræftelsesdialog med dynamisk titel „Delete <name>?" og en meddelelseslinje, der eksplicit gør opmærksom på, at posten havner i papirkurven og kan gendannes derfra (indtil papirkurven tømmes). To knapper: „Move to Trash" som destruktiv handling (vist i rødt) og „Cancel" med automatisk Esc-binding. Dialogen er non-modal i den forstand, at den kun blokerer dette vindue, ikke hele appen — det er macOS-standard for reversible sletninger.
Hovedvindue: Loss-forløb og Gaussian-antal (I39–I41, krydsreference)
Tre af Inspector-visningerne i hovedvinduet fortjener en selvstændig forklaring, fordi de er konstant synlige under et igangværende træningsforløb, og fordi der findes vigtige tommelfingerregler for, hvornår forløbet ser sundt ud. Visningerne sidder i Inspector i afsnittet Fremskridt, i den udvidelige gruppe Loss-forløb (se kapitel 2 — Inspector), og hjælper med at vurdere træningens fremskridt.
Hvornår er loss-kurven sund? En sund loss-kurve viser tre faser: (1) Warmup — i de første 200–500 iterationer falder loss stejlt fra højt (typisk 0,15–0,25 for L1+SSIM-kombineret afhængigt af scenen) til omtrent det halve. Falder loss IKKE i denne fase, er det som regel input, der er forkert (ødelagte billeder, dårlige SfM-poser, for lille antal indledende Gaussians). (2) Densification — mellem ~500 og densifyUntilIteration (klassisk 15K, MCMC op til 20K eller 25K) falder loss videre, ofte med små spring nedad, når densify-operationer indsætter nye Gaussians, og optimeringen udnytter dem. Gaussian-antallet stiger i denne fase. (3) Refinement — derefter går loss ind i en gradvist fladere hale. Typiske slutværdier til orientering: en velbelyst objekt-scene (f.eks. Tanks-&-Temples Truck med P4 Quality) lander på L1 ≈ 0,023, mens vidtstrakte udendørsscener som dem fra Mip-NeRF 360 naturligt ligger højere (0,04–0,07).
Hvad betyder et plateau? Et plateau (loss-kurven forløber vandret over flere tusind iterationer) har to fortolkninger: (a) modellen er konvergeret, yderligere træning giver ikke mere — det er det gode tilfælde. (b) modellen sidder fast (lokalt minimum, dårlig gradient-information, et loft ved buffer-grænsen) — det dårlige tilfælde. Begge ser identiske ud i diagrammet. Sådan skelner du: kig på Gaussian-antallet. Hvis det også er fladt OG tæt på MCMC-loftet (f.eks. 150K af 150K ved presettet P8 Quality (MCMC)), er du ved grænsen — enten hæv loftet, eller accepter plateauet. Hvis Gaussian-antallet stadig vokser, men loss ikke falder, sidder modellen fast.
Hvornår skal du afbryde vs. fortsætte træningen? Tommelfingerregel: 10K iterationer uden forbedring af min-loss → afbryd, yderligere iterationer er spildte. Inden da: via Training-menuen → Continue Training → „+5.000 iterations" kan du tilføje en forlængelse, hvis du ser marginal forbedring (der findes ingen genvejstast til dette). Bemærk: ved MCMC er plateauet ofte reelt — loftet er den naturlige grænse.
Gaussian-antal-plateau er IKKE et „færdig"-signal. Det betyder kun, at MCMC har nået loftet, eller at klassisk densification er udtømt. Det egentlige „færdig"-spørgsmål besvares først af PSNR/SSIM/LPIPS på et uafhængigt testsæt. Det uafhængige testsæt viser samtidig, om dit kamerasæt muliggør en fair opdeling i trænings- og testvinkler.
PSNR/Holdout er sandheden, loss er kun en proxy. Loss er en relativ metrik: den falder, mens din model tilpasser sig trænings-views. Et lavt loss betyder dog ikke automatisk en god model — hvis modellen har lært træningsbillederne udenad (overfitting), ville loss være lille, men PSNR på usete views (holdout) ville være dårlig. Derfor: for den endelige kvalitetsvurdering skal du altid kigge på holdout-metrikker, ikke kun på slut-loss.
Tommelfingerregel-boks
- User Guide og Keyboard Shortcuts er statisk hjælp — hurtig ved stikordsspørgsmål, brug denne manual til dybde. - Åbn Manage Storage, så snart disken kommer under 10% ledig plads. Logs og Imports-staging er de sædvanlige syndere. - Loss-plateau og Gaussian-count-plateau skal fortolkes hver for sig. Cap-grænsen er ikke et „færdig"-signal. Reel kvalitet måles kun med Holdout-PSNR. - 10K iterationer uden forbedring af min-loss → stop træningen.