cityImage.obstructions_3d#

cityImage.obstructions_3d(potential_sight_lines, obstructions_gdf, potential_obstructions_column, meshes, simplified_target_buildings, num_workers)[source]#

Check 3D visibility for sight lines with candidate obstructions.

Parameters:

  • potential_sight_lines (geopandas.GeoDataFrame) – Candidate sight lines with 3D geometry and a candidate-obstruction column.

  • obstructions_gdf (geopandas.GeoDataFrame) – Obstruction building table. Kept for workflow consistency.

  • potential_obstructions_column (str) – Column containing lists of candidate obstruction building IDs.

  • meshes (dict) – Mapping from building IDs to triangulated PyVista meshes.

  • simplified_target_buildings (geopandas.GeoDataFrame or None) – Optional simplified target outlines. When provided, the current target building is removed from each candidate obstruction list.

  • num_workers (int) – Number of worker threads used for ray tracing.

Returns:

Sight lines that remain visible after 3D ray-tracing checks.

Return type:

geopandas.GeoDataFrame