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
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.
La position du soleil est calculée à partir de la date et heure de début jusqu’à la date et heure de fin. Pour effectuer le calcul à partir du lever du soleil, spécifiez la date de début sans l’heure. De même, pour calculer la position du soleil jusqu’à son coucher, spécifiez la date de fin sans l’heure. Si un intervalle temporel est spécifié, la position du soleil est calculée entre la date de début et la date de fin.
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
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. Si seule la date a été précisée, l’heure de début est définie par le lever du soleil pour cette date en particulier. La valeur par défaut est égale à la date et à l’heure correspondant au moment où l’outil est ouvert dans l’application ou exécuté dans Python. | Date |
end_time (Facultatif) | Date et heure auxquelles les calculs de la position du soleil se terminent. Si seule la date a été précisée, l’heure de fin est définie par le coucher du soleil pour cette date en particulier. | 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é.
| 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
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
Informations de licence
- Basic: Requiert 3D Analyst
- Standard: Requiert 3D Analyst
- Advanced: Requiert 3D Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?