Sun Shadow Volume (3D Analyst)

ArcGIS Pro 3.3 | | 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.

  • UTCβ€”The time zone will be UTC.
  • Dateline Standard Timeβ€”The time zone will be Dateline Standard Time (UTC-12:00).
  • UTC-11β€”The time zone will be UTC-11 (UTC-11:00).
  • Aleutian Standard Timeβ€”The time zone will be Aleutian Standard Time (UTC-10:00).
  • Hawaiian Standard Timeβ€”The time zone will be Hawaiian Standard Time (UTC-10:00).
  • Marquesas Standard Timeβ€”The time zone will be Marquesas Standard Time (UTC-09:30).
  • Alaskan Standard Timeβ€”The time zone will be Alaskan Standard Time (UTC-09:00).
  • UTC-09β€”The time zone will be UTC-09 (UTC-09:00).
  • Pacific Standard Time (Mexico)β€”The time zone will be Pacific Standard Time (Mexico) (UTC-08:00).
  • UTC-08β€”The time zone will be UTC-08 (UTC-08:00).
  • Pacific Standard Timeβ€”The time zone will be Pacific Standard Time (UTC-08:00).
  • US Mountain Standard Timeβ€”The time zone will be US Mountain Standard Time (UTC-07:00).
  • Mountain Standard Time (Mexico)β€”The time zone will be Mountain Standard Time (Mexico) (UTC-07:00).
  • Mountain Standard Timeβ€”The time zone will be Mountain Standard Time (UTC-07:00).
  • Yukon Standard Timeβ€”The time zone will be Yukon Standard Time (UTC-07:00).
  • Central America Standard Timeβ€”The time zone will be Central America Standard Time (UTC-06:00).
  • Central Standard Timeβ€”The time zone will be Central Standard Time (UTC-06:00).
  • Easter Island Standard Timeβ€”The time zone will be Easter Island Standard Time (UTC-06:00).
  • Central Standard Time (Mexico)β€”The time zone will be Central Standard Time (Mexico) (UTC-06:00).
  • Canada Central Standard Timeβ€”The time zone will be Canada Central Standard Time (UTC-06:00).
  • SA Pacific Standard Timeβ€”The time zone will be SA Pacific Standard Time (UTC-05:00).
  • Eastern Standard Time (Mexico)β€”The time zone will be Eastern Standard Time (Mexico) (UTC-05:00).
  • Eastern Standard Timeβ€”The time zone will be Eastern Standard Time (UTC-05:00).
  • Haiti Standard Timeβ€”The time zone will be Haiti Standard Time (UTC-05:00).
  • Cuba Standard Timeβ€”The time zone will be Cuba Standard Time (UTC-05:00).
  • US Eastern Standard Timeβ€”The time zone will be US Eastern Standard Time (UTC-05:00).
  • Turks And Caicos Standard Timeβ€”The time zone will be Turks And Caicos Standard Time (UTC-04:00).
  • Paraguay Standard Timeβ€”The time zone will be Paraguay Standard Time (UTC-04:00).
  • Atlantic Standard Timeβ€”The time zone will be Atlantic Standard Time (UTC-04:00).
  • Venezuela Standard Timeβ€”The time zone will be Venezuela Standard Time (UTC-04:00).
  • Central Brazilian Standard Timeβ€”The time zone will be Central Brazilian Standard Time (UTC-04:00).
  • SA Western Standard Timeβ€”The time zone will be SA Western Standard Time (UTC-04:00).
  • Pacific SA Standard Timeβ€”The time zone will be Pacific SA Standard Time (UTC-04:00).
  • Newfoundland Standard Timeβ€”The time zone will be Newfoundland Standard Time (UTC-03:30).
  • Tocantins Standard Timeβ€”The time zone will be Tocantins Standard Time (UTC-03:00).
  • E. South America Standard Timeβ€”The time zone will be E. South America Standard Time (UTC-03:00).
  • SA Eastern Standard Timeβ€”The time zone will be SA Eastern Standard Time (UTC-03:00).
  • Argentina Standard Timeβ€”The time zone will be Argentina Standard Time (UTC-03:00).
  • Greenland Standard Timeβ€”The time zone will be Greenland Standard Time (UTC-03:00).
  • Montevideo Standard Timeβ€”The time zone will be Montevideo Standard Time (UTC-03:00).
  • Magallanes Standard Timeβ€”The time zone will be Magallanes Standard Time (UTC-03:00).
  • Saint Pierre Standard Timeβ€”The time zone will be Saint Pierre Standard Time (UTC-03:00).
  • Bahia Standard Timeβ€”The time zone will be Bahia Standard Time (UTC-03:00).
  • UTC-02β€”The time zone will be UTC-02 (UTC-02:00).
  • Mid-Atlantic Standard Timeβ€”The time zone will be Mid-Atlantic Standard Time (UTC-02:00).
  • Azores Standard Timeβ€”The time zone will be Azores Standard Time (UTC-01:00).
  • Cape Verde Standard Timeβ€”The time zone will be Cape Verde Standard Time (UTC-01:00).
  • GMT Standard Timeβ€”The time zone will be GMT Standard Time (UTC+00:00).
  • Greenwich Standard Timeβ€”The time zone will be Greenwich Standard Time (UTC+00:00).
  • Sao Tome Standard Timeβ€”The time zone will be Sao Tome Standard Time (UTC+00:00).
  • Morocco Standard Timeβ€”The time zone will be Morocco Standard Time (UTC+00:00).
  • W. Europe Standard Timeβ€”The time zone will be W. Europe Standard Time (UTC+01:00).
  • Central Europe Standard Timeβ€”The time zone will be Central Europe Standard Time (UTC+01:00).
  • Romance Standard Timeβ€”The time zone will be Romance Standard Time (UTC+01:00).
  • Central European Standard Timeβ€”The time zone will be Central European Standard Time (UTC+01:00).
  • W. Central Africa Standard Timeβ€”The time zone will be W. Central Africa Standard Time (UTC+01:00).
  • Jordan Standard Timeβ€”The time zone will be Jordan Standard Time (UTC+02:00).
  • GTB Standard Timeβ€”The time zone will be GTB Standard Time (UTC+02:00).
  • Middle East Standard Timeβ€”The time zone will be Middle East Standard Time (UTC+02:00).
  • Egypt Standard Timeβ€”The time zone will be Egypt Standard Time (UTC+02:00).
  • E. Europe Standard Timeβ€”The time zone will be E. Europe Standard Time (UTC+02:00).
  • Syria Standard Timeβ€”The time zone will be Syria Standard Time (UTC+02:00).
  • West Bank Standard Timeβ€”The time zone will be West Bank Standard Time (UTC+02:00).
  • South Africa Standard Timeβ€”The time zone will be South Africa Standard Time (UTC+02:00).
  • FLE Standard Timeβ€”The time zone will be FLE Standard Time (UTC+02:00).
  • Israel Standard Timeβ€”The time zone will be Israel Standard (UTC+02:00).
  • South Sudan Standard Timeβ€”The time zone will be South Sudan Standard Time (UTC+02:00).
  • Kaliningrad Standard Timeβ€”The time zone will be Kaliningrad Standard Time (UTC+02:00).
  • Sudan Standard Timeβ€”The time zone will be Sudan Standard Time (UTC+02:00).
  • Libya Standard Timeβ€”The time zone will be Libya Standard Time (UTC+02:00).
  • Namibia Standard Timeβ€”The time zone will be Namibia Standard Time (UTC+02:00).
  • Arabic Standard Timeβ€”The time zone will be Arabic Standard Time (UTC+03:00).
  • Turkey Standard Timeβ€”The time zone will be Turkey Standard Time (UTC+03:00).
  • Arab Standard Timeβ€”The time zone will be Arab Standard Time (UTC+03:00).
  • Belarus Standard Timeβ€”The time zone will be Belarus Standard Time (UTC+03:00).
  • Russian Standard Timeβ€”The time zone will be Russian Standard Time (UTC+03:00).
  • E. Africa Standard Timeβ€”The time zone will be E. Africa Standard Time (UTC+03:00).
  • Volgograd Standard Timeβ€”The time zone will be Volgograd Standard Time (UTC+03:00).
  • Iran Standard Timeβ€”The time zone will be Iran Standard Time (UTC+03:30).
  • Arabian Standard Timeβ€”The time zone will be Arabian Standard Time (UTC+04:00).
  • Astrakhan Standard Timeβ€”The time zone will be Astrakhan Standard Time (UTC+04:00).
  • Azerbaijan Standard Timeβ€”The time zone will be Azerbaijan Standard Time (UTC+04:00).
  • Russia Time Zone 3β€”The time zone will be Russia Time Zone 3 (UTC+04:00).
  • Mauritius Standard Timeβ€”The time zone will be Mauritius Standard Time (UTC+04:00).
  • Saratov Standard Timeβ€”The time zone will be Saratov Standard Time (UTC+04:00).
  • Georgian Standard Timeβ€”The time zone will be Georgian Standard Time (UTC+04:00).
  • Caucasus Standard Timeβ€”The time zone will be Caucasus Standard Time (UTC+04:00).
  • Afghanistan Standard Timeβ€”The time zone will be Afghanistan Standard Time (UTC+04:30).
  • West Asia Standard Timeβ€”The time zone will be West Asia Standard Time (UTC+05:00).
  • Ekaterinburg Standard Timeβ€”The time zone will be Ekaterinburg Standard Time (UTC+05:00).
  • Pakistan Standard Timeβ€”The time zone will be Pakistan Standard Time (UTC+05:00).
  • Qyzylorda Standard Timeβ€”The time zone will be Qyzylorda Standard Time (UTC+05:00).
  • India Standard Timeβ€”The time zone will be India Standard Time (UTC+05:30).
  • Sri Lanka Standard Timeβ€”The time zone will be Sri Lanka Standard Time (UTC+05:30).
  • Nepal Standard Timeβ€”The time zone will be Nepal Standard Time (UTC+05:45).
  • Central Asia Standard Timeβ€”The time zone will be Central Asia Standard Time (UTC+06:00).
  • Bangladesh Standard Timeβ€”The time zone will be Bangladesh Standard Time (UTC+06:00).
  • Omsk Standard Timeβ€”The time zone will be Omsk Standard Time (UTC+06:00).
  • Myanmar Standard Timeβ€”The time zone will be Myanmar Standard Time (UTC+06:30).
  • SE Asia Standard Timeβ€”The time zone will be SE Asia Standard Time (UTC+07:00).
  • Altai Standard Timeβ€”The time zone will be Altai Standard Time (UTC+07:00).
  • W. Mongolia Standard Timeβ€”The time zone will be W. Mongolia Standard Time (UTC+07:00).
  • North Asia Standard Timeβ€”The time zone will be North Asia Standard Time (UTC+07:00).
  • N. Central Asia Standard Timeβ€”The time zone will be N. Central Asia Standard Time (UTC+07:00).
  • Tomsk Standard Timeβ€”The time zone will be Tomsk Standard Time (UTC+07:00).
  • China Standard Timeβ€”The time zone will be China Standard Time (UTC+08:00).
  • North Asia East Standard Timeβ€”The time zone will be North Asia East Standard Time (UTC+08:00).
  • Singapore Standard Timeβ€”The time zone will be Singapore Standard Time (UTC+08:00).
  • W. Australia Standard Timeβ€”The time zone will be W. Australia Standard Time (UTC+08:00).
  • Taipei Standard Timeβ€”The time zone will be Taipei Standard Time (UTC+08:00).
  • Ulaanbaatar Standard Timeβ€”The time zone will be Ulaanbaatar Standard Time (UTC+08:00).
  • Aus Central W. Standard Timeβ€”The time zone will be Aus Central W. Standard Time (UTC+08:45).
  • Transbaikal Standard Timeβ€”The time zone will be Transbaikal Standard Time (UTC+09:00).
  • Tokyo Standard Timeβ€”The time zone will be Tokyo Standard Time (UTC+09:00).
  • North Korea Standard Timeβ€”The time zone will be North Korea Standard Time (UTC+09:00).
  • Korea Standard Timeβ€”The time zone will be Korea Standard Time (UTC+09:00).
  • Yakutsk Standard Timeβ€”The time zone will be Yakutsk Standard Time (UTC+09:00).
  • Cen. Australia Standard Timeβ€”The time zone will be Cen. Australia Standard Time (UTC+09:30).
  • AUS Central Standard Timeβ€”The time zone will be AUS Central Standard Time (UTC+09:30).
  • E. Australia Standard Timeβ€”The time zone will be E. Australia Standard Time (UTC+10:00).
  • AUS Eastern Standard Timeβ€”The time zone will be AUS Eastern Standard Time (UTC+10:00).
  • West Pacific Standard Timeβ€”The time zone will be West Pacific Standard Time (UTC+10:00).
  • Tasmania Standard Timeβ€”The time zone will be Tasmania Standard Time (UTC+10:00).
  • Vladivostok Standard Timeβ€”The time zone will be Vladivostok Standard Time (UTC+10:00).
  • Lord Howe Standard Timeβ€”The time zone will be Lord Howe Standard Time (UTC+10:30).
  • Bougainville Standard Timeβ€”The time zone will be Bougainville Standard Time (UTC+11:00).
  • Russia Time Zone 10β€”The time zone will be Russia Time Zone 10 (UTC+11:00).
  • Magadan Standard Timeβ€”The time zone will be Magadan Standard Time (UTC+11:00).
  • Norfolk Standard Timeβ€”The time zone will be Norfolk Standard Time (UTC+11:00).
  • Sakhalin Standard Timeβ€”The time zone will be Sakhalin Standard Time (UTC+11:00).
  • Central Pacific Standard Timeβ€”The time zone will be Central Pacific Standard Time (UTC+11:00).
  • Russia Time Zone 11β€”The time zone will be Russia Time Zone 11 (UTC+11:00).
  • New Zealand Standard Timeβ€”The time zone will be New Zealand Standard Time (UTC+12:00).
  • UTC+12β€”The time zone will be UTC+12 (UTC+12:00).
  • Fiji Standard Timeβ€”The time zone will be Fiji Standard Time (UTC+12:00).
  • Kamchatka Standard Timeβ€”The time zone will be Kamchatka Standard Time (UTC+12:00).
  • Chatham Islands Standard Timeβ€”The time zone will be Chatham Islands Standard Time (UTC+12:45).
  • UTC+13β€”The time zone will be UTC+13 (UTC+13:00).
  • Tonga Standard Timeβ€”The time zone will be Tonga Standard Time (UTC+13:00).
  • Samoa Standard Timeβ€”The time zone will be Samoa Standard Time (UTC+13:00).
  • Line Islands Standard Timeβ€”The time zone will be Line Islands Standard Time (UTC+14:00).
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.

  • Daysβ€”Iteration value will represent days. This is the default.
  • Hoursβ€”Iteration value will represent one or more hours.
  • Minutesβ€”Iteration value will represent one or more minutes.
String

Licensing information

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

Related topics