diff --git a/ROADMAP.md b/ROADMAP.md index 5fd2258..3a8901f 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -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. | diff --git a/docs/gaps.md b/docs/gaps.md index ccfbc30..fa3f6a8 100644 --- a/docs/gaps.md +++ b/docs/gaps.md @@ -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 | diff --git a/docs/research.md b/docs/research.md index ea12065..13ddd71 100644 --- a/docs/research.md +++ b/docs/research.md @@ -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 diff --git a/docs/standards-parity.md b/docs/standards-parity.md index b41fcc6..3c11ef7 100644 --- a/docs/standards-parity.md +++ b/docs/standards-parity.md @@ -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. diff --git a/docs/status.md b/docs/status.md index 1aea9d4..44e3a22 100644 --- a/docs/status.md +++ b/docs/status.md @@ -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 @@ -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. diff --git a/parity/features.toml b/parity/features.toml index 59ca7fa..57edf4b 100644 --- a/parity/features.toml +++ b/parity/features.toml @@ -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"