Sun Shadow Frequency (3D Analyst)

ArcGIS Pro 3.4 | | Help archive

Summary

Calculates the number of times a fixed position on a surface has its direct sight line to the sun obstructed by multipatch features.

Illustration

Sun Shadow Frequency tool illustration

Usage

  • The sun position will be calculated from the start date and time to the end date and time. If a time interval is specified, the sun position will be iteratively calculated from the start time to the end time for each day between the start date and end date. Any time the sun is not above the horizon will be skipped.

  • The output raster's cell values represent the number of times a given cell is in a shadow. The maximum possible value for any cell corresponds to the number of times the sun is positioned above the horizon.

  • Consider defining a maximum shadow length when generating results for sun inclination angles near sunrise and sunset to avoid factoring the impact of long shadow footprints. Enforcing a distance also helps improve tool performance.

Parameters

LabelExplanationData Type
Input Features

The multipatch features that will constitute the source of obstruction for sunlight.

Feature Layer
Ground Surface

The raster ground surface that will define the positions where sunlight obstruction will be evaluated.

Raster Layer
Output Shadow Raster

The output raster whose cell values reflect the number of times the corresponding ground height position was obstructed by the input features.

Raster Dataset
Output Cell Size
(Optional)

The cell size of the output raster.

Linear Unit
Start Time
(Optional)

The date and time sun position calculations will begin. The default value is the date and time the tool is initialized.

Date
End Time
(Optional)

The date and time sun position calculations will end. The Time Interval parameter is used to iteratively evaluate each day from the start time to the end time. For this reason, the end time cannot be earlier than the start time.

Date
Time Interval
(Optional)

The interval that will be used to calculate sun positions from the start date and time to the end date and time.

Time Unit
Time Zone
(Optional)

Specifies the time zone that corresponds to the specified input times that will be used to determine the relative position of the sun.

  • 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
Adjusted for Daylight Saving Time
(Optional)

Specifies whether the input times will be adjusted for daylight saving time.

  • Checked—The input times will be adjusted for daylight saving time.
  • Unchecked—The input times will not be adjusted for daylight saving time. This is the default.
Boolean
Maximum Shadow Length
(Optional)

The maximum distance that a shadow will be cast from an input feature during calculation. Consider defining this value when the sun position has a low altitude angle, as the resulting shadows will be long and potentially add unnecessary processing time.

Linear Unit

Licensing information

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

Related topics