Fréquence des ombres solaires (3D Analyst)

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

Résultat de l’outil Fréquence des ombres solaires

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

ÉtiquetteExplicationType 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 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.

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)

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
Ajustée pour l’heure d’été
(Facultatif)

Indique si les heures spécifiées sont ajustées pour prendre en compte l’heure d’été.

  • Activé : les heures en entrée sont ajustées pour l’heure d’été.
  • Désactivé : les heures en entrée ne sont pas ajustées pour l’heure d’été. Il s’agit de l’option par défaut.
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 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

arcpy.ddd.SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})
NomExplicationType 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é.

  • DSTLes heures en entrée sont ajustées pour l’heure d’été.
  • NO_DSTLes 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')

Informations de licence

  • Basic: Nécessite 3D Analyst
  • Standard: Nécessite 3D Analyst
  • Advanced: Nécessite 3D Analyst

Rubriques connexes