Source code for energy_data_retrieval.bess_catalogue.emi
"""Stage Electricity Authority dispatched-fleet battery observations offline."""
import csv
import io
import math
[docs]
def parse_emi_batteries(content: bytes) -> list[dict[str, str]]:
"""Keep dated BAT observations, without treating effective dates as COD.
Repeated units with different effective periods remain separate candidates;
conflicting or duplicate observation identities require manual review.
"""
reader = csv.DictReader(io.StringIO(content.decode("utf-8-sig")))
required = {
"PlantName",
"TechnologyCode",
"PointOfConnectionCode",
"UnitCode",
"NameplateMegawatts",
"EffectiveStartDate",
"EffectiveEndDate",
}
if not required.issubset(reader.fieldnames or []):
raise ValueError("EMI header changed")
output = []
seen = set()
for row in reader:
if row["TechnologyCode"] != "BAT":
continue
key = tuple(row[k] for k in ("PointOfConnectionCode", "UnitCode", "EffectiveStartDate"))
if key in seen:
raise ValueError("Duplicate EMI observation; review revisions")
seen.add(key)
value = float(row["NameplateMegawatts"])
if not math.isfinite(value) or value < 0:
raise ValueError("Invalid EMI battery power")
output.append(row)
return output