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

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

public class PointsSolarRadiation
extends AbstractGPTool

Derives incoming solar radiation for specific locations in a point feature class or location table. The Points 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
PointsSolarRadiation()
          Creates the Points Solar Radiation tool with defaults.
PointsSolarRadiation(java.lang.Object inSurfaceRaster, java.lang.Object inPointsFeatureOrTable, java.lang.Object outGlobalRadiationFeatures)
          Creates the Points 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 getHeightOffset()
          Returns the Height offset parameter of this tool .
 double getHourInterval()
          Returns the Hour interval parameter of this tool .
 java.lang.Object getInPointsFeatureOrTable()
          Returns the Input points feature or table 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 getOutDiffuseRadiationFeatures()
          Returns the Output diffuse radiation features parameter of this tool .
 java.lang.Object getOutDirectDurationFeatures()
          Returns the Output direct duration features parameter of this tool .
 java.lang.Object getOutDirectRadiationFeatures()
          Returns the Output direct radiation features parameter of this tool .
 java.lang.Object getOutGlobalRadiationFeatures()
          Returns the Output global radiation features 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 setHeightOffset(double heightOffset)
          Sets the Height offset parameter of this tool .
 void setHourInterval(double hourInterval)
          Sets the Hour interval parameter of this tool .
 void setInPointsFeatureOrTable(java.lang.Object inPointsFeatureOrTable)
          Sets the Input points feature or table 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 setOutDiffuseRadiationFeatures(java.lang.Object outDiffuseRadiationFeatures)
          Sets the Output diffuse radiation features parameter of this tool .
 void setOutDirectDurationFeatures(java.lang.Object outDirectDurationFeatures)
          Sets the Output direct duration features parameter of this tool .
 void setOutDirectRadiationFeatures(java.lang.Object outDirectRadiationFeatures)
          Sets the Output direct radiation features parameter of this tool .
 void setOutGlobalRadiationFeatures(java.lang.Object outGlobalRadiationFeatures)
          Sets the Output global radiation features 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

PointsSolarRadiation

public PointsSolarRadiation()
Creates the Points Solar Radiation tool with defaults.

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


PointsSolarRadiation

public PointsSolarRadiation(java.lang.Object inSurfaceRaster,
                            java.lang.Object inPointsFeatureOrTable,
                            java.lang.Object outGlobalRadiationFeatures)
Creates the Points 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.
inPointsFeatureOrTable - the input point feature class or table specifying the locations to analyze solar radiation.
outGlobalRadiationFeatures - the output feature class representing the global radiation or amount of incoming solar insolation (direct + diffuse) calculated for each location. 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.

getInPointsFeatureOrTable

public java.lang.Object getInPointsFeatureOrTable()
Returns the Input points feature or table parameter of this tool . This parameter is the input point feature class or table specifying the locations to analyze solar radiation. This is a required parameter.

Returns:
the Input points feature or table

setInPointsFeatureOrTable

public void setInPointsFeatureOrTable(java.lang.Object inPointsFeatureOrTable)
Sets the Input points feature or table parameter of this tool . This parameter is the input point feature class or table specifying the locations to analyze solar radiation. This is a required parameter.

Parameters:
inPointsFeatureOrTable - the input point feature class or table specifying the locations to analyze solar radiation.

getOutGlobalRadiationFeatures

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

Returns:
the Output global radiation features

setOutGlobalRadiationFeatures

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

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

getHeightOffset

public double getHeightOffset()
Returns the Height offset parameter of this tool . This parameter is the height (in meters) above the DEM surface for which calculations are to be performed. the height offset will be applied to all input locations. This is an optional parameter.

Returns:
the Height offset

setHeightOffset

public void setHeightOffset(double heightOffset)
Sets the Height offset parameter of this tool . This parameter is the height (in meters) above the DEM surface for which calculations are to be performed. the height offset will be applied to all input locations. This is an optional parameter.

Parameters:
heightOffset - the height (in meters) above the DEM surface for which calculations are to be performed. the height offset will be applied to all input locations.

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.

getOutDirectRadiationFeatures

public java.lang.Object getOutDirectRadiationFeatures()
Returns the Output direct radiation features parameter of this tool . This parameter is the output feature class 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 features

setOutDirectRadiationFeatures

public void setOutDirectRadiationFeatures(java.lang.Object outDirectRadiationFeatures)
Sets the Output direct radiation features parameter of this tool . This parameter is the output feature class 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:
outDirectRadiationFeatures - the output feature class representing the direct incoming solar radiation for each location. the output has units of watt hours per square meter (WH/m2).

getOutDiffuseRadiationFeatures

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

Returns:
the Output diffuse radiation features

setOutDiffuseRadiationFeatures

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

Parameters:
outDiffuseRadiationFeatures - the output feature class representing the incoming solar radiation for each location that is diffuse. the output has units of watt hours per square meter (WH/m2).

getOutDirectDurationFeatures

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

Returns:
the Output direct duration features

setOutDirectDurationFeatures

public void setOutDirectDurationFeatures(java.lang.Object outDirectDurationFeatures)
Sets the Output direct duration features parameter of this tool . This parameter is the output feature class representing the duration of direct incoming solar radiation. the output has units of hours. This is an optional parameter.

Parameters:
outDirectDurationFeatures - the output feature class 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