Building shadow

Shadow from sunlight

pybdshadow.bdshadow_sunlight(buildings, date, height='height', roof=False, include_building=True, ground=0)

Calculate the sunlight shadow of the buildings.

Parameters:

  • buildings (GeoDataFrame) – Buildings. coordinate system should be WGS84

  • date (datetime) – Datetime

  • height (string) – Column name of building height(meter).

  • roof (bool) – Whether to calculate the roof shadows.

  • include_building (bool) – Whether the shadow include building outline.

  • ground (number) – Height of the ground(meter).

Returns:

shadows – Building shadow

Return type:

GeoDataFrame

Shadow from pointlight

pybdshadow.bdshadow_pointlight(buildings, pointlon, pointlat, pointheight, merge=True, height='height', ground=0)

Calculate the sunlight shadow of the buildings.

Parameters:

  • buildings (GeoDataFrame) – Buildings. coordinate system should be WGS84

  • pointlon (float) – Point light coordinates and height(meter).

  • pointlat (float) – Point light coordinates and height(meter).

  • pointheight (float) – Point light coordinates and height(meter).

  • date (datetime) – Datetime

  • merge (bool) – Whether to merge the wall shadows into the building shadows

  • height (string) – Column name of building height(meter).

  • ground (number) – Height of the ground

Returns:

shadows – Building shadow

Return type:

GeoDataFrame