Skip to main content

If Value Is (Model Tools)

Summary

Evaluates an input value compared to a single value, a list of values, or a range of values using a defined comparison operator.

Learn how If Value Is works in ModelBuilder

Usage

  • This tool is only available from ModelBuilder for use in models. The tool is not available from the Geoprocessing pane or from Python.

  • The tool has two Boolean outputs, True and False. Based on the condition being evaluated, one of the two Boolean outputs is true and the other is false after the tool runs. These Boolean outputs must be set as a precondition to the downstream tools for those to run if either of the preconditions is true.

    Note:

    Most tools are empty (without color) when added to a model; however, the If Value Is, If Data Exists, Collect Values, and Merge Branch tools are not. The If Value Is tool is always in a ready-to-run state (with color). This is because the input to the tool can be empty, which is considered a valid input for the comparison.

Parameters

Label Explanation Data type

Input Value

(Optional)

The input value to evaluate.

Any Value

Value Test

(Optional)

Specifies the type of comparison operator to use.

  • Is equal to at least one value—Determine whether the input value is equal to any one of the comparison values. This is the default.

  • Does not match at least one value—Determine whether the input value is not equal to any one of the comparison values.

  • Does not match every value—Determine whether the input value is not equal to every comparison value.

  • Is between any one range of values—Determine whether the input value is between any one range of comparison values.

  • Is not between any range of values—Determine whether the input value is not between any range of comparison values.

  • Is less than—Determine whether the input value is less than the comparison value.

  • Is greater than—Determine whether the input value is greater than the comparison value.

  • Is less than or equal to—Determine whether the input value is less than or equal to the comparison value.

  • Is greater than or equal to—Determine whether the input value is greater than or equal to the comparison value.

  • Is empty—Determine whether the input value is empty.

String

Comparison Type

(Optional)

Specifies the type of data comparison to use.

  • Case insensitive string—The input value is compared to the comparison values as a case insensitive string. This is the default.

  • Case sensitive string—The input value is compared to the comparison values as a case sensitive string.

  • Long—The input numeric value is compared to the comparison values as a Long type.

  • Double—The input numeric value is compared to the comparison values as a Double type.

  • Automatic data type detection—The input data type is checked and an equivalent data type comparison is performed. For example, compare the input and comparison values using string comparison for string type, long for long, and double for double. All other input data types use the default string comparison method.

String

Values

(Optional)

The list of values to compare to the input value.

Any Value

Range Values

(Optional)

Specifies the range values to compare to the input value.

Value table columns:

  • Minimum—The minimum value in the range.

  • Maximum—The maximum value in the range.

Value Table

Comparison Value

(Optional)

The single value to compare to the input value.

Any Value

Derived output

Label Explanation Data type

True

If the specified criteria evaluates to True, this parameter will be set to True.

Boolean

False

If the specified criteria evaluates to False, this parameter will be set to True.

Boolean

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes