Skip to main content

Sun Shadow Frequency (3D Analyst Tools)

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

Label Explanation Data 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.

  • 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

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

Environments

Current Workspace, Scratch Workspace, Output Coordinate System, Geographic Transformations, Extent

Licensing information

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