Median Absolute Difference (MAD) Roughness (Spatial Analyst Tools)
Summary
Calculates the median absolute difference roughness value for each cell of a raster surface.
Learn more about how Median Absolute Difference (MAD) Roughness works
Usage
The output roughness values calculated by this tool are decoupled from the effect of the local slope. A sloping terrain can have a low roughness value if its surface is smooth.
This tool supports roughness anisotropy analysis through the two optional output rasters, an output anisotropy strength raster and an output anisotropy direction raster.
This tool uses a circular processing neighborhood when searching for the median absolute difference values. The radius of the neighborhood is specified through the Search Neighborhood Radius (
search_radiusin Python) parameter.When the input Lag Distance (
lag_distancein Python) parameter value is 1 cell, this tool uses a 3-by-3 moving window for computing the directional differences. When the input lag distance is 2 cells, a 5-by-5 moving window will be used. If any cell in the moving window is NoData, the output for the current processing cell will be NoData.This tool supports parallel processing. If your computer has multiple processors or processors with multiple cores, better performance may be achieved, particularly on larger datasets. The Parallel processing with Spatial Analyst help topic includes details about this capability and how to configure it.
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 parameter (
analysis_target_devicein Python) to control whether the GPU or CPU will be used to run the tool.See GPU processing with Spatial Analyst for details on compatible GPUs, configuring and working with GPU devices, as well as troubleshooting tips.
When the output raster format is a
.crffile, this tool supports the Pyramid raster storage environment. Pyramids will be created in the output by default. For any other output format, this environment is not supported, and pyramids will not be created.See Analysis environments and Spatial Analyst for additional details about the geoprocessing environments that apply to this tool.
Parameters
| Label | Explanation | Data type |
|---|---|---|
|
Input Surface Raster |
The input surface raster. |
Raster Layer |
|
Output Anisotropy Strength Raster (Optional) |
The output roughness anisotropy strength raster. The cell values are floating-point numbers ranging from 0 to 1. The value 0 represents minimum anisotropy, and 1 represents maximum anisotropy. |
Raster Dataset |
|
Output Anisotropy Direction Raster (Optional) |
The output roughness anisotropy direction raster. The cell values are geographic angles representing the direction of maximum continuity at each cell location. The values are floating-point numbers ranging from 90 to 270. Cells that are isotropic (where no direction can be determined) will have value -1. |
Raster Dataset |
|
Radius Units (Optional) |
Specifies the radius unit that will be used for the Search Neighborhood Radius parameter.
|
String |
|
Search Neighborhood Radius (Optional) |
Specifies the radius of the circular search neighborhood. The value must be a positive number. The maximum allowed value is 1024 cells. The default value is 3 cells. |
Double |
|
Lag Distance (Optional) |
Specifies the lag distance used in height difference computation between neighboring points.
|
String |
|
Target Device for Analysis (Optional) |
Specifies the device that will be used to perform the calculation.
|
String |
Return value
| Label | Explanation | Data type |
|---|---|---|
|
Output Roughness Raster |
The output roughness raster. It will be floating-point type. |
Raster |
Environments
Auto Commit, Cell Size, Cell Size Projection Method, Compression, Current Workspace, Extent, Geographic Transformations, Mask, Output CONFIG Keyword, Output Coordinate System, Parallel Processing Factor, Processor Type, Pyramid, Scratch Workspace, Snap Raster, Tile Size
Licensing information
- Basic: Requires Spatial Analyst
- Standard: Requires Spatial Analyst
- Advanced: Requires Spatial Analyst
References
See the following references for additional information:
- Trevisani, S., Teza, G., and Guth, P., 2023. "A simplified geostatistical approach for characterizing key aspects of short-range roughness". CATENA, Volume 223, ISSN 0341-8162, doi:10.1016/j.catena.2023.106927.