Rayonnement solaire zonal (Spatial Analyst)

Niveau de licence :De baseStandardAvancé

Récapitulatif

Détermine le rayonnement solaire entrant à partir d’une surface raster.

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

Utilisation

Syntaxe

AreaSolarRadiation (in_surface_raster, {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_raster}, {out_diffuse_radiation_raster}, {out_direct_duration_raster})
ParamètreExplicationType de données
in_surface_raster

Raster de surface d'altitude en entrée.

Raster Layer
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 x 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}, {start_time}, {end_time})
  • TimeMultiDays ({year}, {start_day}, {end_day})
  • 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.
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_raster
(Facultatif)

Raster en sortie correspondant au rayonnement solaire direct entrant pour chaque emplacement.

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

Raster Dataset
out_diffuse_radiation_raster
(Facultatif)

Raster en sortie correspondant au rayonnement solaire diffus entrant pour chaque emplacement.

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

Raster Dataset
out_direct_duration_raster
(Facultatif)

Raster en sortie correspondant à la durée du rayonnement solaire direct entrant.

La sortie est exprimée en heures.

Raster Dataset

Valeur renvoyée

NomExplicationType de données
out_global_radiation_raster

Raster en sortie correspondant au rayonnement global ou à l'insolation solaire entrante totale (directe + diffuse) calculée pour chaque emplacement de la surface en entrée.

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

Raster

Exemple de code

AreaSolarRadiation : exemple 1 (fenêtre Python)

Le script dans la fenêtre Python ci-après explique comment utiliser l'outil AreaSolarRadiation.

import arcpy
from arcpy.sa import *
from arcpy import env
env.workspace = "C:/sapyexamples/data"
outGlobalRadiation = AreaSolarRadiation("dem30", "", "400", TimeMultipleDays(2008,91,152))
outGlobalRadiation.save("C:/sapyexamples/output/glob_rad")
AreaSolarRadiation : exemple 2 (script autonome)

Calculez la quantité de rayonnement solaire entrant dans une zone géographique.

# Name: AreaSolarRadiation_example02.py
# Description: Derives incoming solar radiation from a raster surface. 
#              Outputs a global radiation raster and optional direct, diffuse and direct duration rasters
#              for a specified time period. (April to July).
#              
# Requirements: Spatial Analyst Extension

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

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

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

# Set local variables
inRaster = "C:/sapyexamples/data/solar_dem"
latitude = 35.75
skySize = 400
timeConfig = TimeMultipleDays(2008, 91, 212)
dayInterval = 14
hourInterval = 0.5
zFactor = 0.3048
calcDirections = 32
zenithDivisions = 16
azimuthDivisions = 16
diffuseProp = 0.7
transmittivity = 0.4
outDirectRad = ""
outDiffuseRad = ""
outDirectDur = Raster("C:/sapyexamples/output/dir_dur")


# Execute AreaSolarRadiation
outGlobalRad = AreaSolarRadiation(inRaster, latitude, skySize, timeConfig,
   dayInterval, hourInterval, "NOINTERVAL", zFactor, "FLAT_SURFACE",
   calcDirections, zenithDivisions, azimuthDivisions, "UNIFORM_SKY",
   diffuseProp, transmittivity, outDirectRad, outDiffuseRad, outDirectDur)

# Save the output 
outGlobalRad.save("C:/sapyexamples/output/glob_rad")

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
9/13/2013