energy_analysis.site_3d.reports#
Static/interactive views and portable mesh exports with explicit model metadata.
- energy_analysis.site_3d.reports.scene_metadata(scene)[source]#
Separate measured/source geometry from explicit mounting scenarios.
- Parameters:
scene (PVSiteScene)
- Return type:
dict[str, Any]
- energy_analysis.site_3d.reports.plot_site_scene(scene, *, title='PV site scenario', attribution='')[source]#
Static metric 3D overview; elevation is not vertically exaggerated.
- Parameters:
scene (PVSiteScene)
title (str)
attribution (str)
- Return type:
Any
- energy_analysis.site_3d.reports.write_scene_html(scene, path, *, title='PV site scenario', attribution='', evidence_note='')[source]#
Write a self-contained offline Plotly viewer; no imagery or CDN calls required.
Display exaggeration affects the camera aspect only. Exported coordinates retain metric Z. All externally supplied text is escaped before embedding.
- Parameters:
scene (PVSiteScene)
path (str | Path)
title (str)
attribution (str)
evidence_note (str)
- Return type:
Path
- energy_analysis.site_3d.reports.export_site_scene(scene, directory, *, title='PV site scenario', provenance=None, attribution='', evidence_note='')[source]#
Export open OBJ/MTL, complete local-coordinate JSON and an offline viewer.
OBJ coordinates use metres, Z-up. Neither OBJ nor JSON converts orthometric heights to WGS84 ellipsoidal heights. JSON retains the georeference and IDs.
- Parameters:
scene (PVSiteScene)
directory (str | Path)
title (str)
provenance (dict[str, Any] | None)
attribution (str)
evidence_note (str)
- Return type:
Path