curtailment 0.1.0__tar.gz

curtailment-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BitSquad LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

curtailment-0.1.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: curtailment
+Version: 0.1.0
+Summary: Curtailment proof report: measured load vs. ERCOT real-time price from a CSV log
+Author-email: BitSquad LLC <admin@megawattland.com>
+License: MIT
+Project-URL: Homepage, https://megawattland.com
+Project-URL: Repository, https://github.com/chutch62416-netizen/vault
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# curtailment
+
+Curtailment proof report: measured load vs. ERCOT real-time price from a CSV log
+
+## Usage
+
+```
+curtailment report curtail.csv [--spike 100] [--days 30] [--json]
+```
+
+`curtail.csv` has columns `ts,hosts_ok,hosts_total,kw,ths,price_mwh` (ISO timestamp, kW, $/MWh).
+The report gives baseline load below the spike threshold, load during spikes, curtailment
+percentage, zone average price and the load-weighted price actually paid.
+
+```python
+from curtailment import report
+report(rows, spike=100, days=30)
+```
+
+Maintained by [BitSquad LLC / MegawattLand](https://megawattland.com). MIT license. Source: https://github.com/chutch62416-netizen/vault

curtailment-0.1.0/README.md

@@ -0,0 +1,20 @@
+# curtailment
+
+Curtailment proof report: measured load vs. ERCOT real-time price from a CSV log
+
+## Usage
+
+```
+curtailment report curtail.csv [--spike 100] [--days 30] [--json]
+```
+
+`curtail.csv` has columns `ts,hosts_ok,hosts_total,kw,ths,price_mwh` (ISO timestamp, kW, $/MWh).
+The report gives baseline load below the spike threshold, load during spikes, curtailment
+percentage, zone average price and the load-weighted price actually paid.
+
+```python
+from curtailment import report
+report(rows, spike=100, days=30)
+```
+
+Maintained by [BitSquad LLC / MegawattLand](https://megawattland.com). MIT license. Source: https://github.com/chutch62416-netizen/vault

curtailment-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "curtailment"
+version = "0.1.0"
+description = "Curtailment proof report: measured load vs. ERCOT real-time price from a CSV log"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "BitSquad LLC", email = "admin@megawattland.com"}]
+requires-python = ">=3.9"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://megawattland.com"
+Repository = "https://github.com/chutch62416-netizen/vault"
+
+[project.scripts]
+curtailment = "curtailment:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

curtailment-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

curtailment-0.1.0/src/curtailment/__init__.py

@@ -0,0 +1,88 @@
+"""curtailment: prove that a flexible load actually comes off when the zone price spikes.
+
+Input CSV columns: ts,hosts_ok,hosts_total,kw,ths,price_mwh  (price in $/MWh, blank = unknown)
+"""
+from __future__ import annotations
+
+import argparse
+import csv
+import datetime as dt
+import json
+import statistics
+import sys
+from pathlib import Path
+
+__version__ = "0.1.0"
+__all__ = ["report", "main", "__version__"]
+
+
+def report(rows: list[dict], spike: float = 100.0, days: int = 30, now: dt.datetime | None = None) -> dict:
+    """Summarise curtailment behaviour from logged (ts, kw, price_mwh) rows."""
+    now = now or dt.datetime.now()
+    cutoff = now - dt.timedelta(days=days)
+    rows = [r for r in rows if dt.datetime.fromisoformat(r["ts"]) >= cutoff and r.get("price_mwh")]
+    if not rows:
+        return {"intervals": 0}
+    kw = [float(r["kw"]) for r in rows]
+    pr = [float(r["price_mwh"]) for r in rows]
+    spikes = [(k, p) for k, p in zip(kw, pr) if p >= spike]
+    normal = [k for k, p in zip(kw, pr) if p < spike]
+    neg = [k for k, p in zip(kw, pr) if p < 0]
+    base = statistics.mean(normal) if normal else 0.0
+    spike_kw = statistics.mean(k for k, _ in spikes) if spikes else None
+    weighted_cost = sum(k * p for k, p in zip(kw, pr)) / max(sum(kw), 1e-9)  # kW-weighted $/MWh paid
+    return {
+        "intervals": len(rows),
+        "days": days,
+        "spike_threshold": spike,
+        "spike_intervals": len(spikes),
+        "baseline_kw": round(base, 1),
+        "kw_during_spikes": None if spike_kw is None else round(spike_kw, 1),
+        "curtailment_pct": None if spike_kw is None or base == 0 else round(100 * (1 - spike_kw / base), 1),
+        "zone_avg_price": round(statistics.mean(pr), 2),
+        "paid_avg_price": round(weighted_cost, 2),
+        "negative_price_intervals": len(neg),
+        "kw_at_negative_price": round(statistics.mean(neg), 1) if neg else None,
+    }
+
+
+def _print(r: dict) -> None:
+    print(f"Curtailment proof - last {r['days']} days, {r['intervals']} priced intervals")
+    print(f"  baseline load (price < ${r['spike_threshold']:.0f})      {r['baseline_kw']:.1f} kW")
+    if r["kw_during_spikes"] is not None:
+        print(f"  load during spikes (>= ${r['spike_threshold']:.0f}, {r['spike_intervals']} intervals)   "
+              f"{r['kw_during_spikes']:.1f} kW  -> curtailed {r['curtailment_pct']:.0f}%")
+    else:
+        print(f"  no intervals at or above ${r['spike_threshold']:.0f}/MWh in range")
+    print(f"  zone average price                {r['zone_avg_price']:.2f} $/MWh")
+    print(f"  load-weighted price actually paid {r['paid_avg_price']:.2f} $/MWh")
+    if r["negative_price_intervals"]:
+        print(f"  negative-price intervals          {r['negative_price_intervals']} (load {r['kw_at_negative_price']:.1f} kW)")
+
+
+def main(argv=None) -> int:
+    p = argparse.ArgumentParser(prog="curtailment", description=__doc__,
+                                formatter_class=argparse.RawDescriptionHelpFormatter)
+    p.add_argument("--version", action="version", version=__version__)
+    sub = p.add_subparsers(dest="cmd", required=True)
+    r = sub.add_parser("report", help="summarise a curtailment log CSV")
+    r.add_argument("log")
+    r.add_argument("--spike", type=float, default=100.0, help="spike threshold $/MWh (default 100)")
+    r.add_argument("--days", type=int, default=30)
+    r.add_argument("--json", action="store_true", help="emit JSON")
+    a = p.parse_args(argv)
+    with Path(a.log).open(newline="") as f:
+        rows = list(csv.DictReader(f))
+    res = report(rows, a.spike, a.days)
+    if not res["intervals"]:
+        print("no priced intervals in range", file=sys.stderr)
+        return 1
+    if a.json:
+        print(json.dumps(res, indent=2))
+    else:
+        _print(res)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

curtailment-0.1.0/src/curtailment/__main__.py

@@ -0,0 +1,3 @@
+from . import main
+
+raise SystemExit(main())

curtailment-0.1.0/src/curtailment.egg-info/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: curtailment
+Version: 0.1.0
+Summary: Curtailment proof report: measured load vs. ERCOT real-time price from a CSV log
+Author-email: BitSquad LLC <admin@megawattland.com>
+License: MIT
+Project-URL: Homepage, https://megawattland.com
+Project-URL: Repository, https://github.com/chutch62416-netizen/vault
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# curtailment
+
+Curtailment proof report: measured load vs. ERCOT real-time price from a CSV log
+
+## Usage
+
+```
+curtailment report curtail.csv [--spike 100] [--days 30] [--json]
+```
+
+`curtail.csv` has columns `ts,hosts_ok,hosts_total,kw,ths,price_mwh` (ISO timestamp, kW, $/MWh).
+The report gives baseline load below the spike threshold, load during spikes, curtailment
+percentage, zone average price and the load-weighted price actually paid.
+
+```python
+from curtailment import report
+report(rows, spike=100, days=30)
+```
+
+Maintained by [BitSquad LLC / MegawattLand](https://megawattland.com). MIT license. Source: https://github.com/chutch62416-netizen/vault

curtailment-0.1.0/src/curtailment.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/curtailment/__init__.py
+src/curtailment/__main__.py
+src/curtailment.egg-info/PKG-INFO
+src/curtailment.egg-info/SOURCES.txt
+src/curtailment.egg-info/dependency_links.txt
+src/curtailment.egg-info/entry_points.txt
+src/curtailment.egg-info/top_level.txt
+tests/test_curtailment.py

curtailment-0.1.0/src/curtailment.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

curtailment-0.1.0/src/curtailment.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+curtailment = curtailment:main

curtailment-0.1.0/src/curtailment.egg-info/top_level.txt

@@ -0,0 +1 @@
+curtailment

curtailment-0.1.0/tests/test_curtailment.py

@@ -0,0 +1,23 @@
+import datetime as dt
+from curtailment import report
+
+
+def test_report_curtails():
+    now = dt.datetime(2026, 1, 10)
+    rows = [
+        {"ts": "2026-01-09T00:00:00", "kw": "1000", "price_mwh": "30"},
+        {"ts": "2026-01-09T00:15:00", "kw": "1000", "price_mwh": "40"},
+        {"ts": "2026-01-09T00:30:00", "kw": "100", "price_mwh": "500"},
+        {"ts": "2026-01-09T00:45:00", "kw": "1000", "price_mwh": "-5"},
+        {"ts": "2025-01-01T00:00:00", "kw": "999", "price_mwh": "999"},  # out of range
+    ]
+    r = report(rows, spike=100, days=30, now=now)
+    assert r["intervals"] == 4
+    assert r["spike_intervals"] == 1
+    assert r["baseline_kw"] == 1000.0
+    assert r["curtailment_pct"] == 90.0
+    assert r["negative_price_intervals"] == 1
+
+
+def test_empty():
+    assert report([], 100, 30)["intervals"] == 0