energy_data_retrieval.pv_catalogue.electra#

Read a pinned, bounded Electra search export as candidates, never as projects.

The filtered CSV is only an index. INSTALACIONID is not established as a whole plant identity; AUTOID is merely an export sequence. No capacity, lifecycle, owner or technology is inferred from installation names.

energy_data_retrieval.pv_catalogue.electra.read_electra_csv(content, *, sha256, scope_page, scope_sha256, region, minimum_net_kw)[source]#

Check both captures, echoed PV/region/filter, schema, count and identifiers.

Reject an unfiltered or truncated export. The query’s net-power threshold is retained only as selection provenance, never as a record’s capacity value. Network access and canonical acceptance remain explicit separate operations.

Parameters:
  • content (bytes)

  • sha256 (str)

  • scope_page (bytes)

  • scope_sha256 (str)

  • region (str)

  • minimum_net_kw (int)

Return type:

list[dict[str, str]]

energy_data_retrieval.pv_catalogue.electra.screen_electra_candidates(rows, *, existing)[source]#

Return review reasons keyed by registry ID; never auto-merge names.

All index rows require phase/privacy/freshness review. Exact normalized name equality only adds a conservative crosswalk flag, never proves identity. Return no installation names or holder/contact information in review output.

Parameters:
  • rows (list[dict[str, str]])

  • existing (list[dict[str, Any]])

Return type:

dict[str, list[str]]