Model/backend/documents_parser
Khalim Conn-Kowlessar 012cbd183f Slice S0380.27: thread floor_construction_type into _main_floor_u_value — closes cert 9796 +0.55 → +0.00174
Per RdSAP10 §5 page 29 "Floor infiltration (suspended timber ground
floor only)":

  Age band A-E:
    a) if floor U-value < 0.5, assume "sealed" → 0.1
    b) if retro-fit + no U → "sealed" → 0.1
    otherwise "unsealed" → 0.2

The cascade routes the (12) sealed/unsealed verdict through
`_main_floor_u_value`, which calls `u_floor` to compute the BS EN ISO
13370 U-value the spec rule keys on. That helper was a stale duplicate
of the real heat-transmission path that did NOT respect the per-bp
`floor_construction_type` lodgement:

  Pre-slice:  u_floor(construction=int_or_None, description=None, ...)
  Cascade:    u_floor(construction=int_or_None, description="Suspended
              timber" if floor_construction_type else <fallback>, ...)

For cert 9796-3058-6205-0346-9200 (Mid-Terrace bungalow age D,
46.87 m² / 15.0 m perimeter, suspended-timber lodged):
  - Broken `_main_floor_u_value` routes through the solid default
    (no description, construction=None) → BS EN ISO 13370 solid →
    U=0.49 W/m²K.
  - 0.49 < 0.5 → spec rule (a) fires → (12) = 0.1 (sealed).
  - Real heat-transmission cascade routes through the suspended branch
    via `effective_floor_description = floor_construction_type` →
    U=0.56 → unsealed → (12) = 0.2.

The 0.1 ach gap then propagated:
  (18) infiltration_rate 0.74 → ws 0.84 (cascade -0.10)
  (25)m Jan 0.82               → ws 0.91 (cascade -0.09)
  (38)m Jan 29.08 W/K          → ws 32.37 (cascade -3.29 W/K)
  (39) Jan 110.35 W/K          → ws 113.64 (cascade -3.29 W/K)
  HLP Jan 2.35 W/m²K           → ws 2.42 (cascade -0.07)
  T_h2 Jan 19.11°C             → ws 19.07 (cascade +0.04)
  MIT Jan 18.51°C              → ws 18.45 (cascade +0.06)
  SAP +0.55 vs worksheet 90.13.

Fix mirrors heat_transmission's `effective_floor_description` rule in
`_main_floor_u_value`: the per-bp `floor_construction_type` takes
precedence over a joined `epc.floors[].description` because it's the
explicit Elmhurst Summary §3/§9 surface. Inlined the description join
(vs importing `_joined_descriptions` from heat_transmission) so
cert_to_inputs stays free of cross-module private-symbol imports.

Cohort-2 outcome (38 certs, Summary path):
  exact (<1e-4): 23 → 23
  ≤±0.07:        14 → **15**  (+1: cert 9796 +0.55 → +0.00174)
  ±0.5..1:        1 → **0**   (last cohort-2 mid-range gap closes)

The remaining cert 9796 +0.00174 SAP residual is the cohort-1 HP-COP
precision floor (the same +0.001..+0.04 SAP that the other 10
triple-glazed HP certs sit at; see handover thread 3).

Cohort-1 golden fixture cert 8135-1728-8500-0511-3296 (Semi-detached
age C, suspended-timber ground floor with floor_construction=2 lodged
but description=None pre-slice) had the same bug:
  Pre-slice: u_floor returned 0.48 (solid branch via construction=2
             present-but-not-suspended) → false sealed verdict (12)=0.1
  Post-slice: u_floor returns 0.54 (suspended branch via description=
              "Suspended timber") → correct unsealed verdict (12)=0.2
  PE residual:  -4.9611 → **-0.0748** kWh/m² (+4.89 closer to API EPC)
  CO2 residual: -0.0678 → **+0.0246** t/yr  (closer to API EPC)
  SAP residual: 0 → 0 (unchanged, EPC integer)

Pin updated on cert 8135 to reflect the new (correct) cascade-vs-API
alignment; no other golden fixtures shifted.

Pyright net-zero per touched file:
  cert_to_inputs.py:                  35 → 35
  tests/test_cert_to_inputs.py:       13 → 12 (suppressed pre-existing
                                       private-import error on
                                       _water_heating_worksheet_and_gains
                                       at the same time as adding
                                       suppressions for the two new
                                       private imports)
  tests/test_golden_fixtures.py:       1 → 1
  tests/test_summary_pdf_mapper_chain.py: 0 → 0

Tests: 708 → 710 pass (+2 new: `_main_floor_u_value` routes
suspended-timber via per-bp lodgement; cert 9796 chain pin against
worksheet 90.1318 within ±0.07 ASHP-cohort spec floor), 10 expected
fails unchanged.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-28 11:24:59 +00:00
..
handler address JTK review comments 2026-04-20 15:11:17 +00:00
tests Slice S0380.27: thread floor_construction_type into _main_floor_u_value — closes cert 9796 +0.55 → +0.00174 2026-05-28 11:24:59 +00:00
__init__.py Map to RdSapSiteNotes from site notes JSON 🟥 2026-04-16 13:54:03 +00:00
db_writer.py include updating epc_property_data to pashub to ara workflow 2026-04-29 09:55:14 +00:00
elmhurst_extractor.py Slice S0380.26: RdSAP10 §5.8 dry-lining adjustment on alt walls — closes cert 7700 -0.44 → +5e-5 2026-05-28 10:56:11 +00:00
extractor.py Handle wall thickness "Unmeasurable" 🟩 2026-04-30 16:41:16 +00:00
local_runner.py update local runner to work for elmhurst 2026-04-24 14:01:36 +00:00
parser.py load ecmk site notes to db 2026-04-29 11:20:47 +00:00
pdf.py update local runner to work for elmhurst 2026-04-24 14:01:36 +00:00