Rayonnement solaire du raster (Spatial Analyst)

Synthèse

Calcule l’insolation solaire entrante de chaque cellule raster d’un modèle numérique de surface pour la Terre ou la Lune.

L’insolation solaire est calculée comme la quantité d’énergie de rayonnement solaire reçue par unité de surface sur une période donnée et est mesurée en kilowatts-heures par mètre carré (kWh/m²).

Utilisation

• Le calcul de l’insolation peut s’avérer lourd pour les étendues de données volumineuses et de multiples intervalles temporels. Il peut nécessiter une puissance de calcul élevée, ainsi qu’un espace de disque dur important. Vous pouvez effectuer des exécutions préliminaires avec des données de résolution moindre ou un sous-ensemble des données pour vérifier que les paramètres sont corrects avant de lancer un calcul avec les données de résolution maximale.

• La référence spatiale définie du paramètre Raster de surface en entrée indique si l’analyse concerne la Terre ou la Lune.

• Le calcul du rayonnement solaire exige que la valeur d’environnement du Système de coordonnées en sortie soit dans un système de coordonnées projetées. Il est recommandé d’utiliser des données d’un système de coordonnées projetées exprimées en mètres. Si vous exécutez l’analyse avec un système de coordonnées sphériques, vous devez définir l’environnement du Système de coordonnées en sortie sur un système de coordonnées projetées valide.

• Si le raster en entrée doit être ré-échantillonné, la technique bilinéaire sera utilisée. Un raster en entrée peut être ré-échantillonné par exemple lorsque le système de coordonnées en sortie, l’étendue ou la taille de cellule est différent(e) de celui ou celle en entrée.

• L’heure d’été est prise en charge uniquement pour la Terre. Dans le cas de la Lune, les heures doivent être exprimées en UTC.

• La valeur du paramètre Date et heure de fin doit être supérieure ou égale à la date de début. La période totale ne doit pas être supérieure à une année. Les heures de début et de fin peuvent s’étendre sur deux années calendaires.

• Les valeurs de rayonnement en sortie sont calculées pour chaque intervalle temporel respectif. Si aucun rayonnement solaire n’est reçu pour un intervalle temporel, le résultat associé à la localisation concernée a une valeur de zéro.

  Si la durée totale time spécifiée entre l’heure de début et l’heure de fin ne peut pas être divisée de manière égale par l’intervalle temporel, la durée totale est étendue en interne pour atteindre le nombre de tranches horaires requises. Par exemple, si le paramètre Intervalle temporel est défini pour couvrir 3 jours, mais que la différence entre les heures de début et de fin couvre 8 jours, l’intervalle temporel est étendu à 9 jours. Aucun résultat partiel n’est renvoyé pour les intervalles temporels.

• L’intervalle temporel minimal pour les données terrestres est de 30 minutes ; il doit être proportionnel à 30. L’intervalle temporel minimum pour les données lunaires est de deux heures et doit être proportionnel à 2.

• Utilisez le paramètre Masque d’analyse en entrée (in_analysis_mask dans Python) pour limiter le raster en sortie aux seules localisations ou cellules définies par la zone de masque. Il est, de plus, essentiel de tenir compte de l’effet de la surface en dehors de la zone d’intérêt. Le masque peut être défini par des données raster ou d’entités.

  Le masque d’analyse n’affecte pas l’étendue de l’analyse utilisée pour les calculs. Cela signifie que la topographie ou les obstructions potentielles en dehors de la zone de masque ont une influence sur les valeurs de rayonnement solaire calculées pour les zones définies.

  Si l’entrée de masque est un jeu de classes d’entités, elle est convertie en raster en interne, en utilisant la taille de cellule et l’alignement de cellule de la valeur du raster de surface en entrée par défaut.

• Le fait de spécifier des rasters de pente et d’exposition en entrée permet d’améliorer les performances, surtout si l’outil est exécuté de manière répétée ou lors de l’analyse de jeux de données volumineux. Si les valeurs de raster de pente ou d’exposition en entrée ne sont pas fournies, les valeurs sont calculées à partir du raster de surface en entrée.

• Le paramètre Distance de voisinage (neighborhood_distance dans Python) détermine la taille du voisinage et calcule le paramètre de surface sur cette distance à partir du centre de la cellule cible. Sa valeur ne peut pas être inférieure à la taille de cellule raster en entrée.

  Une faible distance de voisinage capture davantage de variabilité locale dans le paysage, comme des caractéristiques d’entités de paysage plus petites. Avec des données d’élévation haute résolution, des distances plus importantes sont davantage appropriées.

• Si le paramètre Utiliser le voisinage adaptatif(use_adaptive_neighborhood = "ADAPTIVE_NEIGHBORHOOD" dans Python) est activé, la distance de voisinage change en fonction de la variabilité du terrain. La distance de voisinage diminue en cas de forte variabilité dans la fenêtre de calcul.

• La Lune de la Terre n’a pas d’atmosphère ; les paramètres de rayonnement que sont la proportion de diffusion et la transmittance ne sont pas pertinents pour l’analyse. Ainsi, le rayonnement solaire diffus entrant est égal à zéro et le rayonnement total est égal au rayonnement solaire direct.

• La proportion de diffusion est la fraction du flux de rayonnement global qui est diffusée. Les valeurs sont comprises entre 0 et 1. Définissez cette valeur en fonction des conditions atmosphériques. En général, les valeurs sont 0,2 lorsque le ciel est très dégagé et 0,3 dans des conditions générales.

• La transmittance est le rapport entre l’énergie qui atteint la surface de la Terre et celle qui est reçue à la limite supérieure de l’atmosphère. La plage de valeurs est comprise entre 0 (pas de transmission) et 1 (transmission totale). En général, les valeurs observées sont 0,6 ou 0,7 dans des conditions de ciel très clair et 0,5 dans des conditions de ciel normalement clair.

• La transmittance a une relation inverse avec le paramètre de proportion de diffusion. Le fait de modifier ces valeurs peut affecter le résultat du modèle. L’identification des meilleures valeurs pour la zone d’intérêt dépend de plusieurs variables (telles que la localisation et le moment). Vous pouvez modifier ces valeurs pour comparer la manière dont elles affectent le résultat.

• Le paramètre Niveau de grille de la carte d’ensoleillement contrôle la vitesse et la précision du calcul. Il ajuste la résolution des cellules de grille hexagonales qui serviront pour les calculs internes reposant sur le système d’indexation géospatiale H3.

  Un niveau de grille plus petit crée un nombre inférieur de zones de carte d’ensoleillement plus grandes et diminue le temps d’exécution de l’outil. Un niveau de grille plus grand crée un nombre supérieur de zones de carte d’ensoleillement plus petites et améliore la précision du résultat.

  Les valeurs valides du niveau de grille de la carte d’ensoleillement pour la Terre varient entre 5 et 7. Pour la Lune, les valeurs valides sont comprises entre 4 et 6.

  Le niveau par défaut est déterminé par le raster de surface en entrée. Lors de l’analyse des données de surface sur la Terre, si la taille de cellule d’analyse est inférieure ou égale à 4 mètres, le niveau de grille par défaut est de 6. Si la taille de cellule est supérieure à 4 mètres, le niveau de grille par défaut s’élève à 5. Pour analyser des données de surface sur la Lune, le niveau par défaut est égal à 6.

  La table suivante montre la surface moyenne des cellules de grille hexagonales pour chaque niveau de la carte d’ensoleillement, en kilomètres carrés :

  Niveau	Terre	Lune
  4	Sans objet	131,6
  5	252,9 (par défaut > 4 m)	18,8
  6	36,1 (par défaut < 4 m)	2,69 (par défaut)
  7	5,16	Sans objet

• Si votre système dispose d’un processeur graphique (GPU) compatible, celui-ci peut accélérer cet outil et améliorer ses performances. Utilisez le paramètre Périphérique cible pour analyse (analysis_target_device dans Python) pour définir si c’est le GPU ou le CPU qui sera utilisé pour exécuter l’outil.

  Reportez-vous à la rubrique Traitement GPU avec Spatial Analyst pour plus de détails sur les GPU compatibles ainsi que sur la configuration et l’utilisation de périphériques GPU, et pour des conseils de dépannage.

• Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.

• Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

• Ressources supplémentaires :

  Acton, C. A. "Ancillary data services of NASA's Navigation and Ancillary Information Facility". Planetary and Space Science. Vol. 44, Issue 1, January 1996, 65-70. https://doi.org/10.1016/0032-0633(95)00107-7

  Acton, C, Bachman, Semenov, B., and Wright, E. "A look towards the future in the handling of space science mission geometry". Planetary and Space Science. Volume 150, January 2018, 9-12. https://doi.org/10.1016/j.pss.2017.02.013

  Brodsky, I., "Uber’s Hexagonal Hierarchical Spatial Index H3", Engineering (blog), June 27, 2018, https://www.uber.com/blog/h3/

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster de surface en entrée	Raster de surface d’altitude en entrée.	Raster Layer
Date et heure de début	Date et heure de début de l’analyse.	Date
Date et heure de fin	Date et heure de fin de l’analyse.	Date
Masque d’analyse en entrée (Facultatif)	Données en entrée définissant les localisations où l’analyse est effectuée.	Composite Geodataset
Input Slope Raster (Raster de pente en entrée) (Facultatif)	Raster de pente en entrée utilisé lors du calcul du rayonnement solaire en sortie. Si cette entrée n’est pas spécifiée, l’outil calcule les valeurs de pente en interne à partir du raster de surface en entrée. Le fait d’indiquer cette valeur permet d’améliorer les performances, surtout si l’outil est exécuté de manière répétée ou lors de l’analyse de jeux de données volumineux.	Raster Layer
Raster d’exposition en entrée (Facultatif)	Raster d’exposition en entrée utilisé lors du calcul du rayonnement solaire en sortie. Si cette entrée n’est pas spécifiée, l’outil calcule les valeurs d’exposition en interne à partir du raster de surface en entrée. Le fait d’indiquer cette valeur permet d’améliorer les performances, surtout si l’outil est exécuté de manière répétée ou lors de l’analyse de jeux de données volumineux.	Raster Layer
Raster de rayonnement direct en sortie (Facultatif)	Raster en sortie correspondant à la valeur du rayonnement solaire direct entrant pour chaque localisation. La sortie est exprimée en kilowattheures par mètre carré (kWh/m^2).	Raster Dataset
Raster de rayonnement diffus en sortie (Facultatif)	Raster en sortie correspondant au rayonnement solaire entrant diffusé par le ciel, les couches de l’atmosphère et d’autres éléments environnants. La sortie est exprimée en kilowattheures par mètre carré (kWh/m^2).	Raster Dataset
Raster de durée en sortie (Facultatif)	Raster en sortie correspondant à la durée du rayonnement solaire direct entrant. La sortie est exprimée en heures.	Raster Dataset
Fuseau horaire (Facultatif)	Fuseau horaire utilisé pour les heures de début et de fin. Le temps universel coordonné (UTC) est le fuseau horaire par défaut. UTC—Le fuseau horaire sera UTC (Temps universel coordonné). Ligne de changement de date—Le fuseau horaire sera Ligne de changement de date (UTC-12:00). UTC-11—Le fuseau horaire sera UTC-11 (UTC-11:00). Heure normale des îles Aléoutiennes—Le fuseau horaire sera Heure normale des îles Aléoutiennes (UTC-10:00). Heure normale d’Hawaï—Le fuseau horaire sera Heure normale d’Hawaï (UTC-10:00). Heure normale des Marquises—Le fuseau horaire sera Heure normale des Marquises (UTC-09:30). Heure normale de l’Alaska—Le fuseau horaire sera Heure normale de l’Alaska (UTC-09:00). UTC-09—Le fuseau horaire sera UTC-09 (UTC-09:00). Heure normale du Pacifique (Mexique)—Le fuseau horaire sera Heure normale du Pacifique (Mexique) (UTC-08:00). UTC-08—Le fuseau horaire sera UTC-08 (UTC-08:00). Heure normale du Pacifique—Le fuseau horaire sera Heure normale du Pacifique (UTC-08:00). Heure normale des montagnes Rocheuses (États-Unis)—Le fuseau horaire sera Heure normale des montagnes Rocheuses (États-Unis) (UTC-07:00). Heure normale des montagnes (Mexique)—Le fuseau horaire sera Heure normale des montagnes Rocheuses (Mexique) (UTC-07:00). Heure normale des montagnes Rocheuses—Le fuseau horaire sera Heure normale des montagnes Rocheuses (UTC-07:00). Heure normale de Yukon—Le fuseau horaire sera Heure normale de Yukon (UTC-07:00). Heure normale d’Amérique centrale—Le fuseau horaire sera Heure normale d’Amérique centrale (UTC-06:00). Heure normale du Centre—Le fuseau horaire sera Heure normale du Centre (UTC-06:00). Heure normale de l’Île de Pâques—Le fuseau horaire sera Heure normale de l’Île de Pâques (UTC-06:00). Heure normale du Centre (Mexique)—Le fuseau horaire sera Heure normale du Centre (Mexique) (UTC-06:00). Heure normale du Centre du Canada—Le fuseau horaire sera Heure normale du Centre du Canada (UTC-06:00). Heure normale du Pacifique (Amérique du Sud)—Le fuseau horaire sera Heure normale du Pacifique (Amérique du Sud) (UTC-05:00). Heure normale de l’Est (Mexique)—Le fuseau horaire sera Heure normale de l’Est (Mexique) (UTC-05:00). Heure normale de l’Est—Le fuseau horaire sera Heure normale de l’Est (UTC-05:00). Heure normale d’Haïti—Le fuseau horaire sera Heure normale d’Haïti (UTC-05:00). Heure normale de Cuba—Le fuseau horaire sera Heure normale de Cuba (UTC-05:00). Heure normale de l’Est (États-Unis)—Le fuseau horaire sera Heure normale de l’Est (États-Unis) (UTC-05:00). Heure normale des îles Turques-et-Caïques—Le fuseau horaire sera Heure normale des îles Turques-et-Caïques (UTC-04:00). Heure normale du Paraguay—Le fuseau horaire sera Heure normale du Paraguay (UTC-04:00). Heure normale de l’Atlantique—Le fuseau horaire sera Heure normale de l’Atlantique (UTC-04:00). Heure normale du Venezuela—Le fuseau horaire sera Heure normale du Venezuela (UTC-04:00). Heure normale du Centre du Brésil—Le fuseau horaire sera Heure normale du Centre du Brésil (UTC-04:00). Heure normale de l’Ouest (Amérique du Sud)—Le fuseau horaire sera Heure normale de l’Ouest (Amérique du Sud) (UTC-04:00). Heure normale du Pacifique (Amérique du Sud)—Le fuseau horaire sera Heure normale du Pacifique (Amérique du Sud) (UTC-04:00) Heure normale de Terre-Neuve—Le fuseau horaire sera Heure normale de Terre-Neuve (UTC-03:00). Heure normale du Tocantins—Le fuseau horaire sera Heure normale du Tocantins (UTC-03:00). Heure normale de l’Est de l’Amérique du Sud—Le fuseau horaire sera Heure normale de l’Est de l’Amérique du Sud (UTC-03:00). Heure normale de l’Est (Amérique du Sud)—Le fuseau horaire sera Heure normale de l’Est (Amérique du Sud) (UTC-03:00). Heure normale d’Argentine—Le fuseau horaire sera Heure normale d’Argentine (UTC-03:00). Heure normale du Groenland—Le fuseau horaire sera Heure normale du Groenland (UTC-03:00). Heure normale de Montevideo—Le fuseau horaire sera Heure normale de Montevideo (UTC-03:00). Heure normale de Magallanes—Le fuseau horaire sera Heure normale de Magallanes (UTC-03:00). Heure normale de Saint-Pierre—Le fuseau horaire sera Heure normale de Saint-Pierre (UTC-03:00). Heure normale de Bahia—Le fuseau horaire sera Heure normale de Bahia (UTC-03:00). UTC-02—Le fuseau horaire sera UTC-02 (UTC-02:00). Heure normale du Centre-Atlantique—Le fuseau horaire sera Heure normale du Centre-Atlantique (UTC-02:00). Heure normale des Açores—Le fuseau horaire sera Heure normale des Açores (UTC-01:00). Heure normale du Cap-Vert—Le fuseau horaire sera Heure normale du Cap-Vert (UTC-01:00). Heure normale GMT—Le fuseau horaire sera Heure normale GMT (UTC+00:00). Heure normale de Greenwich—Le fuseau horaire sera Heure normale de Greenwich (UTC+00:00). Heure normale de Sao Tomé—Le fuseau horaire sera Heure normale de Sao Tomé (UTC+00:00). Heure normale du Maroc—Le fuseau horaire sera Heure normale du Maroc (UTC+00:00). Heure normale d’Europe de l’Ouest—Le fuseau horaire sera Heure normale d’Europe de l’Ouest (UTC+01:00). Heure normale d’Europe centrale—Le fuseau horaire sera Heure normale d’Europe centrale (UTC+01:00). Heure normale d’Europe centrale—Le fuseau horaire sera Heure normale d’Europe centrale (UTC+01:00). Heure normale d’Europe centrale—Le fuseau horaire sera Heure normale d’Europe centrale (UTC+01:00). Heure normale d’Afrique de l’Ouest—Le fuseau horaire sera Heure normale d’Afrique de l’Ouest (UTC+01:00). Heure normale de Jordanie—Le fuseau horaire sera Heure normale de Jordanie (UTC+02:00). Heure normale GTB—Le fuseau horaire sera Heure normale GTB (UTC+02:00). Heure normale du Moyen-Orient—Le fuseau horaire sera Heure normale du Moyen-Orient (UTC+02:00). Heure normale d’Égypte—Le fuseau horaire sera Heure normale d’Égypte (UTC+02:00). Heure normale d’Europe de l’Est—Le fuseau horaire sera Heure normale d’Europe de l’Est (UTC+02:00). Heure normale de la Syrie—Le fuseau horaire sera Heure normale de la Syrie (UTC+02:00). Heure normale de Cisjordanie—Le fuseau horaire sera Heure normale de Cisjordanie (UTC+02:00). Heure normale d’Afrique du Sud—Le fuseau horaire sera Heure normale d’Afrique du Sud (UTC+02:00). Heure normale FLE—Le fuseau horaire sera Heure normale FLE (UTC+02:00). Heure normale d’Israël—Le fuseau horaire sera Heure normale d’Israël (UTC+02:00). Heure normale du Soudan du Sud—Le fuseau horaire sera Heure normale du Soudan du Sud (UTC+02:00). Heure normale de Kaliningrad—Le fuseau horaire sera Heure normale de Kaliningrad (UTC+02:00). Heure normale du Soudan—Le fuseau horaire sera Heure normale du Soudan (UTC+02:00). Heure normale de la Libye—Le fuseau horaire sera Heure normale de la Libye (UTC+02:00). Heure normale de Namibie—Le fuseau horaire sera Heure normale de Namibie (UTC+02:00). Heure normale de l’Arabie—Le fuseau horaire sera Heure normale de l’Arabie (UTC+03:00). Heure normale de Turquie—Le fuseau horaire sera Heure normale de la Turquie (UTC+03:00). Heure normale de l’Arabie—Le fuseau horaire sera Heure normale de l’Arabie (UTC+03:00). Heure normale du Bélarus—Le fuseau horaire sera Heure normale du Bélarus (UTC+03:00). Heure normale de Russie—Le fuseau horaire sera Heure normale de la Russie (UTC+03:00). Heure normale d’Afrique de l’Est—Le fuseau horaire sera Heure normale d’Afrique de l’Est (UTC+03:00). Heure standard de Volgograd—Le fuseau horaire sera Heure normale de Volgograd (UTC+03:00). Heure normale de l’Iran—Le fuseau horaire sera Heure normale de l’Iran (UTC+03:00). Heure normale de l’Arabie—Le fuseau horaire sera Heure normale de l’Arabie (UTC+04:00). Heure normale d’Astrakhan—Le fuseau horaire sera Heure normale d’Astrakhan (UTC+04:00). Heure normale de l’Azerbaïdjan—Le fuseau horaire sera Heure normale de l’Azerbaïdjan (UTC+04:00). Fuseau horaire de la Russie 3—Le fuseau horaire sera Fuseau horaire de la Russie 3 (UTC+04:00). Heure normale de l’île Maurice—Le fuseau horaire sera Heure normale de l’île Maurice (UTC+04:00). Heure normale de Saratov—Le fuseau horaire sera Heure normale de Saratov (UTC+04:00). Heure normale de Géorgie—Le fuseau horaire sera Heure normale de la Géorgie (UTC+04:00). Heure normale du Caucase—Le fuseau horaire sera Heure normale du Caucase (UTC+04:00). Heure normale d’Afghanistan—Le fuseau horaire sera Heure normale d’Afghanistan (UTC+04:30). Heure normale d’Asie de l’Ouest—Le fuseau horaire sera Heure normale d’Asie de l’Ouest (UTC+05:00). Heure normale d’Ekaterinbourg—Le fuseau horaire sera Heure normale d’Ekaterinbourg (UTC+05:00). Heure normale du Pakistan—Le fuseau horaire sera Heure normale du Pakistan (UTC+05:00). Heure normale de Kyzylorda—Le fuseau horaire sera Heure normale de Kyzylorda (UTC+05:00). Heure normale de l’Inde—Le fuseau horaire sera Heure normale de l’Inde (UTC+05:30). Heure normale du Sri Lanka—Le fuseau horaire sera Heure normale du Sri Lanka (UTC+05:30). Heure normale du Népal—Le fuseau horaire sera Heure normale du Népal (UTC+05:45). Heure normale d’Asie centrale—Le fuseau horaire sera Heure normale d’Asie centrale (UTC+06:00). Heure normale du Bangladesh—Le fuseau horaire sera Heure normale du Bangladesh (UTC+06:00). Heure normale d’Omsk—Le fuseau horaire sera Heure normale d’Omsk (UTC+06:00). Heure normale du Myanmar—Le fuseau horaire sera Heure normale du Myanmar (UTC+06:30). Heure normale d’Asie du Sud-Ouest—Le fuseau horaire sera Heure normale d’Asie du Sud-Ouest (UTC+07:00). Heure normale de l’Altaï—Le fuseau horaire sera Heure normale de l’Altaï (UTC+07:00). Heure normale de l’Ouest de la Mongolie—Le fuseau horaire sera Heure normale de l’Ouest de la Mongolie (UTC+07:00). Heure normale d’Asie du Nord—Le fuseau horaire sera Heure normale d’Asie du Nord (UTC+07:00). Heure normale d’Asie centrale septentrionale—Le fuseau horaire sera Heure normale d’Asie centrale septentrionale (UTC+07:00). Heure normale de Tomsk—Le fuseau horaire sera Heure normale de Tomsk (UTC+07:00). Heure normale de Chine—Le fuseau horaire sera Heure normale de la Chine (UTC+08:00). Heure normale d’Asie du Nord-Est—Le fuseau horaire sera Heure normale d’Asie du Nord-Est (UTC+08:00). Heure normale de Singapour—Le fuseau horaire sera Heure normale de Singapour (UTC+08:00). Heure normale de l’Ouest de l’Australie—Le fuseau horaire sera Heure normale de l’Ouest de l’Australie (UTC+08:00). Heure normale de Taïpei—Le fuseau horaire sera Heure normale de Taïpei (UTC+08:00). Heure normale d’Oulan-Bator—Le fuseau horaire sera Heure normale d’Oulan-Bator (UTC+08:00). Heure normale du centre-ouest australien—Le fuseau horaire sera Heure normale du centre-ouest australien (UTC+08:45). Heure normale de la Transbaïkalie—Le fuseau horaire sera Heure normale de la Transbaïkalie (UTC+09:00). Heure normale de Tokyo—Le fuseau horaire sera Heure normale de Tokyo (UTC+09:00). Heure normale de la Corée du Nord—Le fuseau horaire sera Heure normale de la Corée du Nord (UTC+09:00). Heure normale de Corée—Le fuseau horaire sera Heure normale de Corée (UTC+09:00). Heure normale de Yakoutsk—Le fuseau horaire sera Heure normale de Yakoutsk (UTC+09:00). Heure normale du Centre de l’Australie—Le fuseau horaire sera Heure normale du Centre de l’Australie (UTC+09:30). Heure normale du Centre de l’Australie—Le fuseau horaire sera Heure normale du Centre de l’Australie (UTC+09:30). Heure normale de l’Est de l’Australie—Le fuseau horaire sera Heure normale de l’Est de l’Australie (UTC+10:00). Heure normale de l’Est de l’Australie—Le fuseau horaire sera Heure normale de l’Est de l’Australie (UTC+10:00). Heure normale du Pacifique occidental—Le fuseau horaire sera Heure normale du Pacifique occidental (UTC+10:00). Heure normale de Tasmanie—Le fuseau horaire sera Heure normale de Tasmanie (UTC+10:00). Heure normale de Vladivostok—Le fuseau horaire sera Heure normale de Vladivostok (UTC+10:00). Heure normale de l’île Lord Howe—Le fuseau horaire sera Heure normale de l’île Lord Howe (UTC+10:30). Heure normale de Bougainville—Le fuseau horaire sera Heure normale de Bougainville (UTC+11:00). Fuseau horaire de la Russie 10—Le fuseau horaire sera Fuseau horaire de la Russie 10 (UTC+11:00). Heure normale de Magadan—Le fuseau horaire sera Heure normale de Magadan (UTC+11:00). Heure normale de l’île Norfolk—Le fuseau horaire sera Heure normale de Norfolk (UTC+11:00). Heure standard de Sakhaline—Le fuseau horaire sera Heure normale de Sakhaline (UTC+11:00). Heure normale du Pacifique central—Le fuseau horaire sera Heure normale du Pacifique central (UTC+11:00). Fuseau horaire de la Russie 11—Le fuseau horaire sera Fuseau horaire de la Russie 11 (UTC+11:00). Heure normale de Nouvelle-Zélande—Le fuseau horaire sera Heure normale de Nouvelle-Zélande (UTC+12:00). UTC+12—Le fuseau horaire sera UTC+12 (UTC+12:00). Heure normale des îles Fidji—Le fuseau horaire sera Heure normale des îles Fidji (UTC+12:00). Heure normale du Kamtchatka—Le fuseau horaire sera Heure normale de Kamchatka (UTC+12:00). Heure normale des îles Chatham—Le fuseau horaire sera Heure normale des îles Chatham (UTC+12:45). UTC+13—Le fuseau horaire sera UTC+13 (UTC+13:00). Heure normale des Tonga—Le fuseau horaire sera Heure normale des Tonga (UTC+13:00). Heure normale des Samoa—Le fuseau horaire sera Heure normale des Samoa (UTC+13:00). Heure normale des îles de la Ligne—Le fuseau horaire sera Heure normale des îles de la Ligne (UTC+14:00).	String
Régler les heures sur l’heure d’été (Facultatif)	Indique si la configuration temporelle en entrée est ajustée en fonction de l’heure d’été. Ce paramètre ne s’applique pas pour l’analyse sur la Lune. Désactivé - Les valeurs temporelles en entrée ne sont pas ajustées pour l’heure d’été. Il s’agit de l’option par défaut. Activé - Les valeurs temporelles en entrée sont ajustées pour l’heure d’été.	Boolean
Calculer l’insolation pour les intervalles temporels (Facultatif)	Indique s’il faut calculer une seule valeur d’insolation totale pour la totalité de la configuration temporelle ou plusieurs valeurs de rayonnement pour l’intervalle spécifié. Désactivé - Une valeur de rayonnement total unique est calculée pour toute la configuration de temps. Il s’agit de l’option par défaut. Activé - Plusieurs valeurs de rayonnement sont calculées pour chaque intervalle de temps sur toute la configuration de temps. Le nombre de sorties dépend de la valeur de l’intervalle. Par exemple, pour une configuration sur toute l’année avec des intervalles mensuels, le résultat donne 12 valeurs de rayonnement en sortie pour chaque localisation.	Boolean
Unité de l’intervalle temporel (Facultatif)	Spécifie l’unité de temps utilisée pour le calcul des valeurs de rayonnement solaire sur la totalité de la configuration temporelle. Ce paramètre est disponible uniquement lorsque le paramètre Calculer l’insolation pour les intervalles temporels est activé. Minute—L’intervalle est exprimé en minutes. Cette option n’est disponible que pour les données terrestres. Heure—L’intervalle est exprimé en heures. Jour—L’intervalle est exprimé en jours. Il s’agit du paramètre par défaut. Semaine—L’intervalle est exprimé en semaines.	String
Intervalle temporel (Facultatif)	Valeur de la durée des intervalles. La valeur par défaut dépend de l’unité de l’intervalle spécifiée. La valeur par défaut de chaque unité disponible est indiquée dans la liste ci-dessous. Minute - 60 Heure - 4 Jour - 14 Semaine - 2	Long
Distance de voisinage (Facultatif)	Distance à partir du centre de cellule cible pour lequel la valeur d’insolation en sortie doit être calculée. Elle détermine la taille du voisinage. La valeur par défaut est la taille de cellule du raster de surface en entrée, soit un voisinage de 3 par 3.	Linear Unit
Utiliser le voisinage adaptatif (Facultatif)	Spécifie si la distance de voisinage varie selon les changements (variations) du paysage. La distance maximale est déterminée par la distance du voisinage. La distance minimale est égale à la taille de cellule raster en entrée. Désactivé : une distance de voisinage unique (fixe) sera utilisée en tout emplacement. Il s’agit de l’option par défaut. Activé : une distance de voisinage adaptative sera utilisée en tout emplacement.	Boolean
Type de modèle de diffusion (Facultatif)	Spécifie le type de modèle de rayonnement diffus utilisé. Ciel uniforme—Le modèle du ciel uniforme avec rayonnement diffus est utilisé. Le rayonnement diffus entrant est identique dans toutes les directions célestes. Il s’agit de l’option par défaut. Ciel couvert standard—Le modèle du ciel couvert standard avec rayonnement diffus est utilisé. Le flux du rayonnement diffus entrant varie avec l‘angle zénithal.	String
Proportion de diffusion (Facultatif)	Proportion du flux du rayonnement normal global qui est diffusé. Les valeurs sont comprises entre 0 et 1. Définissez cette valeur en fonction des conditions atmosphériques. La valeur par défaut est de 0,3 pour des conditions de ciel dégagé.	Double
Transmittance (Facultatif)	Fraction du rayonnement traversant l'atmosphère (moyennée sur toutes les longueurs d'onde). La plage de valeurs est comprise entre 0 (pas de transmission) et 1 (transmission totale). La valeur par défaut est de 0,5 pour des conditions de ciel dégagé.	Double
Périphérique cible pour analyse (Facultatif)	Spécifie le périphérique qui sera utilisé pour effectuer le calcul. GPU puis CPU—Si un GPU compatible est trouvé, celui-ci sera utilisé pour effectuer le calcul. Autrement, le CPU sera utilisé. Il s’agit de l’option par défaut. CPU uniquement—Le calcul sera uniquement exécuté sur le CPU. GPU uniquement—Le calcul sera uniquement exécuté sur le GPU.	String
Niveau de grille de la carte d’ensoleillement (Facultatif)	Résolution utilisée pour générer les cellules de grille hexagonales H3 utilisées pour les calculs internes. Une valeur de niveau de grille plus petite crée un nombre inférieur de zones de carte d’ensoleillement plus grandes et diminue le temps d’exécution de l’outil. Un niveau de grille plus grand crée un nombre supérieur de zones de carte d’ensoleillement plus petites et améliore la précision du résultat. Les valeurs valides du niveau de grille de la carte d’ensoleillement pour la Terre varient entre 5 et 7. Pour la Lune, les valeurs valides sont comprises entre 4 et 6. Par défaut, le niveau de grille est déterminé par le raster de surface en entrée. Lors de l’analyse des données de surface sur la Terre, si la taille de cellule d’analyse est inférieure ou égale à 4 mètres, le niveau de grille par défaut est de 6. Si la taille de cellule d’analyse est supérieure à 4 mètres, le niveau de grille par défaut s’élève à 5. Pour analyser des données de surface sur la Lune, le niveau de grille par défaut est égal à 6.	Long

Valeur renvoyée

Étiquette	Explication	Type de données
Raster de rayonnement solaire en sortie	Raster en sortie correspondant au rayonnement solaire total reçu par unité de surface sur la surface en entrée. La sortie est exprimée en kilowattheures par mètre carré (kWh/m^2).	Raster

Python

RasterSolarRadiation(in_surface_raster, start_date_time, end_date_time, {in_analysis_mask}, {in_slope_raster}, {in_aspect_raster}, {out_direct_radiation_raster}, {out_diffuse_radiation_raster}, {out_duration_raster}, {time_zone}, {adjust_DST}, {use_time_interval}, {interval_unit}, {interval}, {neighborhood_distance}, {use_adaptive_neighborhood}, {diffuse_model_type}, {diffuse_proportion}, {transmittivity}, {analysis_target_device}, {sunmap_grid_level})

Nom	Explication	Type de données
in_surface_raster	Raster de surface d’altitude en entrée.	Raster Layer
start_date_time	Date et heure de début de l’analyse.	Date
end_date_time	Date et heure de fin de l’analyse.	Date
in_analysis_mask (Facultatif)	Données en entrée définissant les localisations où l’analyse est effectuée.	Composite Geodataset
in_slope_raster (Facultatif)	Raster de pente en entrée utilisé lors du calcul du rayonnement solaire en sortie. Si cette entrée n’est pas spécifiée, l’outil calcule les valeurs de pente en interne à partir du raster de surface en entrée. Le fait d’indiquer cette valeur permet d’améliorer les performances, surtout si l’outil est exécuté de manière répétée ou lors de l’analyse de jeux de données volumineux.	Raster Layer
in_aspect_raster (Facultatif)	Raster d’exposition en entrée utilisé lors du calcul du rayonnement solaire en sortie. Si cette entrée n’est pas spécifiée, l’outil calcule les valeurs d’exposition en interne à partir du raster de surface en entrée. Le fait d’indiquer cette valeur permet d’améliorer les performances, surtout si l’outil est exécuté de manière répétée ou lors de l’analyse de jeux de données volumineux.	Raster Layer
out_direct_radiation_raster (Facultatif)	Raster en sortie correspondant à la valeur du rayonnement solaire direct entrant pour chaque localisation. La sortie est exprimée en kilowattheures par mètre carré (kWh/m^2).	Raster Dataset
out_diffuse_radiation_raster (Facultatif)	Raster en sortie correspondant au rayonnement solaire entrant diffusé par le ciel, les couches de l’atmosphère et d’autres éléments environnants. La sortie est exprimée en kilowattheures par mètre carré (kWh/m^2).	Raster Dataset
out_duration_raster (Facultatif)	Raster en sortie correspondant à la durée du rayonnement solaire direct entrant. La sortie est exprimée en heures.	Raster Dataset
time_zone (Facultatif)	Fuseau horaire utilisé pour les heures de début et de fin. Le temps universel coordonné (UTC) est le fuseau horaire par défaut. UTC—Le fuseau horaire sera UTC (Temps universel coordonné). Dateline_Standard_Time—Le fuseau horaire sera Ligne de changement de date (UTC-12:00). UTC-11—Le fuseau horaire sera UTC-11 (UTC-11:00). Aleutian_Standard_Time—Le fuseau horaire sera Heure normale des îles Aléoutiennes (UTC-10:00). Hawaiian_Standard_Time—Le fuseau horaire sera Heure normale d’Hawaï (UTC-10:00). Marquesas_Standard_Time—Le fuseau horaire sera Heure normale des Marquises (UTC-09:30). Alaskan_Standard_Time—Le fuseau horaire sera Heure normale de l’Alaska (UTC-09:00). UTC-09—Le fuseau horaire sera UTC-09 (UTC-09:00). Pacific_Standard_Time_(Mexico)—Le fuseau horaire sera Heure normale du Pacifique (Mexique) (UTC-08:00). UTC-08—Le fuseau horaire sera UTC-08 (UTC-08:00). Pacific_Standard_Time—Le fuseau horaire sera Heure normale du Pacifique (UTC-08:00). US_Mountain_Standard_Time—Le fuseau horaire sera Heure normale des montagnes Rocheuses (États-Unis) (UTC-07:00). Mountain_Standard_Time_(Mexico)—Le fuseau horaire sera Heure normale des montagnes Rocheuses (Mexique) (UTC-07:00). Mountain_Standard_Time—Le fuseau horaire sera Heure normale des montagnes Rocheuses (UTC-07:00). Yukon_Standard_Time—Le fuseau horaire sera Heure normale de Yukon (UTC-07:00). Central_America_Standard_Time—Le fuseau horaire sera Heure normale d’Amérique centrale (UTC-06:00). Central_Standard_Time—Le fuseau horaire sera Heure normale du Centre (UTC-06:00). Easter_Island_Standard_Time—Le fuseau horaire sera Heure normale de l’Île de Pâques (UTC-06:00). Central_Standard_Time_(Mexico)—Le fuseau horaire sera Heure normale du Centre (Mexique) (UTC-06:00). Canada_Central_Standard_Time—Le fuseau horaire sera Heure normale du Centre du Canada (UTC-06:00). SA_Pacific_Standard_Time—Le fuseau horaire sera Heure normale du Pacifique (Amérique du Sud) (UTC-05:00). Eastern_Standard_Time_(Mexico)—Le fuseau horaire sera Heure normale de l’Est (Mexique) (UTC-05:00). Eastern_Standard_Time—Le fuseau horaire sera Heure normale de l’Est (UTC-05:00). Haiti_Standard_Time—Le fuseau horaire sera Heure normale d’Haïti (UTC-05:00). Cuba_Standard_Time—Le fuseau horaire sera Heure normale de Cuba (UTC-05:00). US_Eastern_Standard_Time—Le fuseau horaire sera Heure normale de l’Est (États-Unis) (UTC-05:00). Turks_And_Caicos_Standard_Time—Le fuseau horaire sera Heure normale des îles Turques-et-Caïques (UTC-04:00). Paraguay_Standard_Time—Le fuseau horaire sera Heure normale du Paraguay (UTC-04:00). Atlantic_Standard_Time—Le fuseau horaire sera Heure normale de l’Atlantique (UTC-04:00). Venezuela_Standard_Time—Le fuseau horaire sera Heure normale du Venezuela (UTC-04:00). Central_Brazilian_Standard_Time—Le fuseau horaire sera Heure normale du Centre du Brésil (UTC-04:00). SA_Western_Standard_Time—Le fuseau horaire sera Heure normale de l’Ouest (Amérique du Sud) (UTC-04:00). Pacific_SA_Standard_Time—Le fuseau horaire sera Heure normale du Pacifique (Amérique du Sud) (UTC-04:00) Newfoundland_Standard_Time—Le fuseau horaire sera Heure normale de Terre-Neuve (UTC-03:00). Tocantins_Standard_Time—Le fuseau horaire sera Heure normale du Tocantins (UTC-03:00). E._South_America_Standard_Time—Le fuseau horaire sera Heure normale de l’Est de l’Amérique du Sud (UTC-03:00). SA_Eastern_Standard_Time—Le fuseau horaire sera Heure normale de l’Est (Amérique du Sud) (UTC-03:00). Argentina_Standard_Time—Le fuseau horaire sera Heure normale d’Argentine (UTC-03:00). Greenland_Standard_Time—Le fuseau horaire sera Heure normale du Groenland (UTC-03:00). Montevideo_Standard_Time—Le fuseau horaire sera Heure normale de Montevideo (UTC-03:00). Magallanes_Standard_Time—Le fuseau horaire sera Heure normale de Magallanes (UTC-03:00). Saint_Pierre_Standard_Time—Le fuseau horaire sera Heure normale de Saint-Pierre (UTC-03:00). Bahia_Standard_Time—Le fuseau horaire sera Heure normale de Bahia (UTC-03:00). UTC-02—Le fuseau horaire sera UTC-02 (UTC-02:00). Mid-Atlantic_Standard_Time—Le fuseau horaire sera Heure normale du Centre-Atlantique (UTC-02:00). Azores_Standard_Time—Le fuseau horaire sera Heure normale des Açores (UTC-01:00). Cape_Verde_Standard_Time—Le fuseau horaire sera Heure normale du Cap-Vert (UTC-01:00). GMT_Standard_Time—Le fuseau horaire sera Heure normale GMT (UTC+00:00). Greenwich_Standard_Time—Le fuseau horaire sera Heure normale de Greenwich (UTC+00:00). Sao_Tome_Standard_Time—Le fuseau horaire sera Heure normale de Sao Tomé (UTC+00:00). Morocco_Standard_Time—Le fuseau horaire sera Heure normale du Maroc (UTC+00:00). W._Europe_Standard_Time—Le fuseau horaire sera Heure normale d’Europe de l’Ouest (UTC+01:00). Central_Europe_Standard_Time—Le fuseau horaire sera Heure normale d’Europe centrale (UTC+01:00). Romance_Standard_Time—Le fuseau horaire sera Heure normale d’Europe centrale (UTC+01:00). Central_European_Standard_Time—Le fuseau horaire sera Heure normale d’Europe centrale (UTC+01:00). W._Central_Africa_Standard_Time—Le fuseau horaire sera Heure normale d’Afrique de l’Ouest (UTC+01:00). Jordan_Standard_Time—Le fuseau horaire sera Heure normale de Jordanie (UTC+02:00). GTB_Standard_Time—Le fuseau horaire sera Heure normale GTB (UTC+02:00). Middle_East_Standard_Time—Le fuseau horaire sera Heure normale du Moyen-Orient (UTC+02:00). Egypt_Standard_Time—Le fuseau horaire sera Heure normale d’Égypte (UTC+02:00). E._Europe_Standard_Time—Le fuseau horaire sera Heure normale d’Europe de l’Est (UTC+02:00). Syria_Standard_Time—Le fuseau horaire sera Heure normale de la Syrie (UTC+02:00). West_Bank_Standard_Time—Le fuseau horaire sera Heure normale de Cisjordanie (UTC+02:00). South_Africa_Standard_Time—Le fuseau horaire sera Heure normale d’Afrique du Sud (UTC+02:00). FLE_Standard_Time—Le fuseau horaire sera Heure normale FLE (UTC+02:00). Israel_Standard_Time—Le fuseau horaire sera Heure normale d’Israël (UTC+02:00). South_Sudan_Standard_Time—Le fuseau horaire sera Heure normale du Soudan du Sud (UTC+02:00). Kaliningrad_Standard_Time—Le fuseau horaire sera Heure normale de Kaliningrad (UTC+02:00). Sudan_Standard_Time—Le fuseau horaire sera Heure normale du Soudan (UTC+02:00). Libya_Standard_Time—Le fuseau horaire sera Heure normale de la Libye (UTC+02:00). Namibia_Standard_Time—Le fuseau horaire sera Heure normale de Namibie (UTC+02:00). Arabic_Standard_Time—Le fuseau horaire sera Heure normale de l’Arabie (UTC+03:00). Turkey_Standard_Time—Le fuseau horaire sera Heure normale de la Turquie (UTC+03:00). Arab_Standard_Time—Le fuseau horaire sera Heure normale de l’Arabie (UTC+03:00). Belarus_Standard_Time—Le fuseau horaire sera Heure normale du Bélarus (UTC+03:00). Russian_Standard_Time—Le fuseau horaire sera Heure normale de la Russie (UTC+03:00). E._Africa_Standard_Time—Le fuseau horaire sera Heure normale d’Afrique de l’Est (UTC+03:00). Volgograd_Standard_Time—Le fuseau horaire sera Heure normale de Volgograd (UTC+03:00). Iran_Standard_Time—Le fuseau horaire sera Heure normale de l’Iran (UTC+03:00). Arabian_Standard_Time—Le fuseau horaire sera Heure normale de l’Arabie (UTC+04:00). Astrakhan_Standard_Time—Le fuseau horaire sera Heure normale d’Astrakhan (UTC+04:00). Azerbaijan_Standard_Time—Le fuseau horaire sera Heure normale de l’Azerbaïdjan (UTC+04:00). Russia_Time_Zone_3—Le fuseau horaire sera Fuseau horaire de la Russie 3 (UTC+04:00). Mauritius_Standard_Time—Le fuseau horaire sera Heure normale de l’île Maurice (UTC+04:00). Saratov_Standard_Time—Le fuseau horaire sera Heure normale de Saratov (UTC+04:00). Georgian_Standard_Time—Le fuseau horaire sera Heure normale de la Géorgie (UTC+04:00). Caucasus_Standard_Time—Le fuseau horaire sera Heure normale du Caucase (UTC+04:00). Afghanistan_Standard_Time—Le fuseau horaire sera Heure normale d’Afghanistan (UTC+04:30). West_Asia_Standard_Time—Le fuseau horaire sera Heure normale d’Asie de l’Ouest (UTC+05:00). Ekaterinburg_Standard_Time—Le fuseau horaire sera Heure normale d’Ekaterinbourg (UTC+05:00). Pakistan_Standard_Time—Le fuseau horaire sera Heure normale du Pakistan (UTC+05:00). Qyzylorda_Standard_Time—Le fuseau horaire sera Heure normale de Kyzylorda (UTC+05:00). India_Standard_Time—Le fuseau horaire sera Heure normale de l’Inde (UTC+05:30). Sri_Lanka_Standard_Time—Le fuseau horaire sera Heure normale du Sri Lanka (UTC+05:30). Nepal_Standard_Time—Le fuseau horaire sera Heure normale du Népal (UTC+05:45). Central_Asia_Standard_Time—Le fuseau horaire sera Heure normale d’Asie centrale (UTC+06:00). Bangladesh_Standard_Time—Le fuseau horaire sera Heure normale du Bangladesh (UTC+06:00). Omsk_Standard_Time—Le fuseau horaire sera Heure normale d’Omsk (UTC+06:00). Myanmar_Standard_Time—Le fuseau horaire sera Heure normale du Myanmar (UTC+06:30). SE_Asia_Standard_Time—Le fuseau horaire sera Heure normale d’Asie du Sud-Ouest (UTC+07:00). Altai_Standard_Time—Le fuseau horaire sera Heure normale de l’Altaï (UTC+07:00). W._Mongolia_Standard_Time—Le fuseau horaire sera Heure normale de l’Ouest de la Mongolie (UTC+07:00). North_Asia_Standard_Time—Le fuseau horaire sera Heure normale d’Asie du Nord (UTC+07:00). N._Central_Asia_Standard_Time—Le fuseau horaire sera Heure normale d’Asie centrale septentrionale (UTC+07:00). Tomsk_Standard_Time—Le fuseau horaire sera Heure normale de Tomsk (UTC+07:00). China_Standard_Time—Le fuseau horaire sera Heure normale de la Chine (UTC+08:00). North_Asia_East_Standard_Time—Le fuseau horaire sera Heure normale d’Asie du Nord-Est (UTC+08:00). Singapore_Standard_Time—Le fuseau horaire sera Heure normale de Singapour (UTC+08:00). W._Australia_Standard_Time—Le fuseau horaire sera Heure normale de l’Ouest de l’Australie (UTC+08:00). Taipei_Standard_Time—Le fuseau horaire sera Heure normale de Taïpei (UTC+08:00). Ulaanbaatar_Standard_Time—Le fuseau horaire sera Heure normale d’Oulan-Bator (UTC+08:00). Aus_Central_W._Standard_Time—Le fuseau horaire sera Heure normale du centre-ouest australien (UTC+08:45). Transbaikal_Standard_Time—Le fuseau horaire sera Heure normale de la Transbaïkalie (UTC+09:00). Tokyo_Standard_Time—Le fuseau horaire sera Heure normale de Tokyo (UTC+09:00). North_Korea_Standard_Time—Le fuseau horaire sera Heure normale de la Corée du Nord (UTC+09:00). Korea_Standard_Time—Le fuseau horaire sera Heure normale de Corée (UTC+09:00). Yakutsk_Standard_Time—Le fuseau horaire sera Heure normale de Yakoutsk (UTC+09:00). Cen._Australia_Standard_Time—Le fuseau horaire sera Heure normale du Centre de l’Australie (UTC+09:30). AUS_Central_Standard_Time—Le fuseau horaire sera Heure normale du Centre de l’Australie (UTC+09:30). E._Australia_Standard_Time—Le fuseau horaire sera Heure normale de l’Est de l’Australie (UTC+10:00). AUS_Eastern_Standard_Time—Le fuseau horaire sera Heure normale de l’Est de l’Australie (UTC+10:00). West_Pacific_Standard_Time—Le fuseau horaire sera Heure normale du Pacifique occidental (UTC+10:00). Tasmania_Standard_Time—Le fuseau horaire sera Heure normale de Tasmanie (UTC+10:00). Vladivostok_Standard_Time—Le fuseau horaire sera Heure normale de Vladivostok (UTC+10:00). Lord_Howe_Standard_Time—Le fuseau horaire sera Heure normale de l’île Lord Howe (UTC+10:30). Bougainville_Standard_Time—Le fuseau horaire sera Heure normale de Bougainville (UTC+11:00). Russia_Time_Zone_10—Le fuseau horaire sera Fuseau horaire de la Russie 10 (UTC+11:00). Magadan_Standard_Time—Le fuseau horaire sera Heure normale de Magadan (UTC+11:00). Norfolk_Standard_Time—Le fuseau horaire sera Heure normale de Norfolk (UTC+11:00). Sakhalin_Standard_Time—Le fuseau horaire sera Heure normale de Sakhaline (UTC+11:00). Central_Pacific_Standard_Time—Le fuseau horaire sera Heure normale du Pacifique central (UTC+11:00). Russia_Time_Zone_11—Le fuseau horaire sera Fuseau horaire de la Russie 11 (UTC+11:00). New_Zealand_Standard_Time—Le fuseau horaire sera Heure normale de Nouvelle-Zélande (UTC+12:00). UTC+12—Le fuseau horaire sera UTC+12 (UTC+12:00). Fiji_Standard_Time—Le fuseau horaire sera Heure normale des îles Fidji (UTC+12:00). Kamchatka_Standard_Time—Le fuseau horaire sera Heure normale de Kamchatka (UTC+12:00). Chatham_Islands_Standard_Time—Le fuseau horaire sera Heure normale des îles Chatham (UTC+12:45). UTC+13—Le fuseau horaire sera UTC+13 (UTC+13:00). Tonga_Standard_Time—Le fuseau horaire sera Heure normale des Tonga (UTC+13:00). Samoa_Standard_Time—Le fuseau horaire sera Heure normale des Samoa (UTC+13:00). Line_Islands_Standard_Time—Le fuseau horaire sera Heure normale des îles de la Ligne (UTC+14:00).	String
adjust_DST (Facultatif)	Indique si la configuration temporelle en entrée est ajustée en fonction de l’heure d’été. Ce paramètre ne s’applique pas pour l’analyse sur la Lune. NOT_ADJUSTED_FOR_DST—Les valeurs temporelles en entrée ne sont pas ajustées pour l’heure d’été. Il s’agit de l’option par défaut. ADJUSTED_FOR_DST—Les valeurs temporelles en entrée sont ajustées pour l’heure d’été.	Boolean
use_time_interval (Facultatif)	Indique s’il faut calculer une seule valeur d’insolation totale pour la totalité de la configuration temporelle ou plusieurs valeurs de rayonnement pour l’intervalle spécifié. NO_INTERVAL—Une seule valeur de rayonnement est calculée pour toute la totalité de la configuration temporelle. Il s’agit de l’option par défaut. INTERVAL—Plusieurs valeurs de rayonnement sont calculées pour chaque intervalle de temps pour toute la configuration de temps.	Boolean
interval_unit (Facultatif)	Spécifie l’unité de temps utilisée pour le calcul des valeurs de rayonnement solaire sur la totalité de la configuration temporelle. Ce paramètre n’est pris en charge que lorsque le paramètre use_time_interval est défini sur INTERVAL. MINUTE—L’intervalle est exprimé en minutes. Cette option n’est disponible que pour les données terrestres. HOUR—L’intervalle est exprimé en heures. DAY—L’intervalle est exprimé en jours. Il s’agit du paramètre par défaut. WEEK—L’intervalle est exprimé en semaines.	String
interval (Facultatif)	Valeur de la durée des intervalles. La valeur par défaut dépend de l’unité de l’intervalle spécifiée. La valeur par défaut de chaque unité disponible est indiquée dans la liste ci-dessous. MINUTE - 60 HOUR - 4 DAY - 14 WEEK - 2	Long
neighborhood_distance (Facultatif)	Distance à partir du centre de cellule cible pour lequel la valeur d’insolation en sortie doit être calculée. Elle détermine la taille du voisinage. La valeur par défaut est la taille de cellule du raster de surface en entrée, soit un voisinage de 3 par 3.	Linear Unit
use_adaptive_neighborhood (Facultatif)	Spécifie si la distance de voisinage varie selon les changements (variations) du paysage. La distance maximale est déterminée par la distance du voisinage. La distance minimale est égale à la taille de cellule raster en entrée. FIXED_NEIGHBORHOOD—Une distance du voisinage unique (fixe) est utilisée au niveau de tous les emplacements. Il s’agit de l’option par défaut. ADAPTIVE_NEIGHBORHOOD—Une distance du voisinage adaptative est utilisée au niveau de tous les emplacements.	Boolean
diffuse_model_type (Facultatif)	Spécifie le type de modèle de rayonnement diffus utilisé. UNIFORM_SKY—Le modèle du ciel uniforme avec rayonnement diffus est utilisé. Le rayonnement diffus entrant est identique dans toutes les directions célestes. Il s’agit de l’option par défaut. STANDARD_OVERCAST_SKY—Le modèle du ciel couvert standard avec rayonnement diffus est utilisé. Le flux du rayonnement diffus entrant varie avec l‘angle zénithal.	String
diffuse_proportion (Facultatif)	Proportion du flux du rayonnement normal global qui est diffusé. Les valeurs sont comprises entre 0 et 1. Définissez cette valeur en fonction des conditions atmosphériques. La valeur par défaut est de 0,3 pour des conditions de ciel dégagé.	Double
transmittivity (Facultatif)	Fraction du rayonnement traversant l'atmosphère (moyennée sur toutes les longueurs d'onde). La plage de valeurs est comprise entre 0 (pas de transmission) et 1 (transmission totale). La valeur par défaut est de 0,5 pour des conditions de ciel dégagé.	Double
analysis_target_device (Facultatif)	Spécifie le périphérique qui sera utilisé pour effectuer le calcul. GPU_THEN_CPU—Si un GPU compatible est trouvé, celui-ci sera utilisé pour effectuer le calcul. Autrement, le CPU sera utilisé. Il s’agit de l’option par défaut. CPU_ONLY—Le calcul sera uniquement exécuté sur le CPU. GPU_ONLY—Le calcul sera uniquement exécuté sur le GPU.	String
sunmap_grid_level (Facultatif)	Résolution utilisée pour générer les cellules de grille hexagonales H3 utilisées pour les calculs internes. Une valeur de niveau de grille plus petite crée un nombre inférieur de zones de carte d’ensoleillement plus grandes et diminue le temps d’exécution de l’outil. Un niveau de grille plus grand crée un nombre supérieur de zones de carte d’ensoleillement plus petites et améliore la précision du résultat. Les valeurs valides du niveau de grille de la carte d’ensoleillement pour la Terre varient entre 5 et 7. Pour la Lune, les valeurs valides sont comprises entre 4 et 6. Par défaut, le niveau de grille est déterminé par le raster de surface en entrée. Lors de l’analyse des données de surface sur la Terre, si la taille de cellule d’analyse est inférieure ou égale à 4 mètres, le niveau de grille par défaut est de 6. Si la taille de cellule d’analyse est supérieure à 4 mètres, le niveau de grille par défaut s’élève à 5. Pour analyser des données de surface sur la Lune, le niveau de grille par défaut est égal à 6.	Long

Valeur renvoyée

Nom	Explication	Type de données
out_solar_radiation_raster	Raster en sortie correspondant au rayonnement solaire total reçu par unité de surface sur la surface en entrée. La sortie est exprimée en kilowattheures par mètre carré (kWh/m^2).	Raster

Exemple de code

Exemple 1 d’utilisation de la fonction RasterSolarRadiation (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction RasterSolarRadiation.

import arcpy
from arcpy.sa import *
from arcpy import env
env.workspace = "C:/sapyexamples/data"
out_raster = arcpy.sa.RasterSolarRadiation("dsm30m_CA.tif", "9/1/2023 06:00:00 AM","9/30/2023 06:30:00 PM",
                                           time_zone="Pacific_Standard_Time")
out_raster.save("C:/sapyexamples/output/dsm30_total_radiation_092023.tif")

Exemple 2 d’utilisation de la fonction RasterSolarRadiation (script autonome)

Calculez l’insolation solaire de la surface en entrée pour l’année 2023 à des intervalles d’un mois. Renvoyez tous les rasters de rayonnement en sortie.

# Name: RasterSolarRadiation_standalone.py
# Description: Calculate solar insolation for the year 2023 at one month 
#  time intervals. Return all output radiation rasters.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Run RasterSolarRadiation
out_solar_radiation_raster = arcpy.sa.RasterSolarRadiation(
	in_surface_raster="dsm30m_CA.tif",
	start_date_time="1/1/2023",
	end_date_time="12/31/2023",
	in_analysis_mask=None,
	in_slope_raster=None,
	in_aspect_raster=None,
	out_direct_radiation_raster=r"C:\sapyexamples\output\dsm30_direct_radiation_2023_1mo.crf",
	out_diffuse_radiation_raster=r"C:\sapyexamples\output\dsm30_diffuse_radiation_2023_1mo.crf",
	out_duration_raster=r"C:\sapyexamples\output\dsm30_duration_radiation_2023_1mo.crf",
	time_zone="Pacific_Standard_Time",
	adjust_DST="ADJUSTED_FOR_DST",
	use_time_interval="INTERVAL",
	interval_unit="MONTH",
	interval="1",
	neighborhood_distance="",
	use_adaptive_neighborhood="",
	diffuse_model_type="UNIFORM_SKY",
	diffuse_proportion=0.3,
	transmittivity=0.5,
	analysis_target_device="GPU_THEN_CPU"
)

# Save the output 
out_solar_radiation_raster.save(r"C:\sapyexamples\output\dsm30_total_radiation_2023_1mo.crf")

Environnements

Taille de cellule, Méthode de projection de la taille de cellule, Espace de travail courant, Heure d’été, Étendue, Transformations géographiques, Masque, Système de coordonnées en sortie, Facteur de traitement parallèle, Pyramide, Espace de travail temporaire, Raster de capture, Fuseau horaire