Frecuencia de sombra del sol (3D Analyst)

Resumen

Calcula el número de veces que una posición fija en una superficie tiene su línea de visión directa al sol obstruida por entidades multiparche.

Ilustración

Resultado de la herramienta Frecuencia de sombra del sol

Uso

  • La posición del sol se calculará desde la fecha y hora de inicio hasta la fecha y hora de finalización. Si se especifica un intervalo de tiempo, la posición del sol se calculará iterativamente desde la hora de inicio hasta la hora de finalización de cada día entre la fecha de inicio y la fecha de finalización. Las horas en que el sol no esté por encima del horizonte se omitirán.

  • Los valores de la celda del ráster de salida representan el número de veces que una celda dada se encuentra a la sombra. El valor máximo posible para cualquier celda se corresponde con el número de veces que el sol se posiciona sobre el horizonte.

  • Considere definir una longitud de sombra máxima al generar resultados para los ángulos de inclinación del sol próximos al amanecer y el atardecer, para evitar el impacto de las huellas de sombras alargadas. Imponer una distancia ayuda también a mejorar el rendimiento de la herramienta.

Sintaxis

arcpy.3d.SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})
ParámetroExplicaciónTipo de datos
in_features
[in_features,...]

Las entidades multiparche que constituirán el origen de la obstrucción de la luz solar.

Feature Layer
ground

La superficie del suelo que define las posiciones donde se evalúa la obstrucción a la luz solar.

Raster Layer
out_raster

El ráster de salida cuyos valores de celda reflejan el número de veces que la posición de la altura del suelo correspondiente fue obstruida por las entidades de entrada.

Raster Dataset
cell_size
(Opcional)

El tamaño de celda del ráster de salida.

Linear Unit
start_time
(Opcional)

La fecha y hora en que se iniciarán los cálculos de posición del sol. El valor predeterminado es la fecha y hora en que se inicializa la herramienta.

Date
end_time
(Opcional)

La fecha y hora en que finalizarán los cálculos de posición del sol.

Date
time_interval
(Opcional)

El intervalo que se utiliza para calcular las posiciones del sol desde la fecha y la hora de inicio hasta la fecha y la hora de finalización.

Time Unit
time_zone
(Opcional)

La zona horaria que se corresponde a las horas de entrada especificadas, utilizada para determinar la posición relativa del sol. La lista de valores disponibles la define el sistema operativo, pero será de forma predeterminada la zona horaria de la hora actual del equipo.

String
dst
(Opcional)

Especifica si se ajustan las horas especificadas para el horario de verano.

  • DSTLas horas de entrada se ajustan para el horario de verano.
  • NO_DSTLas horas de entrada no se ajustan para el horario de verano. Esta es la opción predeterminada.
Boolean
max_shadow_length
(Opcional)

La distancia máxima que se proyecta una sombra desde una entidad de entrada durante el cálculo. Considere la posibilidad de definir este valor al procesar horas en las que la posición del sol tiene un ángulo de baja altitud, ya que las sombras resultantes son alargadas y pueden agregar tiempo de procesamiento innecesario.

Linear Unit

Muestra de código

SunShadowFrequency example 1 (Python window)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de 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')

Información de licenciamiento

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

Temas relacionados