Skip to main content

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_radius in Python) parameter.

  • When the input Lag Distance (lag_distance in 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_device in 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 .crf file, 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.

  • Cells—The distance unit will be cells. This is the default.

  • Meters—The distance unit will be meters.

  • Centimeters—The distance unit will be centimeters.

  • Kilometers—The distance unit will be kilometers.

  • Inches—The distance unit will be international inches.

  • Feet—The distance unit will be international feet.

  • Yard—The distance unit will be international yards.

  • Miles—The distance unit will be international miles.

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.

  • 1 cell—The lag distance will be 1 cell. This is the default.

  • 2 cells—The lag distance will be 2 cells.

String

Target Device for Analysis

(Optional)

Specifies the device that will be used to perform the calculation.

  • GPU then CPU—If a compatible GPU is found, it will be used to perform the calculation; otherwise, the CPU will be used. This is the default.

  • CPU only—The calculation will only be performed on the CPU.

  • GPU only—The calculation will only be performed on the GPU.

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.