| Étiquette | Explication | Type de données |
Entités en entrée | Entités multipatch qui constituent la source d’obstruction de la lumière du soleil. | Feature Layer |
Surface au sol | Surface au sol raster qui définit les positions où l’obstruction à la lumière du soleil est évaluée. | Raster Layer |
Raster d’ombrage en sortie | 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 |
Taille de cellule en sortie (Facultatif) | La taille de la cellule du Raster en sortie. | Linear Unit |
Heure de début (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 |
Heure de fin (Facultatif) | Date et heure auxquelles les calculs de la position du soleil se terminent. Le paramètre Intervalle temporel sert à évaluer de manière itérative chaque jour de l’heure de début à l’heure de fin. C’est pourquoi l’heure de fin ne peut pas être antérieure à l’heure de début. | Date |
Intervalle temporel (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 |
Fuseau horaire (Facultatif) | Spécifie le fuseau horaire correspondant aux heures en entrée spécifiées qui seront utilisées pour déterminer la position relative du soleil.
| String |
Ajustée pour l’heure d’été (Facultatif) | Indique si les heures en entrée sont ajustées pour prendre en compte l’heure d’été.
| Boolean |
Longueur d’ombre maximale (Facultatif) | Distance maximale qu’une ombre peut projeter depuis une entité en entrée au cours du calcul. Pensez à définir cette valeur lorsque 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 |
Synthèse
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.
Paramètres
arcpy.ddd.SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})| Nom | 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 raster 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. Le paramètre time_interval sert à évaluer de manière itérative chaque jour de l’heure de début à l’heure de fin. C’est pourquoi l’heure de fin ne peut pas être antérieure à l’heure de début. | 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) | Spécifie le fuseau horaire correspondant aux heures en entrée spécifiées qui seront utilisées pour déterminer la position relative du soleil.
| String |
dst (Facultatif) | Indique si les heures en entrée 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 lorsque 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 montre comment utiliser cette fonction 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: Nécessite 3D Analyst
- Standard: Nécessite 3D Analyst
- Advanced: Nécessite 3D Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?