Sun Shadow Volume (3D Analyst)

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

  • 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—The name of the feature class casting the shadow volume.
    • SOURCE_ID—The unique ID of the feature casting the shadow volume.
    • DATE_TIME—The local date and time used to calculate sun position.
    • AZIMUTH—The 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—The 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 will appear to hug, or be cast tightly against, its originating feature. If a shadow cannot 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 HUGS_FEATR field 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 from which sun positions will be determined. Both a date and a time must be provided, and only the times when the sun is above the horizon will produce an output shadow volume.

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 the time value will be adjusted for daylight saving time (DST).

  • Unchecked—The time value will not be adjusted for DST. This is the default.
  • Checked—The time value will be adjusted for DST.
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.

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

The final date and time that will be used for calculating sun position. A time can be specified without a date, in which case the end date will be the same as the start date. If a date is provided, a time must also be given. Only the times at which the sun is above the horizon will produce an output shadow volume.

Date
Iteration Interval
(Optional)

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

Double
Iteration Unit
(Optional)

Specifies the unit that will define the iteration value applied to the Start Date and Time parameter value.

  • DaysThe iteration value will represent days. This is the default.
  • HoursThe iteration value will represent one or more hours.
  • MinutesThe 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