Geoprocessing options

The Geoprocessing tab on the Options dialog box provides options related to the geoprocessing tools, models, and scripts that you run in ArcGIS AllSource. You can access these options in the following ways:

  • From an open project, click the Project tab on the ribbon, and in the list of side tabs, click Options.
  • From the ArcGIS AllSource start page, click Settings in the lower left corner, and from the list on the left, click Options.

On the Options dialog box, click Geoprocessing to set the geoprocessing options.

Alternatively, on the Analysis ribbon tab, in the Geoprocessing group, click the Options dialog box launcher Launcher.

The geoprocessing options are described in the sections below.

Allow geoprocessing tools to overwrite existing datasets

This option controls whether a geoprocessing tool can overwrite an existing output dataset specified in the tool's parameters. This can include various types of datasets including tables, feature classes, rasters, layers, and files.

  • Checked—A warning appears in the Geoprocessing pane next to any output parameter that references an existing dataset, but the tool can still be run and overwrite the output dataset. This is the default.
  • Unchecked—An error icon appears in the Geoprocessing pane next to any output parameter that references an existing dataset, and the tool cannot be run.

Tools that edit or modify datasets, such as the Calculate Field tool, do not use this option.

Remove layers that reference data overwritten by geoprocessing tools

This option controls whether layers in a map are removed if their source datasets are deleted by a geoprocessing tool that overwrites output.

  • Checked—Layers with a data source that is overwritten are removed and a new layer that references the new dataset is added to the map. This is the default.
  • Unchecked—Layers remain as is in the map, unless the data type or shape type (point, line, or polygon) of the data changes.

Note:

Your software administrator may provide a default value for this option; the administrator may also lock this value.

Learn more about administrator management of application settings

Add output datasets to an open map

This option controls whether output datasets created by geoprocessing tools are automatically added to an open map.

  • Checked—Output datasets are added to an open map. This is the default.
  • Unchecked—Output datasets are not added to an open map.

Note:

Your software administrator may provide a default value for this option; the administrator may also lock this value.

Learn more about administrator management of application settings

Add output layers to the top of map contents

This option controls how geoprocessing tool output layers are added to the Contents pane.

  • Checked—Output layers created by geoprocessing tools are added to the top of the Contents pane.
  • Unchecked—Output layers created by geoprocessing tools are added to the Contents pane based on the layer and feature type. The position of a layer in the Contents pane aligns with its position if it was manually added using the Add Data button. This is the default.

Display disabled parameters

This option controls whether geoprocessing tool parameters that are disabled are displayed or hidden.

  • Checked—Disabled parameters are displayed in a grayed-out read-only state until the parameter is enabled, which typically happens through the tool's internal validation routine.
  • Unchecked—Tool parameters that are disabled are hidden. This is the default.

Enable Undo toggled on by default

This option controls whether the Enable Undo toggle button on geoprocessing tools that modify the input dataset is on by default.

  • Checked—Enable Undo is automatically turned on.
  • Unchecked—You must use the toggle button on the geoprocessing tool dialog box to enable undo for the operation. This is the default.
Learn more about undoing geoprocessing tools

Note:

Your software administrator may provide a default value for this option; the administrator may also lock this value.

Learn more about administrator management of application settings

Display data paths as shortened names

This option controls whether geoprocessing tool parameters that contain a dataset path are displayed as a shortened name.

  • Checked—Dataset paths are displayed as a shortened name, and you can click the shortened name to see the full dataset path. This is the default.
  • Unchecked—Full dataset paths are always displayed.
Note:

This option has no effect when a layer name or value that is not a dataset path is specified for a parameter.

Analyze script and model tools for ArcGIS AllSource compatibility

This option controls whether script and model tools are run through a compatibility-checking routine. If the model or script tool contains reference to a data format, tool, or Python syntax that is no longer supported, an error message is returned.

  • Checked—Model and script tools are checked for compatibility with ArcGIS AllSource to ensure that the tool can run successfully.
  • Unchecked—No compatibility check is run before the tool is run. This is the default.

You can use the Analyze Tools For Pro tool to manually perform the same compatibility check.

Learn more about geoprocessing tools that are not supported in ArcGIS AllSource

Open messages window automatically after running a tool

This option controls whether the messages window automatically opens after running a tool in the Geoprocessing pane.

  • Checked—The messages window automatically opens.
  • Unchecked—The messages window does not automatically open. This is the default.
Note:

You can click View Details in the status banner at the bottom of the Geoprocessing pane to open the messages window.

Show notification when tool completes

This option controls whether a notification pop-up appears when a geoprocessing tool finishes running. The notification displays the tool status and time of completion. Click the notification to open the messages window. The notification only appears when the Geoprocessing pane and History pane are not visible.

  • Checked—The notification pop-up appears when a tool finishes running.
  • Unchecked—The notification pop-up does not appear when a tool finishes running. This is the default.

Script Editor

This option controls which application or Python integrated development environment (IDE) is used to edit Python script tools and Python toolboxes. When you right-click a script tool or Python toolbox and click Edit, this application opens.

Note:

The Script Editor option is not used for debugging script tools, only for editing the script tool source file.

Learn more about debugging script tools

Additional information messages

The options described below control whether tool messages include additional categories of informative messages. All categories of additional informative messages are excluded by default.

Transformations

This option controls whether tool messages include geographic transformation-related messages. These messages are applicable when a tool requires transforming input datasets to a different coordinate system.

Command syntax

This option controls whether tool messages include a command syntax message. Command syntax is not Python code, it's a space-delimited string of the tool name and the parameter values used to run the tool.

Diagnostics

This option controls whether tool messages include diagnostic messages. The messages include details about geoprocessing preprocessing and postprocessing, geoprocessing thread disconnect and reconnecting, and more. Diagnostic messages are the same as the geoprocessing event messages logged in the ArcGIS AllSource Diagnostic Monitor. Esri staff uses diagnostic messages to troubleshoot geoprocessing tool issues.

Logging

The options described below control how geoprocessing operations are logged.

Write geoprocessing operations to Geoprocessing History

This option controls whether the tools you run are added to the current project's geoprocessing history.

  • Checked—Every tool run is logged in the project's geoprocessing history. This is the default.
  • Unchecked—Tools are not logged in geoprocessing history.

Note:

Your software administrator may provide a default value for this option; the administrator may also lock this value.

Learn more about administrator management of application settings

Write geoprocessing operations to XML log file

This option controls whether information about all the geoprocessing tools you run is written to an external log file.

  • Checked—XML log files are created in the %AppData%\Esri\ArcGISPro\ArcToolbox\History directory.
  • Unchecked—XML log files are not created. This is the default.

Write geoprocessing operations to dataset metadata

This option controls whether geoprocessing tool input and output datasets' metadata is updated to include the tool name, parameters, when the tool was run, and other information.

  • Checked—The dataset metadata contains a Geoprocessing history section with logging of the tools used with that dataset. This is the default.
  • Unchecked—Dataset metadata is not updated.

Learn more about geoprocessing history and metadata

Note:

You can view the Geoprocessing history section of dataset metadata in the FGDC metadata style.

Note:

Your software administrator may provide a default value for this option; the administrator may also lock this value.

Learn more about administrator management of application settings

R-ArcGIS support

The options described below allow you to install R-ArcGIS Bridge, review or update the current installation, or switch R home directories. Click the information button Information to go to the R-ArcGIS community to learn more.

Detected R home directories

After you install R, you can select the installation or home directory of R used to run R script tools. You can choose from a list of automatically detected home directories, or browse to find a location on disk.

arcgisbinding package

When the Detected R home directories option is set to a valid R home directory, this option appears and searches for the presence of the R-ArcGIS integration package, arcgisbinding, in the home directory.

  • If the arcgisbinding package is found, you can search for updates, download the latest version, and update from a file.
  • If the arcgisbinding package is not found, a warning message appears with options to download and install the package.