@oimlsmart/primmel-packages 0.18.0 → 0.20.0

package/oiml-r91/execution/test-report-skeleton.prl

@@ -0,0 +1,426 @@
+# OIML R 91 — test report skeleton (kernel 1.14.0's test_report_skeleton,
+# TODO.roadmap/40): the R 91-3:2025 test report format — sections and the
+# form inventory (C140 resolves the entries against the forms register).
+# The R 91-4 type evaluation report is a separate document — its template
+# is the evaluation-report family, not this register.
+test_report_skeleton r91-3/test-report {
+  title "OIML R 91-3:2025 — Test report format for speed meters"
+  description "The complete test report for an OIML R 91 speed meter evaluation, structured per the R 91-3:2025 report format: the metrological field test, the laboratory programme per R 91-2, and the category-specific tests."
+  note "R 91-4 additionally defines the TYPE EVALUATION REPORT format — a separate document from the lab test report (R 91-3); its template is the evaluation-report family, not this register."
+  section 01 {
+    title "Metrological field test (OIML R 91-2, 4)"
+    form r91-3/report-1-1 {
+      file "01-01-field-test"
+      title "1.1 Traffic condition during measurement (metrological field test)"
+      conformance_test /conf/field/stationary-field-test
+      requirements { /req/metrological/mpe-stationary /req/metrological/measuring-intervals /req/metrological/indicated-speed /req/category-moving/stationary-mode }
+      required always
+    }
+    form r91-3/report-1-2 {
+      file "01-02-statistical-analysis"
+      title "1.2 Statistical analysis of errors (optional)"
+      conformance_test /conf/field/stationary-field-test
+      requirements { /req/metrological/mpe-stationary }
+      required conditional
+      notes "Optional per R 91-2, 4.7 — the statistical analysis is completed when the field-test error distribution warrants it."
+    }
+    form r91-3/report-1-3 {
+      file "01-03-image-evidence"
+      title "1.3 Assignment to image evidence"
+      conformance_test /conf/field/stationary-field-test
+      requirements { /req/metrological/vehicle-identification }
+      required always
+    }
+  }
+  section 02 {
+    title "Metrological laboratory tests by traffic simulation (OIML R 91-2, 5)"
+    form r91-3/report-2-1 {
+      file "02-01-dynamic-performance"
+      title "2.1 Dynamic performance test"
+      conformance_test /conf/field/dynamic-performance
+      requirements { /req/metrological/mpe-stationary /req/metrological/relevant-speed-values }
+      required always
+    }
+    form r91-3/report-2-2 {
+      file "02-02-speed-linearity"
+      title "2.2 Speed linearity test"
+      conformance_test /conf/linearities/speed-linearity
+      requirements { /req/metrological/linearity-limit }
+      required always
+    }
+    form r91-3/report-2-3 {
+      file "02-03-distance-linearity"
+      title "2.3 Distance linearity test"
+      conformance_test /conf/linearities/distance-linearity
+      requirements { /req/metrological/distance-angle-indication }
+      required always
+    }
+    form r91-3/report-2-4 {
+      file "02-04-angle-linearity"
+      title "2.4 Angle linearity test"
+      conformance_test /conf/linearities/angle-linearity
+      requirements { /req/metrological/distance-angle-indication }
+      required always
+    }
+  }
+  section 03 {
+    title "Influence factor and disturbance tests (OIML R 91-2, 6)"
+    form r91-3/report-3-1 {
+      file "03-01-dry-heat-operating"
+      title "3.1 Dry heat (operating)"
+      conformance_test /conf/influence/dry-heat-operating
+      requirements { /req/metrological/linearity-limit /req/metrological/influence-quantities }
+      required always
+    }
+    form r91-3/report-3-2 {
+      file "03-02-dry-heat-storage"
+      title "3.2 Dry heat (storage)"
+      conformance_test /conf/disturbances/dry-heat-storage
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-3 {
+      file "03-03-cold-operating"
+      title "3.3 Cold (operating)"
+      conformance_test /conf/influence/cold-operating
+      requirements { /req/metrological/linearity-limit /req/metrological/influence-quantities }
+      required always
+    }
+    form r91-3/report-3-4 {
+      file "03-04-cold-storage"
+      title "3.4 Cold (storage)"
+      conformance_test /conf/disturbances/cold-storage
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-5 {
+      file "03-05-damp-heat-cyclic"
+      title "3.5 Damp heat, cyclic (condensing)"
+      conformance_test /conf/influence/damp-heat-cyclic
+      requirements { /req/metrological/linearity-limit /req/metrological/influence-quantities }
+      required always
+    }
+    form r91-3/report-3-6 {
+      file "03-06-water"
+      title "3.6 Water (optional)"
+      conformance_test /conf/disturbances/water
+      requirements { /req/metrological/disturbances }
+      required conditional
+      notes "Optional test (R 91-2, 6.1 Tables 1-2) — applied when relevant for the declared point of use and installation conditions."
+    }
+    form r91-3/report-3-7 {
+      file "03-07-sand-and-dust"
+      title "3.7 Sand and dust (optional)"
+      conformance_test /conf/disturbances/sand-and-dust
+      requirements { /req/metrological/disturbances }
+      required conditional
+      notes "Optional test (R 91-2, 6.1 Tables 1-2) — applied when relevant for the declared point of use and installation conditions."
+    }
+    form r91-3/report-3-8 {
+      file "03-08-salt-mist"
+      title "3.8 Salt mist (optional)"
+      conformance_test /conf/disturbances/salt-mist
+      requirements { /req/metrological/disturbances }
+      required conditional
+      notes "Optional test (R 91-2, 6.1 Table 1, row 6) — applied when relevant for the declared point of use and installation conditions."
+    }
+    form r91-3/report-3-9 {
+      file "03-09-vibration-random"
+      title "3.9 Vibration (random)"
+      conformance_test /conf/influence/vibration-random
+      requirements { /req/metrological/linearity-limit /req/metrological/influence-quantities }
+      required always
+    }
+    form r91-3/report-3-10 {
+      file "03-10-mechanical-shock"
+      title "3.10 Mechanical shock"
+      conformance_test /conf/disturbances/mechanical-shock
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-11 {
+      file "03-11-dc-mains-voltage-variation"
+      title "3.11 DC mains voltage variation"
+      conformance_test /conf/influence/dc-mains-voltage-variation
+      requirements { /req/metrological/linearity-limit /req/metrological/influence-quantities }
+      required always
+    }
+    form r91-3/report-3-12 {
+      file "03-12-ripple-on-dc-mains"
+      title "3.12 Ripple on DC mains power"
+      conformance_test /conf/disturbances/ripple-on-dc-mains
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-13 {
+      file "03-13-ac-mains-voltage-variation"
+      title "3.13 AC mains voltage variation"
+      conformance_test /conf/influence/ac-mains-voltage-variation
+      requirements { /req/metrological/linearity-limit /req/metrological/influence-quantities }
+      required always
+    }
+    form r91-3/report-3-14 {
+      file "03-14-ac-mains-frequency-variation"
+      title "3.14 AC mains frequency variation"
+      conformance_test /conf/influence/ac-mains-frequency-variation
+      requirements { /req/metrological/linearity-limit /req/metrological/influence-quantities }
+      required always
+    }
+    form r91-3/report-3-15 {
+      file "03-15-dc-mains-voltage-dips"
+      title "3.15 DC mains voltage dips, short interruptions and (short term) voltage variations"
+      conformance_test /conf/disturbances/dc-mains-voltage-dips
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-16 {
+      file "03-16-ac-mains-voltage-dips"
+      title "3.16 AC mains voltage dips, short interruptions and reductions"
+      conformance_test /conf/disturbances/ac-mains-voltage-dips
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-17 {
+      file "03-17-ac-mains-frequency-harmonics"
+      title "3.17 AC mains frequency harmonics"
+      conformance_test /conf/disturbances/ac-mains-frequency-harmonics
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-18 {
+      file "03-18-vlf-lf-disturbances"
+      title "3.18 VLF and LF disturbances on AC and DC mains"
+      conformance_test /conf/disturbances/vlf-lf-disturbances-ac-mains
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-19 {
+      file "03-19-bursts-ac-dc-mains"
+      title "3.19 Bursts (transients) on AC and DC mains"
+      conformance_test /conf/disturbances/bursts-ac-dc-mains
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-20 {
+      file "03-20-surges-ac-dc-mains"
+      title "3.20 Surges on AC and DC mains power lines"
+      conformance_test /conf/disturbances/surges-ac-dc-mains
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-21 {
+      file "03-21-bursts-signal-lines"
+      title "3.21 Bursts (transients) on signal, data and control lines"
+      conformance_test /conf/disturbances/bursts-signal-lines
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-22 {
+      file "03-22-surges-signal-lines"
+      title "3.22 Surges on signal, data and control lines"
+      conformance_test /conf/disturbances/surges-signal-lines
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-23 {
+      file "03-23-ac-mains-magnetic-field"
+      title "3.23 AC mains power frequency magnetic field"
+      conformance_test /conf/disturbances/ac-mains-power-frequency-magnetic-field
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-24 {
+      file "03-24-conducted-rf-common-mode"
+      title "3.24 Conducted (common mode) currents generated by RF electromagnetic fields"
+      conformance_test /conf/disturbances/conducted-rf-common-mode-currents
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-25 {
+      file "03-25-rf-electromagnetic-fields"
+      title "3.25 RF electromagnetic fields"
+      conformance_test /conf/disturbances/rf-electromagnetic-fields
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-26 {
+      file "03-26-electrostatic-discharges"
+      title "3.26 Electrostatic discharges"
+      conformance_test /conf/disturbances/electrostatic-discharges
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-27 {
+      file "03-27-internal-battery-low-voltage"
+      title "3.27 Low voltage of internal battery"
+      conformance_test /conf/influence/internal-battery-low-voltage
+      requirements { /req/metrological/linearity-limit /req/metrological/influence-quantities }
+      required always
+    }
+    form r91-3/report-3-28 {
+      file "03-28-road-vehicle-battery"
+      title "3.28 Voltage variations of a road vehicle battery"
+      conformance_test /conf/influence/road-vehicle-battery-voltage-variations
+      requirements { /req/metrological/linearity-limit /req/metrological/influence-quantities }
+      required always
+    }
+    form r91-3/report-3-29 {
+      file "03-29-transient-supply-lines"
+      title "3.29 Electrical transient conduction along supply lines of external 12 V and 24 V batteries"
+      conformance_test /conf/disturbances/transient-conduction-supply-lines
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-30 {
+      file "03-30-transient-other-lines"
+      title "3.30 Electrical transient conduction via lines other than supply lines for external 12 V and 24 V batteries"
+      conformance_test /conf/disturbances/transient-conduction-other-lines
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-31 {
+      file "03-31-battery-cranking"
+      title "3.31 Battery voltage variations during cranking"
+      conformance_test /conf/disturbances/battery-voltage-cranking
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-32 {
+      file "03-32-load-dump"
+      title "3.32 Load dump test"
+      conformance_test /conf/disturbances/load-dump
+      requirements { /req/metrological/disturbances }
+      required always
+    }
+    form r91-3/report-3-33 {
+      file "03-33-acceleration"
+      title "3.33 Acceleration test"
+      conformance_test /conf/field/acceleration-test
+      requirements { /req/metrological/mpe-stationary }
+      required always
+    }
+    form r91-3/report-3-34 {
+      file "03-34-further-influence"
+      title "3.34 Further influence quantity tests"
+      requirements { /req/metrological/linearity-limit }
+      required always
+    }
+    form r91-3/report-3-35 {
+      file "03-35-installation-alignment"
+      title "3.35 Installation and alignment of sensor and camera"
+      conformance_test /conf/linearities/alignment-misalignment
+      requirements { /req/category-across-road/alignment-error }
+      required always
+    }
+  }
+  section 04 {
+    title "Tests specific to certain categories of speed meters (OIML R 91-2, 7)"
+    form r91-3/report-4-1 {
+      file "04-01-doppler-radar"
+      title "4.1 Doppler-radar based speed meters"
+      requirements { /req/category-doppler-radar/beam-width /req/category-doppler-radar/frequency-spectrum /req/category-doppler-radar/spectrum-stability /req/category-doppler-radar/side-lobe }
+      required always
+    }
+    form r91-3/report-4-2 {
+      file "04-02-range-finding"
+      title "4.2 Range-finding based speed meters"
+      requirements { /req/category-range-finding/beam-width /req/category-range-finding/max-distance-viewfinder /req/category-range-finding/pulse-stability /req/category-range-finding/wavelength }
+      required always
+    }
+    form r91-3/report-4-3 {
+      file "04-03-average-speed"
+      title "4.3 Average speed meters"
+      requirements { /req/category-average-speed/detection-field-size /req/category-average-speed/time-synchronisation /req/category-average-speed/image-time-evidence }
+      required always
+    }
+    form r91-3/report-4-4 {
+      file "04-04-fixed-distance"
+      title "4.4 Fixed-distance speed meters"
+      requirements { /req/category-fixed-distance/detection-point-distance /req/category-fixed-distance/redundancy }
+      required always
+    }
+    form r91-3/report-4-5 {
+      file "04-05-image-based"
+      title "4.5 Image based speed meters"
+      conformance_test /conf/category-image-based/image-quality
+      requirements { /req/category-image-based/image-quality /req/category-image-based/position-marking /req/category-image-based/position-distances }
+      required always
+    }
+    form r91-3/report-4-6 {
+      file "04-06-across-road"
+      title "4.6 Across-the-road speed meters"
+      conformance_test /conf/examinations/across-road-examination
+      requirements { /req/category-across-road/reference-marking /req/category-across-road/cosine-verification }
+      required always
+    }
+  }
+  section 05 {
+    title "Moving speed meters (OIML R 91-2, 7.7)"
+    form r91-3/report-5-1 {
+      file "05-01-moving-field-test"
+      title "5.1 Moving metrological field test"
+      conformance_test /conf/field/moving-field-test
+      requirements { /req/category-moving/mpe-moving }
+      required always
+    }
+    form r91-3/report-5-2 {
+      file "05-02-ego-field-test"
+      title "5.2 Metrological field test of the ego speed meter"
+      conformance_test /conf/field/ego-field-test
+      requirements { /req/category-moving/ego-speed /req/category-moving/ego-adjustment }
+      required always
+    }
+    form r91-3/report-5-3 {
+      file "05-03-moving-traffic-simulation"
+      title "5.3 Traffic simulation for moving speed meters"
+      requirements { /req/category-moving/mpe-moving /req/category-moving/ego-speed }
+      required always
+    }
+  }
+  section 06 {
+    title "Software (OIML R 91-2, 8.3)"
+    form r91-3/report-6-1 {
+      file "06-01-software-general"
+      title "6.1 General requirements [mandatory]"
+      conformance_test /conf/software/software-examination
+      requirements { /req/technical/software }
+      required always
+    }
+    form r91-3/report-6-2 {
+      file "06-02-software-protection"
+      title "6.2 Software protection [mandatory]"
+      conformance_test /conf/software/software-examination
+      requirements { /req/technical/software }
+      required always
+    }
+    form r91-3/report-6-3 {
+      file "06-03-software-hardware-support"
+      title "6.3 Support of hardware features [mandatory]"
+      conformance_test /conf/software/software-examination
+      requirements { /req/technical/software }
+      required always
+    }
+    form r91-3/report-6-4 {
+      file "06-04-software-separation"
+      title "6.4 Specification and separation of legally relevant parts and specification of interfaces [optional]"
+      conformance_test /conf/software/software-examination
+      requirements { /req/technical/software }
+      required always
+    }
+    form r91-3/report-6-5 {
+      file "06-05-software-maintenance"
+      title "6.5 Maintenance and re-configuration [optional]"
+      conformance_test /conf/software/software-examination
+      requirements { /req/technical/software }
+      required always
+    }
+  }
+  section 07 {
+    title "General remarks"
+    form r91-3/report-general-remarks {
+      file "07-general-remarks"
+      title "General remarks"
+      required always
+    }
+  }
+}

package/oiml-twin-cert/evaluation/certificate-template.prl

@@ -0,0 +1,111 @@
+# oiml-twin-cert — TWIN CERTIFICATE TEMPLATE (TODO.v2/01 TCD-3;
+# analysis/twin-certification-design.md Q3 "the certificate's claim").
+#
+# The twin certificate claims a SCOPED, CONDITIONAL relation (Q3): for
+# instrument <model/serial>, the twin served at endpoint <endpoint-id> via
+# operations <op-list> reflects the physical state of registers
+# <aspect-list> within tolerance <δ per register> and freshness
+# <fresh_within per register>, verified by probe schedule <schedule-id> on
+# <date> (report <id>), with served-timestamp provenance declared
+# (timestamp_fields). Validity is CONDITIONAL: continuous surveillance per
+# monitor <monitor-id>; a sustained fail suspends; an unresolved fail
+# withdraws.
+#
+# The characteristic rows are the claim's print projection. Every row
+# resolves BY NAME from the certification decision's claim context
+# (browser/src/services/twin-certificate.service.ts —
+# twinCertificateCharacteristics): the twin's endpoint identity and the
+# certified registers ride the decision evidence, never an entity-graph
+# attribute (the program composes into nothing — there is no rec entity
+# graph to bind, hence no attribute/dimension bindings on the rows).
+# obligation: mandatory rows must carry a value on the issued certificate;
+# the attestation-limitation row prints only when the probe evidence rode
+# the attestation channel (controller decision 3: never silently upgraded).
+#
+# The certificate number format mirrors the Annex B shape with the
+# program's own designators: TW-1 (the governing document,
+# urn:oiml:pub:cs:twin-1:2027) / edition - T5 (the ISO/IEC 17067 scheme
+# type the program self-classifies — type 5, surveillance-constitutive) -
+# the scheme operator code - year.sequence.
+#
+# Row labels are the default-spelling (eng-Latn) content sets inline —
+# the YAML twin re-wraps them as the Prose array the renderer resolves
+# with src/data/prose.ts.
+certificate_template certificate {
+  number_format "TW-1/{edition}-T5-{authority}-{year2}.{seq}"
+  characteristic instrument_model {
+    type string
+    label "Instrument model (the underlying certified type)"
+    obligation mandatory
+  }
+  characteristic instrument_serial {
+    type string
+    label "Instrument serial number (the certified unit — per-UNIT certification, type 5)"
+    obligation mandatory
+  }
+  characteristic twin_endpoint {
+    type string
+    label "Twin endpoint identifier (bound to the certified unit's serial)"
+    obligation mandatory
+  }
+  characteristic served_operations {
+    type string
+    label "Served operations certified"
+    obligation mandatory
+  }
+  characteristic fidelity_registers {
+    type string
+    label "Fidelity registers certified (served aspects)"
+    obligation mandatory
+  }
+  characteristic twin_tolerance_indication {
+    type string
+    label "Twin tolerance δ_indication (|served − reference| ≤ δ at every probe point)"
+    obligation mandatory
+  }
+  characteristic fresh_within_indication {
+    type string
+    label "Freshness window — indication register (fresh_within)"
+    obligation mandatory
+  }
+  characteristic fresh_within_op_state {
+    type string
+    label "Freshness window — state register (fresh_within)"
+    obligation mandatory
+  }
+  characteristic probe_schedule {
+    type string
+    label "Probe schedule (the certification's executable — range, envelope, transitions)"
+    obligation mandatory
+  }
+  characteristic verified_on {
+    type string
+    label "Verification date (the probe campaign's completion)"
+    obligation mandatory
+  }
+  characteristic fidelity_report {
+    type string
+    label "Twin-fidelity test report (the D2 evidence)"
+    obligation mandatory
+  }
+  characteristic surveillance_monitor {
+    type string
+    label "Surveillance monitor (the type-5 continuous half — validity is CONDITIONAL on it)"
+    obligation mandatory
+  }
+  characteristic type_certificate {
+    type string
+    label "Type certificate of the underlying instrument (the hard admission prerequisite, cited as provenance)"
+    obligation mandatory
+  }
+  characteristic probe_sources {
+    type string
+    label "Probe channels used (reference_instrument preferred; sim_ground_truth acceptance-only)"
+    obligation mandatory
+  }
+  characteristic traceability_limitation {
+    type string
+    label "Declared traceability limitation (observer-attestation evidence proves twin ≡ display, not twin ≡ mass)"
+    obligation optional
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oimlsmart/primmel-packages",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "The OIML SMART platform's authoritative model content: every Recommendation, the OIML-CS scheme, the CASCO foundations, the shared modules, and the product/program reference packages as Primmel (.prl) packages — the single source of truth the platform's data trees regenerate from. Consumed by the smart monorepo (oimlsmart/smart) at a pinned version (TODO.repos/02).",
   "type": "module",
   "repository": {