Create Viewshed

Create Viewshed tool for Portal


This tool 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). The result areas are those areas where the observers can see the observed objects and vice versa: the observed objects can see the observers.

Both the observers and the observed objects can have a height above ground, and these heights are used in determining visibility. For example, a viewshed computed for 300-foot wind turbines and six-foot tall person standing on the ground will typically be larger than a viewshed computed for 200-foot turbines and a five-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 non-visible 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.

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

Point features that represent observer locations


The point features representing the observer locations to calculate the viewsheds for.

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 selection.
  • 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.

You can specify either a numerical value representing a linear distance, or select a numerical field from the input observer features. If a field is provided, the values contained in the field must be in the same unit as the XY unit of the input elevation surface.

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 visibilty extent can give you some control over the time of day by approximating the affect of dusk.

Maximum viewing distance


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.

You can specify either a numerical value representing a linear distance, or select a numerical field from the input observer features. If a field is provided, the values contained in the field must be in the same unit as the XY unit of the input elevation surface.

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.

Minimum viewing distance


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. When the option is checked, the viewing distances are treated as 3D distance. When unchecked, they are treated as 2D distances.

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.

You can specify either a numerical value representing the elevation of all observers, or as a field that represents the elevation of each observer. If a field is provided, the value contained in the field should must be in the same unit as the Z unit of the input elevation surface.

Elevation of observer locations


Height of observers


Enter the height above ground of your observer locations.

You can specify either a numerical value for the height, or a field from the input observer features. 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.

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 observers


Height of target


Enter the height of structures or people on the ground used to establish visibility.

You can specify either a numerical value for the height, or a field from the input observer features. 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.

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).
  • 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.
  • represent scenic overlooks along some roads or trails, and you want to determine where wind turbines that are 400 or more feet tall can be seen, enter 400 feet for the height.
  • 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.

Height of observers


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 asked to provide another name.

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