Conditional evaluation with Con

Available with Spatial Analyst license.

Available with Image Analyst license.

The Con tool allows you to control the output value for each cell based on whether the cell value is evaluated as true or false in a specified conditional statement.

If the cell is evaluated as true, it will receive one value. If it is evaluated as false, it will receive another value. The values a cell will receive when it is evaluated as true are specified by the Input true raster or constant value parameter. The values a cell will receive when it is evaluated as false are specified by the Input false raster or constant parameter.

Conceptually, during processing, the Con tool visits each cell location and, based on the cell's value and the conditional statement, determines if the cell is evaluated as true or false. If the cell is evaluated as true, the output value for that location is identified in the true input. If the cell is evaluated as false, the output value for that location is identified in the false input.

In the geoprocessing environment, there are two ways to identify whether a cell location is evaluated as true or false: by an input raster or by an input raster in which an optional input expression is applied. If only an input raster is used, all nonzero values in the input raster are considered true and all zero values are considered false. Cells assigned NoData will receive NoData as output. NoData does not equate to false.

A number of Spatial Analyst tools can be used to create a conditional input raster. In particular, the logical tools in the Math toolbox can be used, with the Test tool being particularly useful.

Using the Con tool in map algebra

To perform conditional evaluation on a raster dataset in map algebra, input the raster dataset as a conditional raster to the Con tool. Input a true raster to provide values to be returned when the conditional evaluation is true. Input a false raster to provide values to be returned when the conditional evaluation is false. The where clause parameter defines the expression to be evaluated using the input conditional raster.

Example

For example, to assign the value of 10 (identified as the true constant) as good for construction and 1 (identified as the false constant) as unsuitable for construction based on the slope at a cell (identified by the input conditional raster), and less than 15 percent slope is considered good, use the expression "VALUE < 15". If a cell has less than 15 percent slope, it will receive the value of true (in this case, 10); otherwise, it will receive the value identified by false (in this case, 1).

OutRas = Con(SlopeRas, 10, 1, "VALUE < 15")

Using complex expressions with the Con tool in map algebra

In map algebra, more capabilities can be attained with the expression than a simple logical condition. With a complex expression, you can, for example, have several individual expressions nested in it, specify multiple rasters, or use other tools and operators.

Any valid map algebra expression that results in a raster can be used as an argument for any of the input conditional, true, or false raster inputs.

The Expression parameter should be dropped if the input conditional raster expression is used in a complex expression. In this case, the syntax of the Con tool takes the following generalized form:

Con(in_conditional_raster, true_raster, {false_raster})

The Expression parameter is dropped in this case because the condition raster is provided by the map algebra expression, which will return a raster dataset, for example, with values of 0 and 1 if it were a logical operation.

Examples

The following are examples of using a complex expression to perform a conditional evaluation.

• The following is an example of using a complex expression in the Con tool:

  OutRas = Con(InRas < 15, 10, 1)

  In the expression above, if the value of a cell in InRas is less than 15, 10 will be assigned to that cell location (true) on the output raster; otherwise, cell values greater than or equal to 15 will be assigned 1 (false) on the output raster.
• If no value or expression is specified for the false expressions, use the following expression:

  OutRas = Con(InRas < 15, 10)

  The results will be the same as the output above except the cells that have a value of 15 or greater will be assigned NoData.
• Any valid expression can be used in place of a value for the true_expression and false_expression arguments.

  OutRas = Con(InRas1 > 5, Sin(InRas1), Cos(InRas1))

  In the expression above, the sine of all values greater than 5 and the cosine for all values of 5 or less are calculated, and the results are sent to OutRas.
• Multiple conditional statements can be used in the Con tool, but each must have a value or expression, true_expression, that can be used to assign values to the output cells if the result of the evaluation of the condition is true. The optional value or expression, false_expression, can be applied if none of the results of the evaluations of the conditions are true.

  OutRas = Con(InRas1 < 5, Sin(InRas1), Con(InRas1 < 20, Cos(InRas1), Con(InRas1 > 50, 100, 0)))

  In the expression above, the sine is calculated for those values that are less than 5, the cosine is calculated for the values that are 5 or greater but less than 20, the values that are 20 or greater but 50 or less are assigned 0, and the values greater than 50 are assigned 100.
• Multiple conditions can be used in a conditional expression of the Con tool.

  OutRas = Con((InRas1 > 5) & (InRas1 < 10), 5, 100)

  In the expression above, if the input value from InRas1 is greater than 5 and less than 10, assign the location 5; otherwise, assign it 100.
• Tools and operators can be applied to the input rasters in the conditional expression and the results evaluated.

  OutRas = Con(Sin(InRas1) > .5, 10, 100)
  OutRas2 = Con((InRas1 + InRas2) > 10, 100, 5)
  OutRas3 = Con(InRas1 > 5, Cos(InRas1), Sin(InRas1))

• A Con tool can be nested in another Con tool.

  OutRas = Con(InRas1 > 23, 5, Con(InRas1 > 20, 12, Con((InRas1 > 2) & (InRas1 < 17), Sin(InRas1), 100)))

• Multiple rasters can be used in the conditional statement or in the expression to be performed on the cells.

  OutRas = Con(InRas1 + InRas2 > 7, Sin(InRas1), Cos(InRas2))
  OutRas2 = Con(InRas1 < 9, InRas1 * InRas2 + Tan(InRas3), Cos(InRas1))

  The input of multiple rasters is possible since the Con tool is evaluated for each x,y cell location before moving to the next cell. When multiple rasters are input, the specified operator or tool will process on a cell-by-cell basis between the multiple rasters.