| Label | Explanation | Data Type |
Input raster | The input surface raster. | Raster Layer |
Output raster | The output aspect raster. It will be floating-point type. | Raster Dataset |
Method (Optional) | Specifies whether the calculation will be based on a planar (flat earth) or a geodesic (ellipsoid) method. The planar method is appropriate to use on local areas in a projection that maintains correct distance and area. It is suitable for analyses that cover areas such cities, counties, or smaller states in area. The geodesic method produces a more accurate result, at the potential cost of an increase in processing time.
| String |
Z unit (Optional) | Specifies the linear unit that will be used for vertical z-values. It is defined by a vertical coordinate system if it exists. If no vertical coordinate system exists, define the z-unit using the unit list to ensure correct geodesic computation. The default is meter.
| String |
Project geodesic azimuths (Optional) | Specifies whether geodesic azimuths will be projected to correct the angle distortion caused by the output spatial reference.
| Boolean |
Target device for analysis (Optional) | Specifies the device that will be used to perform the calculation.
| String |
Available with Spatial Analyst license.
Available with 3D Analyst license.
Summary
Derives the aspect from each cell of a raster surface.
The aspect identifies the compass direction that the downhill slope faces for each location.
The Surface Parameters tool provides a newer implementation and enhanced functionality.
Illustration
Usage
-
The Surface Parameters tool provides a newer implementation of aspect and is recommended to be used instead of the Aspect tool. The Aspect tool fits a plane to the nine local cells, but a plane may not be a good descriptor of the landscape and may mask or exaggerate natural variations of interest. The Surface Parameters tool fits a surface to the neighborhood of cells instead of a plane, which provides a more natural fit to the terrain.
The Aspect tool uses a 3 by 3 window of cells to compute the value, while the Surface Parameters tool allows window sizes from 3 by 3 to 15 by 15 cells. Larger window sizes are useful with high resolution elevation data to capture land surface processes at an appropriate scale. The Surface Parameters tool also provides an adaptive window option that evaluates the local variability of the terrain and identifies the largest appropriate neighborhood size for each cell. This can be useful with gradual homogeneous terrain interrupted by streams, roads, or sharp breaks in slope.
You can continue to use the traditional approach of the Aspect tool if you need the results to exactly match previous tool runs or if fast processing time is more important than a better algorithm.
This tool uses a 3 by 3 cell moving window to process the data. If the processing cell is NoData, the output for that location will be NoData.
Of the eight cells neighboring the processing cell, this tool requires that at least seven of them have a valid value. If there are fewer than seven valid cells, the calculation will not be performed, and the output at that processing cell will be NoData.
The cells in the outermost rows and columns of the output raster will be NoData. This is because along the boundary of the input dataset, those cells do not have enough valid neighbors.
Aspect is expressed in positive degrees from 0 to 360, measured clockwise from north.
Cells in the input raster that are flat—with zero slope—are assigned an aspect of -1.
For the geodesic method, specifying the surface z-unit ensures the accuracy of the output. The Z unit parameter will be enabled only when the geodesic method is selected.
If a z-unit is available in the vertical coordinate system of the input raster, it will be applied automatically. It is recommended that you define a z-unit for the input raster if it is missing. You can use the Define Projection tool to specify a z-unit. If it is undefined, meter will be used by default.
The Project geodesic azimuths (project_geodesic_azimuths in Python) parameter is available only when the Method parameter is set to Geodesic.
For the Geodesic method, if the Project geodesic azimuths parameter is checked (project_geodesic_azimuths is set to PROJECT_GEODESIC_AZIMUTHS in Python), the following are true:
- North is always represented by 360 degrees.
- Azimuths will be projected to correct the distortion caused by a nonconformal Output Coordinate System environment value. These angles can be used to accurately locate points along the steepest downhill slope.
When the input raster needs to be resampled, the bilinear technique will be used. An example of when an input raster may be resampled is when the output coordinate system, extent, or cell size is different from that of the input.
If the Input raster parameter value is high resolution with a cell size of less than a few meters, or particularly noisy, consider using the Surface Parameters tool and its user-defined neighborhood distance option instead of the immediate 3 by 3 neighborhood of this tool. Using a larger neighborhood can minimize the effect of noisy surfaces. Using a larger neighborhood can also better represent landforms and surface characteristics when using high resolution surfaces.
This tool can be GPU accelerated, which means that if a compatible graphics processing unit (GPU) is available on your system, it will be used to enhance the performance of the tool. Use the Target device for analysis (analysis_target_device in Python) parameter to control whether the GPU or CPU will be used to run the tool.
See GPU processing with Spatial Analyst in the Spatial Analyst extension help for details on compatible GPUs, configuring and working with GPU devices, as well as troubleshooting tips.
Parameters
arcpy.ddd.Aspect(in_raster, out_raster, {method}, {z_unit}, {project_geodesic_azimuths}, {analysis_target_device})| Name | Explanation | Data Type |
in_raster | The input surface raster. | Raster Layer |
out_raster | The output aspect raster. It will be floating-point type. | Raster Dataset |
method (Optional) | Specifies whether the calculation will be based on a planar (flat earth) or a geodesic (ellipsoid) method.
The planar method is appropriate to use on local areas in a projection that maintains correct distance and area. It is suitable for analyses that cover areas such cities, counties, or smaller states in area. The geodesic method produces a more accurate result, at the potential cost of an increase in processing time. | String |
z_unit (Optional) | Specifies the linear unit that will be used for vertical z-values. It is defined by a vertical coordinate system if it exists. If no vertical coordinate system exists, define the z-unit using the unit list to ensure correct geodesic computation. The default is meter.
| String |
project_geodesic_azimuths (Optional) | Specifies whether geodesic azimuths will be projected to correct the angle distortion caused by the output spatial reference.
| Boolean |
analysis_target_device (Optional) | Specifies the device that will be used to perform the calculation.
| String |
Code sample
This example creates an aspect raster from an input surface raster.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.ddd.Aspect("elevation", "C:/output/outaspect.img")This example creates an aspect raster from an input surface raster.
# Name: Aspect_3d_Ex_02.py
# Description: Derives aspect from a raster surface.
# Requirements: 3D Analyst Extension
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "elevation"
outAspect = "C:/output/outaspect2"
method = "GEODESIC"
zUnit = "FOOT"
# Check out the ArcGIS 3D Analyst extension license
arcpy.CheckOutExtension("3D")
# Execute Aspect
arcpy.ddd.Aspect(inRaster, outAspect, method, zUnit)Environments
Licensing information
- Basic: Requires 3D Analyst or Spatial Analyst
- Standard: Requires 3D Analyst or Spatial Analyst
- Advanced: Requires 3D Analyst or Spatial Analyst