Open, scriptable emergency-lighting calculations, in pure Rust.
luxpath checks emergency escape lighting designs against EN 1838:2024: escape routes, open (anti-panic) areas, high-risk task areas and points of emphasis. You describe a floor in a readable text file and give it photometric files (IES, EULUMDAT). luxpath computes the illuminance and tells you which requirements pass, which fail and why.
Status: pre-alpha (M3). Photometric files (IES, EULUMDAT), the calculation engine and the scene format work, and
luxpath checkcomputes a scene's emergency lighting. No EN 1838 requirement is checked yet (M4), and nothing is validated against another tool (M6): do not rely on the results. See ROADMAP.md.
Lighting designers already have free tools (DIALux evo, ReluxDesktop), but they are closed, mostly Windows-only and GUI-only. luxpath aims to be:
- Open and transparent. Every number can be traced to a formula and a clause of the standard.
- Scriptable and reproducible. Scenes are diffable text, results are JSON, and the CLI has CI-friendly exit codes.
- Everywhere. macOS, Linux, Windows, and the browser via WebAssembly. One core can also be embedded as a calculator on a manufacturer's website.
- Current. Built for the 2024 edition (full escape-route width) from day one.
cargo run -p luxpath-cli -- check examples/corridor.toml # emergency lighting of an example scene
cargo run -p luxpath-cli -- point 2.5 3 # direct illuminance 3 m away from a source mounted at 2.5 m
cargo run -p luxpath-cli -- photometry crates/photometry/tests/fixtures/downlight.ldt # read an IES or LDT file
cargo xtask ci # every quality gate
cargo xtask parity # feature progress by milestone| Document | Holds |
|---|---|
| ROADMAP.md | One-page summary: stage, next steps, progress log |
| docs/roadmap.md | Milestones M0–M9 with exit criteria and estimates |
| docs/gaps.md | Every known shortfall, ranked: the work list |
| docs/status.md | Where work stands right now, blockers, open questions |
| docs/architecture.md | Crates, layers, data flow, design decisions |
| docs/scene-format.md | The scene file format that luxpath check reads |
| docs/standards-parity.md | EN 1838:2024 requirements and their implementation status |
| docs/research.md | Market and standards research behind the project |
| parity/features.toml | Machine-readable feature checklist (cargo xtask parity) |
| CONTRIBUTING.md / SECURITY.md | How to help, and how to report wrong results and vulnerabilities |
| AGENTS.md / CLAUDE.md | Rules and working instructions for contributors and agents |
luxpath produces calculations, not certificates. Emergency lighting is life-safety equipment: a competent designer remains responsible for every design, and for checking it against the standard and national regulations in force.
Licensed under either of Apache License 2.0 or MIT license, at your option.