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 values.
  • 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

ElementImageDescription

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 executed.

In/Out derived data

The tool alters the input data when the model is executed. 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.

Iterator

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

Learn more about iterators
If

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

Learn more about If logical tools
Stop tool

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

Learn more about logical tools
Model utilities

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

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

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 in which you decide things such as the processing extent that limits processing to a specific geographic area or a coordinate system for all output geodatasets.

There are three levels of environment settings that apply to ModelBuilder:

  • Project-level environments are the settings that will be applied to any tool when it is executed 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 and model-level settings.

Workspace environments

There are four workspace environments that can be used in ModelBuilder to simplify model data management.

  • Scratch GDB

    The scratch GDB 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 is the location of a folder you can use to write file-based data, such as shapefiles, text files, and layer files. It is a read-only environment managed by ArcGIS.

  • Current workspace

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

  • Scratch workspace

    Tools that honor the Scratch Workspace environment setting use the specified location as the default workspace for output datasets. The Scratch Workspace is intended for output data you do not wish 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.

Feedback

You can use the output of a process as an input to a previous process. This is known as feedback, since you feed the output back to the input.

Learn more about ModelBuilder feedback

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

Contents of a variable can be used as a substitute for another variable by enclosing the substituting variable in percent signs (%). For example, if you have a model variable Category that references a value Desert, and you want to use that value as input to a geoprocessing tool, specify the tool input as %Category%.

Learn more about in-line variable substitution

Iterators and iteration

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 executed over and over using different settings or data each time.

Learn more about iteration

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

Layout

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

Parameters

Model parameters are the parameters that appear 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

Learn more about model parameters

Preconditions

Preconditions can be used 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 tool execution, and any tool can have more than one precondition.

Learn more about preconditions

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 show red color.

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

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

Validation

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

Learn more about validating a model

Related topics