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
Uso
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.
La posición del sol se calculará desde la fecha y hora de inicio hasta la fecha y hora de finalización. Para calcular desde el amanecer, especifique la fecha de inicio sin la hora. Del mismo modo, para calcular la posición del sol hasta el atardecer, especifique la fecha de finalización sin la hora de finalización. Si se especifica un intervalo de tiempo, la posición del sol se calcula desde la hora de inicio hasta la hora de finalización.
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
SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})| Parámetro | Explicación | Tipo 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. Si solo se proporciona la fecha, la hora de inicio se define como el amanecer de la fecha especificada. El valor predeterminado es la fecha y la hora en que la herramienta se abre en la aplicación o se ejecuta en Python. | Date |
end_time (Opcional) | La fecha y hora en que finalizarán los cálculos de posición del sol. Si solo se proporciona la fecha, la hora de finalización se define como el atardecer de la fecha especificada. | 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.
| 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
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')Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst