gea-program 0.84.0__tar.gz → 0.86.0__tar.gz

{gea_program-0.84.0/gea_program.egg-info → gea_program-0.86.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gea-program
-Version: 0.84.0
+Version: 0.86.0
 Summary: GEA-Program: downhole gauge monitoring - canonical measurement records, quality rules, drift evaluation with a re-fit change log, well-test validation, alarm management, model cards, store-and-forward, monthly SLA measurement, FAT/SAT protocols and a dashboard, generated from live objects in the client's reporting outline.
 Author: Daniel T. Murphy
 License: MPL-2.0
@@ -847,7 +847,7 @@ unsigned, the key hand-overs - and shows the reports as they were signed. A
 reader made from the workspace knows the site's key fingerprints, so it
 says whether a dossier is the site's; it allows no network request, and it
 leaves the trusted time-stamp to `verify_dossier.py`. For a client who wants
-it installed, every release also carries `GEA-Reader-Setup-0.84.0.exe`: GEA
+it installed, every release also carries `GEA-Reader-Setup-0.86.0.exe`: GEA
 Reader as a Windows program of its own - its own icon and taskbar button,
 Check with GEA Reader on a dossier's right-click menu, fingerprints the client
 saves kept on that computer, nothing of GEA-Program. `gea help reader`.
@@ -966,6 +966,40 @@ pressure rise there and the volume it would take for the water itself to
 arrive, every projection labelled SIMULATION. The **Fluid balance** tab,
 `gea fluid`, `gea help fluid`.
 
+### Pressure plume
+
+The ledger's barrels put into the declared formation on a plan grid
+centred on the injection well and stepped forward day by day - single-phase,
+slightly compressible flow by explicit finite differences, checked against
+the line source on the page. The rise drawn as contours at every month's
+end of the record and a year on, both continued at the last rates and shut
+in now; the cells over a declared threshold as the area of review, in acres
+and reach; every mapped fault within the radius read for its rise and its
+slip tendency at each snapshot, with the first day its margin would be used
+up; a fault layer declared sealing blocks the flow and the plume piles up
+against it. The same contours drawn at the declared top in the 3D tab and
+carried in the dossier. Every figure a SIMULATION, said on every line. The
+**Pressure plume** tab, `gea plume`, `gea help plume`.
+
+### Fluid front
+
+Where the injected water itself has gone. The pressure plume is miles wide;
+the water, which has to push the formation's own out of the pore space, is
+hundreds of feet from the well. On a fine grid around each injection well
+the wells' steady flow is solved once per well (conjugate gradients, the
+sealing faults closed) and the injected water moved with it - the fraction
+of the thickness it fills, spreading under its own weight against the
+formation water's by the sharp-interface equations, so a denser water runs
+out along the base and a lighter one along the top. The tip, the half and
+the whole thickness against a piston of the same volume; the day the water
+reaches each producer, its share of that producer's stream and the TDS that
+predicts, beside the TDS the producer's own report measures and the share
+that implies; continued and shut in for five years; every injected barrel
+accounted - in place, produced back, across a fault, beyond the grid. Drawn
+in plan, in section and, at its depths, in the 3D tab. Every figure a
+SIMULATION, said on every line. The **Fluid front** tab, `gea front`,
+`gea help front`.
+
 ### Plan vs actual and the survey tools
 
 Each well against its directional plan: at every survey station, how far
@@ -1630,7 +1664,7 @@ attaches the zips to the GitHub release of that tag.
 
 ### The Windows installer
 
-Every release also carries `GEA-Program-Setup-0.84.0.exe` (for 0.84.0): the
+Every release also carries `GEA-Program-Setup-0.86.0.exe` (for 0.86.0): the
 same Windows kit installed like any Windows program, for the signed-in user
 alone and with no administrator rights (`%LOCALAPPDATA%\Programs\GEA-Program`).
 It asks for the site workspace (an existing one such as `C:\site` is used as
@@ -1649,7 +1683,7 @@ it, removes the program and leaves the workspace. Silent, for a site's
 software deployment:
 
 ```
-GEA-Program-Setup-0.84.0.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /WORKSPACE="C:\site" /SITENAME="Pad 3" /TASKS="desktopicon"
+GEA-Program-Setup-0.86.0.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /WORKSPACE="C:\site" /SITENAME="Pad 3" /TASKS="desktopicon"
 ```
 
 The setup is built by Inno Setup 6 from `tools/installer.iss` in the same

{gea_program-0.84.0 → gea_program-0.86.0}/README.md

@@ -808,7 +808,7 @@ unsigned, the key hand-overs - and shows the reports as they were signed. A
 reader made from the workspace knows the site's key fingerprints, so it
 says whether a dossier is the site's; it allows no network request, and it
 leaves the trusted time-stamp to `verify_dossier.py`. For a client who wants
-it installed, every release also carries `GEA-Reader-Setup-0.84.0.exe`: GEA
+it installed, every release also carries `GEA-Reader-Setup-0.86.0.exe`: GEA
 Reader as a Windows program of its own - its own icon and taskbar button,
 Check with GEA Reader on a dossier's right-click menu, fingerprints the client
 saves kept on that computer, nothing of GEA-Program. `gea help reader`.
@@ -927,6 +927,40 @@ pressure rise there and the volume it would take for the water itself to
 arrive, every projection labelled SIMULATION. The **Fluid balance** tab,
 `gea fluid`, `gea help fluid`.
 
+### Pressure plume
+
+The ledger's barrels put into the declared formation on a plan grid
+centred on the injection well and stepped forward day by day - single-phase,
+slightly compressible flow by explicit finite differences, checked against
+the line source on the page. The rise drawn as contours at every month's
+end of the record and a year on, both continued at the last rates and shut
+in now; the cells over a declared threshold as the area of review, in acres
+and reach; every mapped fault within the radius read for its rise and its
+slip tendency at each snapshot, with the first day its margin would be used
+up; a fault layer declared sealing blocks the flow and the plume piles up
+against it. The same contours drawn at the declared top in the 3D tab and
+carried in the dossier. Every figure a SIMULATION, said on every line. The
+**Pressure plume** tab, `gea plume`, `gea help plume`.
+
+### Fluid front
+
+Where the injected water itself has gone. The pressure plume is miles wide;
+the water, which has to push the formation's own out of the pore space, is
+hundreds of feet from the well. On a fine grid around each injection well
+the wells' steady flow is solved once per well (conjugate gradients, the
+sealing faults closed) and the injected water moved with it - the fraction
+of the thickness it fills, spreading under its own weight against the
+formation water's by the sharp-interface equations, so a denser water runs
+out along the base and a lighter one along the top. The tip, the half and
+the whole thickness against a piston of the same volume; the day the water
+reaches each producer, its share of that producer's stream and the TDS that
+predicts, beside the TDS the producer's own report measures and the share
+that implies; continued and shut in for five years; every injected barrel
+accounted - in place, produced back, across a fault, beyond the grid. Drawn
+in plan, in section and, at its depths, in the 3D tab. Every figure a
+SIMULATION, said on every line. The **Fluid front** tab, `gea front`,
+`gea help front`.
+
 ### Plan vs actual and the survey tools
 
 Each well against its directional plan: at every survey station, how far
@@ -1591,7 +1625,7 @@ attaches the zips to the GitHub release of that tag.
 
 ### The Windows installer
 
-Every release also carries `GEA-Program-Setup-0.84.0.exe` (for 0.84.0): the
+Every release also carries `GEA-Program-Setup-0.86.0.exe` (for 0.86.0): the
 same Windows kit installed like any Windows program, for the signed-in user
 alone and with no administrator rights (`%LOCALAPPDATA%\Programs\GEA-Program`).
 It asks for the site workspace (an existing one such as `C:\site` is used as
@@ -1610,7 +1644,7 @@ it, removes the program and leaves the workspace. Silent, for a site's
 software deployment:
 
 ```
-GEA-Program-Setup-0.84.0.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /WORKSPACE="C:\site" /SITENAME="Pad 3" /TASKS="desktopicon"
+GEA-Program-Setup-0.86.0.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /WORKSPACE="C:\site" /SITENAME="Pad 3" /TASKS="desktopicon"
 ```
 
 The setup is built by Inno Setup 6 from `tools/installer.iss` in the same

{gea_program-0.84.0 → gea_program-0.86.0}/gea/__init__.py

@@ -123,7 +123,7 @@ from .profile_catalog import (
     read_pangaea_txt,
 )
 
-__version__ = "0.84.0"
+__version__ = "0.86.0"
 __all__ = [
     "aging_rate", "rate_psi_yr", "accuracy_psi",
     "Sensor", "SimulatorConfig", "DownholeEngine",

{gea_program-0.84.0 → gea_program-0.86.0}/gea/__main__.py

@@ -590,6 +590,27 @@ def main(argv=None) -> int:
     p_fl.add_argument("--write", action="store_true", help="write the report under reports/fluid/ (fluid_balance.json, .md, the ledger CSVs)")
     p_fl.add_argument("--actor", type=str, default="cli")
     p_fl.add_argument("--json", action="store_true")
+    p_pm = sub.add_parser("plume", help="the pressure plume (SIMULATION): the ledger's barrels put into the formation on a plan grid and stepped through time - the rise as contours at every month's end and a year on, continued or shut in; the area of review over a declared threshold; every mapped fault's rise and slip tendency through time, sealing or open as declared")
+    p_pm.add_argument("--workspace", type=str, default=None, help="the workspace folder; without one the self-test runs (the grid against the line source, a sealing fault, the contours)")
+    p_pm.add_argument("--formation", type=str, default=None, help="one formation's plume (default: every formation with an injection ledger)")
+    p_pm.add_argument("--threshold-psi", type=float, default=None, help="settings: the area of review's threshold, psi (default 50)")
+    p_pm.add_argument("--cells", type=int, default=None, help="settings: cells per side of the grid, odd, 21 to 121 (default 81)")
+    p_pm.add_argument("--radius-km", type=float, default=None, help="settings: the radius the faults are taken within (default 25)")
+    p_pm.add_argument("--projection-days", type=int, default=None, help="settings: how far beyond the record to project (default 365)")
+    p_pm.add_argument("--sealing", type=str, default=None, help="settings: a structure layer whose faults block flow (with --source)")
+    p_pm.add_argument("--open", dest="open_layer", type=str, default=None, help="settings: a structure layer whose faults do not block flow again")
+    p_pm.add_argument("--source", type=str, default="", help="where the sealing declaration comes from")
+    p_pm.add_argument("--write", action="store_true", help="write reports/plume/plume.json and .md")
+    p_pm.add_argument("--actor", type=str, default="cli")
+    p_pm.add_argument("--json", action="store_true")
+    p_ff = sub.add_parser("front", help="the fluid front (SIMULATION): where the injected water itself has gone - the fraction of the thickness it fills on a fine grid around each injection well, moved by the wells' steady flow and spread by its own weight against the formation water's; the day it reaches each producer, its share of the stream and the TDS that predicts beside the measured one; every injected barrel accounted")
+    p_ff.add_argument("--workspace", type=str, default=None, help="the workspace folder; without one the self-test runs (the piston radius, the doublet's breakthrough, the tongue, a sealing fault)")
+    p_ff.add_argument("--well", type=str, default=None, help="one injection well's front (default: every injection well in the ledger)")
+    p_ff.add_argument("--cells", type=int, default=None, help="settings: cells per side of the grid, odd, 41 to 141 (default 81)")
+    p_ff.add_argument("--projection-days", type=int, default=None, help="settings: how far beyond the record to project, 365 to 7300 (default 1825)")
+    p_ff.add_argument("--write", action="store_true", help="write reports/front/front.json and .md")
+    p_ff.add_argument("--actor", type=str, default="cli")
+    p_ff.add_argument("--json", action="store_true")
     p_os = sub.add_parser("seismicity", help="operations and seismicity: each well's drilling, completion and disposal windows against the earthquake catalogue around it - the events during and after each, the levels a regulator's protocol would reach, and the rate during operations against the rest of the record; the Mahoning Valley worked example")
     p_os.add_argument("--workspace", type=str, default=None)
     p_os.add_argument("--scene", type=str, default=None, choices=("workspace", "mahoning"), help="your wells (the default with --workspace) or the public worked example")
@@ -2687,6 +2708,74 @@ def main(argv=None) -> int:
             raise SystemExit(f"fluid: {e.args[0] if e.args else e}")
         print(_json.dumps(p, default=str) if a.json else _FL.text(p))
         return 0
+    elif a.cmd == "plume":
+        import json as _json
+        from . import plume as _PM
+        from .cli import _safe_stdout
+        from .workspace import Workspace, WorkspaceError
+        _safe_stdout()
+        if not a.workspace:
+            r = _PM.selftest()
+            print(_json.dumps(r, default=str) if a.json else "\n".join(f"{'PASS' if c['pass'] else 'FAIL'}  {c['check']}: {c['value']}" for c in r["checks"]) + f"\n{'OK' if r['ok'] else 'FAILED'} - {r['label']} (grid {r['grid']['n']} x {r['grid']['n']}, {r['grid']['dx_ft']} ft, {r['grid']['substeps_per_day']} sub-steps a day)")
+            return 0 if r["ok"] else 1
+        try:
+            ws = Workspace(a.workspace)
+        except WorkspaceError as e:
+            raise SystemExit(f"plume: {e}")
+        try:
+            if any(v is not None for v in (a.threshold_psi, a.cells, a.radius_km, a.projection_days, a.sealing, a.open_layer)):
+                sealing = {}
+                if a.sealing:
+                    sealing[a.sealing] = True
+                if a.open_layer:
+                    sealing[a.open_layer] = False
+                st_ = _PM.set_settings(ws, a.actor, a.threshold_psi, a.cells, a.radius_km, sealing or None, a.projection_days, a.source)
+                print("settings: " + ", ".join(f"{k} {v}" for k, v in st_.items() if k in ("threshold_psi", "cells", "radius_km", "projection_days", "sealing_layers")))
+                return 0
+            if a.write:
+                from . import __version__ as _ver85
+                r = _PM.write_report(ws, _ver85, a.actor)
+                print(f"written: {', '.join(r['files'])} under {r['folder']}")
+                p = r["page"]
+            else:
+                p = _PM.page(ws, a.formation)
+        except (_PM.PlumeError, WorkspaceError, ValueError, OSError) as e:
+            raise SystemExit(f"plume: {e.args[0] if e.args else e}")
+        if a.json:
+            print(_json.dumps(p, default=str))
+        else:
+            print(_PM.text(p))
+        return 0
+    elif a.cmd == "front":
+        import json as _json
+        from . import front as _FF
+        from .cli import _safe_stdout
+        from .workspace import Workspace, WorkspaceError
+        _safe_stdout()
+        if not a.workspace:
+            r = _FF.selftest()
+            print(_json.dumps(r, default=str) if a.json else "\n".join(f"{'PASS' if c['pass'] else 'FAIL'}  {c['check']}: {c['value']}" for c in r["checks"]) + f"\n{'OK' if r['ok'] else 'FAILED'} - {r['label']}")
+            return 0 if r["ok"] else 1
+        try:
+            ws = Workspace(a.workspace)
+        except WorkspaceError as e:
+            raise SystemExit(f"front: {e}")
+        try:
+            if a.cells is not None or a.projection_days is not None:
+                st_ = _FF.set_settings(ws, a.actor, a.cells, a.projection_days)
+                print("settings: " + ", ".join(f"{k} {v}" for k, v in st_.items() if k in ("cells", "projection_days")))
+                return 0
+            if a.write:
+                from . import __version__ as _ver86
+                r = _FF.write_report(ws, _ver86, a.actor)
+                print(f"written: {', '.join(r['files'])} under {r['folder']}")
+                p = r["page"]
+            else:
+                p = _FF.page(ws, a.well)
+        except (_FF.FrontError, WorkspaceError, ValueError, OSError) as e:
+            raise SystemExit(f"front: {e.args[0] if e.args else e}")
+        print(_json.dumps(p, default=str) if a.json else _FF.text(p))
+        return 0
     elif a.cmd == "seismicity":
         import json as _json
         from . import op_seismicity as _OS