Source code for energy_analysis.site_3d.rengo
"""Continue the El Mirlo counting pilot using a pinned native Copernicus DSM crop."""
from __future__ import annotations
import hashlib
import json
from pathlib import Path
from typing import Any
import numpy as np
from energy_analysis.module_counting.rengo import run_rengo_study
from energy_analysis.site_3d.pipeline import elevation_grid, footprints_from_count
from energy_data_retrieval.terrain import TerrainSource, read_terrain
from energy_methods.pv_site_3d import LocalSiteFrame, MountingParameters, build_pv_site_scene
[docs]
def build_rengo_scene(
counting_directory: str | Path, terrain_directory: str | Path
) -> dict[str, Any]:
"""Re-run the existing count; add declared terrain and mounting assumptions."""
counting_directory, terrain_directory = Path(counting_directory), Path(terrain_directory)
config = json.loads((terrain_directory / "scene_config.json").read_text())
for name, checksum in config["sha256"].items():
if hashlib.sha256((terrain_directory / name).read_bytes()).hexdigest() != checksum:
raise ValueError(f"3D input checksum mismatch: {name}")
if (
hashlib.sha256((counting_directory / "rengo_study.json").read_bytes()).hexdigest()
!= config["counting_manifest_sha256"]
):
raise ValueError("Counting study changed; review the 3D continuation")
source = json.loads((terrain_directory / "terrain_provenance.json").read_text())
spec = source["source"]
descriptor = TerrainSource(
spec["id"],
spec["name"],
spec["surface"],
spec["vertical_datum"],
tuple(spec["reference_ids"]),
)
window = read_terrain(terrain_directory / source["fixture"], descriptor)
grid = elevation_grid(window)
counting = run_rengo_study(counting_directory)
bounds = tuple(counting["manifest"]["detail_capture"]["bbox"])
lon, lat = (bounds[0] + bounds[2]) / 2, (bounds[1] + bounds[3]) / 2
centre_height = grid.sample([[lon, lat]])[0]
if not np.isfinite(centre_height):
raise ValueError("The scene origin has no terrain support")
frame = LocalSiteFrame(lon, lat, float(np.floor(centre_height)))
footprints = footprints_from_count(counting["advanced"], bounds)
scene = build_pv_site_scene(
footprints,
grid,
frame=frame,
bounds_wgs84=bounds,
mounting=MountingParameters(**config["mounting"]),
display_grid_shape=tuple(config["display_grid_shape"]),
)
return {
"scene": scene,
"counting": counting,
"terrain_window": window,
"grid": grid,
"terrain_source": source,
"configuration": config,
}