Once you have found a geoprocessing tool, open it, then use it by entering parameters and running the tool. Any geoprocessing tool you select from the Analysis gallery, the Geoprocessing pane, or any other place in the application will open the tool in the Geoprocessing pane.
You can get help for the open geoprocessing tool by hovering over the Help button, or click the button to open the tool reference page.
After the tool opens, you fill in the tool's parameters, which are a set of options or settings, such as the input data to process, output dataset, and other options that modify how the tool runs. Every geoprocessing tool has a unique set of parameters. You can get more information about each tool parameter by hovering over the information icon next to each parameter. Parameters can be required or optional:
- Required parameters must be filled in for the tool to execute and are indicated by a red asterisk.
- Optional parameters can be left blank or unmodified to use a default behavior.
Geoprocessing tools have both input and output parameters. Input parameters can reference data or be options that control what the tool does. There are a number of ways to specify the input data to be processed by the tool, including the following:
- Select a layer from a list of map layers. If the layer has a selection, only the selected features will be processed.
- Browse to a dataset that is in a project database or connection using the browse button .
- Create input features interactively using the interactive input button .
For input parameters that are not data, you will typically only need to specify a number, check a box, or select an option from a list.
An output parameter is typically the location of a new dataset, object, or resulting value to be created by the tool. For output dataset parameters, an output location and name are automatically selected for you, but you can change the path of the dataset or browse using the output browse button . The output location that is automatically selected is based on your current or scratch workspace.
You can modify additional options that affect tool execution in the tool Environments. All environment settings are optional. Only the geoprocessing environments that actually apply to the specific open tool will be displayed in Environments.
Environment options set from the tool Environments will only be applied to that specific execution of the tool. If you reopen the tool from geoprocessing history, the environment settings will be retained; otherwise, all environment settings will be the default. To set geoprocessing environments that should be applied to all geoprocessing performed in the project, set environments from the Environments window opened from Analysis > Geoprocessing > Environments .
Progress and messages
Run a geoprocessing tool by clicking the Run button at the bottom of the Geoprocessing pane. When a tool is running, a progress bar is displayed to show completion percentage, and a cancel button is available to stop processing. You can hover on the progress bar to display a popup window containing comprehensive information about the tool that is running, such as messages, execution time, and all tool settings. You can also click the pop-out button to see the same information in a detached window, or expand the messages section to view any geoprocessing messages.
The geoprocessing tool you ran will stay open until you close it or click the back button.
When the tool is finished running, any output layers will be added to the map and the progress bar will display Completed if the tool ran successfully. If an error occurred during execution, the progress bar will display Error.
When you are finished running a geoprocessing tool, you can click the back button to return to the last page you viewed in the Geoprocessing pane.
When you run a geoprocessing tool, it will typically execute in a thread dedicated to geoprocessing. This enables the application and map to remain useable for other tasks while the tool is running, which is especially important if you are running a tool that takes a significant amount of time to complete. There are several cases when a geoprocessing tool will not run in this separate thread, which causes the running tool to lock the application so other tasks cannot be performed until the tool has completed. The following cases lock the application until the tool has completed:
- Running a geoprocessing tool in the Python window.
- Running a geoprocessing tool from an ArcGIS Pro add-in may or may not execute in the geoprocessing thread. You can receive this information from the add-in developer.
- Running a geoprocessing tool when there are unsaved edits in the workspace the geoprocessing tool uses as input or output.
- Running a model interactively within ModelBuilder.
Geoprocessing history and recently run tools
When a geoprocessing tool is run from the Geoprocessing pane or the Python window, an entry is added to the project Geoprocessing History with details on when the tool was run, the settings that were used, if the tool completed successfully, and any information, warning, or error messages.
The Favorites section of the Geoprocessing pane will show the tools that you have recently run. Tools that have been recently run display an indication icon that you can hover over to open the tool with the settings you previously used.