RadianceKit Käyttöopas
Luku 1 — Valikkorivi
RadianceKitin valikkorivi jäsentää kaikki toiminnot, jotka eivät sijaitse suoraan pääikkunassa tai Tarkastajassa. Nämä ovat ensisijaisesti toimintoja, jotka vaikuttavat koko näkymään (Avaa, Tallenna, Uusi projekti), ohjaavat koulutusta (Aloita, Tauko, Jatka), hallitsevat näkymää (Automaattinen kierto, Kuvakaappaus, Taustaväri) ja käynnistävät vientitoimintoja erilaisiin 3D- ja mediamuotoihin. Lisäksi valikossa on linkit kaikkiin apuikkunoihin (Käyttöopas, Pareto-koontinäyttö, Holdout-analyysi, BayesOpt-konsoli).
Pikanäppäimet näkyvät valikkokohdan oikealla puolella. Käytännöt: ⌘ tarkoittaa Komento-näppäintä (omenanäppäin), ⇧ on vaihto, ⌥ on optio (alt) ja ⌃ on control. Esimerkki: ⇧⌘T tarkoittaa vaihto+komento+T. Kaikki tässä dokumentoidut pikanäppäimet on lisäksi lueteltu omassa yleiskatsausikkunassaan kohdassa Help → Keyboard Shortcuts (⌘/).
Seuraavat 42 kohtaa on dokumentoitu inventaarion (M1–M42) järjestyksessä, ryhmiteltynä vastaavan ylätason valikon mukaan. Kaikki kohdat on tarkistettu vastaamaan nykyistä kooditilaa tiedostossa RadianceKitApp.swift (rivit 175–477). Yhtään kohtaa ei ole poistettu tai vanhentunut inventaarioon nähden; uusi Muokkaa-valikon kohta (Cmd-Z komennolle "Poista kuva") lisätään järjestelmän NSUndoManager-kehyksen kautta, eikä se siksi näy RadianceKitApp-koodissa (katso huomautus luvun lopussa).
Tiedosto-valikko

Tiedosto-valikko korvaa Applen oletusarvoisen "Uusi ikkuna" -kohdan projektikohtaisilla toiminnoilla. Se sisältää näkymien lataamisen/tallentamisen, dynaamisen Viimeisimmät-listan, työtilan tuonnin sekä täydellisen nollauksen tyhjään tilaan.
M1Tiedosto > Avaa näkymä…
MISSÄ
Valikkorivi → Tiedosto → Avaa näkymä… (⌘O).
TEKNINEN
Avaa tiedostovalintaikkunan formaateille RadianceScene-paketti, .ply, .splat ja .spz. Vain yhden valinta, voi näyttää sekä tiedostoja että hakemistoja (pakettiformaatille). Onnistuneen valinnan jälkeen polku lisätään Viimeisimmät-listaan ja näkymä ladataan asynkronisesti – edellinen korvataan ja koulutusputki alustetaan ladatulla tilalla. PLY/SPZ/Splat-tiedostot luetaan vastaavilla formaattilukijoilla; .radiancescene-paketti on hakemisto, joka sisältää manifestin, pilvipalvelun tilannekuvan ja SfM-tulokset.
M2Tiedosto > Tallenna näkymä…
MISSÄ
Valikkorivi → Tiedosto → Tallenna näkymä… (⌘S).
TEKNINEN
Avaa tiedoston tallennusikkunan, jonka sisältötyyppi on RadianceScene-paketti ja oletustiedostonimi scene.radiancescene. Kirjoittaa hakemistopaketin, joka sisältää manifest.json-tiedoston, sarjallistetun Gaussian-pilven (PLY-tilannekuva) ja SfM-tuloksen vedoksen, jotta myös koulutuksen jatkaminen toimii uudelleen avaamisen jälkeen. Kohta on poissa käytöstä, kunnes Gaussianeja on olemassa. Ei tallenna koulutuslokien polkuun, vaan sinne, minne tallennusikkuna osoittaa – tyypillisesti ~/Documents/.
M3Tiedosto > Avaa viimeisin > [Näkymän nimi]
MISSÄ
Valikkorivi → Tiedosto → Avaa viimeisin → (Lista).
TEKNINEN
Dynaaminen alivalikko, joka luodaan viimeksi avattujen polkujen listasta (tallennettu asetuksiin). Jokainen listan kohta nimetään tiedostonimen mukaan ja ladataan napsautettaessa. Jos lista on tyhjä, sen sijaan näytetään poissa käytöstä oleva teksti "No Recent Scenes". Applelle tyypillisesti lista sisältää N viimeksi avattua näkymää – rajoitus tapahtuu asetuksiin kirjoitettaessa, ei itse valikon rakentajassa.
M4Tiedosto > Avaa viimeisin > Tyhjennä viimeisimmät
MISSÄ
Valikkorivi → Tiedosto → Avaa viimeisin → Tyhjennä viimeisimmät.
TEKNINEN
Tyhjentää Viimeisimmät-listan asetuksista. Vaikuttaa välittömästi ilman vahvistusikkunaa. Kohta näkyy vain silloin alivalikossa, jos Viimeisimmät-listassa on ylipäätään kohteita (se sijaitsee erottimen alla polkujen jälkeen).
M5Tiedosto > Tuo COLMAP / Metashape -työtila…
MISSÄ
Valikkorivi → Tiedosto → Tuo COLMAP / Metashape -työtila… (⇧⌘I).
TEKNINEN
Avaa kansionvalitsimen. Odottaa kansiota, jolla on COLMAP-työtilan asettelu (esim. sparse/0/cameras.{bin,txt} sekä images/). Valinnan jälkeen työtilalle suoritetaan esitarkistus – tämä tunnistaa kolme asettelua (sparse/0/, sparse/, juuri) ja sen, onko rekonstruktio binäärinen (cameras.bin) vai ETH3D-tekstimuodossa (cameras.txt). Onnistuessaan työtila tuodaan; muuten sovelluslokiin ilmestyy vain varoitus. Katso myös Luku 9 "SfM-taustajärjestelmät", Q6 koko putken logiikasta.
M6Tiedosto > Uusi projekti
MISSÄ
Valikkorivi → Tiedosto → Uusi projekti (⇧⌘N).
TEKNINEN
Tarkistaa, onko tallentamatonta työtä. Jos on, näyttöön tulee vahvistusikkuna ennen kuin mitään menetetään. Jos tallennettavaa ei ole, nollaus suoritetaan suoraan – se tyhjentää tuodut kuvat, SfM-tuloksen, Gaussian-pilven, koulutustilan ja kaikki riippuvaiset käyttöliittymän ilmaisimet. Huomio: Käyttäjän luoma esiasetuskirjasto säilyy, koska se sijaitsee sovelluksen asetuksissa eikä projektin tilassa.
Tila-valikko

Kaksi yksinkertaista valitsinta opastetun aloittelijatilan (ohjattu, 4 vaihetta) ja täyden asiantuntijatilan (klassinen Tarkastaja-asettelu kaikkine säätimineen) välillä.
M7Tila > Aloittelijatila
MISSÄ
Valikkorivi → Tila → Aloittelijatila (⌘1).
TEKNINEN
Vaihtaa sovelluksen tilan aloittelijatilaan. Sovelluksen pääalue näyttää silloin opastetun työnkulun asiantuntija-asettelun sijaan. Tilan tila tallennetaan asetuksiin (katso S1 "Oletustila" Luvussa 3 Asetukset).
M8Tila > Asiantuntijatila
MISSÄ
Valikkorivi → Tila → Asiantuntijatila (⌘2).
TEKNINEN
Vaihtaa sovelluksen tilan asiantuntijatilaan. Tällöin näkyviin tulee täysi Tarkastaja-asettelu kaikkine osioineen (Presets, TrainingConfig, Enhancements, Metrics, LossChart, ProjectNavigator). Asiantuntijatilassa kaikki koulutusparametrit, COLMAP-valitsimet, Mid-Compact-kytkimet ja diagnostiikka ovat käytettävissä. Myös live-esikatselu toimii vain tässä tilassa.
Koulutus-valikko

Neljä toimintoa koulutusajoon liittyen: aloita, keskeytä, peruuta ja jatka tietyllä iteraatiomäärällä. Kaikki kolme Jatka-kohtaa ovat IAP-rajoitettuja (ilmaisessa kokeiluversiossa ei voi napsauttaa).
M9Koulutus > Aloita koulutus
MISSÄ
Valikkorivi → Koulutus → Aloita koulutus (⇧⌘T).
TEKNINEN
Käynnistää koulutusputken asynkronisesti. Edellytys: SfM-tulos on olemassa eikä mikään muu putki ole käynnissä. Molemmat ehdot estävät kohdan, jos ne eivät täyty. Käynnistyksen yhteydessä luetaan nykyiset konfiguraatioarvot, luodaan uusi JSONL-loki osoitteeseen ~/Documents/RadianceKit/Logs/training_YYYY-MM-DD_HHmmss.jsonl ja strategian valinnasta riippuen ajetaan klassinen tai MCMC-polku. Koulutustila vaihtuu "idle"-tilasta "training"-tilaan.
M10Koulutus > Keskeytä koulutus
MISSÄ
Valikkorivi → Koulutus → Keskeytä koulutus.
TEKNINEN
Keskeyttää käynnissä olevan koulutuksen. Aktivoituu vain, kun koulutustila on "training". Keskeytys pysäyttää iteraatiosilmukan seuraavassa turvallisessa synkronointipisteessä, säilyttää täyden GPU-tilan (Gaussian-puskurit, optimoijan momentit, aikatauluttajan sijainti) ja vaihtaa "paused"-tilaan. Jatko tapahtuu painamalla uudelleen (valikkokohdan otsikko on staattinen – sovellus kuitenkin vaihtaa keskeytyksen/jatkamisen välillä sisäisessä logiikassa). Keskeytetyt koulutukset eivät selviä sovelluksen sulkemisesta; siinä tapauksessa tallenna näkymä ja jatka myöhemmin Jatka koulutusta -kohdilla (M12–M14).
M11Koulutus > Peruuta koulutus
MISSÄ
Valikkorivi → Koulutus → Peruuta koulutus.
TEKNINEN
Peruuttaa käynnissä olevan koulutuksen. Aktiivinen, kun koulutustila ei ole "idle". Asettaa peruutuslipun koulutusmoottorissa, mikä päättää iteraatiosilmukan siististi seuraavassa synkronointipisteessä, kirjoittaa lopullisen yhteenvetomerkinnän JSONL-lokiin ja palauttaa tilan "idle"-tilaan. Tähän mennessä koulutettu pilvi säilyy (voidaan tallentaa tai viedä), mutta se merkitään "cancelled"-tilaan.
M12Koulutus > Jatka koulutusta > +5 000 iteraatiota
MISSÄ
Valikkorivi → Koulutus → Jatka koulutusta → +5 000 iteraatiota.
TEKNINEN
Jatkaa koulutusta 5 000 iteraatiolla. Aktiivinen, kun päätetty koulutus on jatkettavissa ja täysversio on aktivoitu. Jatkettavuus on voimassa, kun päätetty koulutus on olemassa ja täysi optimoijan tila on vielä muistissa. Jatkettaessa Adam-momentteja ja LR-aikatauluttajaa jatketaan, joten jatko käyttäytyy kuin yhtenäinen 25K/45K/60K-ajo uudelleenkäynnistyksen sijaan. JSONL-loki saa uuden konfiguraatiomerkinnän inkrementaalisella asetuksella. Saatavilla vain täysversiossa.
M13Koulutus > Jatka koulutusta > +10 000 iteraatiota
MISSÄ
Valikkorivi → Koulutus → Jatka koulutusta → +10 000 iteraatiota.
TEKNINEN
Identtinen M12:n kanssa, mutta 10 000 lisäiteraatiolla. Samat ennakkoehdot, sama LR-aikatauluttajan polku. Suositellaan, jos alkuperäinen koulutus ajettiin keskitason esiasetuksella ja haluat nähdä merkittävän laadunparannuksen käynnistämättä ajoa kokonaan uudelleen.
M14Koulutus > Jatka koulutusta > +20 000 iteraatiota
MISSÄ
Valikkorivi → Koulutus → Jatka koulutusta → +20 000 iteraatiota.
TEKNINEN
Identtinen M12/M13:n kanssa, mutta 20 000 lisäiteraatiolla. Suurin ennalta määritetty jatkohyppy. MCMC-koulutuksissa tämä tekee usein eron "sopivan" ja "vertailukelpoisen" välillä; klassisessa koulutuksessa 35–40K:n jälkeen kokemuksen mukaan lisähyöty on vähäinen.
Näkymä-valikko

Ohjaa 3D-näkymää: muokkaustila Gaussian-valintaan ja siivoukseen, kameran ohjaus (automaattinen kierto, toisto, tallennus), kuvakaappaus, taustaväri ja nollaus.
M15Näkymä > Siirry muokkaustilaan / Poistu muokkaustilasta
MISSÄ
Valikkorivi → Näkymä → Siirry muokkaustilaan (tai "Poistu muokkaustilasta", tilasta riippuen). ⇧⌘E.
TEKNINEN
Valikkokohdan otsikko on dynaaminen ja näyttää tilasta riippuen "Poistu muokkaustilasta" tai "Siirry muokkaustilaan". Painettaessa muokkaustila kytketään päälle/pois näkymän renderöijässä. Muokkaustilasta poistuttaessa myös nykyinen valinta nollataan. Muokkaustila aktivoi Gaussianien napsautusvalinnan, laatikkvalinnan ja merkittyjen Gaussianien poistamisen (katso käyttöliittymän editorialue). Poissa käytöstä, kunnes näkymän renderöijä on liitetty.
M16Näkymä > Kytke automaattinen kierto
MISSÄ
Valikkorivi → Näkymä → Kytke automaattinen kierto (⌘⌥T).
TEKNINEN
Kytkee näkymän kameran jatkuvan kierron pystyakselin ympäri näkymän keskipisteen kautta päälle tai pois. Akseli ja nopeus tulevat kameran ohjausasetuksista. Automaattinen kierto on puhdas näkymäefekti eikä vaikuta koulutukseen tai tallennukseen – jos käytät samanaikaisesti kääntöpöytä-videotallenninta (M18), automaattinen kierto tuottaa juuri sen polun, jonka tallennin kaappaa.
M17Näkymä > Kytke kameran toisto
MISSÄ
Valikkorivi → Näkymä → Kytke kameran toisto.
TEKNINEN
Kytkee kamerareitin toiston päälle/pois. Jos tallennettu kamerareitti on olemassa (esim. edellisestä tallennuksesta tai koska transforms.json on ladattu), reitti toistetaan – näkymän kamera ei siis enää liiku hiiren/ohjauslevyn syötteiden mukaan, vaan toistaa liikeradan kuva kuvalta. Uudelleen painaminen keskeyttää toiston.
M18Näkymä > Tallenna kääntöpöytävideo
MISSÄ
Valikkorivi → Näkymä → Tallenna kääntöpöytävideo.
TEKNINEN
Kytkee näkymän tallennuksen päälle/pois. Ensimmäisellä painalluksella alkaa kuvien tallennus väliaikaiseen polkuun; toisella painalluksella tallennus päättyy, koodataan ja kirjoitetaan MP4-polkuun (polku kysytään tallennusikkunassa). Toisin kuin Vie → Media → Kiertovideo (M31), joka luo kiinteän 360°-reitin säädettävällä kestolla, kääntöpöytätallennin tallentaa livenä sen, mitä näkymässä näet – voit siis myös tallentaa manuaalisen kamera-ajon.
M19Näkymä > Tallenna kuvakaappaus
MISSÄ
Valikkorivi → Näkymä → Tallenna kuvakaappaus (⇧⌘S).
TEKNINEN
Kaappaa yhden näkymän kuvan täydellä renderöintitarkkuudella (eli ei ikkunan pikseliasettelua, vaan täyden renderöintikohteen sisällön) PNG-tiedostona. Polku kysytään tallennusikkunassa. Taustaväri (M21–M23) poltetaan mukaan. MetalFX-/MPS-skaalausasetukset parannuksista (katso I27/I28) vaikuttavat, jos ne ovat aktiivisia – kuvakaappaus näyttää siis ylösskaalatun tuloksen.
M20Näkymä > Kopioi kameran tiedot
MISSÄ
Valikkorivi → Näkymä → Kopioi kameran tiedot.
TEKNINEN
Lukee nykyisen näkymän kameran asennon (sijainti, katselupiste, ylös-vektori) ja FOV-arvot kameran ohjauksesta ja kirjoittaa ne monirivisenä tekstinä leikepöydälle. Muoto on ihmisluettava (otsikko = arvo per rivi), ei JSON. Käytännöllinen tietyn näkymän toistamiseen vianmääritystarkoituksessa tai sen jakamiseen tuen kanssa.
M21Näkymä > Tausta > Tummanharmaa
MISSÄ
Valikkorivi → Näkymä → Tausta → Tummanharmaa.
TEKNINEN
Asettaa näkymän taustavärin tummanharmaaksi (RGB 0.1/0.1/0.1). Renderöijä käyttää tätä väriä taustana, jonka päälle Gaussianit yhdistetään. Oletusväriä sovelluksen käynnistyessä ohjaa asetus S3 "Oletusnäkymän tausta".
M22Näkymä > Tausta > Musta
MISSÄ
Valikkorivi → Näkymä → Tausta → Musta.
TEKNINEN
Asettaa näkymän taustavärin puhtaaksi mustaksi (RGB 0/0/0). Auttaa, jos näkymässä on paljon vaaleita leijuvia partikkeleita ja haluat tunnistaa ne, tai markkinointimateriaaliin, jossa on tumma ilme.
M23Näkymä > Tausta > Valkoinen
MISSÄ
Valikkorivi → Näkymä → Tausta → Valkoinen.
TEKNINEN
Asettaa näkymän taustavärin puhtaaksi valkoiseksi (RGB 1/1/1). Hyödyllinen, jos näkymässä on pääasiassa tummaa sisältöä ja haluat nähdä tummia leijuvia partikkeleita (tyypillistä ulkokuvausten taustakohinaa).
M24Näkymä > Nollaa kamera
MISSÄ
Valikkorivi → Näkymä → Nollaa kamera.
TEKNINEN
Nollaa näkymän kameran, poistuu koulutuskameranäkymästä ja pysäyttää automaattisen kierron. Tämän jälkeen kamera on palannut alkuperäiseen asentoonsa (tyypillisesti: näkymän edessä, hieman ylhäältä katsottuna), automaattinen kierto on pois päältä, ja jos renderöijä näytti juuri koulutuskameraa (yhtä SfM-asennoista), se palaa vapaaseen kameraan.
Vienti-valikko

Kahdeksan vientikohdetta sekä kaksi fotogrammetriavientiä, ryhmiteltynä kolmeen osioon (3D-formaatit, Media, Fotogrammetria). Ensimmäiset kuusi rakennetaan yhteisen apurutiinin avulla, joka avaa tallennusikkunan ja rekisteröi viennin formaattiluetteloon. Fotogrammetriakohteilla on yksilöllinen logiikka. Kaikki fotogrammetria- ja jotkut 3D-viennit ovat saatavilla vain täysversiossa.
M25Vie > 3D-formaatit > Vie PLY…
MISSÄ
Valikkorivi → Vie → 3D-formaatit → PLY (⌘E).
TEKNINEN
Avaa tallennusikkunan oletustiedostonimellä gaussians.ply. OK-painikkeen jälkeen nykyinen Gaussian-pilvi kirjoitetaan standardoituun ASCII/Binary-PLY-muotoon – yhteensopiva SuperSplatin, PolyCamin, PlayCanvasin ja kaikkien yleisten 3DGS-katseluohjelmien kanssa. Täydet SH-kertoimet, täysi tarkkuus (Float32 per kenttä). Tiedostokoko usein satoja megatavuja, kun Gaussianeja on ≥ 500K.
M26Vie > 3D-formaatit > Vie pakattu PLY…
MISSÄ
Valikkorivi → Vie → 3D-formaatit → Pakattu PLY.
TEKNINEN
Kirjoittaa Gaussian-pilven pakatussa PLY-muodossa mukautetulla kvantisoinnilla sijainti-, skaalaus-, kierto- ja SH-kentille. 5–10× pienemmät tiedostot kuin pakkaamaton PLY (M25) minimaalisilla visuaalisilla menetyksillä. Yhteensopiva SuperSplatin (joka lukee pakatun PLY-standardin) ja PlayCanvasin kanssa. Oletustiedostonimi gaussians_compressed.ply.
M27Vie > 3D-formaatit > Vie SPZ…
MISSÄ
Valikkorivi → Vie → 3D-formaatit → SPZ.
TEKNINEN
Kirjoittaa Gaussian-pilven SPZ-muodossa – Nianticin julkaisema pakattu splat-formaatti aggressiivisella kvantisoinnilla (n. 90 % pienempi kuin pakkaamaton PLY). Optimoitu erityisesti verkkokatseluohjelmille ja mobiilisovelluksille. Yhteensopiva Nianticin Splatt3R:n, gsplat.js:n ja Nianticin selainkatseluohjelman kanssa.
M28Vie > 3D-formaatit > Vie glTF…
MISSÄ
Valikkorivi → Vie → 3D-formaatit → glTF.
TEKNINEN
Kirjoittaa .glb-tiedoston (binäärinen glTF), jossa on KHR_gaussian_splatting-laajennus. Standardin mukainen, sopii putkille, jotka käyttävät glTF-moottoreita kuten Babylon.js tai Three.js ja toteuttavat KHR_gaussian_splatting-laajennuksen.
M29Vie > 3D-formaatit > Vie .splat…
MISSÄ
Valikkorivi → Vie → 3D-formaatit → .splat.
TEKNINEN
Kirjoittaa Antimatter15:n .splat-formaatin – kiinteä koko 32 tavua per Gaussian (sijainti 3× Float32, skaalaus 3× Float32, kierto 4× Uint8 normalisoitu kvaternio, RGB+läpinäkyvyys 4× Uint8). Ei SH-kertoimia DC:tä korkeampia. Pienin tiedosto, jolla on suora selainyhteensopivuus. gsplat.js:lle ja antimatter15:n online-demokatseluohjelmalle.
M30Vie > 3D-formaatit > Vie SOG…
MISSÄ
Valikkorivi → Vie → 3D-formaatit → SOG.
TEKNINEN
Kirjoittaa Gaussian-pilven SOG-muodossa. SOG ("Self-Organizing Gaussian") on PlayCanvas-formaatti, jossa on tekstuurikartta-asettelu ja WebP-pakkaus kvantisoiduille tiedoille. Skaalautuu 15–20× paremmalla kokosuhteella kuin PLY. Vienti kutsuu sisäisesti cwebp-työkalua ulkoisena työkaluna – siksi hiekkalaatikkoversiossa (App Store) mahdollisesti rajoitettu.
M31Vie > Media > Vie kiertovideo…
MISSÄ
Valikkorivi → Vie → Media → Kiertovideo.
TEKNINEN
Renderöi 360° kierron näkymän keskipisteen ympäri ja koodaa sen MP4-muotoon (H.264) tai MOV-muotoon (HEVC, järjestelmän oletuksesta riippuen). Toisin kuin M18 (live-tallennus), reitti on tässä kiinteästi määritelty – kesto valitaan asetuksissa tai aloittelijatilan vientivaiheessa.
M32Vie > Media > Vie verkkokatselin…
MISSÄ
Valikkorivi → Vie → Media → Verkkokatselin.
TEKNINEN
Pakkaa itsenäisen HTML-katseluohjelman (gsplat.js-pohjainen) sekä Gaussian-tiedot Base64-koodattuna yhteen .html-tiedostoon. Tämä tiedosto toimii offline-tilassa missä tahansa modernissa selaimessa – ei palvelinriippuvuuksia, ei ulkoisia URL-osoitteita. Tiedostokoko on noin 1,3 kertaa suurempi kuin SPZ-versio (Base64-ylikuormituksen vuoksi).
M33Vie > Fotogrammetria > Vie SfM (transforms.json)…
MISSÄ
Valikkorivi → Vie → Fotogrammetria → Vie SfM (transforms.json).
TEKNINEN
Oma vientipolku (ei yhteisen apurutiinin kautta), koska ei viedä Gaussian-pilveä, vaan SfM-tulos. Avaa tallennusikkunan, jossa transforms.json on oletuksena ja sisältötyyppi json. OK-painikkeen jälkeen kirjoitetaan nerfstudio-yhteensopiva transforms.json, jossa on kameran sisäiset parametrit, asennot (4×4-matriisina NeRF-konvention mukaan) ja kuvapolut. Ohjeteksti käyttöliittymässä huomauttaa, että koulutuskuvat on kopioitava sisarkansioon images/. Aktiivinen vain, kun SfM-tulos on olemassa ja täysversio on aktivoitu.
M34Vie > Fotogrammetria > Vie SfM (COLMAP-työtila)…
MISSÄ
Valikkorivi → Vie → Fotogrammetria → Vie SfM (COLMAP-työtila).
TEKNINEN
Avaa tallennusikkunan oletusnimellä colmap-workspace (ilman päätettä, koska se on kansio). Kirjoittaa standardinmukaisen COLMAP-työtilan, jossa on sparse/0/cameras.bin, images.bin, points3D.bin. Mahdollistaa RadianceKitissä lasketun tai tuodun SfM-rekonstruktion avaamisen muissa työkaluissa, kuten Postshot, Nerfstudio tai Meshroom, tai A/B-uudelleenajossa jo laskettuna syötteenä RadianceKitiin itseensä (M5:n kautta) uudelleen lataamisen – säästää laskenta-aikaa. Aktiivinen vain, kun SfM-tulos on olemassa ja täysversio on aktivoitu.
Ohje-valikko

Seitsemän kohtaa: kaksi dokumentaatioikkunaa (Käyttöopas, Pikanäppäimet), kolme kansio-oikotietä (Koulutuslokit, Viennit, Tallennustila) ja kolme analyysi-ikkunaa (Pareto-koontinäyttö, Holdout-analyysi, BayesOpt-konsoli). Applelle tyypillisesti Ohje-valikko näkyy aivan oikealla. Oletusarvoinen Ohje-valikko korvataan kokonaan RadianceKitin omalla versiolla.
M35Ohje > Käyttöopas
MISSÄ
Valikkorivi → Ohje → Käyttöopas (⌘?).
TEKNINEN
Avaa Käyttöopas-ikkunan. Se näyttää navigaation, jossa on aihe-sivupalkki ja vieritettävä yksityiskohta-alue oletuskoossa 860×640. Sisällöt on tallennettu staattisesti (ei jäsennetty Markdownista).
M36Ohje > Pikanäppäimet
MISSÄ
Valikkorivi → Ohje → Pikanäppäimet (⌘/).
TEKNINEN
Avaa Pikanäppäimet-ikkunan – yksinkertainen vieritettävä asettelu, jossa on kaikki sovelluksen pikanäppäimet, ryhmiteltynä ylätason valikon mukaan. Oletuskoko 440×560. Sisällöt on myös tallennettu staattisesti.
M37Ohje > Avaa koulutuslokit…
MISSÄ
Valikkorivi → Ohje → Avaa koulutuslokit… (⇧⌘L).
TEKNINEN
Laskee lokikansion polun ~/Documents/RadianceKit/Logs, luo sen tarvittaessa ja avaa sen Finderissa. Jokainen koulutusajo kirjoittaa sinne oman JSONL-tiedoston training_YYYY-MM-DD_HHmmss.jsonl.
M38Ohje > Avaa vientikansio…
MISSÄ
Valikkorivi → Ohje → Avaa vientikansio…
TEKNINEN
Vastaa M37:ää, mutta polulla ~/Documents/RadianceKit/Exports. Luodaan ensimmäisen automaattisen testiajon tai ensimmäisen napsautuksen yhteydessä; sen jälkeen sinne päätyvät kaikkien automaattisten testivientien oletuspolut (esim. autotest_<timestamp>.ply). Manuaalisesti tallennusikkunan kautta valitut viennit EIVÄT välttämättä mene tänne, vaan sinne, minne käyttäjä ne tallentaa – siksi tämä kansio on erityisen kiinnostava automaattisille testeille.
M39Ohje > Hallitse tallennustilaa…
MISSÄ
Valikkorivi → Ohje → Hallitse tallennustilaa…
TEKNINEN
Avaa tallennustilan selaimen (katso Luku 4 Apuikkunat, ID:t W7–W12). Listaa kaikki pysyvästi tallennetut näkymät, koulutuslokit, viennit ja välimuistit ~/Documents/RadianceKit/-kansiossa koon kanssa, mahdollistaa Näytä Finderissa ja Siirrä roskakoriin -toiminnot jokaiselle kohteelle.
M40Ohje > Pareto-koontinäyttö…
MISSÄ
Valikkorivi → Ohje → Pareto-koontinäyttö… (⇧⌘D).
TEKNINEN
Avaa Pareto-koontinäytön (katso Luku 4, ID:t W13–W22). Koontinäyttö lataa kaikki JSONL-koulutuslokit ~/Documents/RadianceKit/Logs/-kansiosta, järjestää ne näkymän ja esiasetuksen mukaan ja piirtää Pareto-hajontakaavion (oletus: häviö vs. Gaussianit, valinnaisesti häviö vs. seinäkelloaika tai PSNR vs. iteraatiot).
M41Ohje > Holdout-analyysi…
MISSÄ
Valikkorivi → Ohje → Holdout-analyysi… (⇧⌘H).
TEKNINEN
Avaa Holdout-analyysi-ikkunan (katso Luku 4, ID:t W23–W29). Lataa transforms.json-tiedoston, piirtää kamerat 3D-pallona ja mahdollistaa harjoitus/testi-taittojen jaon (kulmittainen tai lineaarinen, 2–8 taittoa). Tuloksena on fold-assignment.json, jota koulutus voi käyttää vastaavissa koulutusasetuksissa testijoukkona.
M42Ohje > BayesOpt-konsoli…
MISSÄ
Valikkorivi → Ohje → BayesOpt-konsoli… (⇧⌘B).
TEKNINEN
Avaa BayesOpt-konsolin (katso Luku 4, ID:t W30–W39). Lataa ennalta määriteltyjä hakuavaruuksia (esim. "MCMC scale-reg + opacity-reg + ssim"), suorittaa Bayesin optimointikokeita asynkronisesti ja näyttää konvergenssikäyrän ja kokeilulokin livenä.
Huomautus: Cmd-Z Muokkaa-valikossa
Toukokuusta 2026 lähtien projektinavigaattori asiantuntijatilassa tukee tuotujen kuvien poistamista miinus-painikkeella tai askelpalauttimella sekä kumoamista Cmd-Z:llä. Tämä Cmd-Z-toiminto näkyy macOS:n Muokkaa-valikossa (jonka SwiftUI tarjoaa) nimellä "Kumoa kuvan poisto", niin kauan kuin poistettu kuva on vielä palautettavissa. Se rekisteröidään standardinmukaisen NSUndoManager-järjestelmän kautta, ei RadianceKitApp.swift-tiedostossa; siksi sille ei ole omaa M-ID-merkintää inventaariossa.
Pikanäppäimet yleiskatsauksessa
| Valikkokohta | Pikanäppäin |
|---|---|
| Tiedosto > Avaa näkymä… | ⌘O |
| Tiedosto > Tallenna näkymä… | ⌘S |
| Tiedosto > Tuo COLMAP / Metashape -työtila… | ⇧⌘I |
| Tiedosto > Uusi projekti | ⇧⌘N |
| Tila > Aloittelijatila | ⌘1 |
| Tila > Asiantuntijatila | ⌘2 |
| Koulutus > Aloita koulutus | ⇧⌘T |
| Näkymä > Siirry muokkaustilaan / Poistu muokkaustilasta | ⇧⌘E |
| Näkymä > Kytke automaattinen kierto | ⌘⌥T |
| Näkymä > Tallenna kuvakaappaus | ⇧⌘S |
| Vie > 3D-formaatit > PLY | ⌘E |
| Ohje > Käyttöopas | ⌘? |
| Ohje > Pikanäppäimet | ⌘/ |
| Ohje > Avaa koulutuslokit… | ⇧⌘L |
| Ohje > Pareto-koontinäyttö… | ⇧⌘D |
| Ohje > Holdout-analyysi… | ⇧⌘H |
| Ohje > BayesOpt-konsoli… | ⇧⌘B |
Muokkaa-valikko (järjestelmän tarjoama, asiantuntijatilassa, kun projektinavigaattorissa on aktiivinen valinta):
| Toiminto | Pikanäppäin |
|---|---|
| Kumoa kuvan poisto | ⌘Z |
| Poista valittu kuva | Askelpalautin / Delete |