Luku 4 — Aputikkunat
Pääikkunan (3D-Viewport ja Inspector) lisäksi RadianceKit hallinnoi kolmea muuta ikkunaa, jotka kaikki avataan Help-valikosta. Valikossa on viisi kohtaa, ylhäältä alas: User Guide (⌘?), Keyboard Shortcuts (⌘/), Open Training Logs… (⇧⌘L), Open Exports Folder… ja Manage Storage…. Molemmat „Open …"-kohdat eivät avaa sovelluksen ikkunaa vaan Finderin; siksi niitä ei käsitellä tässä tarkemmin.
Kolme yksinkertaista ikkunaa (User Guide, Keyboard Shortcuts, Manage Storage) ja kaksi kansiovalikon kohtaa (Open Training Logs / Open Exports Folder) saavat lyhyen kuvauksen per säädin.
Luvun lopussa on ristiviittausosio pääikkunan Inspectoriin: mitä voit järkevästi lukea Live-Loss-Chartista ja Gaussian-Count-näytöstä käynnissä olevan koulutuksen aikana.
Käyttöopas (W1–W4)

Mitä se on: Sisäänrakennettu ohjeikkuna, joka renderöi sovelluksen mukana toimitetun guide_<sprache>.md-tiedoston. Kieli johdetaan Settings-asetuksista (välilehti General → Language) tai, jos siellä on „System", macOS:n kieliasetuksista. Ulkoasu on klassinen: vasemmalla sivupalkki kaikilla otsikoilla, oikealla varsinainen leipäteksti.
Kun tarvitset nopean muistutuksen jostain yksittäisestä kohdasta — eli hakusanamaisena korvaajana. Tämä käsikirja on kattava viitteistö; sisäänrakennettu ohjeikkuna on sen lyhennetty versio nopeaa selailua varten. Se päivitetään jokaisen sovellusjulkaisun yhteydessä, mutta sisältö pidetään pinnallisempana.
W1NavigationSplitView (sivupalkki + yksityiskohdat)
MISSÄ
Help → User Guide (⌘?).
TEKNINEN
Kaksipalstainen asettelu, jossa on kapea sivupalkki (vähintään 180 pt leveä) sisältöpuuta varten ja vieritettävä yksityiskohta-alue varsinaista Markdown-sisältöä varten. Ikkunan vähimmäiskoko on 700 × 500 pt. Ensimmäisellä avauskerralla ikkuna lataa sopivan guide_<lang>.md-tiedoston sovelluspaketista (varajärjestelmä guide_en.md), jäsentää sen lohkotietueiksi (otsikot H1–H4, kappaleet, listat, taulukot, erotinviivat) ja poimii erikseen otsikkorakenteen sivupalkkia varten. Rivinsisäinen muotoilu (lihavointi, kursivointi, koodinpätkät) renderöidään sisäänrakennetun Markdown-moottorin avulla. Kieli luetaan sovelluksen asetuksista, erikoistapauksina kiina (zh-Hans) ja brasilianportugali (pt-BR), jotka säilytetään täysinä locale-tunnisteina, koska nämä varianttit eroavat kielistä zh ja pt.
W2List (otsikkosivupalkki)
MISSÄ
Vasen palsta käyttöopas-ikkunassa.
TEKNINEN
Luettelo kaikista nykyisen Markdown-dokumentin H2- ja H3-otsikoista. H2-kohteet näkyvät ilman sisennystä keskipainoisella fontilla, H3-kohteet 16 pt vasemmalla sisennyksellä ja himmennetyllä etualan tyylillä. Kaikki muut tasot — niin H1 kuin H4 ja syvemmät — eivät näy sivupalkissa, koska ne muuten tekisivät siitä sekavan. Ankkuri-ID:t luodaan otsikkotekstistä slugifioimalla (pienet kirjaimet + välilyönnit viivoiksi + suodatus kirjaimiin/numeroihin/viivoihin — sama algoritmi, jota GitHub käyttää Markdown-ankkureilleen, joten myös ulkoiset URL-osoitteet dokumentaatioon saattaisivat osua samaan ankkuriin). Luettelo käyttää natiivia macOS-tyyliä.
W3Button (otsikosta ankkuriin hyppy)
MISSÄ
Yksi painike per sivupalkin rivi.
TEKNINEN
Jokainen sivupalkin kohde on painike, joka asettaa nykyisen ankkurin, mutta näyttää visuaalisesti listakohteelta. Tarkkailijamuuttuja laukaisee tämän jälkeen vieritysanimoinnin vastaavaan ankkuriin pehmeällä 0,3 sekunnin animaatiolla. Hypyn jälkeen ankkuriarvo nollataan, jotta seuraava klikkaus samaan ankkuriin laukeaa uudelleen (muuten tarkkailija ei laukeaisi uudelleen, koska arvo ei ole muuttunut).
W4ScrollView (yksityiskohtainen sisältö)
MISSÄ
Oikea palsta.
TEKNINEN
Vieritettävä, pystysuunnassa pinottu sisältöalue laiskalla renderöinnillä, koska pidemmissä oppaissa voi helposti olla yli 200 Markdown-lohkoa — ilman laiskaa renderöintiä kaikki instansioitaisiin samanaikaisesti. Jokainen lohko saa oman ID:n, joko otsikkoankkurin (jonka saa jokainen otsikko tasosta riippumatta) tai indeksi-paikkamerkin. Enimmäisleveys on 720 pt, täyte 32 vaakasuunnassa / 24 pystysuunnassa, jotta pitkät rivit säilyttävät hyvin luettavan asettelun. Taulukot renderöidään solu kerrallaan vaakasuuntaisilla pinoilla ja erotinviivoilla; rivinsisäinen koodi sisäänrakennetun Markdown-moottorin avulla. Varsinaiset koodilohkot käsitellään tällä hetkellä kappaleina — tunnettu rajoitus ohje-ikkunassa.
Näppäinoikotiet (W5–W6)

Staattinen viiteluettelo viidessä osiossa. Navigation: Mouse Drag (Orbit/Fly), Shift+Drag/Right-Drag (Pan), Scroll (Zoom), WASD (Fly-Through-liike), 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 (Hyppää Training-Cam:iin 1=10%/5=50%/0=viimeinen), 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 (Poista valinta), Cmd-Z (Kumoa viimeisin poisto), [ / ] (Pienennä/suurenna sivellintä), Esc (Poista valinta). Training: Option+Space (Keskeytä/jatka koulutus), Cmd+E (Vie näkymä). Muuta tässä ei ole — Start, Cancel ja jatkoajat löydät Training-valikosta (luku 1).
Mikä se on: Yksinkertainen staattinen yleiskatsaus kaikista näppäinoikoteistä — Navigation, Views, Capture, Editor, Training. Sisältö on kiinteästi koodattu eikä sitä ladata mistään tiedostosta.
Kun etsit nopeinta tapaa tehdä jotain Viewportissa. WASD-Fly-Through, R kameran resetointiin, B taustan vaihtamiseen — kaikki löytyvät täältä.
W5ScrollView (sisältöalue)
MISSÄ
Help → Keyboard Shortcuts (⌘/).
TEKNINEN
Yksinkertainen vieritysalue, jonka sisällä on pystysuora luettelo. Padding 20 joka puolella, ei sivupalkin navigointipuuta (luettelo on tarpeeksi lyhyt). Sisältö on ryhmitelty viiteen osioon (Navigation, Views, Capture, Editor, Training). Jokaista näppäinyhdistelmää kohden yksi rivi, jossa käännettävä teksti molemmissa sarakkeissa. Vasen sarake (näppäinkoodi) on kiinnitetty 180 pt leveyteen, jotta kuvaukset oikealla pysyvät pystysuunnassa linjassa. Ei muuta vuorovaikutusta kuin vieritys — rivin klikkaaminen ei laukaise mitään, näppäinoikotiet ovat todellisia näppäimistön modifioijia valikossa ja Viewportissa.
W6VStack (oikotie-osiot)
MISSÄ
ScrollView'n sisällä.
TEKNINEN
Vasempaan reunaan tasatut, pinotut osiot 16 pt:n välein. Kunkin viiden osion sisällä otsikko + rivien sarja. Otsikoissa käytetään toissijaista Subheadline-tyyliä — tarkoituksella ei Title-muotoa, koska osioiden ei tarvitse olla navigoitavia. Sisältö on tarkoituksella litteä (ei Disclosurea, ei Searchia, ei filtteriä), jotta komponentti toimii muuttumattomana jokaisessa macOS-versiossa ja tiedosto pysyy luettavana.
Manage Storage (W7–W12)

Taulukkonäkymä kaikista RadianceKitin hallitsemista tiedostoista. Otsikko laskee 1 356 kohdetta, 55,1 Gt kokonaiskoko. Työkalurivi ylhäällä: „Show in Finder" + „Refresh". Jokainen rivi: vientikuvake, tiedostonimi (esim. training_20260718T194416Z.ply), vientipäivämäärä, koko (vaihtelee tässä 7,8 Mt:sta 2,24 Gt:hen), suurennuslasi-ikoni (Reveal) ja roskakori-ikoni (Move to Trash). Järjestys on ensin kategorian mukaan ja kategorian sisällä päivämäärän mukaan, uusin ylimpänä. Tässä kuvakaappauksessa PLY-viennit hallitsevat, koska tähän tallennuspaikkaan on tallennettu ennen kaikkea koulutustuloksia.
Mikä se on: Levynkäytön yleiskatsaus kaikelle, mitä RadianceKit tallentaa hakemistoon ~/Documents/RadianceKit/ — lokit, viennit, näkymät, capture-paketit (iOS-kumppanisovellukselta), tuonnit (syötekuvien staging-kopiot). Jokaista kohdetta kohti koko tavuina ja kaksi painiketta: „näytä Finderissä" ja „siirrä roskakoriin". Tämä EI ole automaattinen siivous — sovellus ei poista mitään itse; sinä päätät kohta kohdalta. Tämä ikkuna on käännetty: suomeksi se on nimeltään „Speicher verwalten" (Hallitse tallennustilaa), otsikkorivin molemmat painikkeet ovat „Näytä Finderissä" ja „Päivitä", rivipainikkeet „Näytä Finderissä" ja „Siirrä roskakoriin". Alla olevien kohtien englanninkieliset nimet ovat englanninkielisen version nimityksiä.
Kun levy alkaa täyttyä. Erityisesti lokit kertyvät (yksi JSONL per koulutusyritys, plus _qualityMetrics.json); viennit tietysti myös (PLY 100 % raakadataa, yksi per vienti). Hyödyllinen myös kaatumisen jälkeen, kun tuontien staging-hakemistoon on jäänyt lojumaan vanhoja kopioita syötekuvista.
W7Painike „Show in Finder"
MISSÄ
Otsikko oikealla ylhäällä storage-selain-ikkunassa.
TEKNINEN
Avaa RadianceKitin datakansion Finderissä — juuri sen hakemiston, jonka sisällön tämä ikkuna listaa. Näin näet kansiorakenteen (Logs, Exports, Scenes, Captures, Imports) suoraan ja voit myös itse siirtää tai kopioida tiedostoja Finderin avulla. Toiminto avaa uuden Finder-ikkunan; ikkunan lista ei muutu tämän myötä — sitä varten on „Refresh" (W8).
W8Painike „Refresh"
MISSÄ
Otsikko, Finder-painikkeen vieressä.
TEKNINEN
Käynnistää taustaskannauksen, joka toimii käyttäjän käynnistämänä asynkronisena tehtävänä, jotta suurien hakemistopuiden skannaus ei jumita käyttöliittymää. Varsinainen läpikäynti käy läpi jokaisen tunnetun alikansion (Logs, Exports, Scenes, Captures, Imports) ja luo jokaisesta suorasta lapsesta storage-kohdan. Jokaiselle kohdalle määritetään rekursiivinen koko — ensisijaisesti todellinen levynkäyttö (mukaan lukien APFS-kovalinkkien jakaminen), varajärjestelynä looginen tiedostokoko.
W9List (storage-kohteet)
MISSÄ
Pääsisältö otsikon alla.
TEKNINEN
Lista, jossa jokaisella rivillä tämä asettelu: kategoriakohtainen SF Symbols -kuvake (dokumentti lokeille, ylösnuoli vienneille, kuutio näkymille, iPhone capture-paketeille, tarjotin tuonneille), nimi + alaotsikko (laji-tunniste + muotoiltu muutospäivämäärä), tavulaskuri oikealla (oikealle tasattu, tasavälinen fontti), Reveal-painike (suurennuslasi-symboli), Trash-painike (roskakori). Järjestys: ensisijaisesti lajin mukaan (Scenes ensin, sitten Exports, Logs, Captures, Imports, Other), toissijaisesti muutospäivämäärän mukaan laskevasti (uusin ylimpänä). Jos skannaus on vielä käynnissä, kohdassa näkyy sen sijaan „Scanning…"-edistymispalkki. Jos mitään ei löytynyt, näytetään tyhjä tila -näkymä tarjotin-ikonilla.
W10Rivipainike „Reveal in Finder"
MISSÄ
Jokaisella rivillä, suurennuslasi-symboli oikealla.
TEKNINEN
Avaa Finderin ja valitsee kyseisen kohteen (tiedoston tai kansion). Ero W7:ään: W7 avaa juurihakemiston; W10 merkitsee tarkalleen tämän yhden kohteen. Käytännön työnkulku: tunnista suuri kohde, klikkaa suurennuslasia, kopioi se sitten esimerkiksi ulkoiselle levylle.
W11Rivipainike „Move to Trash"
MISSÄ
Jokaisella rivillä, roskakori-symboli suurennuslasin vieressä oikealla.
TEKNINEN
Laukaisee vahvistusdialogin (W12). Vasta vahvistuksen jälkeen suoritetaan macOSin vakiotoiminto „siirrä roskakoriin" (eli peruutettavissa oleva, ei suoraa poistoa). Onnistuneen roskakoriin siirron jälkeen kohde poistetaan listasta ja kokonaistavulaskuri päivitetään. Virhetilanteissa näytetään modaalinen virhedialogi.
W12ConfirmationDialog (poiston vahvistus)
MISSÄ
Laukaistaan W11:sta, esitetään macOS-sheetinä.
TEKNINEN
Vakiovahvistusdialogi, jossa dynaaminen otsikko „Delete <name>?" ja viestirivi, joka nimenomaisesti huomauttaa, että kohde päätyy roskakoriin ja on sieltä palautettavissa (kunnes roskakori tyhjennetään). Kaksi painiketta: „Move to Trash" tuhoavana toimintona (näytetään punaisena) ja „Cancel" automaattisella Esc-sidonnalla. Dialogi on ei-modaalinen siinä mielessä, että se estää vain tämän ikkunan, ei koko sovellusta — tämä on macOSin vakiokäytäntö peruutettaville poistoille.
Pääikkuna: häviön kehityskuvaaja ja Gaussian-määrä (I39–I41, ristiviittaus)
Kolme Inspectorin näytöistä pääikkunassa ansaitsee oman selityksensä, koska ne näkyvät jatkuvasti käynnissä olevan koulutuksen aikana ja niihin liittyy tärkeitä nyrkkisääntöjä siitä, milloin kehitys näyttää terveeltä. Näytöt sijaitsevat Inspectorin osiossa Edistyminen, avattavassa ryhmässä Häviön kehitys (katso luku 2 — Inspector), ja ne auttavat tulkitsemaan koulutuksen edistymistä.
Milloin loss-käyrä on terve? Terve loss-käyrä näyttää kolme vaihetta: (1) Warmup — ensimmäisten 200–500 iteraation aikana loss laskee jyrkästi korkeasta (tyypillisesti 0.15–0.25 yhdistetylle L1+SSIM:lle scenestä riippuen) noin puoleen. Jos loss EI laske tässä vaiheessa, syöte on yleensä väärä (kuvat rikki, SfM-poosit huonot, alkuperäisten Gaussianeiden määrä liian pieni). (2) Densification — ~500:n ja densifyUntilIteration-arvon välillä (klassisesti 15K, MCMC:llä 20K tai 25K) loss laskee edelleen, usein pienin hyppäyksin alaspäin, kun densify-operaatiot lisäävät uusia Gaussianeja ja optimoija hyödyntää niitä. Gaussian-määrä kasvaa tässä vaiheessa. (3) Refinement — tämän jälkeen loss etenee kohti tasoittuvaa häntää. Tyypilliset lopulliset arvot suuntaa-antavina: hyvin valaistu esine-scene (esimerkiksi Tanks-&-Temples Truck P4 Quality -asetuksella) päätyy tasolle L1 ≈ 0.023, laajat ulkotilan scenet kuten Mip-NeRF 360:ssa jäävät luonnostaan tämän yläpuolelle (0.04–0.07).
Mitä plateau tarkoittaa? Plateau (loss-käyrä kulkee vaakasuoraan usean tuhannen iteraation ajan) voidaan tulkita kahdella tavalla: (a) malli on konvergoitunut, lisäkoulutus ei enää tuota mitään — tämä on hyvä tapaus. (b) malli on jumissa (paikallinen minimi, huono gradienti-informaatio, puskurirajan yläraja) — huono tapaus. Molemmat näyttävät kaaviossa samalta. Erottelu: katso Gaussian-määrää. Jos sekin on tasainen JA lähellä MCMC-rajaa (esim. 150K/150K esiasetuksella P8 Quality (MCMC)), olet rajalla — joko nosta rajaa tai hyväksy plateau. Jos Gaussian-määrä kasvaa vielä, mutta loss ei laske, kyseessä on jumiutuminen.
Milloin keskeyttää vai jatkaa koulutusta? Nyrkkisääntö: jos minimiloss ei parane 10K iteraation aikana → keskeytä, lisäiteraatiot menevät hukkaan. Ennen sitä: Training-valikosta → Continue Training → "+5,000 iterations" voit vielä liittää jatkoa, jos näet rajatapauksellista parannusta (tälle ei ole pikanäppäintä). Huomio: MCMC:llä plateau on usein aito — raja on luonnollinen yläraja.
Gaussian-määrän plateau EI ole "valmis"-signaali. Se tarkoittaa vain, että MCMC on saavuttanut rajansa tai että Classic Densification on käytetty loppuun. Todellisen "valmis"-kysymyksen vastaavat vasta PSNR/SSIM/LPIPS riippumattomalla testijoukolla. Riippumaton testijoukko näyttää samalla, salliiko kamerajoukkosi oikeudenmukaisen jaon koulutus- ja testinäkymiin.
PSNR/Holdout on totuus, loss vain likiarvo. Loss on suhteellinen mittari: se laskee, kun mallisi sopeutuu koulutusnäkymiin. Matala loss ei kuitenkaan automaattisesti tarkoita hyvää mallia — jos malli on opetellut koulutuskuvat ulkoa (ylisovitus), loss olisi pieni, mutta PSNR näkemättömillä näkymillä (holdout) olisi huono. Siksi: lopullisessa laadunarvioinnissa katso aina holdout-mittareita, älä pelkkää lopullista lossia.
Nyrkkisääntö-laatikko
- User Guide ja Keyboard Shortcuts ovat staattista ohjetta — nopeita avainsana-kysymyksiin, mutta syvempään tietoon käytä tätä käsillä olevaa manuaalia. - Avaa Manage Storage heti, kun levyllä on alle 10 % vapaata tilaa. Lokit ja Imports-staging ovat tavanomaiset syylliset. - Loss-Plateau ja Gaussian-Count-Plateau on tulkittava erikseen. Cap-raja ei ole "valmis"-merkki. Todellista laatua mittaa vain Holdout-PSNR. - 10K iteraatiota ilman Min-Loss-parannusta → pysäytä harjoitus.