Rayonnement solaire ponctuel (Spatial Analyst)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Détermine le rayonnement solaire entrant pour des emplacements spécifiques dans une classe d'entités ponctuelles ou dans une table d'emplacements

Pour en savoir plus sur le calcul d'un rayonnement solaire

Utilisation

Syntaxe

PointsSolarRadiation (in_surface_raster, in_points_feature_or_table, out_global_radiation_features, {height_offset}, {latitude}, {sky_size}, {time_configuration}, {day_interval}, {hour_interval}, {each_interval}, {z_factor}, {slope_aspect_input_type}, {calculation_directions}, {zenith_divisions}, {azimuth_divisions}, {diffuse_model_type}, {diffuse_proportion}, {transmittivity}, {out_direct_radiation_features}, {out_diffuse_radiation_features}, {out_direct_duration_features})
ParamètreExplicationType de données
in_surface_raster

Raster de surface d'altitude en entrée.

Raster Layer
in_points_feature_or_table

Table ou classe d'entités ponctuelles spécifiant les emplacements d'analyse du rayonnement solaire.

Feature Layer | Table View
out_global_radiation_features

Classe d'entités en sortie représentant le rayonnement global ou l'ensoleillement entrant total (direct + diffus) calculé pour chaque emplacement.

La sortie est exprimée en watts heures par mètre carré (WH/m2).

Feature Class
height_offset
(Facultatif)

Hauteur (en mètres) au-dessus de la surface MNA pour laquelle les calculs sont à effectuer.

Le décalage de hauteur est appliqué à tous les emplacements en entrée.

Double
latitude
(Facultatif)

Latitude de la surface du site. Les unités sont des degrés décimaux, avec des valeurs positives pour l'hémisphère nord et négatives pour l'hémisphère sud.

Pour les rasters de surface en entrée contenant une référence spatiale, la latitude moyenne est calculée automatiquement. Dans le cas contraire, la latitude est égale à 45 degrés par défaut.

Double
sky_size
(Facultatif)

Résolution ou taille du raster de diffusion pour les grilles d'un champ de vision, des cartes d'ensoleillement et du ciel. Les unités sont des cellules.

Par défaut le système crée un raster de 200 par 200 cellules.

Long
time_configuration
(Facultatif)

Spécifie la configuration de temps (période) utilisée pour calculer le rayonnement solaire.

Les objets de la classe Temps permettent de spécifier la configuration de temps.

Les différents types de configuration de temps disponibles sont les suivants : TimeWithinDay, TimeMultiDays, TimeSpecialDayset TimeWholeYear.

Voici les formules associées :

  • TimeWithinDay({day},{startTime},{endTime})
  • TimeMultiDays({year},{startDay},{endDay})
  • TimeSpecialDays ()
  • TimeWholeYear ({year})

Le paramètre time_configuration affiche par défaut la valeur TimeMultiDays si le paramètre start_day est défini sur 5 et end_day sur 160, pour l'année Julienne en cours.

Time configuration
day_interval
(Facultatif)

Intervalle de temps sur l'année (unités : jours) utilisé pour calculer les secteurs du ciel pour la carte d'ensoleillement.

La valeur par défaut est 14 (bihebdomadaire).

Long
hour_interval
(Facultatif)

Intervalle de temps sur la journée (unités : heures) utilisé pour calculer les secteurs du ciel pour les cartes d'ensoleillement.

La valeur par défaut est 0,5.

Double
each_interval
(Facultatif)

Spécifie s'il faut calculer une valeur d'insolation totale unique pour tous les emplacements ou plusieurs valeurs pour l'intervalle spécifié, heure et jour.

  • NOINTERVALUne valeur de rayonnement total unique est calculée pour toute la configuration de temps. Il s'agit de l'option par défaut.
  • INTERVALPlusieurs valeurs de rayonnement sont calculées pour chaque intervalle de temps pour toute la configuration de temps. Le nombre de sorties dépend de l'intervalle, heure ou jour. 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 emplacement.
Boolean
z_factor
(Facultatif)

Nombre d'unités x,y terrestres sur une unité z de surface.

Le facteur z ajuste les unités de mesure des unités z lorsqu'elles sont différentes des unités x,y de la surface en entrée. Les valeurs z de la surface en entrée sont multipliées par le facteur z lors du calcul de la surface finale en sortie.

Si les unités x,y et les unités z utilisent les mêmes unités de mesure, le facteur z est égal à 1.

Si les valeurs x,y et les valeurs z sont exprimées dans des unités de mesure différentes, le facteur z doit être défini comme approprié, sinon les résultats sont incorrects.

Par exemple, si les unités z sont des pieds et les unités x,y sont des mètres, vous devez utiliser un facteur z égal à 0,3048 pour convertir les unités z de pieds en mètres (1 pied = 0,3048 mètre).

Double
slope_aspect_input_type
(Facultatif)

Dérivation des informations de pente et d'exposition pour analyse.

  • FROM_DEM Les grilles de pente et d'exposition sont calculées à partir du raster de surface en entrée. Il s'agit de l'option par défaut.
  • FLAT_SURFACE Des valeurs constantes égales à zéro sont utilisées pour la pente et l'exposition.
  • FROM_POINTS_TABLE Des valeurs de pente et d'exposition peuvent être spécifiées avec les coordonnées x,y dans le fichier des emplacements.
String
calculation_directions
(Facultatif)

Nombre de directions azimutales utilisées lors du calcul du champ de vision.

Pour être valides, les valeurs doivent être des multiples de 8 (8, 16, 24, 32, etc.). La valeur par défaut de 32 directions est appropriée pour une topographie complexe.

Long
zenith_divisions
(Facultatif)

Nombre de divisions utilisées pour créer des secteurs du ciel dans la carte du ciel.

La valeur par défaut est égale à huit divisions (par rapport au zénith). Les valeurs doivent être supérieures à zéro et inférieures à la moitié de la valeur de la taille du raster de diffusion.

Long
azimuth_divisions
(Facultatif)

Nombre de divisions utilisées pour créer des secteurs du ciel dans la carte du ciel.

La valeur par défaut est égale à huit divisions (par rapport au nord). Pour être valides, les valeurs doivent être des multiples de 8, supérieures à zéro et inférieures à 160.

Long
diffuse_model_type
(Facultatif)

Type de modèle de rayonnement diffus.

  • UNIFORM_SKY Modèle du ciel uniforme avec rayonnement diffus. Le rayonnement diffus entrant est identique dans toutes les directions célestes. Il s'agit de l'option par défaut.
  • STANDARD_OVERCAST_SKY Modèle du ciel couvert standard avec rayonnement diffus. 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.

Cette valeur doit être définie 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
out_direct_radiation_features
(Facultatif)

Classe d'entités en sortie représentant le rayonnement solaire entrant direct pour chaque emplacement.

La sortie est exprimée en watts heures par mètre carré (WH/m2).

Feature Class
out_diffuse_radiation_features
(Facultatif)

Classe d'entités en sortie représentant le rayonnement solaire entrant diffus pour chaque emplacement.

La sortie est exprimée en watts heures par mètre carré (WH/m2).

Feature Class
out_direct_duration_features
(Facultatif)

Classe d'entités en sortie représentant la durée de rayonnement solaire entrant direct.

La sortie est exprimée en heures.

Feature Class

Exemple de code

Exemple 1 d'utilisation de l'outil PointsSolarRadiation (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre comment utiliser l'outil PointsSolarRadiation.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
PointsSolarRadiation("elevation", "observers.shp", 
                     "c:/sapyexamples/output/outglobalrad1.shp", "", 35, 200, 
                     TimeMultipleDays(2009, 91, 212), 14, 0.5,"NOINTERVAL", 
                     1, "FROM_DEM", 32, 8, 8,"STANDARD_OVERCAST_SKY", 0.3, 0.5, 
                     "c:/sapyexamples/output/outdirectrad1.shp", 
                     "c:/sapyexamples/output/outdiffuserad1.shp", 
                     "c:/sapyexamples/output/outduration1.shp")
Exemple 2 d'utilisation de l'outil PointsSolarRadiation (script autonome)

Calcule la totalité du rayonnement solaire entrant pour des emplacements ponctuels spécifiques.

# PointsSolarRadiation_Example02.py
# Description: For all point locations, calculates total global, direct,
#    diffuse and direct duration solar radiation for a whole year.
# Requirements: Spatial Analyst Extension

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

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

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

# Set local variables
inRaster = "elevation"
inPntFC = "observers.shp"
outFeatures = "c:/sapyexamples/output/outglobal1.shp"
latitude = 35.75
skySize = 200
timeConfig = TimeMultipleDays(2009, 91, 212)
dayInterval = 14
hourInterval = 0.5
zFactor = 0.3048
calcDirections = 32
zenithDivisions = 8
azimuthDivisions = 8
diffuseProp = 0.3
transmittivity = 0.5
outDirectRad = "C:/sapyexamples/output/outdirectrad1.shp"
outDiffuseRad = "C:/sapyexamples/output/outdiffuserad1.shp"
outDirectDur = "C:/sapyexamples/output/outduration1.shp"

# Execute PointsSolarRadiation...
PointsSolarRadiation(inRaster, inPntFC, outFeatures, "", latitude, skySize, 
                     timeConfig, dayInterval, hourInterval, "INTERVAL", 
                     zFactor, "FROM_DEM", calcDirections, zenithDivisions, 
                     azimuthDivisions,"STANDARD_OVERCAST_SKY", diffuseProp, 
                     transmittivity, outDirectRad, outDiffuseRad, outDirectDur)

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst
5/10/2014