energy_data_retrieval.bess_catalogue.mastr#

Offline, review-only staging of MaStR revision 26.2 storage XML partitions.

Units and storage installations have different IDs and rating boundaries. No site aggregation, fuzzy identity matching, operator-name lookup or COD inference is performed. Downloaded XML and ZIP members remain outside the repository.

energy_data_retrieval.bess_catalogue.mastr.stage_mastr_storage(unit_paths, storage_paths, values_path, *, snapshot_date, minimum_kw=1000)[source]#

Stage ratings >= threshold, including flagged non-battery exclusions.

Duplicate IDs fail across partitions. Shared locations are flagged using all supplied battery units, including those below the power threshold. This is not a guarantee of completeness across omitted export partitions. Energy joins require a reciprocal, single-unit storage link; otherwise energy is withheld. Raw source dates remain observations, never commercial COD.

Parameters:
  • unit_paths (list[Path])

  • storage_paths (list[Path])

  • values_path (Path)

  • snapshot_date (str)

  • minimum_kw (float)

Return type:

list[dict[str, Any]]