Etiqueta | Explicación | Tipo de datos |
Entidades de entrada
| Las entidades multiparche que constituirán el origen de la obstrucción de la luz solar. | Feature Layer |
Superficie del suelo
| La superficie del suelo que define las posiciones donde se evalúa la obstrucción a la luz solar. | Raster Layer |
Ráster de sombras de salida
| 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 |
Tamaño de celda de salida (Opcional) | El tamaño de celda del ráster de salida. | Linear Unit |
Hora de inicio
(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 |
Hora de finalización
(Opcional) | La fecha y hora en que finalizarán los cálculos de posición del sol. | Date |
Intervalo de tiempo
(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 |
Zona horaria
(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 |
Ajustado al horario de verano
(Opcional) | Especifica si se ajustan las horas especificadas para el horario de verano.
| Boolean |
Longitud máxima de sombra
(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 |
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
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.
Parámetros
arcpy.ddd.SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})
Nombre | 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. 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.
| 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
Casos especiales
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst