Display Name: CreateViewshed

Description: Creates areas where an observer can see objects on the ground. The input observer points can represent either observers (such as people on the ground or lookouts in a fire tower) or observed objects (such as wind turbines, water towers, vehicles, or other people)., Both the observers and the observed objects can have a height above ground, and these heights are used to determine visibility. For example, a viewshed computed for 300-foot wind turbines and a 6-foot tall person standing on the ground will typically be larger than a viewshed computed for 200-foot turbines and a 5-foot tall person., The result layer records the number of times that each cell location in the input surface raster can be seen by the input observation points. Nonvisible cells are given NoData values.

Category:

Help URL: https://terra.library.brocku.ca/arcgis/rest/directories/arcgisoutput/System/RasterAnalysisTools_GPServer/System_RasterAnalysisTools/CreateViewshed.htm

Execution Type: esriExecutionTypeAsynchronous

Parameters:

Parameter: inputElevationSurface

Data Type: GPString
Display Name inputElevationSurface
Description: The elevation surface to use for calculating the viewshed.If the vertical unit of the input surface is different from the horizontal unit, such as when the elevation values are represented in feet but the coordinate system is in meters, the surface must have a defined vertical coordinate system. The reason for this is that the tool uses the vertical (Z) and horizontal (XY) units to compute a z-factor for the viewshed analysis. Without a vertical coordinate system, and thus having no Z unit information available, the tool will assume that the Z unit is the same as the XY unit. The result of this is that an internal Z factor of 1.0 will be used for the analysis, which may give unexpected results.The elevation surface can be integer or floating point.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeRequired
Category:


Parameter: inputObserverFeatures

Data Type: GPFeatureRecordSetLayer
Display Name inputObserverFeatures
Description: The point features that represent the observer locations when calculating the viewsheds.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Geometry Type:
HasZ: false
HasM: false
Spatial Reference: N/A
Fields: None

Features: None.



Parameter Type: esriGPParameterTypeRequired
Category:


Parameter: outputName

Data Type: GPString
Display Name outputName
Description: The name of the output raster service.The default name is based on the tool name and the input layer name. If the layer already exists, you will be prompted to provide another name.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeRequired
Category:


Parameter: optimizeFor

Data Type: GPString
Display Name optimizeFor
Description: The optimization method to use for calculating the viewshed.Speed—This method optimizes the processing speed, trading some accuracy in the result for higher performance. This is the default.Accuracy—This method is optimized for accuracy in the results, at the expense of a longer processing time.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:
Choice List: [ SPEED, ACCURACY ]

Parameter: maximumViewingDistance

Data Type: GPLinearUnit
Display Name maximumViewingDistance
Description: This is a cutoff distance, where the computation of visible areas stops. Beyond this distance, it is unknown whether the observer points and the other objects can see each other.The units can be Kilometers, Meters, Miles, Yards, or Feet.The default is miles.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: maximumViewingDistanceField

Data Type: GPString
Display Name maximumViewingDistanceField
Description: This is a field you can use to specify the maximum viewing distance for each observer. The values contained in the field must be in the same unit as the XY unit of the input elevation surface.The maximum viewing distance is a cutoff distance where the computation of visible areas stops. Beyond this distance, it is unknown whether the observer points and the other objects can see each other.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: minimumViewingDistance

Data Type: GPLinearUnit
Display Name minimumViewingDistance
Description: This is a distance where the computation of visible areas begins. Cells on the surface closer than this distance are not visible in the output but can still block visibility of the cells between the minimum and maximum viewing distance.The units can be Kilometers, Meters, Miles, Yards, or Feet.The default units are Meters.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: minimumViewingDistanceField

Data Type: GPString
Display Name minimumViewingDistanceField
Description: This is a field you can use to specify the minimum viewing distance for each observer. The values contained in the field must be in the same unit as the XY unit of the input elevation surface.The minimum viewing distance defines where the computation of visible areas begins. Cells on the surface closer than this distance are not visible in the output but can still block visibility of the cells between the minimum and maximum viewing distance.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: viewingDistanceIs3D

Data Type: GPBoolean
Display Name viewingDistanceIs3D
Description: Specify whether the minimum and maximum viewing distance parameters are measured in a three-dimensional way or a simpler, two-dimensional way. A 2D distance is the simple linear distance measured between an observer and the target using their projected locations at sea level. A 3D distance gives a more realistic value by taking their relative heights into consideration. Checked—The viewing distance is measured in 3D distance. Unchecked—The viewing distance is measured in 2D distance. This is the default.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: observersElevation

Data Type: GPLinearUnit
Display Name observersElevation
Description: This is the elevation of your observer locations.If this parameter is not specified, the observer elevation will be obtained from the surface raster using bilinear interpolation. If this parameter is set to a value, that value will be applied to all the observers. To specify different values for each observer, set this parameter to a field in the input observer features.The units can be Kilometers, Meters, Miles, Yards, or Feet.The default units are Meters.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: observersElevationField

Data Type: GPString
Display Name observersElevationField
Description: This is a field you can use to specify the elevation for the observers. The value contained in the field must be in the same unit as the Z unit of the input elevation surface.If this parameter is not specified, the observer elevation will be obtained from the surface raster using bilinear interpolation.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: observersHeight

Data Type: GPLinearUnit
Display Name observersHeight
Description: This is the height used for your observer locations.The units can be Kilometers, Meters, Miles, Yards, or Feet.The default units are Meters.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: observersHeightField

Data Type: GPString
Display Name observersHeightField
Description: This is a field you can use to specify the height for the observers. The value contained in the field must be in the same unit as the Z unit of the input elevation surface.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: targetHeight

Data Type: GPLinearUnit
Display Name targetHeight
Description: This is the height of structures or people on the ground used to establish visibility. The result viewshed are those areas where an observer point can see these other objects. The converse is also true; the other objects can see an observer point.The units can be Kilometers, Meters, Miles, Yards, or Feet.The default units are Meters.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: targetHeightField

Data Type: GPString
Display Name targetHeightField
Description: This is a field used to specify the height for the targets. The value contained in the field must be in the same unit as the Z unit of the input elevation surface.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: aboveGroundLevelOutputName

Data Type: GPString
Display Name aboveGroundLevelOutputName
Description: The name of the output aboveground-level (AGL) raster. The AGL result is a raster where each cell value is the minimum height that must be added to an otherwise nonvisible cell to make it visible by at least one observer. Cells that were already visible will be assigned 0 in this output raster.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: context

Data Type: GPString
Display Name context
Description:
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category:


Parameter: outputRaster

Data Type: GPString
Display Name outputRaster
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeDerived
Category:


Parameter: outputAboveGroundLevelRaster

Data Type: GPString
Display Name outputAboveGroundLevelRaster
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeDerived
Category:

Supported Operations:   Submit Job

Child Resources:   Metadata