com.esri.arcgis.geoprocessing.tools.spatialanalysttools
Class AreaSolarRadiation

java.lang.Object
  extended by com.esri.arcgis.geoprocessing.AbstractGPTool
      extended by com.esri.arcgis.geoprocessing.tools.spatialanalysttools.AreaSolarRadiation
All Implemented Interfaces:
GPTool

public class AreaSolarRadiation
extends AbstractGPTool

Derives incoming solar radiation from a raster surface. The Area Solar Radiation tool is contained in the Spatial Analyst Tools tool box.

Usage tips:


Field Summary
 
Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool
vals
 
Constructor Summary
AreaSolarRadiation()
          Creates the Area Solar Radiation tool with defaults.
AreaSolarRadiation(java.lang.Object inSurfaceRaster, java.lang.Object outGlobalRadiationRaster)
          Creates the Area Solar Radiation tool with the required parameters.
 
Method Summary
 int getAzimuthDivisions()
          Returns the Azimuth divisions parameter of this tool .
 int getCalculationDirections()
          Returns the Calculation directions parameter of this tool .
 int getDayInterval()
          Returns the Day interval parameter of this tool .
 java.lang.String getDiffuseModelType()
          Returns the Diffuse model type parameter of this tool .
 double getDiffuseProportion()
          Returns the Diffuse proportion parameter of this tool .
 java.lang.String getEachInterval()
          Returns the Create outputs for each interval parameter of this tool .
 double getHourInterval()
          Returns the Hour interval parameter of this tool .
 java.lang.Object getInSurfaceRaster()
          Returns the Input raster parameter of this tool .
 double getLatitude()
          Returns the Latitude parameter of this tool .
 java.lang.Object getOutDiffuseRadiationRaster()
          Returns the Output diffuse radiation raster parameter of this tool .
 java.lang.Object getOutDirectDurationRaster()
          Returns the Output direct duration raster parameter of this tool .
 java.lang.Object getOutDirectRadiationRaster()
          Returns the Output direct radiation raster parameter of this tool .
 java.lang.Object getOutGlobalRadiationRaster()
          Returns the Output global radiation raster parameter of this tool .
 int getSkySize()
          Returns the Sky size / Resolution parameter of this tool .
 java.lang.String getSlopeAspectInputType()
          Returns the Slope and aspect input type parameter of this tool .
 java.lang.Object getTimeConfiguration()
          Returns the Time configuration parameter of this tool .
 java.lang.String getToolboxAlias()
          Returns the alias of the tool box containing this tool.
 java.lang.String getToolboxName()
          Returns the name of the tool box containing this tool.
 java.lang.String getToolName()
          Returns the name of this tool.
 double getTransmittivity()
          Returns the Transmittivity parameter of this tool .
 int getZenithDivisions()
          Returns the Zenith divisions parameter of this tool .
 double getZFactor()
          Returns the Z factor parameter of this tool .
 void setAzimuthDivisions(int azimuthDivisions)
          Sets the Azimuth divisions parameter of this tool .
 void setCalculationDirections(int calculationDirections)
          Sets the Calculation directions parameter of this tool .
 void setDayInterval(int dayInterval)
          Sets the Day interval parameter of this tool .
 void setDiffuseModelType(java.lang.String diffuseModelType)
          Sets the Diffuse model type parameter of this tool .
 void setDiffuseProportion(double diffuseProportion)
          Sets the Diffuse proportion parameter of this tool .
 void setEachInterval(java.lang.String eachInterval)
          Sets the Create outputs for each interval parameter of this tool .
 void setHourInterval(double hourInterval)
          Sets the Hour interval parameter of this tool .
 void setInSurfaceRaster(java.lang.Object inSurfaceRaster)
          Sets the Input raster parameter of this tool .
 void setLatitude(double latitude)
          Sets the Latitude parameter of this tool .
 void setOutDiffuseRadiationRaster(java.lang.Object outDiffuseRadiationRaster)
          Sets the Output diffuse radiation raster parameter of this tool .
 void setOutDirectDurationRaster(java.lang.Object outDirectDurationRaster)
          Sets the Output direct duration raster parameter of this tool .
 void setOutDirectRadiationRaster(java.lang.Object outDirectRadiationRaster)
          Sets the Output direct radiation raster parameter of this tool .
 void setOutGlobalRadiationRaster(java.lang.Object outGlobalRadiationRaster)
          Sets the Output global radiation raster parameter of this tool .
 void setSkySize(int skySize)
          Sets the Sky size / Resolution parameter of this tool .
 void setSlopeAspectInputType(java.lang.String slopeAspectInputType)
          Sets the Slope and aspect input type parameter of this tool .
 void setTimeConfiguration(java.lang.Object timeConfiguration)
          Sets the Time configuration parameter of this tool .
 void setTransmittivity(double transmittivity)
          Sets the Transmittivity parameter of this tool .
 void setZenithDivisions(int zenithDivisions)
          Sets the Zenith divisions parameter of this tool .
 void setZFactor(double zFactor)
          Sets the Z factor parameter of this tool .
 
Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool
getParameterValues, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

AreaSolarRadiation

public AreaSolarRadiation()
Creates the Area Solar Radiation tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.


AreaSolarRadiation

public AreaSolarRadiation(java.lang.Object inSurfaceRaster,
                          java.lang.Object outGlobalRadiationRaster)
Creates the Area Solar Radiation tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:
inSurfaceRaster - input elevation surface raster.
outGlobalRadiationRaster - the output raster representing the global radiation or total amount of incoming solar insolation (direct + diffuse) calculated for each location of the input surface. the output has units of watt hours per square meter (WH/m2).
Method Detail

getInSurfaceRaster

public java.lang.Object getInSurfaceRaster()
Returns the Input raster parameter of this tool . This parameter is input elevation surface raster. This is a required parameter.

Returns:
the Input raster

setInSurfaceRaster

public void setInSurfaceRaster(java.lang.Object inSurfaceRaster)
Sets the Input raster parameter of this tool . This parameter is input elevation surface raster. This is a required parameter.

Parameters:
inSurfaceRaster - input elevation surface raster.

getOutGlobalRadiationRaster

public java.lang.Object getOutGlobalRadiationRaster()
Returns the Output global radiation raster parameter of this tool . This parameter is the output raster representing the global radiation or total amount of incoming solar insolation (direct + diffuse) calculated for each location of the input surface. the output has units of watt hours per square meter (WH/m2). This is a required parameter.

Returns:
the Output global radiation raster

setOutGlobalRadiationRaster

public void setOutGlobalRadiationRaster(java.lang.Object outGlobalRadiationRaster)
Sets the Output global radiation raster parameter of this tool . This parameter is the output raster representing the global radiation or total amount of incoming solar insolation (direct + diffuse) calculated for each location of the input surface. the output has units of watt hours per square meter (WH/m2). This is a required parameter.

Parameters:
outGlobalRadiationRaster - the output raster representing the global radiation or total amount of incoming solar insolation (direct + diffuse) calculated for each location of the input surface. the output has units of watt hours per square meter (WH/m2).

getLatitude

public double getLatitude()
Returns the Latitude parameter of this tool . This parameter is the latitude for the site area. The units are decimal degrees, with positive values for the northern hemisphere and negative for the southern. for input surface rasters containing a spatial reference, the mean latitude is automatically calculated; otherwise, latitude will default to 45 degrees. This is an optional parameter.

Returns:
the Latitude

setLatitude

public void setLatitude(double latitude)
Sets the Latitude parameter of this tool . This parameter is the latitude for the site area. The units are decimal degrees, with positive values for the northern hemisphere and negative for the southern. for input surface rasters containing a spatial reference, the mean latitude is automatically calculated; otherwise, latitude will default to 45 degrees. This is an optional parameter.

Parameters:
latitude - the latitude for the site area. The units are decimal degrees, with positive values for the northern hemisphere and negative for the southern. for input surface rasters containing a spatial reference, the mean latitude is automatically calculated; otherwise, latitude will default to 45 degrees.

getSkySize

public int getSkySize()
Returns the Sky size / Resolution parameter of this tool . This parameter is the resolution or sky size for the viewshed, sky map, and sun map grids. The units are cells. the default creates a raster of 200 x 200 cells. This is an optional parameter.

Returns:
the Sky size / Resolution

setSkySize

public void setSkySize(int skySize)
Sets the Sky size / Resolution parameter of this tool . This parameter is the resolution or sky size for the viewshed, sky map, and sun map grids. The units are cells. the default creates a raster of 200 x 200 cells. This is an optional parameter.

Parameters:
skySize - the resolution or sky size for the viewshed, sky map, and sun map grids. The units are cells. the default creates a raster of 200 x 200 cells.

getTimeConfiguration

public java.lang.Object getTimeConfiguration()
Returns the Time configuration parameter of this tool . This parameter is specifies the time configuration (period) used for calculating solar radiation. the Time class objects are used to specify the time configuration. the different types of time configurations available are TimeWithinDay, TimeMultiDays, TimeSpecialDays, and TimeWholeYear. the following are the forms: the default time_configuration is TimeMultiDays with the start_day of 5 and end_day of 160, for the current Julian year. This is an optional parameter.

Returns:
the Time configuration

setTimeConfiguration

public void setTimeConfiguration(java.lang.Object timeConfiguration)
Sets the Time configuration parameter of this tool . This parameter is specifies the time configuration (period) used for calculating solar radiation. the Time class objects are used to specify the time configuration. the different types of time configurations available are TimeWithinDay, TimeMultiDays, TimeSpecialDays, and TimeWholeYear. the following are the forms: the default time_configuration is TimeMultiDays with the start_day of 5 and end_day of 160, for the current Julian year. This is an optional parameter.

Parameters:
timeConfiguration - specifies the time configuration (period) used for calculating solar radiation. the Time class objects are used to specify the time configuration. the different types of time configurations available are TimeWithinDay, TimeMultiDays, TimeSpecialDays, and TimeWholeYear. the following are the forms: the default time_configuration is TimeMultiDays with the start_day of 5 and end_day of 160, for the current Julian year.

getDayInterval

public int getDayInterval()
Returns the Day interval parameter of this tool . This parameter is the time interval through the year (units: days) used for calculation of sky sectors for the sun map. the default value is 14 (biweekly). This is an optional parameter.

Returns:
the Day interval

setDayInterval

public void setDayInterval(int dayInterval)
Sets the Day interval parameter of this tool . This parameter is the time interval through the year (units: days) used for calculation of sky sectors for the sun map. the default value is 14 (biweekly). This is an optional parameter.

Parameters:
dayInterval - the time interval through the year (units: days) used for calculation of sky sectors for the sun map. the default value is 14 (biweekly).

getHourInterval

public double getHourInterval()
Returns the Hour interval parameter of this tool . This parameter is time interval through the day (units: hours) used for calculation of sky sectors for sun maps. the default value is 0.5. This is an optional parameter.

Returns:
the Hour interval

setHourInterval

public void setHourInterval(double hourInterval)
Sets the Hour interval parameter of this tool . This parameter is time interval through the day (units: hours) used for calculation of sky sectors for sun maps. the default value is 0.5. This is an optional parameter.

Parameters:
hourInterval - time interval through the day (units: hours) used for calculation of sky sectors for sun maps. the default value is 0.5.

getEachInterval

public java.lang.String getEachInterval()
Returns the Create outputs for each interval parameter of this tool . This parameter is specifies whether to calculate a single total insolation value for all locations or multiple values for the specified hour and day interval. This is an optional parameter.

Returns:
the Create outputs for each interval

setEachInterval

public void setEachInterval(java.lang.String eachInterval)
Sets the Create outputs for each interval parameter of this tool . This parameter is specifies whether to calculate a single total insolation value for all locations or multiple values for the specified hour and day interval. This is an optional parameter.

Parameters:
eachInterval - specifies whether to calculate a single total insolation value for all locations or multiple values for the specified hour and day interval.

getZFactor

public double getZFactor()
Returns the Z factor parameter of this tool . This parameter is the number of ground x,y units in one surface z unit. the z-factor adjusts the units of measure for the z units when they are different from the x,y units of the input surface. The z-values of the input surface are multiplied by the z-factor when calculating the final output surface. if the x,y units and z units are in the same units of measure, the z-factor is 1. This is the default. if the x,y units and z units are in different units of measure, the z-factor must be set to the appropriate factor, or the results will be incorrect. for example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter). This is an optional parameter.

Returns:
the Z factor

setZFactor

public void setZFactor(double zFactor)
Sets the Z factor parameter of this tool . This parameter is the number of ground x,y units in one surface z unit. the z-factor adjusts the units of measure for the z units when they are different from the x,y units of the input surface. The z-values of the input surface are multiplied by the z-factor when calculating the final output surface. if the x,y units and z units are in the same units of measure, the z-factor is 1. This is the default. if the x,y units and z units are in different units of measure, the z-factor must be set to the appropriate factor, or the results will be incorrect. for example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter). This is an optional parameter.

Parameters:
zFactor - the number of ground x,y units in one surface z unit. the z-factor adjusts the units of measure for the z units when they are different from the x,y units of the input surface. The z-values of the input surface are multiplied by the z-factor when calculating the final output surface. if the x,y units and z units are in the same units of measure, the z-factor is 1. This is the default. if the x,y units and z units are in different units of measure, the z-factor must be set to the appropriate factor, or the results will be incorrect. for example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter).

getSlopeAspectInputType

public java.lang.String getSlopeAspectInputType()
Returns the Slope and aspect input type parameter of this tool . This parameter is how slope and aspect information are derived for analysis. This is an optional parameter.

Returns:
the Slope and aspect input type

setSlopeAspectInputType

public void setSlopeAspectInputType(java.lang.String slopeAspectInputType)
Sets the Slope and aspect input type parameter of this tool . This parameter is how slope and aspect information are derived for analysis. This is an optional parameter.

Parameters:
slopeAspectInputType - how slope and aspect information are derived for analysis.

getCalculationDirections

public int getCalculationDirections()
Returns the Calculation directions parameter of this tool . This parameter is the number of azimuth directions used when calculating the viewshed. valid values must be multiples of 8 (8, 16, 24, 32, and so on). The default value is 32 directions, which is adequate for complex topography. This is an optional parameter.

Returns:
the Calculation directions

setCalculationDirections

public void setCalculationDirections(int calculationDirections)
Sets the Calculation directions parameter of this tool . This parameter is the number of azimuth directions used when calculating the viewshed. valid values must be multiples of 8 (8, 16, 24, 32, and so on). The default value is 32 directions, which is adequate for complex topography. This is an optional parameter.

Parameters:
calculationDirections - the number of azimuth directions used when calculating the viewshed. valid values must be multiples of 8 (8, 16, 24, 32, and so on). The default value is 32 directions, which is adequate for complex topography.

getZenithDivisions

public int getZenithDivisions()
Returns the Zenith divisions parameter of this tool . This parameter is the number of divisions used to create sky sectors in the sky map. the default is eight divisions (relative to zenith). Values must be greater than zero and less than half the sky size value. This is an optional parameter.

Returns:
the Zenith divisions

setZenithDivisions

public void setZenithDivisions(int zenithDivisions)
Sets the Zenith divisions parameter of this tool . This parameter is the number of divisions used to create sky sectors in the sky map. the default is eight divisions (relative to zenith). Values must be greater than zero and less than half the sky size value. This is an optional parameter.

Parameters:
zenithDivisions - the number of divisions used to create sky sectors in the sky map. the default is eight divisions (relative to zenith). Values must be greater than zero and less than half the sky size value.

getAzimuthDivisions

public int getAzimuthDivisions()
Returns the Azimuth divisions parameter of this tool . This parameter is the number of divisions used to create sky sectors in the sky map. the default is eight divisions (relative to north). Valid values must be multiples of 8. Values must be greater than zero and less than 160. This is an optional parameter.

Returns:
the Azimuth divisions

setAzimuthDivisions

public void setAzimuthDivisions(int azimuthDivisions)
Sets the Azimuth divisions parameter of this tool . This parameter is the number of divisions used to create sky sectors in the sky map. the default is eight divisions (relative to north). Valid values must be multiples of 8. Values must be greater than zero and less than 160. This is an optional parameter.

Parameters:
azimuthDivisions - the number of divisions used to create sky sectors in the sky map. the default is eight divisions (relative to north). Valid values must be multiples of 8. Values must be greater than zero and less than 160.

getDiffuseModelType

public java.lang.String getDiffuseModelType()
Returns the Diffuse model type parameter of this tool . This parameter is type of diffuse radiation model. This is an optional parameter.

Returns:
the Diffuse model type

setDiffuseModelType

public void setDiffuseModelType(java.lang.String diffuseModelType)
Sets the Diffuse model type parameter of this tool . This parameter is type of diffuse radiation model. This is an optional parameter.

Parameters:
diffuseModelType - type of diffuse radiation model.

getDiffuseProportion

public double getDiffuseProportion()
Returns the Diffuse proportion parameter of this tool . This parameter is the proportion of global normal radiation flux that is diffuse. Values range from 0 to 1. this value should be set according to atmospheric conditions. The default value is 0.3 for generally clear sky conditions. This is an optional parameter.

Returns:
the Diffuse proportion

setDiffuseProportion

public void setDiffuseProportion(double diffuseProportion)
Sets the Diffuse proportion parameter of this tool . This parameter is the proportion of global normal radiation flux that is diffuse. Values range from 0 to 1. this value should be set according to atmospheric conditions. The default value is 0.3 for generally clear sky conditions. This is an optional parameter.

Parameters:
diffuseProportion - the proportion of global normal radiation flux that is diffuse. Values range from 0 to 1. this value should be set according to atmospheric conditions. The default value is 0.3 for generally clear sky conditions.

getTransmittivity

public double getTransmittivity()
Returns the Transmittivity parameter of this tool . This parameter is the fraction of radiation that passes through the atmosphere (averaged over all wavelengths). Values range from 0 (no transmission) to 1 (all transmission). the default is 0.5 for a generally clear sky. This is an optional parameter.

Returns:
the Transmittivity

setTransmittivity

public void setTransmittivity(double transmittivity)
Sets the Transmittivity parameter of this tool . This parameter is the fraction of radiation that passes through the atmosphere (averaged over all wavelengths). Values range from 0 (no transmission) to 1 (all transmission). the default is 0.5 for a generally clear sky. This is an optional parameter.

Parameters:
transmittivity - the fraction of radiation that passes through the atmosphere (averaged over all wavelengths). Values range from 0 (no transmission) to 1 (all transmission). the default is 0.5 for a generally clear sky.

getOutDirectRadiationRaster

public java.lang.Object getOutDirectRadiationRaster()
Returns the Output direct radiation raster parameter of this tool . This parameter is the output raster representing the direct incoming solar radiation for each location. the output has units of watt hours per square meter (WH/m2). This is an optional parameter.

Returns:
the Output direct radiation raster

setOutDirectRadiationRaster

public void setOutDirectRadiationRaster(java.lang.Object outDirectRadiationRaster)
Sets the Output direct radiation raster parameter of this tool . This parameter is the output raster representing the direct incoming solar radiation for each location. the output has units of watt hours per square meter (WH/m2). This is an optional parameter.

Parameters:
outDirectRadiationRaster - the output raster representing the direct incoming solar radiation for each location. the output has units of watt hours per square meter (WH/m2).

getOutDiffuseRadiationRaster

public java.lang.Object getOutDiffuseRadiationRaster()
Returns the Output diffuse radiation raster parameter of this tool . This parameter is the output raster representing the diffuse incoming solar radiation for each location. the output has units of watt hours per square meter (WH/m2). This is an optional parameter.

Returns:
the Output diffuse radiation raster

setOutDiffuseRadiationRaster

public void setOutDiffuseRadiationRaster(java.lang.Object outDiffuseRadiationRaster)
Sets the Output diffuse radiation raster parameter of this tool . This parameter is the output raster representing the diffuse incoming solar radiation for each location. the output has units of watt hours per square meter (WH/m2). This is an optional parameter.

Parameters:
outDiffuseRadiationRaster - the output raster representing the diffuse incoming solar radiation for each location. the output has units of watt hours per square meter (WH/m2).

getOutDirectDurationRaster

public java.lang.Object getOutDirectDurationRaster()
Returns the Output direct duration raster parameter of this tool . This parameter is the output raster representing the duration of direct incoming solar radiation. the output has units of hours. This is an optional parameter.

Returns:
the Output direct duration raster

setOutDirectDurationRaster

public void setOutDirectDurationRaster(java.lang.Object outDirectDurationRaster)
Sets the Output direct duration raster parameter of this tool . This parameter is the output raster representing the duration of direct incoming solar radiation. the output has units of hours. This is an optional parameter.

Parameters:
outDirectDurationRaster - the output raster representing the duration of direct incoming solar radiation. the output has units of hours.

getToolName

public java.lang.String getToolName()
Returns the name of this tool.

Returns:
the tool name

getToolboxName

public java.lang.String getToolboxName()
Returns the name of the tool box containing this tool.

Returns:
the tool box name

getToolboxAlias

public java.lang.String getToolboxAlias()
Returns the alias of the tool box containing this tool.

Returns:
the tool box alias