Project (Data Management)
Release 9.3 Last modified March 8, 2012	Print all topics in : "Feature tools"

NOTE: This topic was updated for 9.3.1.

Changes the coordinate system of your Input Dataset or Feature Class to a new Output Dataset or Feature Class with the newly defined coordinate system including the datum and spheroid

Usage tips

• All input feature classes, feature layers, and/or feature datasets in a geodatabase are valid inputs to this tool.

• In-memory feature classes, layers, or selection on layers are not supported by the Project tool. The Copy Features tool may be used as an alternative to Project, where the new feature class's coordinate system is specified in the environment settings. A datum transformation may also be defined within the environment settings, if needed.

• Coverage, VPF Coverage, CAD dataset, raster dataset, and catalog are not supported. For projecting Coverages, use the Project tool in the Coverage toolbox. For projecting CAD datasets, browse properties from the context menu and click the Edit button on the General tab. Use Project Raster to project raster datasets.

• You will need to rebuild the network if you project a feature class participating in that network. Topology of a feature class is not affected by the Project tool.

• If you have a feature class that does not have a defined projection, then use the Define Projection tool first.

• Depending on the input and output projection definitions, a line in the input feature class may have to be clipped into more than one segment while the output feature class is being generated. This will occur whenever a line encounters the horizon line or crosses the line of longitude opposite the central meridian.

• Whenever a vertex is encountered that cannot be projected, the previous vertex will be interpreted as the end of a line, and the partially projected line will be written to the output. It is possible for a line to be split into several segments if subsequent vertices are encountered that can be projected.

• Do not name an output file the same as the projection_file, even if the projection_file has a .prj extension.

• All coordinate systems use a datum as the reference to earth's surface. A datum may represent the entire globe (Geocentric), or a specific part (Local). Each transformation is specific to a set of input and output datums, so when a geodataset is being projected from one coordinate system to another, one or more transformations may be required. Many coordinate system conversions do not require a transformation, which is why providing one or more transformations is optional. For example, a geographic transformation is not required when projecting from GCS_North_American_1983 to NAD_1983_UTM_Zone_12N because both the Input and Output Coordinate Systems use the NAD_1983 datum. However, projecting from GCS_North_American_1983 to WGS_1984_UTM_Zone_12N requires a geographic transformation because the Input Coordinate System uses the NAD_1983 datum while the Output Coordinate System uses the WGS_1984 datum. Learn more about datums.

• The Geographic Transformation parameter is initially optional. However, when any projection requires a transformation (see above tip), a green dot appears beside the control, indicating it is required now. Although the label of this parameter's control shows optional (which is static), a drop-down list shows available transformations. While running Project in batch mode, you need to double-click the transformation column to verify whether transformation is required.

• When working with geographic transformations, if no mention is made of the direction, the Geoprocessing Tool will handle the directionality automatically. For example, if converting data from WGS 1984 to NAD 1927, you can pick a transformation called NAD_1927_to_WGS_1984_3 and the software will apply it correctly.

• When using the Project Tool to reproject data participating in relationship classes (as with feature-linked anno in a feature datatset,) relationship classes are maintained and carried over to the output featureclass, with the exception of relates to standalone tables.

• For more information on map projections, see An overview of map projections, and List of supported map projections. For more information on coordinate systems, see About coordinate systems and map projections, About geographic coordinate systems, and About projected coordinate systems.

• Learn more about spatial reference and geoprocessing. For more information on geographic transformations, see Geographic transformation methods.

• The following environments affect this tool: configKeyword, extent, outputCoordinateSystem, scratchWorkspace, Geographic transformations, and workspace.

Command line syntax
An overview of the Command Line window
Project_management <in_dataset> <out_dataset> <out_coor_system> {transform_method;transform_method...} {in_coor_system}

Parameter	Explanation	Data Type
<in_dataset>	The feature class whose coordinates are to be converted.	Feature Layer | Feature Dataset
<out_dataset>	The feature class whose coordinates have been converted into the new coordinate system.	Geodataset
<out_coor_system>	The coordinate system to be applied to the Output Dataset or Feature Class.	Coordinate System
{transform_method;transform_method...}	A method for converting data between two geographic coordinate systems or datums. Depending on the input and output coordinate systems, this parameter may be required. For more information on geographic transformations, see Geographic transformation methods.	String
{in_coor_system}	The coordinate system of the Input Dataset or Feature Class.	Coordinate System

Data types for geoprocessing tool parameters

Command line example

Project_management c:\test_data\dams C:\test_data\dams_projected.shp 'Coordinate Systems\Projected Coordinate Systems\Utm\Nad 1927\NAD 1927 UTM Zone 14N.prj'  NAD_1927_To_NAD_1983_NTv2_Canada

Scripting syntax
About getting started with writing geoprocessing scripts
Project_management (in_dataset, out_dataset, out_coor_system, transform_method, in_coor_system)

Parameter	Explanation	Data Type
in_dataset (Required)	The feature class whose coordinates are to be converted.	Feature Layer | Feature Dataset
out_dataset (Required)	The feature class whose coordinates have been converted into the new coordinate system.	Geodataset
out_coor_system (Required)	The coordinate system to be applied to the Output Dataset or Feature Class.	Coordinate System
transform_method (Optional)	A method for converting data between two geographic coordinate systems or datums. Depending on the input and output coordinate systems, this parameter may be required. For more information on geographic transformations, see Geographic transformation methods.	String
in_coor_system (Optional)	The coordinate system of the Input Dataset or Feature Class.	Coordinate System

Data types for geoprocessing tool parameters

Script example

# Create the Geoprocessor Object
import arcgisscripting
gp = arcgisscripting.create()

# Set the workspace
GP.workspace = "c:/Test_data/Personal GDB/canada.mdb"

# Set the Toolbox
GP.toolbox = "management"

# Set the spatial reference variable
cs = "C:/ArcGIS/Coordinate Systems/Geographic Coordinate Systems/North America/North American Datum 1983.prj"

# Run tool in a try and except
try:
    GP.project (GP.workspace + "/prov/province_buffer1", "province_buffer5", cs, "NAD_1927_To_NAD_1983_NTv2_Canada")

except:
    print GP.GetMessages(2)

Please visit the Feedback page to comment or give suggestions on ArcGIS Desktop Help.
Copyright © Environmental Systems Research Institute, Inc.