Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ luxpath's one-page summary. Details live in:

| Date | Change |
|---|---|
| 2026-10-25 | EN 1838:2024 clause map: `docs/standards-parity.md` cites the 2024 clause of every requirement, from the table of contents in the free SIST preview (values stay unverified, gap 4), and lists what 2024 added: specific areas (5.4), safety signs (6), local area and standby lighting (7), the annexes. New parity entries `en1838.specific-areas`, `en1838.local-area`, `en1838.safety-signs`. |
| 2026-10-22 | Public: the repository opened after a licence check; vulnerability reporting, topics, protected `main` with hosted CI on Linux, macOS and Windows (its first Windows run found a line-ending bug in a test, fixed). |
| 2026-10-21 | Routes can be given as their floor outline (BIM models draw corridors as rooms), for Ashlar's emergency-lighting plugin (R2.9a). |
| 2026-10-21 | Walls block light (gap 16): `[[wall]]` in scenes, sight lines tested against every wall piece; the corridor example's minimum drops from 1.45 to 0.60 lx once light no longer passes through its corner; 100 luminaires × 10,000 points × 36 walls in about 90 ms. |
Expand Down
4 changes: 2 additions & 2 deletions docs/gaps.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Gaps: what luxpath cannot do yet

> **Last updated:** 2026-10-21 · **Change:** walls block light: row 16 narrowed to point luminaires (no longer an alpha blocker)
> **Last updated:** 2026-10-25 · **Change:** row 4: clause numbers from the 2024 table of contents; values still unverified

Every known shortfall, ranked by user impact. This is the work list: pick from the top, and remove or update a row
in the same PR that closes it. **[alpha blocker]** rows fail the alpha gate (ROADMAP.md).

| # | Gap | Why it ranks here | Milestone | Est. h |
|---|---|---|---|---|
| 4 | **[alpha blocker]** Requirement values not verified against EN 1838:2024 text | Values in `standards-parity.md` come from secondary sources | M4 | 3 + buying the standard |
| 4 | **[alpha blocker]** Requirement values not verified against EN 1838:2024 text | Values in `standards-parity.md` come from secondary sources; since 2026-10-25 the clause numbers come from the 2024 table of contents (free preview), the values still do not | M4 | 3 + buying the standard |
| 6 | **[alpha blocker]** No EN 1838 checks | The project's purpose | M4 | 25–40 |
| 7 | **[alpha blocker]** No independent validation | Trust: nobody should rely on unvalidated numbers | M6 | 10–20 + human |
| 10 | No reports beyond the terminal | Designers hand over documents | M5 | 15–25 |
Expand Down
8 changes: 8 additions & 0 deletions docs/research.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,14 @@ claims are marketing until checked.
Designs made to the 2013 centre-line rule may no longer comply. This is a concrete reason for a new tool.
- Also new: a procedure for escape routes through open areas, local area lighting, more detail for points of
emphasis and high-risk areas, and an informative Annex C (lockdown and prolonged power loss).
- **Free preview (2026-10-25):** SIST, the Slovenian body, and iTeh publish the first 11 pages of SIST EN 1838:2025
free (kept in `plan/standards/`, never committed). It ends inside clause 3, so it holds no requirement value, but
its table of contents gives the 2024 clause numbers (now in `docs/standards-parity.md`) and its foreword lists the
changes from 2013: full-width escape routes, more detail for points of emphasis and specific areas of hazard
(new 5.4: toilets and changing rooms, public indoor swimming pools, plant rooms), and the lockdown considerations.
It also shows local area lighting (7.1) and standby lighting (7.2) as clauses of their own, safety signs as
clause 6, informative annexes on durations and activation times (A) and on-site measurement (B), and national
A-deviations (D).
- Read with EN 50172:2024.

## 3. Existing tools
Expand Down
67 changes: 42 additions & 25 deletions docs/standards-parity.md
Original file line number Diff line number Diff line change
@@ -1,38 +1,55 @@
# EN 1838:2024 coverage

> **Last updated:** 2026-10-16 · **Change:** initial, from secondary sources
> **Last updated:** 2026-10-25 · **Change:** clause numbers from the 2024 edition's table of contents; rows for
> specific areas (5.4), safety signs (6), local area and standby lighting (7)

The requirements luxpath checks, one row each. **Every value below is "unverified"**: it comes from manufacturer
guides and summaries (see `docs/research.md`), not from the standard's text. Clause numbers are left blank until
someone checks the purchased standard (gap 4). Values are facts restated in our own words; never paste the
standard's text here (`AGENTS.md` §1.1).
guides and summaries (see `docs/research.md`), not from the standard's text (gap 4). Values are facts restated in
our own words; never paste the standard's text here (`AGENTS.md` §1.1).

Context: EN 1838:2024 replaced the 2013 edition. National bodies publish the same text under their own number and
year: **UNI EN 1838:2025** in Italy (in force 6 Feb 2025, [UNI store](https://store.uni.com/uni-en-1838-2025)),
BS EN 1838:2024 in the UK (31 Dec 2024), NEN-EN 1838:2025 in the Netherlands. The requirements are identical. It is meant to be read with **EN 50172:2024** (system design, duration, maintenance). National rules may add
to it, for example longer durations.
**Clause numbers** come from the 2024 edition's table of contents, read in the free preview SIST and iTeh publish
(SIST EN 1838:2025, kept in the git-ignored `plan/standards/`). The preview ends inside clause 3 (terms and
definitions), so it confirms the structure and the list of changes, not a single requirement value. "Not in the
preview" means the table of contents does not show which clause holds the requirement.

Context: EN 1838:2024 replaced the 2013 edition. Every CEN member adopts the same text under its own number and
year (the European foreword names the countries, Italy and Slovenia among them): **UNI EN 1838:2025** in Italy (in
force 6 Feb 2025, [UNI store](https://store.uni.com/uni-en-1838-2025)), BS EN 1838:2024 in the UK (31 Dec 2024),
NEN-EN 1838:2025 in the Netherlands, SIST EN 1838:2025 in Slovenia. National legal deviations ("A-deviations") are
listed in Annex D, which the preview does not reach. It is read with **EN 50172:2024** (system design, duration,
maintenance). National rules may add to it, for example longer durations.

The changes from 2013 the foreword lists: escape-route requirements now cover the route's **full width**; more
detail for **points of emphasis** and **specific areas of hazard**; considerations for lockdowns and long periods
without power, as an informative annex.

## Requirements

| Requirement | Value (unverified) | Clause | Parity id | Status |
|---|---|---|---|---|
| Escape routes: minimum horizontal illuminance on the floor **over the full width** (new in 2024; 2013 used the centre line and a central band) | ≥ 1 lx | | `en1838.escape-route-full-width` | planned |
| Escape routes: uniformity | max/min ≤ 40:1 | | `en1838.escape-route-uniformity` | planned |
| Escape routes through open areas: new procedure in 2024 | to read | | `en1838.escape-route-full-width` | planned |
| Open (anti-panic) areas: minimum horizontal illuminance on the floor, excluding a border | ≥ 0.5 lx, border 0.5 m | | `en1838.open-area` | planned |
| Open areas: which areas need it (2013 summaries say ≥ 60 m², or by risk assessment) | to read | | `en1838.open-area` | planned |
| Open areas: uniformity | max/min ≤ 40:1 | | `en1838.open-area` | planned |
| High-risk task areas: maintained illuminance relative to normal lighting | ≥ 10 % of normal and ≥ 15 lx (2013 summaries) | | `en1838.high-risk` | planned |
| High-risk task areas: uniformity | ≥ 0.1 (2013 summaries) | | `en1838.high-risk` | planned |
| Points of emphasis and safety equipment (exits, changes of direction and level, fire-fighting, first aid, call points): illuminance near them; more detail in 2024 | to read | | `en1838.points-of-emphasis` | planned |
| Local area lighting (new in 2024) | to read | | — | not yet planned |
| Adaptive escape-route emergency lighting (in scope per UNI's summary) | to read | | — | not yet planned |
| Disability glare: maximum luminous intensity by mounting height, in the field of view | table by mounting height | | `en1838.glare-limits` | planned |
| Colour rendering of emergency light | Ra ≥ 40 | | `en1838.declarations` | planned |
| Response time: share of required illuminance within a time limit | 50 % within 5 s, 100 % within 60 s | | `en1838.declarations` | planned |
| Duration | minimum 1 h (often longer by national rules) | | `en1838.declarations` | planned |
| Annex C: lockdown and prolonged power loss (new in 2024) | informative | | — | out of scope |
| Safety signs (luminance, contrast, viewing distance) | to read | | — | later |
| Escape routes: minimum horizontal illuminance on the floor **over the full width** (new in 2024; 2013 used the centre line and a central band) | ≥ 1 lx | 5.1 | `en1838.escape-route-full-width` | planned |
| Escape routes: uniformity | max/min ≤ 40:1 | 5.1 | `en1838.escape-route-uniformity` | planned |
| Escape routes through open areas: new procedure in 2024 | to read | 5.1 or 5.2, not in the preview | `en1838.escape-route-full-width` | planned |
| Open (anti-panic) areas: minimum horizontal illuminance on the floor, excluding a border | ≥ 0.5 lx, border 0.5 m | 5.2 | `en1838.open-area` | planned |
| Open areas: which areas need it (2013 summaries say ≥ 60 m², or by risk assessment) | to read | 5.2 | `en1838.open-area` | planned |
| Open areas: uniformity | max/min ≤ 40:1 | 5.2 | `en1838.open-area` | planned |
| High-risk task areas: maintained illuminance relative to normal lighting | ≥ 10 % of normal and ≥ 15 lx (2013 summaries) | 5.3 | `en1838.high-risk` | planned |
| High-risk task areas: uniformity | ≥ 0.1 (2013 summaries) | 5.3 | `en1838.high-risk` | planned |
| Points of emphasis and safety equipment (exits, changes of direction and level, fire-fighting, first aid, call points): illuminance near them; more detail in 2024 | to read | 4.2 | `en1838.points-of-emphasis` | planned |
| Toilets and changing rooms (new in 2024) | to read | 5.4.1 | `en1838.specific-areas` | planned |
| Public indoor swimming pools (new in 2024) | to read | 5.4.2 | `en1838.specific-areas` | planned |
| Motor generator, control, switch and plant rooms (new in 2024) | to read | 5.4.3 | `en1838.specific-areas` | planned |
| Local area lighting (new in 2024) | to read | 7.1 (Annex C, informative) | `en1838.local-area` | planned |
| Standby lighting: lighting that lets normal activities continue | to read | 7.2 | — | out of scope (not escape lighting) |
| Adaptive emergency escape lighting (in the scope; techniques in CEN/TS 17951) | to read | 1 | — | not yet planned |
| Disability glare: maximum luminous intensity by mounting height, in the field of view | table by mounting height | not in the preview | `en1838.glare-limits` | planned |
| Colour rendering of emergency light | Ra ≥ 40 | not in the preview | `en1838.declarations` | planned |
| Response time: share of required illuminance within a time limit | 50 % within 5 s, 100 % within 60 s | Annex A (informative); the normative clause is not in the preview | `en1838.declarations` | planned |
| Duration | minimum 1 h (often longer by national rules) | Annex A (informative); the normative clause is not in the preview | `en1838.declarations` | planned |
| Safety signs: conformity, illumination, viewing distance and mounting height | to read | 6.1–6.4 | `en1838.safety-signs` | planned |
| Annex B: on-site illuminance and luminance measurement (methods A–D, initial and five-year verification) | informative | Annex B | — | later (comparing measurements with calculations) |
| Lockdown and prolonged power loss | informative | Annex C per the foreword; the table of contents calls Annex C "Local area lighting": to read | — | out of scope |
| National deviations (A-deviations) | to read, for Italy first | Annex D | — | to read |

Declared values (duration, response time, colour rendering) can't be calculated from photometry: luxpath records
them as inputs, shows them in the report, and checks them against the requirement.
10 changes: 9 additions & 1 deletion docs/status.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,17 @@
# Status

> **Last updated:** 2026-10-21
> **Last updated:** 2026-10-25

**Milestone:** M3 done (scene and `luxpath check`); M1–M2 done (photometry readers, engine). **Direction under study:** EN 1838 checks on IFC models
(docs/research.md §6–7). The IFC inspector (`luxpath inspect-ifc`, an early piece of M7) is done.

## EN 1838:2024 clause map (2026-10-25)
`docs/standards-parity.md` now cites the 2024 clause of every requirement, from the table of contents of the free
SIST EN 1838:2025 preview; the values are still from secondary sources (gap 4). The preview also shows what the 2024
edition added, now rows and parity entries: specific areas (5.4: toilets and changing rooms, public indoor swimming
pools, plant rooms), safety signs (6), local area lighting (7.1). Next: the scene's area kinds for 5.4 and 7.1, and a
finding per requirement, each "cannot verify" until its value is verified.

## Walls (2026-10-21)
Scenes have `[[wall]]`s (polylines with a height); a luminaire whose sight line to a point crosses one gives that
point nothing. In the corridor example the minimum on the route drops from 1.45 lx to 0.60 lx once light no longer
Expand Down Expand Up @@ -48,6 +55,7 @@ FireExit flags. Luminaires collapse into few types (410 → 5), so a photometry

## Blockers
- None. **Before M4:** the EN 1838:2024 text (Italian edition UNI EN 1838:2025) is needed to verify values (gap 4).
The free SIST preview (`plan/standards/`) gave the 2024 clause numbers and the list of changes, but no values.

## Open questions (owner)
- Practitioner questions in `docs/research.md` §5.
24 changes: 24 additions & 0 deletions parity/features.toml
Original file line number Diff line number Diff line change
Expand Up @@ -261,6 +261,30 @@ tier = "P1"
milestone = "M4"
status = "planned"

[[feature]]
id = "en1838.specific-areas"
title = "Specific areas new in 2024: toilets and changing rooms, public indoor swimming pools, plant rooms (5.4)"
area = "en1838"
tier = "P1"
milestone = "M4"
status = "planned"

[[feature]]
id = "en1838.local-area"
title = "Local area lighting, new in 2024 (7.1)"
area = "en1838"
tier = "P2"
milestone = "M4"
status = "planned"

[[feature]]
id = "en1838.safety-signs"
title = "Safety signs: illumination, viewing distance and mounting height (6)"
area = "en1838"
tier = "P1"
milestone = "M4"
status = "planned"

[[feature]]
id = "en1838.edition-2013"
title = "Check against the withdrawn 2013 edition (centre line) for older projects"
Expand Down
Loading