Skip To Content


Available with Spatial Analyst license.


Defines a year, using monthly intervals, to perform solar caclulations.


This object can be used in the following tools: Area Solar Radiation, Points Solar Radiation, and Solar Radiation Graphics.

If the {each_interval} option is set in the tool parameter, then output files will be created for each month; otherwise, a single output will be created for the whole year.


 TimeWholeYear ({year})
ParameterExplanationData Type

The Julian year.

(The default value is the current Julian year)



PropertyExplanationData Type
(Read and Write)

The Julian year.


Code sample

TimeWholeYear example 1 (Python window)

Demonstrates how to create a TimeWholeYear class and use it in the AreaSolarRadiation tool within the Python window.

import arcpy
from arcpy import env
from import *
env.workspace = "C:/sapyexamples/data"
outAreaSolar = AreaSolarRadiation("solar_dem", "", "", TimeWholeYear(2008))"C:/sapyexamples/output/areasolartwy")
TimeWholeYear example 2 (stand-alone script)

Calculates the incoming solar radiation with the AreaSolarRadiation tool using the TimeWholeYear class.

# Name:
# Description: Execute AreaSolarRadiation using the TimeWholeYear object
# Requirements: Spatial Analyst Extension

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

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

# Set local variables
inRaster = "solar_dem"

# Create a TimeWholeYear Object
year = 2004
myTimeWholeYear = TimeWholeYear(year)

# Execute AreaSolarRadiation
outAreaSolar = AreaSolarRadiation(inRaster, "", 200, myTimeWholeYear, 14, 0.5,
                                  "NOINTERVAL", 1, "FROM_DEM", 32, 8, 8,
                                  "UNIFORM_SKY", 0.3, 0.5)

# Save the output"C:/sapyexamples/output/mysolarout")

Related topics