Create Viewshed (Map Viewer Classic—raster analysis)—ArcGIS Image Server | Documentation for ArcGIS Enterprise
Skip To Content

Create Viewshed (Map Viewer Classic—raster analysis)

Create Viewshed The Create Viewshed tool identifies areas that are visible to the input observer locations.

Workflow diagram

Create Viewshed workflow

Examples

Using an input observer point from the top of a wind turbine, this tool will create a viewshed output representing the areas that are visible from the wind turbine.

Usage notes

This tool identifies the areas that the input observer locations can see, accounting for surface topography. The input point locations 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). The results define the areas that can be seen from the observer locations.

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. The nonvisible cells are given NoData values.

If Use current map extent is checked, only the raster area and the observer points that are visible within the current map extent will be analyzed. If unchecked, all observer points in the input layer will be analyzed, even if they are outside the current map extent.

The parameters for this tool are listed in the following table:

ParameterExplanation
Elevation surface

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 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 data type of the elevation surface can be integer or floating point.

Point features that represent observer locations

The point features that represent the observer locations when calculating the viewsheds.

Optimize for

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.
Maximum viewing distance

Enter a cutoff distance where the computation of visible areas will stop. Beyond this distance, whether the observer points and the other objects can see each other will not be determined.

There are two methods by which the maximum viewing distance can be specified.

  • Distance—The maximum distance is defined by a value you specify. This is the default method.
  • Field—The maximum distance for each observer location is determined by the values in a field you specify.

Note that large values will increase computation time. Unless specified, a default maximum distance will be computed based on the resolution and extent of the input elevation surface.

This parameter is useful for modeling certain phenomena. For example, by limiting the extent of visibility, you can model weather conditions such as a light fog. Similarly, restricting the visibility extent can give you some control over the time of day by approximating the effect of dusk.

Minimum viewing distance

Enter a distance where the computation of visible areas is to begin. 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 the maximum viewing distance.

There are two methods by which the minimum viewing distance can be specified.

  • Distance—The minimum distance is defined by a value you specify. This is the default method.
  • Field—The minimum distance for each observer location is determined by the values in a field you specify.

This parameter is useful for controlling the viewshed analysis area at a specific distance away from the observer. For example, if you are evaluating the visibility from a building top to a distant park, you can set a minimum viewing distance to exclude the areas close by that are of no interest and gain a better processing speed.

Distance is 3D

Specify whether the minimum and maximum viewing distance parameters are measured in a three-dimensional way or a simpler, two-dimensional way.

  • Checked—The viewing distances are treated as a 3D distance.
  • Unchecked—The viewing distances are treated as a 2D distance. This is the default.

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.

Elevation of observer locations

Enter the elevation of your observer locations. There are two methods by which the elevation of observer locations can be specified.

  • Elevation—The observer elevation is defined by a value you specify. This is the default method.
  • Field—The elevation for each observer location is determined by the values in a field you specify.

If a field is provided, the value contained in the field must be in the same unit as the Z unit of the input elevation surface.

Height of observers

Enter the height above ground for your observer locations. There are two methods by which the height of observers can be specified.

  • Height—The observer height is obtained from the value you specify. This is the default method.
  • Field—The height for each observer location is determined by the values in a field you specify.

The default is 6 feet. If you are looking from an elevated location, such as an observation tower or a tall building, use that height instead. During the viewshed calculation, this value is added to the observer elevation if it is specified; otherwise, it is added to the interpolated surface z-value.

Height of target

Enter the height of structures or people on the ground used to establish visibility. There are two methods by which the height of target can be specified.

  • Height—The target height is obtained from the value you specify. This is the default method.
  • Field—The height for each target is determined by the values in a field you specify.

The resulting viewshed identifies those areas where an observer point can see these objects on the ground. The converse is also true; the objects on the ground can see an observer point.

Following are some examples of target height settings:

  • If your input points represent wind turbines and you want to determine where people standing on the ground can see the turbines, enter the average height of a person (approximately 6 feet).
  • If your input points represent fire lookout towers and you want to determine which lookout towers can see a smoke plume that rises 20 feet high or higher, enter 20 feet for the target height.
  • If your input points represent scenic overlooks along some roads or trails and you want to determine where wind turbines that are 400 feet tall or more can be seen, enter 400 feet for the height.
  • If your input points represent scenic overlooks and you want to determine how much area on the ground people standing at the overlook can see, enter zero for the target height.
Output height to become visible

The name of the output above ground level (AGL) result. 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.

Result layer name

The name of the layer that will be created in My Content and added to the map. 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.

You can specify the name of a folder in My Content where the result will be saved using the Save result in drop-down box.

Environments

Analysis environment settings are additional parameters that affect a tool's results. You can access the tool's analysis environment settings by clicking the gear icon Analysis Environments at the top of the tool pane.

This tool honors the following Analysis Environments:

  • Output coordinate system—Specifies the coordinate system of the output layer.
  • Extent—Specifies the area to be used for analysis.
  • Snap Raster—Adjusts the extent of the output so it matches the cell alignment of the specified snap raster layer.
  • Cell size—The cell size to use in the output layer.
  • Mask—Specifies a mask layer, where only the cells that fall within the mask area will be used for analysis.
  • Parallel processing factor—Controls the raster processing CPU or GPU instances.

Similar tools and raster functions

Use Create Viewshed tool to identify visible areas on an elevation surface for a given set of input observer locations. Other tools may be useful in solving similar problems.

Map Viewer Classic analysis tools and raster functions

Use the Create Viewshed raster function to identify visible areas on an elevation surface for a given set of input observer locations.

ArcGIS Pro analysis tools and raster functions

The Geodesic Viewshed geoprocessing tool is available in the Spatial Analyst and 3D Analyst toolboxes.

The Create Viewshed tool is available in the Raster Analysis toolbox.

Viewshed is also available as a raster function.

ArcGIS Enterprise developers resources

If you are working in the ArcGIS REST API, use the Create Viewshed task.

If you are working in ArcGIS API for Python, use create_viewshed ArcGIS for Python API website from the arcgis.raster.analytics module.