Kapittel 4 — Aux-vinduer
Ved siden av hovedvinduet (3D-viewport pluss Inspector) forvalter RadianceKit tre andre vinduer, som alle åpnes via Help-menyen. Menyen har fem oppføringer, ovenfra og ned: User Guide (⌘?), Keyboard Shortcuts (⌘/), Open Training Logs… (⇧⌘L), Open Exports Folder… og Manage Storage…. De to «Open …»-oppføringene åpner ikke et app-vindu, men Finder; derfor er de ikke omtalt videre her.
De tre enkle vinduene (User Guide, Keyboard Shortcuts, Manage Storage) og de to mappe-menypunktene (Open Training Logs / Open Exports Folder) får en kort oppføring per kontrollelement.
Til slutt i kapittelet er det et kryssreferanse-avsnitt til Inspector i hovedvinduet: hva du med fordel kan lese ut av live-loss-diagrammet og Gaussian-count-visningen mens en trening pågår.
Brukerveiledning (W1–W4)

Hva det er: Et innebygd hjelpevindu som rendrer guide_<sprache>.md-filen som følger med appen. Språket avledes fra Settings (Tab General → Language) eller, hvis det står «System» der, fra macOS-språkpreferansene. Layouten er klassisk: sidefelt med alle overskrifter til venstre, brødtekst til høyre.
Når du trenger en rask påminnelse om et enkelt punkt — altså som stikkordserstatning. Den fyldige referansen er dette manualet; det innebygde hjelpevinduet er kortversjonen for raskt oppslag. Det oppdateres ved hvert app-release, men holdes bevisst mer overfladisk innholdsmessig.
W1NavigationSplitView (sidefelt + detalj)
HVOR
Help → User Guide (⌘?).
TEKNISK
Tospalte-layout med et smalt sidefelt (minst 180 pt bredt) for innholdstreet og et rullbart detaljområde for selve Markdown-innholdet. Vinduet har en minstestørrelse på 700 × 500 pt. Ved første åpning laster vinduet den passende guide_<lang>.md fra app-bundlen (fallback guide_en.md), parser den til blokk-poster (overskrifter H1–H4, avsnitt, lister, tabeller, skillelinjer) og trekker separat ut overskriftsstrukturen for sidefeltet. Inline-formatering (fet, kursiv, kode-span) rendres via den innebygde Markdown-motoren. Språket leses fra app-innstillingene, med spesialtilfellene kinesisk (zh-Hans) og brasiliansk portugisisk (pt-BR), som beholdes som fulle locale-tags fordi disse variantene skiller seg fra zh og pt.
W2List (overskrift-sidefelt)
HVOR
Venstre kolonne i brukerveiledning-vinduet.
TEKNISK
Liste over alle H2- og H3-overskrifter i det gjeldende Markdown-dokumentet. H2-oppføringer vises uten innrykk med middels skriftvekt, H3-oppføringer med 16 pt innrykk til venstre og redusert forgrunnsstil. Alle andre nivåer — H1 så vel som H4 og dypere — vises ikke i sidefeltet, fordi de ellers ville gjort det uoversiktlig. Anker-IDer genereres fra overskriftsteksten via slugifisering (lowercase + mellomrom til bindestreker + filtrering på bokstaver/tall/bindestreker — samme algoritme som GitHub bruker for sine Markdown-ankere, slik at også eksterne URL-er til dokumentasjonen potensielt kan lande på samme anker). Listen bruker den native macOS-stilen.
W3Button (overskrift → anker-hopp)
HVOR
Én knapp per sidefelt-rad.
TEKNISK
Hver sidefelt-oppføring er en knapp som setter det gjeldende ankeret, men visuelt ser den ut som en listeoppføring. En observer-variabel utløser deretter rulle-hoppet til det tilsvarende ankeret med en myk animasjon over 0,3 s. Etter hoppet nullstilles anker-verdien, slik at neste klikk på samme anker utløser på nytt (ellers ville observeren ikke utløst igjen, fordi verdien ikke har endret seg).
W4ScrollView (detalj-innhold)
HVOR
Høyre kolonne.
TEKNISK
Rullbart, vertikalt stablet innholdsområde med lazy-rendering, fordi lengre guider lett kan ha over 200 Markdown-blokker — en ikke-lazy variant ville instansiert alle samtidig. Hver blokk får en egen ID, enten overskrift-ankeret (som hver overskrift får, uavhengig av nivå) eller en indeks-plassholder. Maksbredde er 720 pt, padding 32 horisontalt / 24 vertikalt, slik at lange linjer beholder et godt lesbart layout. Tabeller rendres celle for celle med horisontale stacks og skillelinjer; inline- kode gjennom den innebygde Markdown-motoren. Ekte kodeblokker behandles for øyeblikket som avsnitt — en kjent begrensning ved hjelpevinduet.
Tastatursnarveier (W5–W6)

Statisk referanseliste i fem seksjoner. Navigation: Mouse Drag (Orbit/Fly), Shift+Drag/Right-Drag (Pan), Scroll (Zoom), WASD (Fly-Through-bevegelse), 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 (Hopp 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 (slett utvalg), Cmd-Z (angre siste sletting), [ / ] (mindre/større penselstørrelse), Esc (opphev utvalg). Training: Option+Space (pause/gjenoppta trening), Cmd+E (eksporter scene). Mer enn dette står ikke her — Start, Cancel og forlengelsene finner du via Training-menyen (kapittel 1).
Hva det er: En enkel statisk oversikt over alle tastatursnarveier — Navigation, Views, Capture, Editor, Training. Innholdet er fast innebygd og lastes ikke inn fra en fil.
Når du leter etter den raskeste måten å gjøre noe i viewporten på. WASD-Fly-Through, R for Camera-Reset, B for Background-Cycling — alle står her.
W5ScrollView (innholdsområde)
HVOR
Help → Keyboard Shortcuts (⌘/).
TEKNISK
Et enkelt scroll-område med en vertikal liste inni. Padding 20 rundt hele, ingen sidebar-navigasjonstre (listen er kort nok). Innholdet er gruppert i fem seksjoner (Navigation, Views, Capture, Editor, Training). Per tastekombinasjon en rad med oversettbar tekst i begge kolonnene. Venstre kolonne (tastekode) er fikset til 180 pt bredde, slik at beskrivelsene til høyre forblir vertikalt alignet. Ingen interaksjon utover scrolling — å klikke på en rad utløser ingenting, tastatursnarveiene er ekte tastaturmodifikatorer i menyen og på viewporten.
W6VStack (snarveis-seksjoner)
HVOR
Inne i ScrollView.
TEKNISK
Venstrejusterte stablede seksjoner med 16 pt avstand. Innenfor de fem seksjonene henholdsvis heading + rad-sekvens. Headings bruker en sekundær subheadline-stil — bevisst ikke Title-format, fordi seksjonene ikke trenger å være navigerbare. Innholdet er bevisst flatt (ingen disclosure, ingen søk, ingen filter), slik at komponenten kjører uendret på enhver macOS-versjon og filen forblir lesbar.
Manage Storage (W7–W12)

Tabellvisning av alle filer RadianceKit forvalter. Header viser 1.356 elementer, 55,1 GB totalstørrelse. Verktøylinje øverst: «Show in Finder» + «Refresh». Hver rad: eksport-ikon, filnavn (f.eks. training_20260718T194416Z.ply), eksportdato, størrelse (varierer her fra 7,8 MB til 2,24 GB), lupe-ikon (Reveal) og papirkurv-ikon (Move to Trash). Sorteringen skjer først etter kategori og innenfor en kategori etter dato, nyeste øverst. I dette opptaket dominerer PLY-eksporter, fordi det i dette lageret hovedsakelig ble sikret treningsresultater.
Hva det er: En disk-bruksoversikt for alt RadianceKit lagrer under ~/Documents/RadianceKit/ — logger, eksporter, scener, capture-bunter (fra iOS-følgesvennen), imports (staging-kopier av inndatabildene). Per oppføring en størrelse i bytes og to knapper: «vis i Finder» og «flytt til papirkurven». Dette er IKKE automatisk opprydding — appen sletter selv ingenting; du bestemmer per oppføring. Dette vinduet er oversatt: på tysk heter det «Speicher verwalten», de to header-knappene heter «Im Finder anzeigen» og «Aktualisieren», rad-knappene «Im Finder anzeigen» og «In den Papierkorb legen». De engelske navnene i oppføringene under er betegnelsene fra den engelske utgaven.
Når disken blir full. Spesielt loggene samler seg opp (én JSONL per treningsforsøk, pluss _qualityMetrics.json); eksportene naturligvis også (PLY er 100% rå data, én per eksport). Også nyttig etter en krasj, når imports-staging-mappen fortsatt har gamle kopier av inndatabildene liggende.
W7Knappen «Show in Finder»
HVOR
Header øverst til høyre i storage-browser-vinduet.
TEKNISK
Åpner RadianceKit-datamappen i Finder — akkurat den mappen hvis innhold dette vinduet lister opp. Slik ser du mappestrukturen (Logs, Exports, Scenes, Captures, Imports) direkte og kan også flytte eller kopiere filene selv med Finder. Handlingen åpner et nytt Finder-vindu; listen i vinduet endrer seg ikke automatisk med — det er «Refresh» (W8) til for.
W8Knappen «Refresh»
HVOR
Header, ved siden av Finder-knappen.
TEKNISK
Utløser et bakgrunnsskann som kjører på en brukerinitiert asynkron oppgave, slik at skanning av store mappetrær ikke blokkerer brukergrensesnittet. Selve gjennomgangen går gjennom hver kjente undermappe (Logs, Exports, Scenes, Captures, Imports) og lager en storage-oppføring per direkte barn. Per oppføring beregnes den rekursive størrelsen — fortrinnsvis det faktiske diskforbruket (inkludert APFS-hardlink-deling) med fallback til den logiske filstørrelsen.
W9List (storage-oppføringer)
HVOR
Hovedinnhold under headeren.
TEKNISK
Liste med dette oppsettet per rad: kategori- spesifikt SF-symbol-ikon (dokument for Logs, opplastingspil for Exports, terning for Scenes, iPhone for Capture-bunter, brett for Imports), navn + undertittel (kind-etikett + formatert modifikasjonsdato), byte-teller til høyre (høyrejustert, monospaced), reveal-knapp (lupe-symbol), trash-knapp (papirkurv). Sortering: primært etter kind (Scenes først, deretter Exports, Logs, Captures, Imports, Other), sekundært etter modifikasjonsdato synkende (nyeste øverst). Hvis skanningen fortsatt kjører, viser stedet i stedet en «Scanning…»-fremdriftsindikator. Hvis ingenting ble funnet, en empty-state-visning med brett-ikon.
W10Rad-knappen «Reveal in Finder»
HVOR
Per rad, lupe-symbol til høyre.
TEKNISK
Åpner Finder og velger den spesifikke oppføringen (fil eller mappe). Forskjell fra W7: W7 åpner rot-mappen; W10 markerer nøyaktig denne ene oppføringen. Praktisk arbeidsflyt: identifiser en stor oppføring, klikk på lupen, kopier den deretter for eksempel til et eksternt volum.
W11Rad-knappen «Move to Trash»
HVOR
Per rad, papirkurv-symbol til høyre for lupen.
TEKNISK
Utløser bekreftelsesdialogboksen (W12). Først etter bekreftelse kjører macOS' standardoperasjon «flytt til papirkurven» (altså reversibelt, ingen direkte sletting). Etter vellykket flytting til papirkurven fjernes oppføringen fra listen og den totale byte-telleren oppdateres. Ved feil vises en modal feildialog.
W12ConfirmationDialog (slette-bekreftelse)
HVOR
Utløses av W11, vises som et macOS-sheet.
TEKNISK
Standard bekreftelsesdialog med dynamisk tittel «Delete <name>?» og en meldingslinje som eksplisitt påpeker at oppføringen havner i papirkurven og kan gjenopprettes derfra (helt til 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 blokkerer dette vinduet, ikke hele appen — det er macOS-standard for reversible slettinger.
Hovedvindu: Tapshistorikk og Gaussian-antall (I39–I41, kryssreferanse)
Tre av Inspector-visningene i hovedvinduet fortjener en egen forklaring, fordi de er konstant synlige under en pågående trening og det finnes viktige tommelfingerregler for når forløpet ser sunt ut. Visningene ligger i Inspector under seksjonen Fremdrift, i den utfoldbare gruppen Tapshistorikk (se kapittel 2 — Inspector), og hjelper deg med å tolke treningsfremdriften.
Når er loss-kurven sunn? En sunn loss-kurve viser tre faser: (1) Oppvarming — de første 200–500 iterasjonene faller loss bratt fra høyt (typisk 0.15–0.25 for L1+SSIM kombinert, avhengig av scenen) til omtrent halvparten. Hvis loss IKKE faller i denne fasen, er det som regel input som er feil (ødelagte bilder, dårlige SfM-poser, for få initial-Gaussians). (2) Densification — mellom ~500 og densifyUntilIteration (klassisk 15K, MCMC opptil 20K eller 25K) faller loss videre, ofte med små hopp nedover når densify-operasjoner setter inn nye Gaussians og optimizeren utnytter dem. Gaussian-antallet stiger i denne fasen. (3) Finpuss — deretter går loss inn i en gradvis flatere hale. Typiske sluttverdier som orientering: en godt belyst objekt-scene (for eksempel Tanks-&-Temples Truck med P4 Quality) havner rundt L1 ≈ 0.023, mens vidstrakte utendørsscener som de fra Mip-NeRF 360 naturlig nok ligger høyere (0.04–0.07).
Hva betyr et platå? Et platå (loss-kurven går horisontalt over flere tusen iterasjoner) har to tolkninger: (a) modellen har konvergert, videre trening gir ikke mer — dette er det gode tilfellet. (b) modellen sitter fast (lokalt minimum, dårlig gradient-informasjon, et cap på buffer-grensen) — det dårlige tilfellet. Begge ser identiske ut i diagrammet. Skille: se på Gaussian-antallet. Hvis det også er flatt OG nær MCMC-caket (f.eks. 150K av 150K ved preset P8 Quality (MCMC)), er du på grensen — enten øk caket eller aksepter platået. Hvis Gaussian-antallet fremdeles vokser, men loss ikke faller, sitter modellen fast.
Når bør du avbryte vs. fortsette treningen? Tommelfingerregel: 10K iterasjoner uten forbedring av min-loss → avbryt, ytterligere iterasjoner er bortkastet. Før det: via Training-menyen → Continue Training → «+5,000 iterations» kan du henge på en forlengelse hvis du ser marginal forbedring (det finnes ingen tastatursnarvei for dette). Merk: ved MCMC er platået ofte reelt — caket er den naturlige grensen.
Platå i Gaussian-antallet er IKKE et «ferdig»-signal. Det betyr bare at MCMC har nådd caket, eller at Classic Densification er uttømt. Det egentlige «ferdig»-spørsmålet besvares først av PSNR/SSIM/LPIPS på et uavhengig testsett. Det uavhengige testsettet viser også om kamerasettet ditt tillater en rettferdig oppdeling i trenings- og testvinkler.
PSNR/Holdout er sannheten, loss er bare en proxy. Loss er en relativ metrikk: den faller etter hvert som modellen din tilpasser seg treningsvisningene. Men en lav loss betyr ikke automatisk en god modell — hvis modellen har pugget treningsbildene utenat (overfitting), ville loss vært lav, men PSNR på usette visninger (holdout) ville vært dårlig. Derfor: se alltid på holdout-metrikker for den endelige kvalitetsvurderingen, ikke bare på sluttverdien for loss.
Tommelfingerregel-boks
- User Guide og Keyboard Shortcuts er statisk hjelp — rask ved stikkordspørsmål, for dybde bruk denne foreliggende manualen. - Åpne Manage Storage så snart disken faller under 10 % ledig plass. Logger og Imports-staging er de vanlige synderne. - Loss-platå og Gaussian-count-platå må tolkes hver for seg. Cap-grense er ikke et «ferdig»-signal. Ekte kvalitet måles kun med Holdout-PSNR. - 10K iterasjoner uten forbedring av min-loss → stopp treningen.