Summary
Upgrades a low precision dataset's spatial reference to high precision.
Input to this tool is a stand-alone feature class, feature dataset, or raster catalog which has a low resolution spatial reference and is stored in a current version personal or ArcSDE geodatabase. The origin and precision of the high precision spatial reference grid will mesh with the existing low precision grid. For each point of the original low precision spatial reference grid there is a point in the new high precision spatial reference grid. Coordinate values will not be affected by the upgrade.
Illustration
Usage
To determine the geodatabase version, right-click the geodatabase and select "Properties...". The "Upgrade Status" section under the General tab will show the ArcGIS release that the geodatabase corresponds to. If version number is less than 9.2, you can use the "Upgrade Geodatabase" function to upgrade the geodatabase to the ArcGIS version being used.
To determine if a dataset (feature class, feature dataset, or raster catalog) is high precision, right-click the dataset and select "Properies...", then select the General tab. In the Geometry Properties, youll see either "Data Storage : High Precision" or "Low Precision". Datasets stored in a file geodatabase are always high precision.
Individual feature classes within a feature dataset cannot be upgraded individually as they inherit their spatial reference from the feature dataset. In order to upgrade them, upgrade the feature dataset's spatial reference, which means the spatial reference of all the feature classes in the dataset will be upgraded.
ArcCatalog's Copy/Paste functionality automatically upgrades the spatial reference of datasets when the output is a 9.2 (or later) geodatabase.
When used on a feature dataset, the M Resolution will not be applied to feature classes contained within a feature dataset.
The XY tolerance property of the upgraded spatial reference will be 2.0 * (9.1 dataset resolution).
Syntax
UpgradeSpatialReference(input_dataset, {xy_resolution}, {z_resolution}, {m_resolution})| Parameter | Explanation | Data Type |
input_dataset | The input dataset whose spatial reference precision will be upgraded. Valid input is a feature class, feature dataset, or raster catalog with a low resolution spatial reference, stored in a 9.2 or current version personal or ArcSDE geodatabase. | Feature Class; Feature Dataset; Raster Catalog |
xy_resolution (Optional) | The value to which the dataset's XY Resolution will be changed as part of the upgrade. The maximum value is the same as the dataset's current XY Resolution. | Double |
z_resolution (Optional) | The value to which the dataset's Z Resolution will be changed as part of the upgrade. The maximum value is the same as the dataset's current Z Resolution. By default, the resolution will be improved by a factor of 4. | Double |
m_resolution (Optional) | The value to which the dataset's M Resolution will be changed as part of the upgrade. The maximum value is the same as the dataset's current M Resolution. By default, the resolution will be improved by a factor of 4. | Double |
Code sample
Upgrade Spatial Reference Example (Python Window)
The following Python window script demonstrates how to use the UpgradeSpatialReference function in immediate mode.
import arcpy
from arcpy import env
env.workspace = "C:/data/data.gdb"
arcpy.UpgradeSpatialReference_management("Euro_WGS", "0.0000000625", "0.0000025", "0.0000025")
Upgrade Spatial Reference Example 2 (Stand-alone Script)
The following standalone script is a simple example of how to apply the UpgradeSpatialReference function in python scripting.
# Name: upgradeSR_Example.py
# Description: upgrade two datasets' spatial references
# Author: ESRI
#Import the system modules
import arcpy
# Set the local parameters
inDataset = "Database Connections/Connection to birch.sde/database.transportFDS"
xyRes = "1.56250000145519E-08"
zRes = "0.0000025"
mRes = "0.0000025"
# Upgrade and specify explicit resolutions
arcpy.UpgradeSpatialReference_management(inDataset, xyRes, zRes, mRes)
# Upgrade and let the 3 resolution parameters default
inDataset = "Database Connections/Connection to birch.sde/database.environmentFDS"
arcpy.UpgradeSpatialReference_management(inDataset, "", "", "")
Environments
This tool does not use any geoprocessing environments.
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes