Odaxium

Mac için aydınlatma hesap ve simülasyon uygulaması — iç mekân aydınlatmasını DIALux'e gitmeden Mac'te tasarlayıp hesaplamak için. Hesap çekirdeği Rust'ta yazıldı ve her özelliği bilimsel referans motor Radiance ile karşılaştırılarak doğrulandı.

English below.

Neler yapıyor

• AutoCAD'den hazır proje. Planı AutoCAD'de çizin; birkaç katman kuralıyla (ODA, ODA_AD, ARMATUR, MOBILYA, PENCERE, KAPI, GECIS) odalar, yükseklikler, hedefler, armatürler, mobilya ve açıklıklar Odaxium'a hazır gelir. Ayrıntı: Odaxium DXF kuralı, şablon fixtures/sablon/odaxium_sablon.dxf, örnek fixtures/ornek_ev_kural.dxf.
• Aydınlık hesabı. Gerçek boyutlu armatürle doğrudan ışık, yüzey yaması radyozitesiyle yansıyan ışık; çalışma düzleminde Em, Emin, Emax, U0; izolüks ve ısı haritası. Tek oda ~15–400 ms: armatürü sürüklerken sonuç canlı değişir.
• Hedefe göre boyutlandırma. Em/U0 hedefini tutan en az armatür sayısını gerçek hesapla bulur.
• UGR (kamaşma) CIE 117 ile, gözlemci 1.20 m, 4 bakış yönü; ugr_max hedef denetimi.
• Mobilya, pencere, kapı, kapısız geçiş. Mobilya gölge yapar ve yansıtır; pencere camdır (ışık dışarı kaçar); kapısız geçişten komşu odaya ışık geçer (eşli odalar tek radyozite sisteminde çözülür).
• Gün ışığı faktörü (DF %) CIE kapalı gökyüzüyle, pencereli her oda için.
• Görünüm. Işıklı 3B (yüzeyler hesaplanan parlaklıklarıyla, pozlama ve yanlış renk kipiyle) ve Radiance ile fotogerçekçi Fotoğraf.
• Gerçek üretici verisi. IES (LM-63) ve EULUMDAT (LDT) okur; 16 bin gerçek üretici dosyasında hatasız ayrıştırma, şüpheli dosyada uyarı.
• Çıktılar. HTML rapor ve DIALux devir paketi (plan.dxf, armatür/oda tabloları, adım adım rehber).

Işıklı 3B	Fotoğraf (Radiance)

Doğrulama

Her özellik Radiance ile aynı sahnede karşılaştırıldı (ayrıntı ve tablolar: docs/TEKNIK.md):

Özellik	Odaxium ↔ Radiance
Yapay ışık, örnek ev (10 oda)	ortalama aydınlık farkı ≤ %0.91
Mobilya gölgesi	≤ %0.58 (döşemede)
Gerçek boyutlu armatür, yarı gölge	yerel fark %75 → %2.5
Odalar arası ışık (armatürsüz komşu oda dahil)	≤ %0.93
Gün ışığı faktörü	ortalama ≤ %1.34
UGR (evalglare), odanın en kötü gözlemcisi	+0.31'e kadar (düşük UGR'li gözlemcide −3.85'e kadar)
Işıklı 3B yüzey parlaklığı	≤ %2.1 (referans sahnede bakım faktörü tek kez)

Ekran görüntüleri ve doğrulama sayıları uydurma bir örnek evden (py/ornek_ev.py, 3+1, net 105 m²). Bilinen eksikler (UGR'de konum indeksi sınırı, armatür gövdesi gölgesi, yalnız kapalı gökyüzü…) docs/TEKNIK.md'de. Odaxium bir tasarım aracıdır; resmî proje teslimi için sonuçları kendi standart ve yazılımınızla teyit edin.

Kurulum (macOS, Apple Silicon)

# Gerekenler: Rust (cargo), Python 3, Tauri CLI; doğrulama ve Fotoğraf için Radiance 6
cargo install tauri-cli --version "^2" --locked
python3 -m venv .venv && .venv/bin/pip install -r py/requirements.txt
./scripts/build_app.sh            # → target/release/bundle/macos/Odaxium.app
open target/release/bundle/macos/Odaxium.app

Radiance (doğrulama ve Fotoğraf için) ~/.local/opt/radiance altında beklenir; kurulumu ve komut satırı kullanımı (lux calc, lux size, lux photometry, Radiance karşılaştırması) docs/TEKNIK.md'de.

Yapı

Klasör	İçerik
crates/lux-core	Hesap çekirdeği (Rust): fotometri, radyozite, alan kaynak, UGR, gün ışığı, odalar arası ışık
crates/lux-cli	lux komut satırı
crates/lux-app	Masaüstü uygulaması (Tauri v2; arayüz düz HTML/CSS/JS, plan SVG, 3B Three.js)
py/	DXF içe aktarma, Radiance sürücüsü, rapor, DIALux paketi
schema/	Proje dosyası şeması (.odaxium = JSON)
fixtures/, tests/	Örnek projeler (uydurma örnek ev fixtures/ornek_ev*.dxf), doğrulama testleri

Lisans

MIT. Üçüncü taraf: Three.js (MIT), Montserrat yazı tipi (SIL OFL 1.1). fixtures/fotometri/ içindeki IES dosyaları sentetiktir (ölçüm değildir).

---

English

Odaxium is a lighting design and calculation app for the Mac: plan and verify interior lighting without leaving macOS. The calculation core is written in Rust, and every feature is validated against Radiance, the scientific reference renderer.

• From AutoCAD to a ready project: a small layer convention (rooms, labels with targets, luminaire blocks, furniture, windows, doors) turns a DXF plan into rooms with heights, targets, luminaires and openings — see the DXF rule (Turkish).
• Illuminance: area-source direct light plus patch radiosity for inter-reflections; Em, Emin, Emax, U0, isolux and heat maps; single-room recalculation fast enough to follow a dragged luminaire.
• Sizing to target: finds the minimum number of luminaires that meets Em/U0 by real calculation.
• UGR (CIE 117, seated observers, four view directions), daylight factor (CIE overcast sky), furniture, windows, doors and doorless passages (light flows into the next room).
• Views: lit 3D (surfaces painted with their computed luminance, exposure and false-colour modes) and a photorealistic Photo rendered with Radiance.
• Manufacturer data: reads IES LM-63 and EULUMDAT; parsed 16 000 real manufacturer files without errors, warns on suspicious files.
• Outputs: HTML report and a DIALux hand-over package.

Validation against Radiance (details in docs/TEKNIK.md, Turkish): mean illuminance within 0.91 % on a synthetic 10-room sample flat, inter-room light within 0.93 %, daylight factor within 1.34 %, room-worst UGR within +0.31 (low-UGR observers differ more, up to −3.85), lit-3D surface luminance within 2.1 % (reference scene with the maintenance factor applied once; the Photo view currently applies it twice, see known issues). The UI and docs are in Turkish. Odaxium is a design tool; confirm results for official submissions.

Build: cargo install tauri-cli --version "^2" --locked, create the Python venv (python3 -m venv .venv && .venv/bin/pip install -r py/requirements.txt), then ./scripts/build_app.sh.

License: MIT. Third-party: Three.js (MIT), Montserrat (SIL OFL 1.1). The IES files in fixtures/fotometri/ are synthetic, not measurements.