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:
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