Sun Shadow Volume (3D Analyst)

ArcGIS Pro 3.2 | | Help archive

Summary

Creates closed volumes that model shadows cast by each feature using sunlight for a given date and time.

Usage

  • All input features should reside in the same locale, as relative sun position calculations are based on the position of the first feature in the first feature class.

  • Shadows modeling sunrise and sunset conditions can be made by providing only a date in the Start Date and Time and End Date and Time parameters, respectively. Shadow volumes will not be produced if the sun is not visible for a given date and time or if the relative position of the sun is at a vertical angle of 90 degrees from the input features.

  • Shadows are modeled as closed multipatches created by extruding the input features in the direction of sunlight. Light rays are considered to be parallel and travel in the direction calculated for the relative position of the sun. Each shadow volume starts and ends at a vertical plane that is perpendicular to the horizontal projection of the sun's rays.

  • The following fields will be attributed to the shadow volume features:

    • SOURCE—Name of the feature class casting the shadow volume.
    • SOURCE_ID—Unique ID of the feature casting the shadow volume.
    • DATE_TIME—Local date and time used to calculate sun position.
    • AZIMUTH—Angle in degrees between true north and the perpendicular projection of the sun's relative position down to the earth's horizon. Values range from 0 to 360.
    • VERT_ANGLE—Angle in degrees between the earth's horizon and the sun's relative position where the horizon defines 0 degrees and 90 degrees is directly above.
    Note:

    Typically, each shadow volume would appear to hug, or be cast tightly against, its originating feature. If a shadow could not be generated in this manner, it will be created from the boundary of the feature's outer extent. When at least one shadow is created this way, a field named HUGS_FEATR is included to indicate which shadows hug their corresponding features.

Parameters

LabelExplanationData Type
Input Features

The multipatch features that will be used to model shadows.

Feature Layer
Start Date and Time

The date and time that the trajectory of sunlight will be calculated for modeling the shadows.

Date
Output Feature Class

The multipatch feature class that will store the resulting shadow volumes.

Feature Class
Adjusted for Daylight Savings Time
(Optional)

Specifies whether time value is adjusted for Daylight Savings Time (DST).

  • Unchecked—DST is not observed. This is the default.
  • Checked—DST is observed.
Boolean
Time Zone
(Optional)

The time zone in which the participating input is located. The default setting is the time zone to which the operating system is set.

String
End Date and Time
(Optional)

The final date and time for calculating sun position. If only a date is provided, the final time is presumed to be sunset.

Date
Iteration Interval
(Optional)

The value used to define the iteration of time from the start date.

Double
Iteration Unit
(Optional)

The unit that defines the iteration value applied to the Start Date and Time.

  • DaysIteration value will represent days. This is the default.
  • HoursIteration value will represent one or more hours.
  • MinutesIteration value will represent one or more minutes.
String

Licensing information

  • Basic: Requires 3D Analyst
  • Standard: Requires 3D Analyst
  • Advanced: Requires 3D Analyst

Related topics