Kullanım Kılavuzu

Bölüm 4 — Yardımcı Pencereler

Ana pencerenin (3D Viewport artı Inspector) yanında RadianceKit, hepsi Help menüsünden açılan üç pencere daha yönetir. Menüde yukarıdan aşağıya beş giriş bulunur: User Guide (⌘?), Keyboard Shortcuts (⌘/), Open Training Logs… (⇧⌘L), Open Exports Folder… ve Manage Storage…. „Open …" ile başlayan iki giriş bir uygulama penceresi açmaz, bunun yerine Finder'ı açar; bu yüzden burada ayrıca ele alınmamıştır.

Üç basit pencere (User Guide, Keyboard Shortcuts, Manage Storage) ve iki klasör menü öğesi (Open Training Logs / Open Exports Folder), her kontrol öğesi için kısa bir giriş alır.

Bölümün sonunda ana pencerenin Inspector'ına dair bir çapraz referans bölümü bulunur: devam eden bir eğitim sırasında canlı kayıp grafiğinden (Live-Loss-Chart) ve Gauss sayısı göstergesinden (Gaussian-Count) anlamlı olarak neler okuyabileceğin.

Kullanıcı Kılavuzu (W1–W4)

Solda kenar çubuğu, sağda render edilmiş Markdown içeriği olan Kullanıcı Kılavuzu penceresi
Solda kenar çubuğu, sağda render edilmiş Markdown içeriği olan Kullanıcı Kılavuzu penceresi

Bu nedir: Uygulamayla birlikte gelen guide_<sprache>.md dosyasını render eden yerleşik bir yardım penceresi. Dil, Settings (General sekmesi → Language) üzerinden veya orada „System" seçiliyse macOS dil tercihlerinden belirlenir. Yerleşim klasiktir: solda tüm başlıkları içeren kenar çubuğu, sağda ana metin.

Tek bir konuyu hızlıca hatırlaman gerektiğinde — yani bir anahtar kelime yardımcısı olarak. Ayrıntılı referans bu kılavuzdur; yerleşik yardım penceresi hızlı başvuru için kısa versiyondur. Her uygulama sürümüyle birlikte güncellenir, ancak içerik olarak daha yüzeysel tutulur.

W1NavigationSplitView (Kenar Çubuğu + Detay)

NEREDE

Help → User Guide (⌘?).

TEKNİK

İçerik ağacı için dar bir kenar çubuğu (en az 180 pt genişlik) ve asıl Markdown içeriği için kaydırılabilir bir detay alanından oluşan iki sütunlu yerleşim. Pencerenin minimum boyutu 700 × 500 pt'dir. İlk açılışta pencere, uygulama paketinden uygun guide_<lang>.md dosyasını yükler (yedek olarak guide_en.md), bunu blok kayıtlarına ayrıştırır (H1–H4 başlıklar, paragraflar, listeler, tablolar, ayırıcı çizgiler) ve kenar çubuğu için başlık yapısını ayrıca çıkarır. Satır içi biçimlendirme (kalın, italik, kod parçası) yerleşik Markdown motoru üzerinden render edilir. Dil, uygulama ayarlarından okunur; Çince (zh-Hans) ve Brezilya Portekizcesi (pt-BR) özel durum olarak tam locale etiketleri şeklinde tutulur, çünkü bu varyantlar zh ve pt'den farklıdır.

W2List (Başlık Kenar Çubuğu)

NEREDE

Kullanıcı Kılavuzu penceresinde sol sütun.

TEKNİK

Geçerli Markdown belgesinin tüm H2 ve H3 başlıklarının listesi. H2 girişleri girintisiz, orta ağırlıklı yazı tipiyle görünür; H3 girişleri solda 16 pt girinti ve azaltılmış ön plan stiliyle görünür. H1 dahil diğer tüm seviyeler — H4 ve daha derin olanlar da — kenar çubuğunu karmaşık hale getirecekleri için görünmez. Çıpa kimlikleri, başlık metninden slugify işlemiyle üretilir (küçük harfe çevirme + boşlukları tireye çevirme + yalnızca harf/sayı/tire filtrelemesi — GitHub'ın Markdown çıpaları için kullandığı algoritmanın aynısı, böylece dokümana giden dış URL'ler de potansiyel olarak aynı çıpaya iner). Liste, yerel macOS stilini kullanır.

W3Button (Başlık → Çıpaya Atlama)

NEREDE

Her kenar çubuğu satırı için bir buton.

TEKNİK

Her kenar çubuğu girişi, geçerli çıpayı ayarlayan ama görsel olarak bir liste öğesi gibi görünen bir butondur. Bir gözlemci değişkeni, ardından 0,3 saniyelik yumuşak bir animasyonla ilgili çıpaya kaydırma atlamasını tetikler. Atlamadan sonra çıpa değeri sıfırlanır, böylece aynı çıpaya sonraki tıklama tekrar tetiklenir (aksi halde değer değişmediği için gözlemci yeniden ateşlenmezdi).

W4ScrollView (Detay İçeriği)

NEREDE

Sağ sütun.

TEKNİK

Tembel (lazy) render kullanan, kaydırılabilir, dikey olarak istiflenen içerik alanı — çünkü daha uzun kılavuzlar kolayca 200'den fazla Markdown bloğu içerebilir; lazy olmayan bir sürüm hepsini aynı anda örneklemek zorunda kalırdı. Her blok kendine özgü bir kimlik alır: ya başlık çıpası (bunu seviyeden bağımsız olarak her başlık alır) ya da bir indeks yer tutucusu. Maksimum genişlik 720 pt, dolgu (padding) yatayda 32 / dikeyde 24'tür, böylece uzun satırlar okunabilir bir yerleşim korur. Tablolar hücre hücre yatay yığınlar ve ayırıcı çizgilerle render edilir; satır içi kod ise yerleşik Markdown motoruyla. Gerçek kod blokları şu anda paragraf olarak işlenir — bu, Yardım penceresinin bilinen bir sınırlamasıdır.

Klavye Kısayolları (W5–W6)

Keyboard Shortcuts Fenster — fünf Gruppen Navigation/Views/Capture/Editor/Training mit Hotkey-Spalte links und Beschreibung rechts
Klavye Kısayolları penceresi — sol tarafta kısayol tuşu sütunu ve sağ tarafta açıklama olan Navigation/Views/Capture/Editor/Training şeklinde beş grup

Beş bölüme ayrılmış statik bir referans listesi. Navigation: Mouse Drag (Orbit/Fly), Shift+Drag/Right-Drag (Pan), Scroll (Zoom), WASD (Fly-Through hareketi), Q/E (Yukarı/Aşağı), F (Orbit/Fly arasında geçiş), Double-click (Yeniden ortalama), Cmd+Scroll (FoV ayarı). Views: R (Kamerayı sıfırla), T (Otomatik döndürme), P (Kamera oynatma), B (Arka plan döngüsü), 0–9 (Training-Cam'e atla 1=%10/5=%50/0=son), Left/Right Arrow (Önceki/Sonraki kamera). Capture: S (Masaüstüne ekran görüntüsü), V (Dönen tabla videosu), C (Kamera bilgisini kopyala). Editor: Tab (Düzenleme modu), Click/Drag (Boyayarak seçim), Option+Click (Seçimi kaldır), X / Delete (Seçimi sil), Cmd-Z (Son silmeyi geri al), [ / ] (Fırça boyutunu küçült/büyüt), Esc (Seçimi iptal et). Training: Option+Space (Eğitimi duraklat/devam ettir), Cmd+E (Sahneyi dışa aktar). Burada bundan fazlası yok — Start, Cancel ve uzatmalara Training menüsünden ulaşırsın (Bölüm 1).

Ne olduğu: Tüm klavye kısayollarının basit, statik bir görünümü — Navigation, Views, Capture, Editor, Training. İçerik sabit olarak gömülüdür ve bir dosyadan yeniden yüklenmez.

Viewport içinde bir şey yapmanın en hızlı yolunu ararken. WASD ile Fly-Through, kamera sıfırlama için R, arka plan döngüsü için B — hepsi burada listelenir.

W5ScrollView (İçerik alanı)

NEREDE

Help → Keyboard Shortcuts (⌘/).

TEKNİK

İçinde dikey bir liste bulunan basit bir kaydırma alanı. Etrafında 20 pt dolgu, kenar çubuğu navigasyon ağacı yok (liste yeterince kısa). İçerik beş bölüme ayrılmış olarak gruplanmış (Navigation, Views, Capture, Editor, Training). Her tuş kombinasyonu için her iki sütunda da çevrilebilir metin içeren bir satır var. Sol sütun (tuş kodu) 180 pt genişlikte sabitlenmiş, böylece sağdaki açıklamalar dikey olarak hizalı kalıyor. Kaydırma dışında hiçbir etkileşim yok — bir satıra tıklamak hiçbir şey tetiklemez, klavye kısayolları menüde ve viewport üzerinde gerçek klavye modifikatörleridir.

W6VStack (Kısayol bölümleri)

NEREDE

ScrollView'ın içinde.

TEKNİK

16 pt aralıklı, sola hizalı şekilde üst üste dizilmiş bölümler. Beş bölümün her birinde bir başlık + satır dizisi bulunur. Başlıklar ikincil bir alt başlık stili kullanır — bilinçli olarak Title formatı kullanılmamıştır, çünkü bölümlerin gezilebilir olması gerekmez. İçerik bilinçli olarak düz tutulmuştur (disclosure yok, arama yok, filtre yok), böylece bileşen her macOS sürümünde değişmeden çalışır ve dosya okunabilir kalır.

Depolamayı Yönet (W7–W12)

Manage Storage Fenster — Header zeigt „1,356 items · 55.1 GB total”, Tabelle mit Export-PLY-Dateien sortiert nach Datum, jeweils Icon + Dateiname + Größe + Datum
Manage Storage penceresi — Üst kısımda „1,356 items · 55.1 GB total" yazıyor, tabloda tarihe göre sıralanmış Export-PLY dosyaları, her satırda simge + dosya adı + boyut + tarih

RadianceKit tarafından yönetilen tüm dosyaların tablo görünümü. Üstte 1.356 öğe, 55,1 GB toplam boyut sayılıyor. Üstteki araç çubuğu: „Show in Finder" + „Refresh". Her satırda: export simgesi, dosya adı (örn. training_20260718T194416Z.ply), export tarihi, boyut (burada 7,8 MB ile 2,24 GB arasında değişiyor), büyüteç simgesi (Reveal) ve çöp kutusu simgesi (Move to Trash). Sıralama önce kategoriye, kategori içinde ise tarihe göre yapılır, en yeni en üstte. Bu çekimde PLY export'ları ağırlıkta, çünkü bu depoda özellikle eğitim sonuçları saklanmış.

Ne olduğu: RadianceKit'in ~/Documents/RadianceKit/ altında sakladığı her şey için bir disk kullanım özeti — Logs, Exports, Scenes, Capture-Bundles (iOS eşlik uygulamasından), Imports (giriş görüntülerinin ara kopyaları). Her girişte bayt cinsinden bir boyut ve iki düğme var: „im Finder anzeigen" ve „in den Papierkorb verschieben". Bu KESİNLİKLE otomatik bir temizleme değildir — uygulama kendiliğinden hiçbir şey silmez; her girişe sen karar verirsin. Bu pencere çevrilmiştir: Türkçede „Depolamayı Yönet" olarak geçer, üstteki iki düğme „Finder'da Göster" ve „Yenile", satır düğmeleri ise „Finder'da Göster" ve „Çöp Kutusuna Taşı" olarak adlandırılır. Aşağıdaki girişlerdeki İngilizce adlar İngilizce sürümden gelen isimlerdir.

Disk dolmaya başladığında. Özellikle loglar birikir (her eğitim denemesi için bir JSONL, artı _qualityMetrics.json); tabii export'lar da (PLY %100 ham veri, her export için bir tane). Bir çökmeden sonra da faydalıdır, çünkü Imports ara depolama dizininde giriş görüntülerinin eski kopyaları kalmış olabilir.

W7„Show in Finder" düğmesi

NEREDE

Storage tarayıcı penceresinin sağ üstünde, üst kısımda.

TEKNİK

RadianceKit veri klasörünü Finder'da açar — tam olarak bu pencerenin içeriğini listelediği dizini. Böylece klasör yapısını (Logs, Exports, Scenes, Captures, Imports) doğrudan görürsün ve dosyaları Finder üzerinden kendin de taşıyabilir ya da kopyalayabilirsin. Bu eylem yeni bir Finder penceresi açar; penceredeki liste bu sebeple değişmez — onun için „Refresh" (W8) vardır.

W8„Refresh" düğmesi

NEREDE

Üst kısım, Finder düğmesinin yanında.

TEKNİK

Kullanıcı tarafından tetiklenen asenkron bir görev üzerinde çalışan bir arka plan taramasını başlatır, böylece büyük dizin ağaçlarının taranması arayüzü kilitlemez. Asıl gezinme, bilinen her alt klasörü (Logs, Exports, Scenes, Captures, Imports) dolaşır ve her doğrudan alt öğe için bir depolama girişi oluşturur. Her giriş için özyinelemeli boyut belirlenir — tercihen gerçek disk kullanımı (APFS sabit bağlantı paylaşımı dahil), buna alternatif olarak mantıksal dosya boyutu kullanılır.

W9List (Depolama girişleri)

NEREDE

Üst kısmın altındaki ana içerik.

TEKNİK

Her satırda şu düzene sahip bir liste: kategoriye özgü SF Symbol simgesi (Logs için belge, Exports için yukarı ok, Scenes için küp, Capture-Bundles için iPhone, Imports için tepsi), ad + alt başlık (Kind etiketi + biçimlendirilmiş değişiklik tarihi), sağda bayt sayacı (sağa hizalı, monospace), Reveal düğmesi (büyüteç simgesi), Trash düğmesi (çöp kutusu). Sıralama: birincil olarak Kind'a göre (önce Scenes, ardından Exports, Logs, Captures, Imports, Other), ikincil olarak değişiklik tarihine göre azalan sırayla (en yeni en üstte). Tarama hâlâ sürüyorsa, bu alanda bunun yerine bir „Scanning…" ilerleme göstergesi görünür. Hiçbir şey bulunmadıysa, tepsi simgeli boş durum gösterimi görünür.

W10Satır düğmesi „Reveal in Finder"

NEREDE

Her satırda, sağda büyüteç simgesi.

TEKNİK

Finder'ı açar ve belirli öğeyi (dosya veya klasör) seçili hale getirir. W7'den farkı: W7 kök dizini açar; W10 ise tam olarak bu tek girişi işaretler. Pratik iş akışı: büyük bir girişi tespit et, büyüteçe tıkla, ardından örneğin harici bir birime kopyala.

W11Satır düğmesi „Move to Trash"

NEREDE

Her satırda, büyütecin hemen yanında çöp kutusu simgesi.

TEKNİK

Onay iletişim kutusunu (W12) tetikler. Ancak onaylandıktan sonra macOS'un standart „çöp kutusuna taşı" işlemi çalışır (yani geri alınabilir, doğrudan silme değil). Başarılı bir çöpe taşımanın ardından giriş listeden kaldırılır ve toplam bayt sayacı güncellenir. Hata durumunda modal bir hata iletişim kutusu gösterilir.

W12ConfirmationDialog (Silme onayı)

NEREDE

W11 tarafından tetiklenir, macOS sayfası (sheet) olarak gösterilir.

TEKNİK

Dinamik başlıklı „Delete <name>?" standart onay iletişim kutusu ve girişin çöp kutusuna gideceğini ve oradan geri yüklenebilir olduğunu (çöp kutusu boşaltılana kadar) açıkça belirten bir mesaj satırı. İki düğme: yıkıcı eylem olarak (kırmızı gösterilen) „Move to Trash" ve otomatik Esc bağlantılı „Cancel". İletişim kutusu, sadece bu pencereyi engellemesi anlamında non-modal'dır, tüm uygulamayı değil — bu, geri alınabilir silmeler için macOS standardıdır.

Ana Pencere: Kayıp Geçmişi ve Gaussian Sayısı (I39–I41, Çapraz Referans)

Ana penceredeki Inspector göstergelerinden üçü ayrı bir açıklamayı hak ediyor, çünkü bunlar devam eden bir eğitim sırasında sürekli olarak görülür ve verilerin ne zaman sağlıklı göründüğüne dair önemli kurallar vardır. Göstergeler, Inspector'ın İlerleme bölümünde, açılıp kapanabilen Kayıp Geçmişi grubunda yer alır (bkz. Bölüm 2 — Inspector) ve eğitim ilerlemesini anlamaya yardımcı olur.

Loss eğrisi ne zaman sağlıklıdır? Sağlıklı bir Loss eğrisi üç aşama gösterir: (1) Warmup — ilk 200–500 iterasyonda loss sahneye bağlı olarak yüksekten (L1+SSIM kombinasyonu için tipik olarak 0.15–0.25) yaklaşık yarısına dik bir şekilde düşer. Bu aşamada loss düşMÜYORSA, genellikle girdi hatalıdır (bozuk görüntüler, kötü SfM pozları, çok küçük başlangıç Gaussian sayısı). (2) Densification — yaklaşık 500 ile densifyUntilIteration (klasik olarak 15K, MCMC'de 20K veya 25K'ya kadar) arasında loss düşmeye devam eder, çoğu zaman Densify işlemleri yeni Gaussian'lar eklediğinde ve optimizer bunları kullandığında küçük aşağı sıçramalarla. Gaussian sayısı bu aşamada artar. (3) Refinement — bundan sonra loss giderek düzleşen bir kuyruğa girer. Yönlendirme için tipik son değerler: iyi aydınlatılmış bir nesne sahnesi (örneğin P4 Quality ile Tanks-&-Temples Truck) L1 ≈ 0.023 civarına ulaşır, Mip-NeRF 360'daki gibi geniş dış mekan sahneleri doğal olarak bunun üzerinde kalır (0.04–0.07).

Bir plato ne anlama gelir? Bir plato (Loss eğrisi birkaç bin iterasyon boyunca yatay seyreder) iki şekilde yorumlanabilir: (a) model yakınsamıştır, daha fazla eğitim bir şey kazandırmaz — bu iyi durumdur. (b) model takılı kalmıştır (yerel minimum, kötü gradyan bilgisi, buffer sınırında bir cap) — bu kötü durumdur. İkisi de grafikte aynı görünür. Ayrım için: Gaussian sayısına bak. Eğer o da düzse VE MCMC cap değerine yakınsa (örneğin P8 Quality (MCMC) preset'inde 150K'nın 150K'sı), sınırdasın — ya cap'i artır ya da platoyu kabul et. Eğer Gaussian sayısı hâlâ artıyor ama loss düşmüyorsa, bu takılı kalma durumudur.

Ne zaman durdurmalı, ne zaman eğitime devam etmeli? Kural: 10K iterasyon boyunca minimum loss'ta iyileşme yoksa → durdur, ek iterasyonlar boşa gider. Bundan önce: Training menüsü → Continue Training → „+5,000 iterations" üzerinden sınırda bir iyileşme görüyorsan bir uzatma daha ekleyebilirsin (bunun için bir klavye kısayolu yoktur). Dikkat: MCMC'de plato genellikle gerçektir — cap doğal sınırdır.

Gaussian sayısı platosu „bitti" sinyali DEĞİLDİR. Bu yalnızca MCMC'nin cap'e ulaştığı veya Classic Densification'ın sınırına dayandığı anlamına gelir. Gerçek „bitti" sorusunu ancak bağımsız bir test setinde PSNR/SSIM/LPIPS yanıtlayabilir. Bağımsız test seti, kamera setinin eğitim ve test bakış açılarına adil bir bölünmeye izin verip vermediğini de gösterir.

PSNR/Holdout gerçektir, loss sadece bir vekildir (proxy). Loss göreceli bir metriktir: modelin eğitim görünümlerine uyum sağlaması sırasında düşer. Ancak düşük bir loss otomatik olarak iyi model anlamına gelmez — eğer model eğitim görüntülerini ezberlemişse (overfitting), loss küçük olur ama görülmemiş görünümlerdeki (Holdout) PSNR kötü olur. Bu yüzden: nihai kalite değerlendirmesi için her zaman Holdout metriklerine bak, sadece son loss değerine değil.

Kural-Kutusu Kısayolu

- User Guide ve Keyboard Shortcuts statik yardım kaynaklarıdır — anahtar kelime sorularında hızlıdır, derinlemesine bilgi için elindeki bu kılavuzu kullan. - Disk boş alanı %10'un altına düştüğünde Manage Storage'ı aç. Loglar ve Imports-Staging genellikle asıl suçlulardır. - Loss-Plateau ve Gaussian-Count-Plateau ayrı ayrı yorumlanmalıdır. Cap limiti bir „bitti" sinyali değildir. Gerçek kaliteyi yalnızca Holdout-PSNR ölçer. - Min-Loss iyileşmesi olmadan 10K iterasyon geçtiyse → eğitimi durdur.