Source code for energy_data_retrieval.pv_catalogue.aragon

"""Offline Aragón operating-PV discovery; GIS features are not canonical plants."""

from __future__ import annotations

import json
import math
from typing import Any

from .sam import verify_sha256

FIELDS = {"objectid", "nombre", "promotor", "potencia_placas_mwp", "potencia_inversior_mwp"}


[docs] def read_aragon_geojson(content: bytes, *, sha256: str) -> list[dict[str, Any]]: """Pin schema/IDs/ratings; retain ambiguous inverter MWp without AC inference.""" verify_sha256(content, sha256) if len(content) > 20_000_000: raise ValueError("Aragón export exceeds reviewed size limit") document = json.loads(content) if not isinstance(document, dict) or document.get("type") != "FeatureCollection": raise ValueError("Aragón FeatureCollection required") features = document.get("features") if not isinstance(features, list): raise ValueError("Aragón features must be a list") seen = set() rows = [] for feature in features: if not isinstance(feature, dict) or feature.get("type") != "Feature": raise ValueError("Invalid Aragón feature") row = feature.get("properties") if not isinstance(row, dict) or set(row) != FIELDS: raise ValueError("Aragón property schema changed") identifier = row["objectid"] if ( isinstance(identifier, bool) or not isinstance(identifier, int) or identifier <= 0 or identifier in seen ): raise ValueError("Invalid or duplicate Aragón GIS feature ID") seen.add(identifier) if not isinstance(row["nombre"], str) or not row["nombre"].strip(): raise ValueError("Aragón name missing") for key in ("potencia_placas_mwp", "potencia_inversior_mwp"): value = row[key] if value is not None and ( isinstance(value, bool) or not isinstance(value, (int, float)) or not math.isfinite(value) or value < 0 ): raise ValueError("Invalid Aragón power assertion") geometry = feature.get("geometry") if not isinstance(geometry, dict) or geometry.get("type") not in { "Polygon", "MultiPolygon", }: raise ValueError("Aragón polygon geometry required") rows.append( { "gis_feature_id": identifier, "source_name": row["nombre"].strip(), "panel_peak_mwp_as_reported": row["potencia_placas_mwp"], "inverter_power_mwp_as_reported": row["potencia_inversior_mwp"], "geometry_type": geometry["type"], "identity_status": "review_only_not_accepted", "coordinate_scope": ( "Projected-looking geometry; CRS not declared; no lat/lon or centroid inferred" ), "rating_scope": "Inverter field is labelled MWp; no AC capacity inferred", "identity_scope": ( "GIS feature ID is not a national plant ID; phases/aggregates require review" ), } ) return rows