How Raster Calculator works

Available with Spatial Analyst license.

Available with Image Analyst license.

The Raster Calculator tool allows you to create and execute Map Algebra expressions in a tool. Like other geoprocessing tools, the Raster Calculator tool can be used in ModelBuilder, allowing the power of Map Algebra to be more easily integrated into your workflows.

Note:

The Raster Calculator tool is not intended to be used in scripting environments and is not available in the standard Spatial Analyst ArcPy module. To learn more about scripting and Map Algebra, see the help topic What is Map Algebra?

The Raster Calculator tool is specifically designed to offer the following benefits:

  • Implement single-line algebraic expressions.
  • Support the use of variables in Map Algebra when in ModelBuilder.
  • Apply Spatial Analyst operators on three or more inputs in a single expression.
  • Use multiple Spatial Analyst tools in a single expression.

Raster Calculator is designed to execute a single-line algebraic expression using multiple tools and operators. When multiple tools or operators are used in one expression, the performance of this equation will generally be faster than executing each of the operators or tools individually.

Using the Raster Calculator tool

There are three main areas in the tool dialog box that are used to create a Map Algebra expression: Rasters, Tools and Expression

Raster Calculator tool dialog box
Raster Calculator tool dialog box example

Rasters

The input Rasters list identifies the input that can be used in the Map Algebra expression. The raster list will contain the layers in the Contents and datasets added with the Add raster button. When the tool is used in ModelBuilder the raster list will also contain Raster model variables.

Tools

The Tools list is a convenient selection of tools that can be used in the Map Algebra expression. By clicking a tool in the list, the tool name and open and close parentheses [()] will be placed in the expression where the pointer is currently positioned. The remaining input required by the tool must then be entered. A tool can be placed anywhere in the expression, but it should be placed in a position that produces valid Map Algebra syntax.

The operators in the list allow you to enter mathematical (addition, division, and so on) and logical (greater than, equal to, and so forth) operators into the expression. By selecting these symbols, that operator will be entered into the expression where the pointer is currently positioned.

Expression

The expression is the Map Algebra expression to be executed. The expression must be entered with valid syntax. See the following section to learn more about the syntax rules for Map Algebra.

The Map Algebra language

Map Algebra is a simple and powerful algebra with which you can execute all Spatial Analyst tools, operators, and functions to perform geographic analysis.

The Map Algebra used in Raster Calculator has a syntax, or a set of rules, that must be followed to create a valid expression. If these rules are not adhered to, the expression may be invalid and will not execute, or you may get results you did not expect.

Not only can Map Algebra be accessed from the Raster Calculator tool, it can also be accessed in Python scripting using the Spatial Analyst ArcPy module. The Map Algebra syntax used in this tool is the same, with the following exceptions:

  • You do not need to put the output raster name or the equal sign (=) in the expression, since the output name is specified in the Output raster parameter.
  • You do not need to cast input data as a Raster object when using operators.

For more information on Map Algebra, see the following:

Related topics