Частота затенения (3D Analyst)

Сводка

Вычисляет, сколько раз линия визирования, направленная на солнце из фиксированного положения на земной поверхности, заслоняется объектами-мультипатч.

Иллюстрация

Результат работы инструмента Частота затенения

Использование

  • Значения ячеек выходного растра показывают количество раз, когда данная ячейка оказывается в тени. Максимально возможное значение для любой ячейки соответствует количеству раз, когда солнце показывалось над горизонтом.

  • Расположение солнца будет вычисляться от начальной даты и времени и до конечной даты и времени. Для того, чтобы сделать расчет, начиная с рассвета, укажите начальную дату без указания времени. А для расчета, заканчивая временем закат, указывается конечная дата без указания времени окончания. Если задан временной интервал, положение солнце будет вычислено от начального до конечного времени.

  • При расчете результатов для углов наклона солнца при рассвете и закате учитывайте определение максимальной длины тени, чтобы избежать влияния фактора длинных теней. Указание расстояния также помогает повысить производительность работы инструмента.

Синтаксис

SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})
ParameterОбъяснениеТип данных
in_features
[in_features,...]

Объекты-мультипатч, которые образуют источник препятствий для солнечного света.

Feature Layer
ground

Земная поверхность, определяющая места, в которых будут оцениваться препятствия для солнечного света.

Raster Layer
out_raster

Выходной растр, значения ячеек которого отражают количество раз, когда соответствующее положение высоты поверхности заслонялось входными объектами.

Raster Dataset
cell_size
(Дополнительный)

Размер ячейки выходного растра.

Linear Unit
start_time
(Дополнительный)

Дата и время, когда будет начато вычисление расположения солнца. Если указана только дата, начальным временем будет считаться начало восхода солнца в этот день. Значение по умолчанию устанавливается на дату и время, соответствующие тому, когда этот инструмент открывается в приложении или выполняется в скрипте Python.

Date
end_time
(Дополнительный)

Дата и время, когда будет завершено вычисление расположения солнца. Если указывается только дата, конечное время определяется как время заката в этот день.

Date
time_interval
(Дополнительный)

Интервал, который будет использоваться для вычисления расположения солнца от начальной даты и времени и до конечной даты и времени.

Time Unit
time_zone
(Дополнительный)

Часовой пояс, соответствующий заданному входному времени, которое используется для определения относительного положения солнца. Список доступных значений определяется операционной системой, но по умолчанию будет установлен часовой пояс текущего времени на компьютере.

String
dst
(Дополнительный)

Показывает, учтено ли летнее время в указанных значениях времени.

  • DSTВходные значения времени настроены на летнее время.
  • NO_DSTВходные значения времени не настроены на летнее время. Используется по умолчанию.
Boolean
max_shadow_length
(Дополнительный)

Максимальное расстояние, на которое объект может отбрасывать тень в ходе вычисления. Это значение следует указать в случае, когда рассчитывается время, при котором солнце находится низко над горизонтом, т.к. полученные тени будут очевидно длинными и потенциально могут увеличить общее время расчета.

Linear Unit

Пример кода

SunShadowFrequency example 1 (Python window)

В следующем примере показано использование этого инструмента в окне Python.

import arcpy
arcpy.env.workspace = 'd:\\data'
arcpy.ddd.SunShadowFrequency('Buildings.shp', 'DEM.tif', 'June_Shade.tif',
                             '4 Feet', '6/1/2018 10:00 AM', '6/30/2018 4:00 PM',
                             '15 Minutes', 'Pacific Standard Time', 'NO_DST')

Информация о лицензиях

  • Basic: Требуется 3D Analyst
  • Standard: Требуется 3D Analyst
  • Advanced: Требуется 3D Analyst

Связанные разделы