ModelBuilder vocabulary

Diagram

The model diagram is everything you see when you edit a model in ModelBuilder, including the appearance and layout of the tools and variables in the model.

Elements

Model elements are the basic building blocks of models. There are four main types of model elements: geoprocessing tools, variables, connectors, and groups.

  • Geoprocessing tools perform various operations on geographic or tabular data. When tools are added to a model, they become model elements. You can open the tool dialog box of any geoprocessing tool in your model to set the input and output parameters.
  • Variables are elements in a model that hold a value or a reference to data. There are two types of variables: data and value variables.
  • Connectors connect data and values to tools. The connector arrows show the direction of processing. There are four types of connectors: data, environment, precondition, and feedback.
  • Groups are visual elements that group related tools together. These groups can collapse or expand to hide or show tools, providing more visual space to work with.

The illustration and table below show the different model elements in ModelBuilder.

Model elements

ElementDescription

Data variable

Input data

Data variables are model elements that store paths and other properties of data on disk. Common data variables include feature class, feature layer, raster dataset, and workspace.

Derived or output data variable

Derived data

Derived or output data is new data created by a tool in the model. When a geoprocessing tool is added to a model, variables for the tool's output parameters are automatically created and connected to the tool.

New derived data
The tool creates a dataset that is written to disk when the model is run.

In/Out derived data
The tool alters the input data when the model is run. By default, the in/out derived data variable will have the same name as the input data but with a unique number appended at the end.

Value variable

Input value

Value variables are values such as strings, numbers, Boolean (true/false values), spatial references, linear units, or extents. Value variables contain anything but references to layers or data stored on disk.

Derived value variable

Derived value

Values that are the result of a tool. Derived values can be inputs to other tools. The Calculate Value tool, for example, outputs the result of a logical or mathematical calculation.

Tool

Geoprocessing tool

Tools are geoprocessing tools added to the model. These include all tools you will find in a system toolbox as well as custom model and script tools. Tools in ModelBuilder also include special tools such as iterators, ModelBuilder utilities, and ModelBuilder logical tools.

Iterators are special ModelBuilder-only tools that repeat the same operation or loop through a set of input data or values.

Iterator

Learn more about iterators

Logical tools are special ModelBuilder-only tools that branch the model based on different conditions.

If

Learn more about If logical tools

Logical tools are used to control the logical flow of models. One logical tool is Stop.

Stop tool

Learn more about logical tools

ModelBuilder utilities are tools that are helpful in constructing models and only work within ModelBuilder, not in scripting.

Model utilities

Learn more about ModelBuilder utilities

Group

Group

Groups are visual categories that include other elements in the model. These groups can be expanded and collapsed.

Learn more about grouping

Descriptions of model elements

Processes and state

A model process consists of a tool and all variables connected to it. Connector lines indicate the sequence of processing. Many processes can be chained together to create a larger process.

Multiple model processes
A process in a model can be in one of four states: not ready to run, ready to run, running, and has been run.

Not ready to run

When you initially drag a tool into ModelBuilder, the process is in a not-ready-to-run state because the required parameter values have not been specified. The tool and its inputs and outputs are gray.

Ready to run

A process is ready to run when the tool has all required parameters filled in. All model elements in the process have color.

Running

The process is in a running state if the model tools are red.

Has been run

If you run the model from within ModelBuilder, the tool and derived data elements are displayed with drop shadows, indicating that the process has run and the derived data has been generated.

Process states

Variable types

The input variables in the models can be a single value, a multivalue, or a value table variable. Single and multivalue variables support a single data type. A value table variable allows you to add more than one data type. You can create a model variable by clicking the Variable button Variable on the ModelBuilder tab, or the Create Variable button from the model view context menu. In the Variable Data Type dialog, you can check the Multiple Values check box to create a multivalue variable, or check the Table of Values check box to create a value table variable. Some data types have special user controls, for example, field map, extent, coordinate system and so on with control-specific interaction.

Validation

Model validation refers to the process of making sure all model variables (data or values) are valid.

Learn more about validating a model

Environment settings

Geoprocessing environment settings are additional settings that affect geoprocessing tools. These settings allow you to ensure that geoprocessing is performed in a controlled environment. For example, you can set the processing extent to limit processing to a specific geographic area or set a coordinate system for all output geodatasets.

Three levels of environment settings apply to ModelBuilder:

  • Project-level environments are the settings that will be applied to any tool when it is run in the current project. These environment settings are saved with the project.
  • Model-level settings are specified and saved with a model and override project-level settings.
  • Model process-level environments are applied to a single run of a tool, saved with the model, and override the project-level and model-level settings.

Workspace environments

There are four workspace environments that you can use in ModelBuilder to simplify model data management.

  • Scratch GDB

    The Scratch GDB environment setting is the location of a file geodatabase you can use to write temporary data.

    The scratch GDB (geodatabase) is the preferred location for writing intermediate outputs in a model. Use this geodatabase by specifying an output dataset path such as %scratchgdb%\output.

  • Scratch folder

    The Scratch Folder environment setting is the location of a folder you can use to write file-based data, such as shapefiles, text files, and layer files.

  • Current Workspace

    Tools that honor the Current Workspace environment use the workspace specified as the default location for geoprocessing tool inputs and outputs.

  • Scratch Workspace

    Tools that honor the Scratch Workspace environment use the specified location as the default workspace for output datasets. The scratch workspace is intended for output data you do not want to maintain.

In addition to the above workspaces, you can also write model outputs to memory. Data written to memory is temporary and automatically cleared when the application closes.

Preconditions

You can use preconditions to explicitly control the order of operations in a model. For example, a process can be made to run after another process by making the output of the first process a precondition to the second process. Any variable can be made a precondition to the running of the tool, and any tool can have more than one precondition.

Learn more about preconditions

Feedback

The output of a process can be used as the input to a previous process. This is known as feedback, since you feed the output back to the input.

Learn more about ModelBuilder feedback

Layout

The elements in a model can be arranged by moving the elements to the desired location or automatically arranged using the Auto Layout button on the ModelBuilder tab. To automatically arrange the elements inside the group, right-click the group and click the Auto Layout from the context menu. To lock or unlock the elements, click the Lock Element or Unlock Element button under the View group on the ModelBuilder tab. Locked elements are not affected by the Auto Layout in the model.

Intermediate data

The output from the intermediate tools in a model can be retained or deleted.

Learn more about intermediate data

In-line variable substitution

In ModelBuilder, you can substitute the value or dataset path of a variable for another variable by enclosing the substituting variable name in percent signs (%VariableName%). Substituting variables in this manner is called inline variable substitution.

For example, if you have a variable Name with a value of Wilson, you can construct a dataset path as C:\Data\Output.gdb\Clipped_%Name% and the path will be resolved as C:\Data\Output.gdb\Clipped_Wilson.

Learn more about in-line variable substitution

Iterators

Iteration, or looping, refers to an automated way to repeat a process. Iteration is very important because automating repetitive tasks reduces the time and effort required to perform the tasks. With iteration in ModelBuilder, a process can be run over and over using different settings or data each time.

Learn more about iteration

Utilities

ModelBuilder provides a number of support utilities, including Calculate Value, Collect Values, Get Field Value, Parse Path, and Select Data.

Learn more about utilities

If-then-else branching and logical tools

If-then-else logic is a concept for performing actions based on different conditions. If-then-else logic can be explained as follows: if the condition is true, then perform an action, else perform a different action.

Learn more about logical tools

Parameters

Model parameters appears in the Geoprocessing pane when the model is opened as a geoprocessing tool. Any variable in the model can be made a model parameter. Derived variables (tool outputs) that are a parameter will be added to the last active map after they are successfully created.

Model parameters and tool dialog box

Learn more about model parameters

Model tool

A ModelBuilder model is saved as a model tool in a toolbox. A model tool is like any other geoprocessing tool: it can be run, used in Python, or added to another model. To edit the model tool in ModelBuilder, right-click and select Edit. To open and run the model tool in the Geoprocessing pane, double-click it or right-click and select Open.

Learn more about creating model tools

Add a submodel to a model

The idea of adding and running one model tool within another model is sometimes referred to as a submodel, nested model, or model within a model. Using one model within another model allows large models to be divided into smaller, more easily managed models that can be reused.

Learn more about adding a submodel to a model

Batch model tool

Model tools can be run in a batch mode that allows you to run the model tool multiple times using many input datasets or different parameter settings. This makes it possible to run a tool many times with very little interaction.

Learn more about batch geoprocessing

Schedule a model

You can schedule a model tool to run at a specific time of day or to run repeatedly at a designated time interval. This is helpful if the model takes a long time to run and you want the results to be available at a certain time.

Learn more about scheduling a model

Export a model to Python

You can export a model either to Python window or a Python script file. Both options will generate the same Python code, which can be further edited and used as a stand-alone Python script or modified to work as a script tool.

Learn more about exporting a model to Python

Model report

The ModelBuilder report view shows all the variables and tools in a model along with its value and other properties. This is helpful for locating variables in a big model. Furthermore, you can also find and replace variable names and values in report view.

Learn more about model report