gea-program 0.1.0__py3-none-any.whl

gea/BENCH_TEST_PROTOCOL.md

@@ -0,0 +1,97 @@
+# Bench-Test Protocol — Measuring the 1.0324 Suppression Ratio
+
+**Field-tier step 8 (independent evaluation, adopted 2026-08-27).**
+Status of the quantity under test: `canonical_suppression()` = **1.0324 at
+unity trims** is today a **DERIVED_HYBRID** composition — industry baseline
+drift (0.215 %FS/yr class) with HPHT stress dressing, divided by a
+locked-primitive GEA composition. It is **not** a measured constant, and the
+product labels it so everywhere it appears. This protocol is the experiment
+that would change — or refuse to change — that label.
+
+---
+
+## 1. Falsifiable prediction
+
+Two matched GEOQ-177-class quartz P/T gauges (same spec, same batch
+preferred), one operated with the GEA-informed configuration and one as the
+conventional reference, co-located at a fixed HPHT setpoint, will exhibit a
+long-term drift-rate ratio
+
+```
+R = drift_conventional / drift_program = 1.0324   (at unity trims)
+```
+
+equivalently a predicted separation rate of ~2.3 psi/yr at a 30,000-psi
+full scale (the service-life module's number for these conditions). The
+prediction is falsifiable in both directions: a measured R statistically
+inconsistent with 1.0324 **refutes the composition at bench conditions**.
+
+## 2. Apparatus
+
+- 2× (minimum; 3+ pairs preferred for scatter) quartz P/T gauges,
+  177 °C / 30 kpsi class, from the same vendor lot.
+- Temperature-controlled bath or HPHT vessel holding a setpoint in the
+  150 °C / 10,000 psi class (inside every rating — the rating_check rule
+  applies on the bench too).
+- Reference pressure standard, 0.01 %-class (deadweight tester or
+  transfer standard), for baseline and periodic checks.
+- Logging at ≥ 1 reading/day per gauge into the package's historian CSV
+  format (`time_s` + one raw pressure column per gauge).
+
+## 3. Duration — the package's own rule applies
+
+The reconciler refuses trend verdicts below its minimum span
+(`ReconcilerConfig.min_trend_span_years`, the ≥18-day slope rule). The bench
+protocol requires **≥ 90 days** at setpoint for slope confidence; 180+ days
+preferred. The analysis tool enforces the 18-day floor mechanically and
+reports `INSUFFICIENT_SPAN` below it — the bench cannot be rushed past the
+product's own honesty rule.
+
+## 4. Procedure
+
+1. Baseline both gauges against the reference standard; record offsets.
+2. Install co-located at the setpoint; log continuously.
+3. Weekly: verify setpoint stability against the reference (do not adjust
+   the gauges under test).
+4. Export each leg as a historian CSV; run
+   `python -m gea bench --program-csv A.csv --conv-csv B.csv`.
+5. Repeat with roles swapped on a second pair (control for unit-to-unit
+   scatter — the piezo lesson: individual units scatter around class curves).
+
+## 5. Analysis and verdict vocabulary
+
+`bench.bench_analysis()` fits each leg's drift slope (OLS, psi/yr →
+%FS/yr), propagates slope uncertainties into the ratio, and returns one of:
+
+- `MEASURED_CONFIRMS` — R within its own propagated uncertainty of 1.0324.
+- `MEASURED_REFUTES`  — R inconsistent with 1.0324 (the uncertainty is small
+  enough to exclude it). **This is a valid and useful outcome** — the
+  composition is falsified at bench conditions and the label stays
+  DERIVED_HYBRID with the refutation on record.
+- `INSUFFICIENT_SPAN` — under the 18-day floor: no verdict.
+- `INSUFFICIENT_SNR`  — the uncertainty band contains both 1.0324 and 1.0
+  (cannot distinguish suppression from no-suppression): no verdict, more
+  data required.
+
+## 6. Outcome handling (labeling rules)
+
+- **Confirmed:** `canonical_suppression()`'s label may move from
+  DERIVED_HYBRID to MEASURED_ON_BENCH **with the test ID, dates, apparatus
+  and per-pair results attached**. The composition's primitives are then a
+  measured-consistent model, not just a labeled one.
+- **Refuted:** the label stays DERIVED_HYBRID; the refutation (conditions,
+  measured R, uncertainty) is recorded beside it. No silent retuning of
+  trims to fit the bench — a post-hoc trim fit would be a new calibration
+  claim, labeled as such, never a derivation.
+- **Either way:** `U_i` remains loaded-but-unused in the drift formula until
+  a GEA derivation path for its role is supplied (Rule 10 — the framework
+  author provides the physics; the product does not invent it).
+
+## 7. Analysis-tool verification (available today, and labeled)
+
+The analysis tool is verified NOW against the simulator's own twin legs:
+`bench --selftest` generates synthetic paired-leg data from the engine's
+models and must return `MEASURED_CONFIRMS` at R ≈ 1.0324. **This is a
+SIMULATION_SELF_TEST — it verifies the analysis arithmetic, not the
+physics.** It proves the bench pipeline is ready; it proves nothing about
+gauges. The acceptance suite runs it on every gate.

gea/IMPORT_RECORD.md

@@ -0,0 +1,61 @@
+# Import record
+
+Source: Star-Magic-Program @ c16090852e28f35f0fcb31cba6384da566016a61 (uqff_downhole_simulator 1.91.0)
+Package version: 0.1.0
+Imported: 2026-09-29T19:34:53Z
+
+| source | destination | sha256 (first 16) |
+|---|---|---|
+| uqff_downhole_simulator/(native tools/native/cli.py) | gea/cli.py | 241ce978934b032d |
+| uqff_downhole_simulator/(native tools/native/shell.py) | gea/shell.py | 93a3f0221b773ce3 |
+| uqff_downhole_simulator/__init__.py | gea/__init__.py | 3d1fc4e3158ecb4a |
+| uqff_downhole_simulator/__main__.py | gea/__main__.py | fb4ae045d738d9fc |
+| uqff_downhole_simulator/acceptance_tests.py | gea/acceptance_tests.py | c0e6fed3acd5d73b |
+| uqff_downhole_simulator/accuracy_statement.py | gea/accuracy_statement.py | 0f0c8f30c802ad4b |
+| uqff_downhole_simulator/alarm_engine.py | gea/alarm_engine.py | 2ca983787ba42f36 |
+| uqff_downhole_simulator/client_reports.py | gea/client_reports.py | 2ea70a4a6a48b8cb |
+| uqff_downhole_simulator/config_versioning.py | gea/config_versioning.py | cda47534351d0dc5 |
+| uqff_downhole_simulator/dashboard.py | gea/dashboard.py | b5f5ecf17b082ff0 |
+| uqff_downhole_simulator/drift_monitor.py | gea/drift_monitor.py | e532a0832f682c5c |
+| uqff_downhole_simulator/fat_sat.py | gea/fat_sat.py | 49bb8c484670ae22 |
+| uqff_downhole_simulator/matplotlib_demo.py | gea/matplotlib_demo.py | b50f8912788c3983 |
+| uqff_downhole_simulator/model_card.py | gea/model_card.py | 11a9e15f0a4e1620 |
+| uqff_downhole_simulator/qt6_downhole_app.py | gea/qt6_downhole_app.py | 1cf384f7ce1290bd |
+| uqff_downhole_simulator/sample_record.py | gea/sample_record.py | 70fd0b4e9174b181 |
+| uqff_downhole_simulator/sbom.py | gea/sbom.py | ba68811dbadfb999 |
+| uqff_downhole_simulator/sla_report.py | gea/sla_report.py | e8fab50b054230e8 |
+| uqff_downhole_simulator/store_forward.py | gea/store_forward.py | 3b0e038eb73ab22a |
+| uqff_downhole_simulator/uqff_bench.py | gea/bench.py | 41e3cb75983a8013 |
+| uqff_downhole_simulator/uqff_blind_harness.py | gea/blind_harness.py | 571f78e21ca5fbce |
+| uqff_downhole_simulator/uqff_case_study.py | gea/case_study.py | f480097a40dedd20 |
+| uqff_downhole_simulator/uqff_correlation.py | gea/correlation.py | 0d889d9767f44d96 |
+| uqff_downhole_simulator/uqff_deviation.py | gea/deviation.py | b32a25990e1632f9 |
+| uqff_downhole_simulator/uqff_differentiator.py | gea/(dropped) | - |
+| uqff_downhole_simulator/uqff_downhole_engine.py | gea/downhole_engine.py | c3b9a6804ef0aadf |
+| uqff_downhole_simulator/uqff_earth_model.py | gea/earth_model.py | b5605e54474bc32a |
+| uqff_downhole_simulator/uqff_follower.py | gea/follower.py | 69224480b838757d |
+| uqff_downhole_simulator/uqff_forward_model.py | gea/forward_model.py | 0c4c9889c053a131 |
+| uqff_downhole_simulator/uqff_gamma.py | gea/gamma.py | 15b379e3d713094e |
+| uqff_downhole_simulator/uqff_gauge_specs.py | gea/gauge_specs.py | 44828b3a9d90cba4 |
+| uqff_downhole_simulator/uqff_gravity_reference.py | gea/gravity_reference.py | 1d006c95b118d6bf |
+| uqff_downhole_simulator/uqff_inverse_engine.py | gea/inverse_engine.py | ce29836c3417e533 |
+| uqff_downhole_simulator/uqff_modbus.py | gea/modbus.py | 5ecb5da8cc2bd520 |
+| uqff_downhole_simulator/uqff_operator_app.py | gea/operator_app.py | df307c7496c09fee |
+| uqff_downhole_simulator/uqff_ports.py | gea/ports.py | 65ee6ac33199167c |
+| uqff_downhole_simulator/uqff_profile_catalog.py | gea/profile_catalog.py | bd680cd96e9f62ae |
+| uqff_downhole_simulator/uqff_project.py | gea/project.py | fe6e2ea2a94f39a9 |
+| uqff_downhole_simulator/uqff_quartz_hpht_extension.py | gea/quartz_hpht_extension.py | 0b76f77babdddb1a |
+| uqff_downhole_simulator/uqff_reconciler.py | gea/reconciler.py | db611a20061765f6 |
+| uqff_downhole_simulator/uqff_rock_inventory.py | gea/rock_inventory.py | 98b6f74e290d0812 |
+| uqff_downhole_simulator/uqff_segy.py | gea/segy.py | 98e1917515371b36 |
+| uqff_downhole_simulator/uqff_service_life.py | gea/service_life.py | cbabcde1c6afe9e7 |
+| uqff_downhole_simulator/uqff_strata_join.py | gea/strata_join.py | a5d9ecec62b255e0 |
+| uqff_downhole_simulator/uqff_structural_ladder.py | gea/(dropped) | - |
+| uqff_downhole_simulator/uqff_survey_cmd.py | gea/survey_cmd.py | d0937bea85ae703c |
+| uqff_downhole_simulator/uqff_survey_view.py | gea/survey_view.py | 790fdec7cbb2205b |
+| uqff_downhole_simulator/uqff_telemetry.py | gea/telemetry.py | 839bcd9e6d576fd8 |
+| uqff_downhole_simulator/uqff_tool_library.py | gea/tool_library.py | 40bc90e7ad18dfe4 |
+| uqff_downhole_simulator/uqff_well_assembler.py | gea/well_assembler.py | cc1e92fb6da52d5c |
+| uqff_downhole_simulator/well_test_validation.py | gea/well_test_validation.py | 08ca4fa66a0333eb |
+
+Transformations: corpus import removed from quartz_hpht_extension (constants labelled as settings); forward_model on CODATA 2018 G, standard gravity and the IUGG mean radius; rock_inventory on the published anchors and range midpoints only; structural_ladder and differentiator dropped; survey report without the structural-frame section; identifiers renamed (see tools/import_from_star_magic.py).

gea/__init__.py

@@ -0,0 +1,160 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+"""gea — the GEA Downhole HPHT Quartz-Gauge Simulator.
+
+The gea-program's first packaged industry-application module: a
+deep-well (TD ~20,300 ft) six-gauge quartz P/T string with GEA-stabilized
+drift, transient events, live animation (matplotlib / optional PyQt6), and
+CSV export.
+
+Provenance: ported 2026-08-22 (Daniel GO) from the 22Aug2026 Grok thread
+template (grok_cce7a73b); canonical primitives locked, template tuning knobs
+renamed to engineering trims per the knob ruling. See README.md and
+PAPER_2256.
+
+Quick use (headless):
+    from gea import DownholeEngine, SimulatorConfig
+    e = DownholeEngine()
+    for _ in range(100): e.step()
+    print(e.summary()); e.export_csv("run.csv")
+
+Demos (need a display):
+    python -m gea.matplotlib_demo
+    python -m gea.qt6_downhole_app   (pip install PyQt6)
+"""
+
+from .quartz_hpht_extension import (
+    calculate_quartz_transducer_hpht_program,
+    canonical_suppression,
+    conventional_drift,
+    drift_comparison,
+    PROGRAM_MODEL_AVAILABLE,
+)
+from .downhole_engine import (
+    Sensor,
+    SimulatorConfig,
+    DownholeEngine,
+    WellProfile,
+    load_well_profile_csv,
+    make_sensor_string,
+    DEFAULT_TD_FT,
+    DEFAULT_SENSOR_DEPTHS_FT,
+)
+from .service_life import (
+    ServiceLifeConfig,
+    ServiceLifeSimulator,
+)
+from .telemetry import (
+    TelemetryConfig,
+    TelemetryRecorder,
+)
+from .case_study import (
+    CaseStudyConfig,
+    case_study,
+    depth_sweep,
+    write_markdown,
+)
+from .gauge_specs import (
+    GaugeSpec,
+    GAUGE_SPECS,
+    load_gauge_spec_json,
+)
+from .deviation import (
+    DeviationSurvey,
+    load_deviation_csv,
+)
+from .downhole_engine import run_batch
+from .tool_library import (
+    ToolSpec,
+    TOOL_LIBRARY,
+    ToolString,
+    drift_model_for,
+    piezoresistive_drift,
+    rating_check,
+)
+from .ports import (
+    LiveStream,
+    StreamChannel,
+    PortSpec,
+    PORT_REGISTRY,
+    ingest,
+    read_historian_csv,
+    read_las,
+    register_port,
+)
+from .reconciler import (
+    Reconciler,
+    ReconcilerConfig,
+    auto_station_map,
+)
+from .follower import (
+    FollowerPoll,
+    HistorianFollower,
+)
+from .modbus import (
+    PYMODBUS_AVAILABLE,
+    RegisterMap,
+    load_register_map,
+)
+from .well_assembler import (
+    WellAssembly, WellComponent, assemble, assemble_ktb_hb, assemble_odp_504b,
+    assemble_site_1027, assemble_u1324, BUILTIN_ASSEMBLIES,
+    demo_config, production_live_stream,
+)
+from .gamma import (
+    find_gr_channels, shale_volume, formation_flags, gamma_report, gamma_entries,
+)
+from .bench import (
+    bench_analysis, bench_selftest,
+)
+from .operator_app import (
+    OperatorSession, launch_operator_app,
+)
+from .profile_catalog import (
+    CATALOG,
+    CatalogEntry,
+    PROFILE_SOURCES,
+    las_to_profile,
+    read_temperature_csv,
+    read_survey_csv,
+    read_core_csv,
+    read_production_csv,
+    read_ktb_dat,
+    read_ktb_table,
+    read_pangaea_txt,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "calculate_quartz_transducer_hpht_program", "canonical_suppression",
+    "conventional_drift", "drift_comparison",
+    "PROGRAM_MODEL_AVAILABLE", "Sensor", "SimulatorConfig", "DownholeEngine",
+    "WellProfile", "load_well_profile_csv", "make_sensor_string",
+    "ServiceLifeConfig", "ServiceLifeSimulator",
+    "TelemetryConfig", "TelemetryRecorder",
+    "CaseStudyConfig", "case_study", "depth_sweep", "write_markdown",
+    "GaugeSpec", "GAUGE_SPECS", "load_gauge_spec_json",
+    "DeviationSurvey", "load_deviation_csv", "run_batch",
+    "ToolSpec", "TOOL_LIBRARY", "ToolString", "drift_model_for",
+    "piezoresistive_drift", "rating_check",
+    "LiveStream", "StreamChannel", "PortSpec", "PORT_REGISTRY",
+    "ingest", "read_historian_csv", "read_las", "register_port",
+    "Reconciler", "ReconcilerConfig", "auto_station_map",
+    "FollowerPoll", "HistorianFollower",
+    "PYMODBUS_AVAILABLE", "RegisterMap", "load_register_map",
+    "CATALOG", "CatalogEntry", "PROFILE_SOURCES", "las_to_profile", "read_temperature_csv", "read_survey_csv", "read_core_csv", "read_production_csv", "read_ktb_dat", "read_ktb_table", "read_pangaea_txt",
+    "DEFAULT_TD_FT", "DEFAULT_SENSOR_DEPTHS_FT",
+    "strata_join",
+    "well_assembler", "gamma", "bench",
+    "operator_app", "acceptance_tests",
+    "reconcile_survey_tvd",
+    "earth_model",
+    "forward_model",
+    "inverse_engine",
+    "survey_view",
+    "correlation",
+    "blind_harness",
+    "segy",
+    "project",
+]