| Étiquette | Explication | Type de données |
Raster de surface en entrée | Raster de surface d’altitude en entrée. | Raster Layer |
Entités ponctuelles ou surfaciques en entrée | Entités en entrée (point ou polygone) qui représentent une localisation ou une surface artificielle pour le calcul de la quantité de rayonnement solaire reçu. | Feature Layer |
Champ d’ID unique | Champ contenant les valeurs qui définissent chaque entité. Il peut s’agir d’un champ de type entier ou chaîne des entités en entrée. | Field |
Table en sortie | Table en sortie qui contient le résumé de la quantité de rayonnement solaire reçu par les entités en entrée Le format de la table est déterminé par l’emplacement et le chemin d’accès en sortie. Par défaut, la sortie est une table de géodatabase dans un espace de travail de géodatabase, et une table dBASE dans un espace de travail de fichier. | Table |
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 |
Fuseau horaire (Facultatif) | Fuseau horaire utilisé pour les heures de début et de fin. Le fuseau horaire par défaut est UTC (temps universel coordonné).
| 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.
| 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é.
| 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é.
| 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.
| Long |
Décalage des entités (Facultatif) | Distance verticale ajoutée à la surface raster en vue de l’analyse. La valeur doit être un entier positif ou un nombre à virgule flottante. Vous pouvez sélectionner un champ dans le jeu de classes d’entités en entrée ou indiquer une valeur numérique. Par exemple, si l’objet est un panneau, indiquez sa hauteur. Si une valeur est fournie pour ce paramètre, elle est utilisée par toutes les entités. Si vous souhaitez spécifier différentes valeurs pour chaque entité, sélectionnez un champ dans le jeu de classes d’entités en entrée. La valeur par défaut est 0. | Double; Field |
Surface des entités (Facultatif) | Surface associée aux entités en entrée. La valeur doit être un entier positif ou un nombre à virgule flottante. Vous pouvez sélectionner un champ dans le jeu de classes d’entités en entrée ou indiquer une valeur numérique. Par exemple, si l’objet est un panneau, indiquez sa surface. Si une valeur est fournie pour ce paramètre, elle est utilisée par toutes les entités. Si vous souhaitez spécifier différentes valeurs pour chaque entité, sélectionnez un champ dans le jeu de classes d’entités en entrée. Par défaut, la surface est obtenue à partir des entités en entrée. Pour les entités ponctuelles, la surface par défaut est 0. | Double; Field |
Pente des entités (Facultatif) | Pente ou inclinaison relative associée aux entités en entrée. La valeur doit être un entier positif ou un nombre à virgule flottante. Vous pouvez sélectionner un champ dans le jeu de classes d’entités en entrée ou indiquer une valeur numérique. Par exemple, si l’objet est un panneau, indiquez son inclinaison. Si une valeur est fournie pour ce paramètre, elle est utilisée par toutes les entités. Si vous souhaitez spécifier différentes valeurs pour chaque entité, sélectionnez un champ dans le jeu de classes d’entités en entrée. La pente est exprimée en degrés, de 0 à 90. Les valeurs par défaut pour l’analyse sont calculées à partir des valeurs sous-jacentes du raster de surface en entrée. | Double; Field |
Exposition des entités (Facultatif) | Exposition ou direction relative associée aux entités en entrée. La valeur doit être un entier positif ou un nombre à virgule flottante. Vous pouvez sélectionner un champ dans le jeu de classes d’entités en entrée ou indiquer une valeur numérique. Par exemple, si l’objet est un panneau, indiquez la direction de sa face. Si une valeur est fournie pour ce paramètre, elle est utilisée par toutes les entités. Si vous souhaitez spécifier différentes valeurs pour chaque entité, sélectionnez un champ dans le jeu de classes d’entités en entrée. L’exposition est exprimée en degrés, de 0 à 360. Les valeurs par défaut de la surface d’analyse sont calculées à partir des valeurs sous-jacentes du raster de surface en entrée. | Double; Field |
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.
| Boolean |
Type de modèle de diffusion (Facultatif) | Spécifie le type de modèle de rayonnement diffus utilisé.
| 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 utilisé pour procéder au calcul.
| String |
Couche de jointure en sortie (Facultatif) | Couche en sortie créée en joignant la table en sortie à la classe d’entités en entrée. Cette sortie est facultative. | Feature Layer |
Disponible avec une licence Spatial Analyst.
Synthèse
Calcule l’insolation solaire entrante des points en entrée ou des entités surfaciques par rapport à la surface (sol) de la Terre ou de la Lune.
Les entités en entrée peuvent représenter des localisations ou des surfaces artificielles par la spécification d’attributs qui définissent la taille, la hauteur et l’orientation en vue de l’analyse par rapport au sol. L’insolation solaire est calculée comme la quantité d’énergie de rayonnement solaire reçue sur une période donnée pour chaque entité. Les valeurs sont représentées sous la forme de totaux et de moyennes de la surface de l’entité et sont exprimées respectivement en kilowattheures (kWh) et en kilowattheures par mètre carré (kWh/m2).
Utilisation
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.
Les entités en entrée doivent être des données d’entités ponctuelles ou surfaciques. L’analyse sur des entités 3D ou multipatch n’est pas prise en charge.
Vous pouvez inclure des détails supplémentaires pour représenter des surfaces artificielles à l’aide des paramètres des entités en entrée en spécifiant la direction, l’inclinaison, la surface et le décalage de toutes les entités ou de chacune d’entre elles, par exemple, pour représenter un ensemble de points sous la forme de panneaux solaires au sol ou sur le toit d’un bâtiment.
Il est recommandé de spécifier la table en sortie au format géodatabase. Cela permet d’améliorer les performances et de renforcer les fonctionnalités. Les tables au format de fichier dBase (.dbf) présentent des limitations connues concernant la précision, les longueurs des noms de champ et la mise en forme de la date et de l’heure.
Les valeurs d’insolation solaires calculées pour le rayonnement total, direct, diffus et de durée directe sont ajoutées en tant qu’attributs à la table en sortie. Elles incluent l’insolation totale (sur la totalité de la surface) et l’insolation moyenne (par unité de surface) de chaque entité. Elles sont respectivement exprimées en kilowattheures (kWh) et en kilowattheures par mètre carré (kWh/m2). Les durées sont exprimées en heures.
L’insolation totale se calcule en analysant chaque localisation de cellule du raster de surface en entrée qui intersecte l’entité (ou une partie de l’entité) et en la multipliant par la surface de cette entité. Elle n’est pas calculée pour une seule localisation centrale de l’entité.
Si vous exécutez une analyse de grandes étendues dans lesquelles les entités surfaciques sont peu nombreuses ou très dispersées, le traitement peut prendre plus longtemps en raison de la résolution requise pour la rastérisation.
Les paramètres Pente des entités, Exposition des entités, Surface des entités et Décalage des entités peuvent être utilisés pour fournir des détails supplémentaires qui permettent de représenter des surfaces artificielles susceptibles d’intercepter le rayonnement solaire entrant, comme la direction, l’inclinaison, la surface et le décalage. Il peut s’agir de la position ou de l’orientation statique ou modifiée dans le temps. Par exemple, un ensemble de points qui représentent des panneaux solaires au sol ou sur le toit d’un bâtiment, ou un panneau sur un véhicule en déplacement.
Si les paramètres des entités ne sont pas spécifiés, les valeurs sont calculées à partir du raster de surface en entrée ou des entités individuelles par défaut. Les points ont une surface de zéro, sauf indication contraire.
Si vous fournissez une valeur pour l’un de ces paramètres, elle est appliquée à toutes les entités en entrée. Vous pouvez également indiquer un attribut de champ en entrée à partir des entités en entrée pour analyser chaque entité individuellement. Si un champ est spécifié et qu’une valeur est manquante (Null), la valeur est définie sur zéro.
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 minimal pour les données lunaires est de 4 heures ; il doit être proportionnel à 2.
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 donc 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.
S'il est installé sur votre système, le processeur graphique compatible peut accélérer cet outil et améliorer ses performances. Utilisez le paramètre Target device for analysis (Périphérique cible pour l’analyse) (analysis_target_device dans Python) pour contrôler si le GPU ou le CPU sont utilisés pour exécuter l’outil.
Voir Traitement GPU avec Spatial Analyst pour plus de détails sur les GPU compatibles, sur la configuration et l’utilisation des périphériques GPU et pour obtenir des conseils sur le dépannage.
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 toward 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
Paramètres
FeatureSolarRadiation(in_surface_raster, in_features, unique_id_field, out_table, start_date_time, end_date_time, {time_zone}, {adjust_DST}, {use_time_interval}, {interval_unit}, {interval}, {feature_offset}, {feature_area}, {feature_slope}, {feature_aspect}, {neighborhood_distance}, {use_adaptive_neighborhood}, {diffuse_model_type}, {diffuse_proportion}, {transmittivity}, {analysis_target_device}, {out_join_layer})| Nom | Explication | Type de données |
in_surface_raster | Raster de surface d’altitude en entrée. | Raster Layer |
in_features | Entités en entrée (point ou polygone) qui représentent une localisation ou une surface artificielle pour le calcul de la quantité de rayonnement solaire reçu. | Feature Layer |
unique_id_field | Champ contenant les valeurs qui définissent chaque entité. Il peut s’agir d’un champ de type entier ou chaîne des entités en entrée. | Field |
out_table | Table en sortie qui contient le résumé de la quantité de rayonnement solaire reçu par les entités en entrée Le format de la table est déterminé par l’emplacement et le chemin d’accès en sortie. Par défaut, la sortie est une table de géodatabase dans un espace de travail de géodatabase, et une table dBASE dans un espace de travail de fichier. | Table |
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 |
time_zone (Facultatif) | Fuseau horaire utilisé pour les heures de début et de fin. Le fuseau horaire par défaut est UTC (temps universel coordonné).
| 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.
| 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é.
| 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.
| 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.
| Long |
feature_offset (Facultatif) | Distance verticale ajoutée à la surface raster en vue de l’analyse. La valeur doit être un entier positif ou un nombre à virgule flottante. Vous pouvez sélectionner un champ dans le jeu de classes d’entités en entrée ou indiquer une valeur numérique. Par exemple, si l’objet est un panneau, indiquez sa hauteur. Si une valeur est fournie pour ce paramètre, elle est utilisée par toutes les entités. Si vous souhaitez spécifier différentes valeurs pour chaque entité, sélectionnez un champ dans le jeu de classes d’entités en entrée. La valeur par défaut est 0. | Double; Field |
feature_area (Facultatif) | Surface associée aux entités en entrée. La valeur doit être un entier positif ou un nombre à virgule flottante. Vous pouvez sélectionner un champ dans le jeu de classes d’entités en entrée ou indiquer une valeur numérique. Par exemple, si l’objet est un panneau, indiquez sa surface. Si une valeur est fournie pour ce paramètre, elle est utilisée par toutes les entités. Si vous souhaitez spécifier différentes valeurs pour chaque entité, sélectionnez un champ dans le jeu de classes d’entités en entrée. Par défaut, la surface est obtenue à partir des entités en entrée. Pour les entités ponctuelles, la surface par défaut est 0. | Double; Field |
feature_slope (Facultatif) | Pente ou inclinaison relative associée aux entités en entrée. La valeur doit être un entier positif ou un nombre à virgule flottante. Vous pouvez sélectionner un champ dans le jeu de classes d’entités en entrée ou indiquer une valeur numérique. Par exemple, si l’objet est un panneau, indiquez son inclinaison. Si une valeur est fournie pour ce paramètre, elle est utilisée par toutes les entités. Si vous souhaitez spécifier différentes valeurs pour chaque entité, sélectionnez un champ dans le jeu de classes d’entités en entrée. La pente est exprimée en degrés, de 0 à 90. Les valeurs par défaut pour l’analyse sont calculées à partir des valeurs sous-jacentes du raster de surface en entrée. | Double; Field |
feature_aspect (Facultatif) | Exposition ou direction relative associée aux entités en entrée. La valeur doit être un entier positif ou un nombre à virgule flottante. Vous pouvez sélectionner un champ dans le jeu de classes d’entités en entrée ou indiquer une valeur numérique. Par exemple, si l’objet est un panneau, indiquez la direction de sa face. Si une valeur est fournie pour ce paramètre, elle est utilisée par toutes les entités. Si vous souhaitez spécifier différentes valeurs pour chaque entité, sélectionnez un champ dans le jeu de classes d’entités en entrée. L’exposition est exprimée en degrés, de 0 à 360. Les valeurs par défaut de la surface d’analyse sont calculées à partir des valeurs sous-jacentes du raster de surface en entrée. | Double; Field |
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.
| Boolean |
diffuse_model_type (Facultatif) | Spécifie le type de modèle de rayonnement diffus utilisé.
| 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 utilisé pour procéder au calcul.
| String |
out_join_layer (Facultatif) | Couche en sortie créée en joignant la table en sortie à la classe d’entités en entrée. Cette sortie est facultative. | Feature Layer |
Exemple de code
Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction FeatureSolarRadiation.
import arcpy
from arcpy.sa import *
from arcpy import env
env.workspace = "C:/sapyexamples/solardata.gdb"
env.scratchWorkspace = "C:/sapyexamples/outfile.gdb"
#Run FeatureSolarRadiation
arcpy.sa.FeatureSolarRadiation("dem30m.tif","solar_pnts","pntID","SolarPnts_radiation_092023",
"9/1/2023 06:30:00 AM","10/1/2023 6:30:00 PM","Pacific_Standard_Time")Calcule l’insolation solaire pour la totalité de l’année 2023 à des intervalles d’une semaine pour les entités artificielles représentées par des entités ponctuelles.
# Name: FeatureSolarRadiation_standalone.py
# Description: Calculate the solar insolation for the whole year 2023 at one week
# intervals for engineered features represented by point features.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/solardata.gdb"
arcpy.env.scratchWorkspace = "C:/sapyexamples/outfile.gdb"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Run FeatureSolarRadiation
arcpy.sa.FeatureSolarRadiation(
in_surface_raster="dem30m.tif",
in_features="solar_pnts",
unique_id_field="pntID",
out_table=r"SolarPnts_radiation_092023",
start_date_time="1/1/2023",
end_date_time="12/31/2023",
time_zone="Mountain_Standard_Time",
adjust_DST="ADJUSTED_FOR_DST",
use_time_interval="NO_INTERVAL",
interval_unit="WEEK",
interval=1,
feature_offset=2.5,
feature_area="Area_FLD",
feature_slope="Slope_FLD",
feature_aspect="Aspect_FLD",
neighborhood_distance="",
use_adaptive_neighborhood="",
diffuse_model_type="UNIFORM_SKY",
diffuse_proportion=0.3,
transmittivity=0.5,
analysis_target_device="GPU_THEN_CPU",
out_join_layer=None
)Environnements
Informations de licence
- Basic: Nécessite Spatial Analyst
- Standard: Nécessite Spatial Analyst
- Advanced: Nécessite Spatial Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?