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 avattuna — kohdat M1–M6
Tiedosto-valikko avattuna — kohdat M1–M6

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

Tila-valikko aloittelija- ja asiantuntijatilan valitsimilla
Tila-valikko aloittelija- ja asiantuntijatilan valitsimilla

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

Koulutus-valikko Jatka-alivalikolla — kohdat M9–M14
Koulutus-valikko Jatka-alivalikolla — kohdat M9–M14

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

Näkymä-valikko, jossa muokkaustila, kameran ohjaus ja tausta-alivalikko
Näkymä-valikko, jossa muokkaustila, kameran ohjaus ja tausta-alivalikko

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

Vienti-valikko, jossa on kolme alivalikkoryhmää — 3D-formaatit, Media ja Fotogrammetria
Vienti-valikko, jossa on kolme alivalikkoryhmää — 3D-formaatit, Media ja Fotogrammetria

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

Ohje-valikko, jossa on dokumentaatio-, kansio- ja analyysikohtia
Ohje-valikko, jossa on dokumentaatio-, kansio- ja analyysikohtia

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

ValikkokohtaPikanä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):

ToimintoPikanäppäin
Kumoa kuvan poisto⌘Z
Poista valittu kuvaAskelpalautin / Delete