Upgrade Spatial Reference (Data Management)

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

Upgrade Spatial Reference graphic
Upgrade Spatial Reference graphic

Usage

Syntax

UpgradeSpatialReference_management (input_dataset, {xy_resolution}, {z_resolution}, {m_resolution})
ParameterExplanationData 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

Related Topics

Licensing Information

ArcView: Yes
ArcEditor: Yes
ArcInfo: Yes

10/27/2014