ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Help
  • Sign Out
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

GIS in your enterprise

ArcGIS Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions

env

  • Summary
  • Properties

Summary

Environment settings are exposed as properties on ArcPy's env class. These properties can be used to retrieve the current values or to set them. Geoprocessing environment settings can be thought of as additional parameters that affect a tool's results.

Properties

PropertyExplanationData Type
addOutputsToMap
(Read and Write)

The tool's resulting output datasets will be added to the application display. The setting has no effect when run from within a tool.

Boolean
autoCancelling
(Read and Write)

For use in script tools or Python toolbox tools.

When autoCancelling is set to True, a cancellation will end the script on the current line. If False, a cancellation will set the isCancelled property to True and continue executing. The default is True.

Learn more about cancellation behavior.

Boolean
autoCommit
(Read and Write)

Tools that honor the Auto Commit environment will force a commit after the specified number of changes have been made within an enterprise geodatabase transaction.

Learn more about autoCommit.

Long
buildStatsAndRATForTempRaster
(Read and Write)

Controls the calculation of statistics and building of raster attribute tables (RAT) for temporary rasters created by Spatial Analyst tools. The environment is only used from the interactive Python window in the application. The default is True.

When set to False, the statistics will be approximate for the purpose of symbolizing raster layers, and no RAT will be built.

Boolean
cartographicCoordinateSystem
(Read and Write)

Tools that honor the Cartographic Coordinate System environment will use the specified coordinate system to determine the size, extent, and spatial relationships of features when making calculations.

Learn more about cartographicCoordinateSystem.

String
cartographicPartitions
(Read and Write)

Tools that honor the Cartographic Partitions environment will subdivide input features by the specified partition polygon features for sequential processing to avoid memory limitations that may otherwise be encountered with large datasets.

Learn more about cartographicPartitions.

String
cellSize
(Read and Write)

Tools that honor the Cell Size environment set the output raster cell size, or resolution, for the operation. The default output resolution is determined by the coarsest of the input raster datasets.

Learn more about cellSize.

String
cellSizeProjectionMethod
(Read and Write)

Tools that honor the Cell Size Projection Method environment will use the specified method for calculating the output raster cell size when datasets are projected during analysis.

Learn more about cellSizeProjectionMethod.

String
coincidentPoints
(Read and Write)

Tools that honor the Coincident Points environment define how coincident data is treated in Geostatistical Analyst.

Learn more about coincidentPoints.

String
compression
(Read and Write)

Tools that honor the Compression environment will set the compression type when storing output raster datasets.

Learn more about compression.

String
configKeyword
(Read and Write)

Tools that honor the Output CONFIG Keyword environment will use the specified keyword when creating datasets in a geodatabase.

Learn more about configKeyword.

String
derivedPrecision
(Read and Write)

Tools that honor the Precision for Derived Coverages environment create output coverages with precision determined by the input coverages based on this setting.

Learn more about derivedPrecision.

String
extent
(Read and Write)

Tools that honor the Extent environment will only process features or rasters that fall within the extent specified in this setting.

Learn more about extent.

String
geographicTransformations
(Read and Write)

Tools that honor the Geographic Transformations environment will use the transformation methods when projecting data.

Learn more about geographicTransformations.

String
isCancelled
(Read Only)

For use in script tools or Python toolbox tools.

When autoCancelling is set to False and the tool has been cancelled, isCancelled will be set to True. isCancelled is False by default and is a read-only property.

Learn more about cancellation behavior.

Boolean
maintainSpatialIndex
(Read and Write)

Tools that honor the Maintain Spatial Index environment delete and re-create the spatial index of an enterprise geodatabase feature class, or keep it in place and update it, according to the setting.

Learn more about maintainSpatialIndex.

Boolean
mask
(Read and Write)

Tools that honor the Mask environment will only consider those cells that fall within the analysis mask in the operation.

Learn more about mask.

String
MDomain
(Read and Write)

Tools that honor the Output M Domain environment will generate output datasets with the specified measure (m)-domain.

Learn more about MDomain.

String
MResolution
(Read and Write)

Tools that honor the M Resolution environment will apply the m-resolution to output geodatasets. The m-resolution, expressed as a very small distance, refers to the number of significant digits used to store m-values.

Learn more about MResolution.

Double
MTolerance
(Read and Write)

Tools that honor the M Tolerance environment will override the default m-tolerance on geodatasets created in a geodatabase.

Learn more about MTolerance.

Double
newPrecision
(Read and Write)

Tools that honor the Precision for New Coverages environment will create output coverages that have the specified precision.

Learn more about newPrecision.

String
nodata
(Read and Write)

Tools that honor the NoData environment will only process rasters in which the NoData value is valid.

Learn more about nodata.

String
outputCoordinateSystem
(Read and Write)

Tools that honor the Output Coordinate System environment will create output geodatasets with the specified coordinate system.

Learn more about outputCoordinateSystem.

String
outputMFlag
(Read and Write)

Tools that honor the Output has M Values environment will control whether the output geodataset will store m-values.

Learn more about outputMFlag.

String
outputZFlag
(Read and Write)

Tools that honor the Output has Z Values environment will control whether the output geodataset will store z-values.

Learn more about outputZFlag.

String
outputZValue
(Read and Write)

Tools that honor the Default Output Z Value environment will set the z-coordinate for each output vertex that does not already have a z-coordinate.

Learn more about outputZValue.

String
overwriteOutput
(Read and Write)

Controls whether tools will automatically overwrite any existing output when run. When set to True, tools will execute and overwrite the output dataset. When set to False, existing outputs will not be overwritten, and the tool will return an error.

Boolean
packageWorkspace
(Read Only)

The Package Workspace environment setting is the location of a folder that locates the contents of a shared geoprocessing package or service.

Learn more about packageWorkspace.

String
parallelProcessingFactor
(Read and Write)

Tools that honor the Parallel Processing Factor environment will divide and perform operations across multiple processes.

Learn more about parallelProcessingFactor.

Integer
processingServer
(Read and Write)

Tools that honor the Remote Processing Server set of environments specify the server, user name, and password for ArcGIS Server when you use the Parallel Processing Factor environment.

The ArcGIS server name or IP address that has the Raster Processing system service enabled. If the Processing Server is a server cluster, use the server name that is the site host.

Learn more about processingServer.

String
processingServerPassword
(Read and Write)

Tools that honor the Remote Processing Server set of environments specify the server, user name, and password for ArcGIS Server when you use the Parallel Processing Factor environment.

The password associated with the user name that is authorized to use the Raster Processing service.

Learn more about processingServerPassword.

String
processingServerUser
(Read and Write)

Tools that honor the Remote Processing Server set of environments specify the server, user name, and password for ArcGIS Server when you use the Parallel Processing Factor environment.

The user name that is authorized to use the Raster Processing service.

Learn more about processingServerUser.

String
projectCompare
(Read and Write)

Tools that honor the Level of Comparison Between Projection Files environment only execute if the input projections match to the degree that is specified.

Learn more about projectCompare.

String
pyramid
(Read and Write)

Tools that honor the Pyramid environment will only process rasters where the pyramids are valid. Pyramids for ERDAS IMAGINE files have limited options that can be set.

Learn more about pyramid.

String
qualifiedFieldNames
(Read and Write)

Tools that honor the Maintain fully qualified field names environment use this setting to distinguish between qualified and unqualified field names. Qualified field names are the names of fields in a feature class or table that have the name of the origin feature class or table appended to the field name. This setting is relevant when working with joined data.

Learn more about qualifiedFieldNames.

Boolean
randomGenerator
(Read and Write)

Tools that use the Random Number Generator environment use algorithms that use the seed and distribution to produce a sequence of random numbers.

Learn more about randomGenerator.

Object
rasterStatistics
(Read and Write)

Tools that honor the Raster Statistics environment control how statistics are built for output raster datasets.

Learn more about rasterStatistics.

String
referenceScale
(Read and Write)

Tools that honor the Reference Scale environment will consider the graphical size and extent of symbolized features as they appear at the reference scale.

Learn more about referenceScale.

Double
resamplingMethod
(Read and Write)

Tools that honor the Resample environment interpolate pixel values while transforming your raster dataset. This is used when the input and output do not line up exactly, when the pixel size changes, when the data is shifted, or a combination of these.

Learn more about resamplingMethod.

String
scratchFolder
(Read Only)

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.

Learn more about scratchFolder.

String
scratchGDB
(Read Only)

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

Learn more about scratchGDB.

String
scratchWorkspace
(Read and Write)

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.

Learn more about scratchWorkspace.

String
snapRaster
(Read and Write)

Tools that honor the Snap Raster environment will adjust the extent of output rasters so that they match the cell alignment of the specified snap raster.

Learn more about snapRaster.

String
spatialGrid1
(Read and Write)

Tools that honor the Output Spatial Grid 1, 2, and 3 environments will create feature classes that have the specified spatial index grids if those feature classes support spatial index grids.

Learn more about spatialGrid1.

Double
spatialGrid2
(Read and Write)

Tools that honor the Output Spatial Grid 1, 2, and 3 environments will create feature classes that have the specified spatial index grids if those feature classes support spatial index grids.

Learn more about spatialGrid2.

Double
spatialGrid3
(Read and Write)

Tools that honor the Output Spatial Grid 1, 2, and 3 environments will create feature classes that have the specified spatial index grids if those feature classes support spatial index grids.

Learn more about spatialGrid3.

Double
terrainMemoryUsage
(Read and Write)

Tools that honor the Minimize memory use during analysis on terrains environment control memory use during analysis on terrains.

Learn more about terrainMemoryUsage.

Boolean
tileSize
(Read and Write)

Tools that honor the Tile Size environment set the tile size for rasters that are stored in blocks of data.

Learn more about tileSize.

String
tinSaveVersion
(Read and Write)

Tools that honor the Default TIN Storage Version environment will output TIN surfaces in the specified version.

Learn more about tinSaveVersion.

String
transferDomains
(Read and Write)

Tools that honor the Transfer field domain descriptions environment control whether output shapefiles and dBASE tables (.dbf) will have fields added containing domain and subtype descriptions, in addition to fields containing domain and subtype codes. This setting is only relevant when the input to a geoprocessing tool is a geodatabase feature class or table with defined domains and subtypes. By default, only domain and subtype codes are included in shapefile or dBASE output.

Learn more about transferDomains.

Boolean
workspace
(Read and Write)

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

Learn more about currentWorkspace.

String
XYDomain
(Read and Write)

Tools that honor the Output XY Domain environment will set the specified range to the output geodataset's x,y domain.

Learn more about XYDomain.

String
XYResolution
(Read and Write)

Tools that honor the XY Resolution environment will apply the x,y resolution to output geodatasets. The x,y resolution, expressed as a very small distance, refers to the number of significant digits used to store x,y coordinate values.

Learn more about XYResolution.

String
XYTolerance
(Read and Write)

Tools that honor the XY Tolerance environment will override the default x,y tolerance on geodatasets created in a geodatabase.

Learn more about XYTolerance.

String
ZDomain
(Read and Write)

Tools that honor the Output Z Domain environment will generate output datasets with the specified z-domain.

Learn more about ZDomain.

String
ZResolution
(Read and Write)

Tools that honor the Z Resolution environment will apply the z-resolution to output geodatasets. The z-resolution, expressed as a very small distance, refers to the number of significant digits used to store z-coordinate values.

Learn more about ZResolution.

String
ZTolerance
(Read and Write)

Tools that honor the Z Tolerance environment will override the default z-tolerance on geodatasets created in a geodatabase.

Learn more about ZTolerance.

String

Related topics

  • Using environment settings in Python
  • What is a geoprocessing environment setting?

ArcGIS Desktop

  • Home
  • Documentation
  • Support

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Esri Blog
  • User Conference
  • Developer Summit
Esri
Tell us what you think.
Copyright © 2021 Esri. | Privacy | Legal