gea-program 0.1.0__py3-none-any.whl

gea/catalog/woodlark_1109_rock_eval.provenance.json

@@ -0,0 +1,23 @@
+{
+  "entry": "woodlark_1109_rock_eval",
+  "kind": "REAL_ROCK_EVAL_PYROLYSIS",
+  "well": "ODP Hole 180-1109D - WOODLARK BASIN, Solomon Sea, offshore Papua New Guinea (9.5063 S, 151.5726 E; seafloor -2,211 m), the type locality for ACTIVE low-angle normal-fault continental rifting (the Moresby detachment); ODP Leg 180 (1998), the organic-rich Miocene interval 688.23-706.36 mbsf",
+  "operator_on_log": "Katz, Barry J (Texaco) - LECO TOC + Rock-Eval pyrolysis per Espitalie et al. 1977 (the founding method paper, cited with DOI in the file's own header): S1/S2 hydrocarbon yields, hydrogen and oxygen indices, transformation ratio, Tmax; drilling by JOIDES Resolution",
+  "source_database": "PANGAEA, dataset doi:10.1594/PANGAEA.787052 ('(Table T2) TOC, hydrocarbon characteristics and hydrogen and oxygen index, ODP Hole 180-1109D'); supplement to Katz 2001, Proc. ODP Sci. Results 180, 1-19 (doi:10.2973/odp.proc.sr.180.151.2001)",
+  "source_url": "https://doi.pangaea.de/10.1594/PANGAEA.787052?format=textfile",
+  "license": "Creative Commons Attribution 3.0 Unported (CC-BY-3.0), declared IN the file's own header and license-checked BEFORE cataloguing. Attribution: Katz / PANGAEA / ODP",
+  "fetch_date": "2026-08-28",
+  "fetch_method": "read-only HTTPS fetch of the PANGAEA textfile export - COMPLETE dataset (68 data points per the header's own Size declaration, re-counted EXACT at gate time: 9 sample labels + 59 numeric cells with the geocode excluded - note this dataset's counting convention includes the label column, measured not assumed) in one fetch",
+  "coverage": "COMPLETE DATASET: 9 source-rock screening analyses through the organic-rich interval - TOC 1.46-32.86 pct, S1 0.09-11.45 and S2 0.24-86.92 mg HC/g rock, HI 13-314, OI 7-82, transformation ratio 0.09-0.16, Tmax 397-424 C; the full Rock-Eval parameter suite of petroleum-systems screening",
+  "curves": [
+    "Depth sed [m] mbsf 688.23-706.36 (GEOCODE)",
+    "TOC [%] (LECO) 1.46-32.86",
+    "S1 / S2 [mg HC/g sed] (Rock-Eval per Espitalie 1977)",
+    "HI [mg HC/g TOC] 13-314 + OI [mg CO2/g TOC] 7-82",
+    "Transformation ratio S1/(S1+S2) + Tmax [degC]",
+    "ODP sample labels verbatim (counted by the archive's own Size convention)"
+  ],
+  "source_anomaly_disclosure": "No internal inconsistencies detected - the archive closes against its own definitions: HI = S2/TOC x 100 re-derives on ALL 9 rows within 0.47 units of the archived integers, and the transformation ratio S1/(S1+S2) re-derives on all 7 populated rows within 0.005; noted for the record: TR and Tmax are BLANK on exactly the same two rows (the two lowest-S2 samples, 0.75 and 0.24 mg/g, where the S2 peak is too small for a reliable Tmax) although TR is arithmetically computable there - the archive's own quality judgment, preserved as blanks",
+  "purpose": "forty-third catalogue entry - the WOODLARK BASIN / SOLOMON SEA joins as region THIRTY-ONE (the type locality of active low-angle-normal-fault rifting) and ROCK-EVAL PYROLYSIS is kind THIRTY-TWO: the petroleum-systems screening quantity itself, the first source-rock assessment data in an energy-industry catalogue - and the verdict re-derives as arithmetic on every gate run: SPECTACULAR RICHNESS WITHOUT MATURITY - TOC to 32.86 pct and S2 to 86.92 mg/g (genuine source potential in the Miocene coaly interval), yet every measured Tmax sits at 397-424 C, below the ~435 C oil-window threshold (thermally immature), with 8 of 9 samples at HI < 160 (gas-prone Type III/IV terrestrial organic matter) - a source rock that has everything except time and temperature",
+  "verified": "9 rows / 68 counted cells against the header's own Size declaration (EXACT under the measured convention: labels counted, geocode excluded); HI identity 9/9 within 0.47; transformation-ratio identity 7/7 within 0.005; TR/Tmax blank-coupling pinned on the two low-S2 rows; all Tmax < 435 with range 397-424; TOC maximum 32.86 and S2 maximum 86.92 pinned; 8/9 rows below HI 160; gate-pinned; source URL serves the identical dataset"
+}

gea/catalog/woodlark_1109_rock_eval.txt

@@ -0,0 +1,30 @@
+/* DATA DESCRIPTION:
+Citation:	Katz, Barry J (2001): (Table T2) Total organic carbon content, hydrocarbon characteristics and hydrogen and oxygen index of samples from ODP Hole 180-1109D [dataset]. PANGAEA, https://doi.org/10.1594/PANGAEA.787052, 
+	In supplement to: Katz, BJ (2001): Geochemical investigation of Sites 1108 and 1109, Leg 180. In: Huchon, P; Taylor, B; Klaus, A (eds.) Proceedings of the Ocean Drilling Program, Scientific Results, College Station, TX (Ocean Drilling Program), 180, 1-19, https://doi.org/10.2973/odp.proc.sr.180.151.2001
+Project(s):	Ocean Drilling Program (ODP) (URI: https://www-odp.tamu.edu:443/)
+Coverage:	LATITUDE: -9.506330 * LONGITUDE: 151.572580
+	DATE/TIME START: 1998-06-27T08:00:00 * DATE/TIME END: 1998-07-04T00:15:00
+	MINIMUM DEPTH, sediment/rock: 688.23 m * MAXIMUM DEPTH, sediment/rock: 706.36 m
+Event(s):	180-1109D * LATITUDE: -9.506330 * LONGITUDE: 151.572580 * DATE/TIME START: 1998-06-27T08:00:00 * DATE/TIME END: 1998-07-04T00:15:00 * ELEVATION: -2211.0 m * PENETRATION: 802 m * RECOVERY: 299.87 m * LOCATION: Solomon Sea * CAMPAIGN: Leg180 * BASIS: Joides Resolution (URI: https://www-odp.tamu.edu:443/resolutn.html) * METHOD/DEVICE: Drilling/drill rig (DRILL) * COMMENT: 51 core; 449.2 m cored; 352.8 m drilled; 66.8 % recovery
+Parameter(s):	Sample code/label (Sample label) * PI: Katz, Barry J * METHOD/DEVICE: DSDP/ODP/IODP sample designation (URI: hdl:10013/epic.27914.d001)
+	DEPTH, sediment/rock [m] (Depth sed) * GEOCODE * COMMENT: mbsf
+	Carbon, organic, total [%] (TOC) * PI: Katz, Barry J * METHOD/DEVICE: Element analyser CS, LECO
+	Hydrocarbon yield, S1, per unit sediment mass [mg/g] (S1 HC/sed) * PI: Katz, Barry J * METHOD/DEVICE: Rock eval pyrolysis (Espitalié et al. 1977) (URI: https://doi.org/10.2516/ogst:1977002)
+	Hydrocarbon yield, S2, per unit sediment mass [mg/g] (S2 HC/sed) * PI: Katz, Barry J * METHOD/DEVICE: Rock eval pyrolysis (Espitalié et al. 1977) (URI: https://doi.org/10.2516/ogst:1977002)
+	Hydrogen index, mass HC, per unit mass total organic carbon [mg/g] (HI, HC/TOC) * PI: Katz, Barry J
+	Oxygen index, mass CO2, per unit mass total organic carbon [mg/g] (OI, CO2/TOC) * PI: Katz, Barry J
+	Transformation ratio (S1/(S1 + S2)) * PI: Katz, Barry J
+	Pyrolysis temperature maximum [°C] (Tmax) * PI: Katz, Barry J
+License:	Creative Commons Attribution 3.0 Unported (CC-BY-3.0) (URI: https://creativecommons.org/licenses/by/3.0/)
+Size:	68 data points
+*/
+Sample label	Depth sed [m]	TOC [%]	S1 HC/sed [mg/g]	S2 HC/sed [mg/g]	HI, HC/TOC [mg/g]	OI, CO2/TOC [mg/g]	S1/(S1 + S2)	Tmax [°C]
+180-1109D-37R-2,73-75	688.23	17.33	1.60	12.61	73	7	0.11	415
+180-1109D-38R-1,124-125	696.84	32.86	5.03	49.69	151	63	0.09	424
+180-1109D-38R-2,29-31	697.21	27.69	11.45	86.92	314	41	0.12	397
+180-1109D-38R-2,90-92	697.90	22.99	1.97	12.38	54	61	0.14	401
+180-1109D-38R-5,21-22	701.51	1.46	0.09	0.75	51	80		
+180-1109D-38R-5,132-134	702.62	1.80	0.10	0.24	13	82		
+180-1109D-38R-6,37-39	703.17	5.66	0.34	1.78	31	71	0.16	403
+180-1109D-39R-1,16-18	705.46	3.31	0.24	1.42	43	72	0.14	414
+180-1109D-39R-1,106-108	706.36	14.07	1.08	7.11	51	68	0.13	399

gea/cli.py

@@ -0,0 +1,125 @@
+# 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.cli - the front door.
+
+    gea quickstart                      first run: a catalogue well, its reports, the dashboard
+    gea survey mywell.las               a LAS file in, one strata report out (--demo: bundled KTB excerpt)
+    gea dashboard ...                   the report family + index.html (see `gea dashboard -h`)
+    gea client-report ...  gea drift-monitor ...  gea well-test ...  gea alarms ...
+    gea model-cards ...    gea store-forward ...  gea sla-report ...  gea fat-sat ...
+    gea guide                           the click-by-click tester guide
+    gea docs                            where the catalogue and the reports live on this machine
+    gea gui                             the desktop window (desktop extra)
+    gea accept                          the product gate
+
+Every subcommand not listed here is passed to `python -m gea` unchanged, so the
+full command set is one entry point. PATH-proof form: `python -m gea.cli ...`.
+"""
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+FRONT = {'quickstart', 'survey', 'guide', 'docs', 'gui', 'help', '-h', '--help'}
+
+
+def _pkg_root() -> Path:
+    return Path(__file__).resolve().parent
+
+
+def _repo_root() -> Path:
+    return _pkg_root().parent
+
+
+def cmd_survey(argv) -> int:
+    import argparse
+    ap = argparse.ArgumentParser(prog='gea survey', description='a LAS file in, one strata report out')
+    ap.add_argument('file', nargs='?', default=None, help='LAS file (omit with --demo)')
+    ap.add_argument('--demo', action='store_true', help='run the bundled public KTB excerpt')
+    ap.add_argument('--family', default='continental_crystalline', help='prior family for the estimator')
+    ap.add_argument('--lat', type=float, default=None)
+    ap.add_argument('--elev', type=float, default=None)
+    a = ap.parse_args(argv)
+    from .survey_cmd import run_survey
+    txt, _ = run_survey(path=a.file, demo=a.demo, family=a.family, lat=a.lat, elev=a.elev)
+    print(txt)
+    return 0
+
+
+def cmd_guide(_argv) -> int:
+    for cand in (_repo_root() / 'docs' / 'TESTER_GUIDE.md', _pkg_root() / 'TESTER_GUIDE.md'):
+        if cand.exists():
+            print(cand.read_text(encoding='utf-8'))
+            return 0
+    print('TESTER_GUIDE.md not found beside the package')
+    return 2
+
+
+def cmd_docs(_argv) -> int:
+    from . import __version__
+    cat = _pkg_root() / 'catalog'
+    n = sum(1 for p in cat.iterdir() if p.suffix != '.json') if cat.exists() else 0
+    print(f'gea build {__version__}')
+    print(f'package:    {_pkg_root()}')
+    print(f'catalogue:  {cat} ({n} entries, each with a .provenance.json)')
+    print(f'reports:    written where you point --out (dashboard/, client_report/, model_cards/, ...)')
+    print(f'records:    drift_monitor/ (evaluations.jsonl, change_log.jsonl), well_tests/ (approvals.jsonl), config_store/')
+    print(f'guide:      gea guide')
+    return 0
+
+
+def cmd_quickstart(_argv) -> int:
+    from . import __version__
+    print(f'== gea quickstart (build {__version__}) ==')
+    print('[1/3] a real catalogue well: Volve 15/9-F-12, 157 daily downhole-pressure samples')
+    from .__main__ import main as sub
+    out = os.path.abspath('gea_quickstart')
+    rc = sub(['dashboard', '--catalog-well', 'volve_f12_f14_production_excerpt:15/9-F-12:10000',
+              '--td', '10500', '--name', 'quickstart', '--out', out])
+    if rc:
+        return rc
+    print('[2/3] the strata survey on the bundled KTB excerpt')
+    rc = cmd_survey(['--demo'])
+    if rc:
+        return rc
+    print('[3/3] done.')
+    print(f'   open {os.path.join(out, "index.html")} in a browser - every tile links to its report.')
+    print('   next: gea dashboard -h | gea client-report -h | gea guide | gea accept')
+    return 0
+
+
+def cmd_gui(_argv) -> int:
+    try:
+        from .shell import main as shell_main
+    except ImportError as e:
+        print(f'gea gui needs the desktop extra:  pip install "gea-program[desktop]"  ({e})')
+        return 3
+    return shell_main()
+
+
+def main(argv=None) -> int:
+    argv = list(sys.argv[1:] if argv is None else argv)
+    if not argv or argv[0] in ('help', '-h', '--help'):
+        print(__doc__)
+        if argv and argv[0] in ('-h', '--help'):
+            return 0
+        return 0
+    cmd, rest = argv[0], argv[1:]
+    if cmd == 'quickstart':
+        return cmd_quickstart(rest)
+    if cmd == 'survey':
+        return cmd_survey(rest)
+    if cmd == 'guide':
+        return cmd_guide(rest)
+    if cmd == 'docs':
+        return cmd_docs(rest)
+    if cmd == 'gui':
+        return cmd_gui(rest)
+    from .__main__ import main as sub
+    return sub(argv)
+
+
+if __name__ == '__main__':
+    raise SystemExit(main())