Environment settings |
|
|
Release 9.2
Last modified September 4, 2007 |
Print all topics in : "Environment Settings" |
Environment settings can be thought of as additional parameters that a tool can use to affect its results. They differ from normal parameters in that they don't appear on a tool's dialog (with certain exceptions). Rather, they are values you set once using a separate dialog, and are then used by tools when they are run. There are over thirty environment settings which are arranged in six categories; general, cartography, coverage, geodatabase, raster analysis, and raster storage.
Learn more about geoprocessing environments.
There are four levels of environment settings; application, tool, model, and model process. These four environment levels form a kind of hierarchy, where application level environments are the highest level. A good way to think of this hierarchy is that environment settings are passed down to the next level: application environment settings are passed down to tools, tool environment settings are passed down to models, and model environment settings are passed down model processes. At each level, the passed down environments can be overridden.
Learn more about environment levels and hierarchy
The way you view and set environments differs between the four levels.
Learn more about specifying application environments.
Learn more about specifying tool environments
Learn more about specifying model environments
Learn more about specifying model process environments
Settings contained here are those applicable to most output data types.
Learn more about general settings.
| Settings | Explanation |
| Current workspace | Specify the workspace from which inputs are taken and into which outputs are placed. |
| Scratch workspace | Specify an output workspace for temporary storage of execution results that are created with an auto-generated name. By default, the scratch workspace path will be prefixed to all output parameters. |
| Output coordinate system | Specify the output features coordinate system. If not explicitly set and the output does not reside inside a feature dataset, the spatial reference of the first input will be used.
|
| Default output Z value | The z-value that will be applied to newly generated output features if the input feature classes contain z-values or the Output has Z Values is enabled. |
| Output has Z values | Specify whether output feature datasets will contain z-values.
|
| Output has M values | Specify whether output feature datasets will contain m- (measure) values.
|
| Extent | Specify the extent of the study area.
|
| Cluster tolerance | Cluster tolerance is the distance range in which all vertices and boundaries in a feature class are considered identical or coincident. To minimize error, the cluster tolerance chosen should be as small as possible, depending on the precision level of your data. By default, the minimum possible tolerance value is calculated in the units of the spatial reference of the input.
NOTE: In ArcGIS 9.2, the term xy tolerance has been introduced. This term is synonymous with cluster tolerance. In certain contexts the term cluster tolerance has been replaced by the term XY Tolerance. |
| M resolution | Determines the resolution of M values when feature classes are created.
The default value is the same as the xy resolution of 0.0001 meters or its equivalent in map units. NOTE: This environment is only applicable with ArcGIS 9.2, or later. |
| M tolerance | Tolerance value for adjusting M values during cluster processing.
The default value is 10 * the M Resolution. NOTE: This environment is only applicable with ArcGIS 9.2, or later. |
| XY resolution | The number of decimal places or significant digits used to store express feature coordinates (in both X and Y).
The default resolution for feature classes created in ArcGIS 9.2 and later releases is 0.0001 meters or its equivalent in map units. NOTE: This environment is only applicable with ArcGIS 9.2, or later. |
| XY tolerance | The minimum distance separating all feature coordinates (nodes and vertices) as well as the distance a coordinate can move in X or Y (or both).
You can set the value to be higher for data that has less coordinate accuracy and lower for datasets with extremely high accuracy. The default XY Tolerance is set to 0.001 meters or its equivalent in map units. NOTE: In ArcGIS 9.2, the term xy tolerance has been introduced. This term is synonymous with cluster tolerance. In certain contexts the term cluster tolerance has been replaced by the term XY Tolerance. |
| Z resolution | The resolution of Z values when creating feature classes.
The default value is the same as the XY Resolution of 0.0001 meters or its equivalent in Z units. NOTE: This environment is only applicable with ArcGIS 9.2, or later. |
| Z tolerance | The tolerance for adjusting Z values during cluster processing.
The default value is 10 * the Z Resolution. NOTE: This environment is only applicable with ArcGIS 9.2, or later. |
| Random number generator | Determines the random number generator type and seed that will be used to create random numbers. |
| Qualified Field Names | Specify if the output tables field names will be qualified with the name of the table. |
| Geographic Transformations | Specify transformation methods that can be used to project data on the fly. |
Settings contained here are those applicable to Cartography tools only.
Learn more about cartography settings.
| Settings | Explanations |
| Cartographic coordinate system | Specify the coordinate system to be used in deriving representations for a target map. |
| Reference scale | The scale at which symbols will appear on the page at their true size, specified in page units. |
Settings contained here are those applicable to coverages only.
Learn more about coverage settings
| Settings | Explanation |
| Precision for Derived Coverages | Determines the coordinate precision for derived coverages. Derived coverages are those derived from tools that accept input data to derive the output coverage, for example, coverages created by running the Buffer tool.
-HIGHEST—The coordinate precision of the output coverage will be the same precision as the input coverage, which has the highest precision. This is the default. -LOWEST—The coordinate precision of the output coverage will be the same precision as the input coverage, which has the lowest precision. -SINGLE—The coordinate precision of the output coverage will always be single precision |
| Precision for New Coverages | Determines the coordinate precision for new coverages. New coverages are those that are created, for example, using the Create Coverage tool.
|
| Level of Comparison between Projection Files | The degree of similarity between input projection files required for tool execution. Use this option if you want to validate the input projections before running coverage tools.
|
Settings contained here are those applicable to results placed in a geodatabase.
Learn more about geodatabase settings.
| Settings | Explanation |
| Output CONFIG keyword | The configuration keyword specifies the default storage parameters (configuration) for geodatabases in a relational database management system (RDBMS). This setting is applicable only when using ArcSDE.
Configuration keywords are only used with file geodatabases or ArcSDE Enterprise Edition geodadatabases. |
| Output spatial grid 1, 2, 3 | The two-dimensional grid system that spans a layer, like a locator grid you might find on a common road map. The first, or lowest, grid level has the smallest cell size.
One to three 2D grids (also referred to as grid levels), each with a distinct cell size, are created for an ArcSDE layer. Set the cell sizes of the other grids to 0 if you only want one; otherwise, set each level at least three times larger than the previous level. Personal and file geodatabases require a maximum of one spatial grid. |
| X,Y domain | Allowable coordinate range for x,y coordinates. |
| M domain | Allowable coordinate range for m- (measure) values. |
| Z Domain | Allowable coordinate range for z-values. |
Settings contained here are those applicable to results placed in a geodatabase.
| Settings | Explanation |
| Coincident points | This environment specifies how coincident data should be treated. |
Settings contained here are those applicable when working with tools that input or output a raster, either file-based or within a personal or ArcSDE geodatabase.
Learn more about raster analysis settings.
| Settings | Explanation |
| Cell size | The output cell size, or resolution. The default output resolution, when a feature class is used as input, is the width or the height (whichever is shorter) of the extent of the feature class divided by 250.
|
| Mask | Identifies those cells within the analysis extent that will be considered when performing an operation or a function. Setting an analysis mask means that processing will only occur on selected cells and that all other cells will be assigned values of nodata. |
Settings contained here are those applicable to raster results placed in a geodatabase.
Learn more about raster storage settings
| Settings | Explanation |
| Pyramid | Specify whether to create pyramids with the output raster dataset. If you are going to build pyramids, the pyramid resampling technique must be specified. Optionally, you can specify how many pyramid levels will be created. Leaving this setting blank will automatically build the optimal number of pyramid levels.
The available pyramid resampling techniques are:
|
| Raster Statistics | The Statistics option enables you to build statistics for the output raster dataset.
A skip factor may be set and applied to all types raster datasets, except for GRID.
A statistics ignore value may also be set for personal geodatabases. These values will be ignored in the calculations. |
| Compression | Specify the compression type of the output raster dataset.
The JPEG and JPEG 2000 compression quality can range from 1 to 100. A higher number means better image quality but less compression. |
| Tile Size | Specify the width and height of the desired tile size for the raster dataset output. The default tile size is 128 pixels by 128 pixels. This option is only valid for raster data that is stored in blocks. |