Fréquence des ombres solaires (3D Analyst)

Résumé

Calcule le nombre de fois où la ligne de visée directe d’une position fixe sur une surface vers le soleil est obstruée par des entités multipatch.

Illustration

Utilisation

• La position du soleil est calculée à partir de la date et heure de début jusqu’à la date et heure de fin. Si un intervalle temporel est spécifié, la position du soleil est calculée de manière itérative entre l’heure de début et l’heure de fin de chaque jour, entre la date de début et la date de fin. Chaque fois que le soleil ne se trouve pas au-dessus de l’horizon est ignorée.

• Les valeurs des cellules du raster en sortie représentent le nombre de fois où une cellule donnée se trouve à l’ombre. La valeur maximale de toute cellule correspond au nombre de fois où le soleil se trouve au-dessus de l’horizon.

• Pensez à définir une longueur d’ombre maximale lors de la génération des résultats pour déterminer les angles d’inclinaison du soleil à l’approche du lever et du coucher du soleil afin d’éviter l’impact d’emprises d’ombres longues. L’application d’une distance contribue également à améliorer les performances de l’outil.

Syntaxe

arcpy.3d.SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})

Paramètre	Explication	Type de données
in_features [in_features,...]	Entités multipatch qui constituent la source d’obstruction de la lumière du soleil.	Feature Layer
ground	Surface au sol qui définit les positions où l’obstruction à la lumière du soleil est évaluée.	Raster Layer
out_raster	Raster en sortie dont les valeurs de cellule reflètent le nombre de fois où la position de hauteur au sol correspondante a été obstruée par les entités en entrée.	Raster Dataset
cell_size (Facultatif)	La taille de la cellule du Raster en sortie.	Linear Unit
start_time (Facultatif)	Date et heure auxquelles les calculs de la position du soleil commencent. La valeur par défaut est égale à la date et à l’heure correspondant au moment où l’outil est initialisé.	Date
end_time (Facultatif)	Date et heure auxquelles les calculs de la position du soleil se terminent.	Date
time_interval (Facultatif)	Intervalle utilisé pour calculer la position du soleil à partir de la date et l’heure de début jusqu’à la date et l’heure de fin.	Time Unit
time_zone (Facultatif)	Fuseau horaire correspondant aux heures en entrée spécifiées pour déterminer la position relative du soleil. La liste des valeurs disponibles est définie par le système d’exploitation, mais le fuseau horaire est par défaut celui de l’heure actuelle de l’ordinateur.	String
dst (Facultatif)	Indique si les heures spécifiées sont ajustées pour prendre en compte l’heure d’été. DST —Les heures en entrée sont ajustées pour l’heure d’été. NO_DST —Les heures ne sont pas ajustées pour l’heure d’été. Il s’agit de l’option par défaut.	Boolean
max_shadow_length (Facultatif)	Distance maximale qu’une ombre peut projeter depuis une entité en entrée au cours du calcul. Pensez à définir cette valeur lors du traitement d’heures au cours desquelles la position du soleil présente un angle d’altitude bas étant donné que les ombres produites sont longues et risquent d’ajouter un délai de traitement supplémentaire.	Linear Unit

Exemple de code

SunShadowFrequency example 1 (Python window)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre 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')

Environnements

Espace de travail courant, Espace de travail temporaire, Système de coordonnées en sortie, Transformations géographiques, Etendue

Informations de licence

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