energy_data_retrieval.bess_catalogue.inventories#
Offline inventory adapters; outputs are candidates requiring scope reconciliation.
EIA rows aggregate operating battery units by plant ID. REPD rows retain planning reference IDs and must be checked for phases, aliases and revised applications. Neither adapter overwrites curated records or equates a planned date with COD.
- energy_data_retrieval.bess_catalogue.inventories.parse_aemo_frame(frame, *, source_id, retrieved_at, published_date)[source]#
Stage existing NEM battery units grouped by survey site, not whole hubs.
Sum unit aggregate AC nameplates, never multiply by unit count or substitute the shared site’s dispatch limit. Other battery phases remain nested outside totals. Full-commercial-use dates stay native, including past target dates. Separate survey sites can be components of one commercial project.
- Parameters:
frame (DataFrame)
source_id (str)
retrieved_at (str)
published_date (str)
- Return type:
list[dict[str, Any]]
- energy_data_retrieval.bess_catalogue.inventories.parse_cne_frame(frame, *, source_id, retrieved_at, published_date)[source]#
Stage Chile’s BESS construction declarations, retaining administrative scope.
Forecast interconnection months do not become exact CODs. Hybrid PMGD net power is kept native because its battery-only scope is ambiguous. Associated generation and additional injection are never substituted for battery power.
- Parameters:
frame (DataFrame)
source_id (str)
retrieved_at (str)
published_date (str)
- Return type:
list[dict[str, Any]]
- energy_data_retrieval.bess_catalogue.inventories.parse_inventory_workbook(content, *, provider, source_id, retrieved_at, published_date)[source]#
Read the explicit AEMO or CNE sheet with a bounded compressed/unpacked size.
- Parameters:
content (bytes)
provider (str)
source_id (str)
retrieved_at (str)
published_date (str)
- Return type:
list[dict[str, Any]]
- energy_data_retrieval.bess_catalogue.inventories.parse_eia860_frames(plants, storage, *, source_id, retrieved_at, year)[source]#
Aggregate OP batteries, retaining other battery units outside the totals.
Nameplate power is AC per EIA instructions; energy is nameplate (nominal). An incomplete component makes the total unknown, not a partial sum. Generator operating months/years stay nested; they are not a whole-project COD.
- Parameters:
plants (DataFrame)
storage (DataFrame)
source_id (str)
retrieved_at (str)
year (int)
- Return type:
list[dict[str, Any]]
- energy_data_retrieval.bess_catalogue.inventories.parse_eia860_archive(content, *, source_id, retrieved_at, year)[source]#
Read the two explicit workbook members without extracting archive paths.
- Parameters:
content (bytes)
source_id (str)
retrieved_at (str)
year (int)
- Return type:
list[dict[str, Any]]
- energy_data_retrieval.bess_catalogue.inventories.parse_repd_frame(frame, *, source_id, retrieved_at, published_date, development_status='Operational')[source]#
Stage one explicitly selected battery lifecycle partition, not automatically unique sites.
REPD does not report MWh. The applicant/operator label and grid coordinates remain native metadata; neither is promoted to ownership or WGS84 location. Operational dates remain native, without asserting an exact commercial COD.
- Parameters:
frame (DataFrame)
source_id (str)
retrieved_at (str)
published_date (str)
development_status (str)
- Return type:
list[dict[str, Any]]
- energy_data_retrieval.bess_catalogue.inventories.parse_repd_csv(content, *, source_id, retrieved_at, published_date, development_status='Operational')[source]#
Read the registered Windows-1252 REPD export with bounded input size.
- Parameters:
content (bytes)
source_id (str)
retrieved_at (str)
published_date (str)
development_status (str)
- Return type:
list[dict[str, Any]]