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

Сводка

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

Иллюстрация

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

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

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

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

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

Синтаксис

arcpy.3d.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
(Дополнительный)

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

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

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