Detailed technical specifications and how each feature works under the hood.
Konva.js powered 2D canvas with advanced rendering, zoom, pan, and grid snapping for precise fixture placement.
Lumina uses Konva.js, a high-performance 2D canvas library, to render the lighting design. The canvas supports:
Zoom Control: 0.3x to 5x magnification using mouse wheel. Perfect for detailed work or overview.
Pan: Hold spacebar + drag or use middle mouse button to pan across your floor plan.
Grid Snap: Toggle snap-to-grid (500mm intervals) for alignment without thinking about coordinates.
Multi-Floor Support: Design multiple floors independently. Switch between floors with tabs.
Multi-Room Support: Create unlimited rooms per floor. All rooms visible simultaneously—active in bright cyan, inactive rooms dimmed.
Fixture Placement: Click to place, drag to position. Double-click to delete. Precision positioning without frustration.
IES Lumen Method with Room Cavity Ratio and Utilization Factor for accurate light distribution analysis.
IES Lumen Method: Industry-standard calculation using the Inverse Square Law and Cosine Law.
Room Cavity Ratio (RCR): Automatically calculated from room dimensions. Determines how light distributes in different room shapes (long narrow vs square).
Utilization Factor (UF): Lookup table based on ceiling/wall/floor reflectance. Shows how much light is actually used vs wasted.
Maintenance Factor (MF): Default 0.80 (20% light loss over time). Accounts for fixture depreciation and dust accumulation.
Real-Time Updates: Every time you move a fixture, add one, or change settings, lux values recalculate instantly.
Status Indicators: GOOD (on target), OVERLIT (too bright), UNDERLIT (too dim), DIM (critically low).
6-stop color gradient heat map with grid-based lux distribution showing light coverage instantly.
Grid Resolution: The room is divided into a 0.5m × 0.5m grid. Each grid point calculates lux using Inverse Square Law.
Inverse Square Law: Light intensity decreases with the square of distance: E = I / d²
Cosine Correction: Accounts for angle of incidence. Light hitting at 60° is less intense than perpendicular.
6-Stop Color Gradient: Blue (150 lux) → Cyan → Green → Yellow → Orange → Red (600+ lux). Easy visual assessment.
Clipped to Boundary: Heat map respects room edges. No calculation outside walls.
Lux Legend: On-screen legend shows exact lux values for each color band.
Automatic DALI addressing, bus management, and driver schedule generation with visual address badges.
Toggle & Auto-Assign: Click DALI button. System instantly assigns addresses (D:1, D:2, ...) to all unprotocol'd fixtures.
Node Limit Management: Choose 64 or 128 node limit. When limit reached, system auto-creates new bus line.
Bus Cable Calculation: Calculates total bus cable length + 20% for bends. Shows in electrical panel.
Driver Schedule: Automatically generates driver requirements. Shows mA output, dimming type (DALI 2.0), and node count.
Topology Selection: Choose DAISY (series), STAR (hub), or MIXED topology. System validates wire runs.
Status Indicator: SAFE (< 80% load), WARNING (80-95% load), FULL (at capacity). Visual on canvas.
Upload PDF, PNG, or JPG floor plans with high-quality rendering and room boundary drawing.
File Support: PNG, JPG (rasterized immediately). PDF (rendered via PDF.js at 4x quality).
PDF Rendering: PDFs loaded via CDN worker for security. Rendered at 4x scale for sharp detail without huge file sizes.
Background Layer: Floor plan becomes canvas background. Grid hides automatically when plan uploaded.
Room Boundary Drawing: Click and drag directly on floor plan to draw rooms. Snaps to grid if enabled.
Dimension Popup: After drawing, popup asks for exact width/height. Unit selector (m/mm/ft/in) in one click.
Multi-Floor: Upload different plans per floor. All managed within one project.
PDF reports, Excel BOQ, and PNG snapshots ready for client delivery and procurement.
PDF Export: 8-page professional report including cover, lux summary, fixture schedule, electrical summary, room layouts, DALI addressing, and design notes.
Excel BOQ: 3-sheet workbook: Fixture List (quantities, wattages, costs), Electrical Components (drivers, cables, control), and Summary (costs by category).
PNG Export: High-resolution canvas snapshot (2x scale) for presentations, emails, or archival.
PDF Generation: Server-side rendering ensures consistent output. Uses PDFKit library for reliable generation.
Excel Generation: Uses ExcelJS for structured worksheets with formatting, formulas, and charts.
File Management: All exports timestamped, stored in user project folder, downloadable anytime.
| Feature | Technical Implementation | Real-Time? | Accuracy |
|---|---|---|---|
| Canvas & Zoom | Konva.js with WebGL acceleration | ✓ | Sub-pixel rendering |
| Lux Calculation | IES Lumen Method + Inverse Square Law | ✓ | ±2% at working plane |
| Heat Map | 0.5m grid + Cosine-cube law | ✓ | ±3% per point |
| DALI Addressing | Sequential auto-assign algorithm | ✓ | 100% compliant (IEC 62386) |
| Bus Calculation | Cumulative current + cable ohm calculation | ✓ | ±5% voltage drop |
| Floor Plan Upload | PDF.js CDN rendering (4x scale) | ✓ | Lossless preservation |
| Room Dimensions | Firebase Firestore with geometry validation | ✓ | 0.01m precision |
| Electrical Panel | MCB sizing tables + phase rotation logic | ✓ | IEC 60898 compliant |
| PDF Export | PDFKit server-side rendering | On-demand | 300 DPI A4 |
| Excel BOQ | ExcelJS with formulas & formatting | On-demand | Live cell formulas |
| Project Storage | Firebase Firestore (asia-south1) | ✓ | Real-time sync |