Source code for energy_data_retrieval.bess_oem_catalogue.ingeteam

"""Offline staging of three reviewed Ingeteam battery-converter datasheets.

No identities are imported. kVA stays apparent power; voltage operating points
of the 350TL remain one model. Common specifications require visual review.
"""

from __future__ import annotations

import hashlib
import re
from typing import Any


def _between(text: str, start: str, end: str) -> str:
    if text.count(start) != 1 or text.count(end) != 1:
        raise ValueError(f"Missing or repeated table boundary: {start}")
    return text.split(start)[1].split(end)[0]


def _numbers(text: str, count: int, suffix: str = "") -> list[int]:
    pattern = r"(?<![\w.])([\d,]+)" + suffix
    values = [int(x.replace(",", "")) for x in re.findall(pattern, text)]
    if len(values) != count or any(x <= 0 for x in values):
        raise ValueError("Unexpected numeric column count or nonpositive value")
    return values


[docs] def parse_converter_text(content: bytes, series: str) -> list[dict[str, Any]]: """Stage reviewed revisions M/C/350; reject unit, heading and shape changes.""" pages = content.decode("utf-8-sig").split("\f") revisions = {"M": "300002287_C", "C": "300001994/F", "350": "300002273_A"} if series not in revisions or revisions[series] not in " ".join(pages): raise ValueError("Unreviewed series or revision") expected = {"M": "4540TL", "C": "3930TL HV", "350": "350TL"}[series] if expected not in " ".join(pages): raise ValueError("Missing exact converter model heading") out: list[dict[str, Any]] = [] if series == "M": table = pages[3] if len(pages) > 3 else "" if not re.search(r"M600\s+M630\s+M660\s+M690", table): raise ValueError("Changed M configuration headers") if not re.search(r"INPUT \(DC\)\s+" + r"M3\s+M4\s+" * 3 + r"M3\s+M4", table): raise ValueError("Changed module configuration order") power = _numbers(_between(table, "(40 °C)[kVA]", "Discharge/charge current"), 8) current = _numbers( _between(table, "Discharge/charge current (40 °C) [A]", "AC output voltage"), 8 ) ranges = re.findall( r"([\d,]+) to 1,500", _between(table, "INPUT (DC)", "Nº DC inputs per module") ) if len(ranges) != 8: raise ValueError("Changed M DC voltage envelopes") for i in range(8): j = i // 2 out.append( dict( model="INGECON SUN STORAGE 4540TL", configuration=f"M{[600, 630, 660, 690][j]} M{3 + i % 2}", ac_voltage_v=[600, 630, 660, 690][j], modules=3 + i % 2, charge_discharge_kva=power[i], ac_current_a=current[i], rated_temperature_c=40, off_grid_dc_min_v=int(ranges[j].replace(",", "")), grid_tied_dc_min_v=int(ranges[4 + j].replace(",", "")), locator=f"PDF p4 column {i + 1}", ) ) elif series == "C": table = pages[2] if len(pages) > 2 else "" voltages = [600, 630, 660, 690, 720, 760, 840] if not re.search(r"\s+".join(f"C{v}" for v in voltages), table): raise ValueError("Changed C configuration headers") discharge = _numbers( _between(table, "Discharge power @1,500 Vdc", "Discharge current @1,500 Vdc"), 14, r" kVA", ) charge = _numbers( _between(table, "Charge power @1,500 Vdc", "Charge current @1,500 Vdc"), 14, r" kVA" ) ranges = re.findall(r"([\d,]+) - 1,500 V", _between(table, "INPUT (DC)", "Maximum voltage")) if len(ranges) != 14 or "(30 °C/ 50 °C)" not in table: raise ValueError("Changed C voltage envelopes or temperatures") for i, voltage in enumerate(voltages): out.append( dict( model="INGECON SUN STORAGE 3930TL HV", configuration=f"C{voltage}", ac_voltage_v=voltage, discharge_kva_30c=discharge[i], discharge_kva_50c=discharge[i + 7], charge_kva_30c=charge[i], charge_kva_50c=charge[i + 7], rating_dc_voltage_v=1500, off_grid_dc_min_v=int(ranges[i].replace(",", "")), grid_tied_dc_min_v=int(ranges[i + 7].replace(",", "")), locator=f"PDF p3 column {i + 1}", ) ) else: points = [] for page, voltages in [(2, [600, 615, 630, 645, 660]), (3, [675, 690, 710, 730, 750, 800])]: table = pages[page] if len(pages) > page else "" if not re.search(r"\s+".join(f"{v} V" for v in voltages), table): raise ValueError("Changed 350TL operating-point headers") power = _numbers( _between(table, "Charge/Discharge power", "Charge/Discharge current"), len(voltages), r" kVA", ) ranges = re.findall( r"([\d,]+) - 1,500 V", _between(table, "INPUT (DC)", "Maximum voltage") ) if len(ranges) != len(voltages): raise ValueError("Changed 350TL voltage envelopes") points.extend( dict( ac_voltage_v=v, charge_discharge_kva=power[i], dc_min_v=int(ranges[i].replace(",", "")), locator=f"PDF p{page + 1} column {i + 1}", ) for i, v in enumerate(voltages) ) out.append( dict( model="INGECON SUN STORAGE 350TL", configuration="IEC variable AC voltage", operating_points=points, locator="PDF pp3-4; one model, eleven voltage-dependent operating points", ) ) for row in out: row.update( document_revision=revisions[series], extracted_text_sha256=hashlib.sha256(content).hexdigest(), active_power_not_inferred=True, ) return out