ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for 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
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Project

  • Summary
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

Summary

Changes the coordinate system of your coverage including its datum or spheroid.

Learn more about how Project works

Usage

  • This tool can convert a dataset from a spherical coordinate system with angular units (such as Geographic) to a planar coordinate system with linear units. Most Coverage tools, among them Build and Clean, assume you have a planar, two-dimensional dataset. So if your dataset is in a geographic coordinate system in decimal degrees (DD, angular units), the Project tool projects your dataset to any suitable projected coordinate system in linear units (meters or feet).

  • A coverage can maintain an explicit definition of the coordinate system in which it is stored. This can be created using the Define Projection tool. If not defined, the projection will be listed as unknown.

  • Output projection information can be specified using a Project File or from an empty output coverage. The Project File must contain both input and output projection definitions. Use of a Project File will override any projection information stored in the data's PRJ file.

  • Clarke 1866 is the default spheroid if it is not inherent to the projection (such as NEWZEALAND_GRID).

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

  • When projecting a coverage, the Output Coverage can be an existing, empty coverage. The coordinates of the Input Coverage will be projected into the coordinate system defined by the PRJ file of the Output Coverage.

  • Depending on the input and output projection definitions, an arc in the input coverage may need to be clipped into more than one segment while the output coverage is being generated. This will occur whenever an arc 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 an arc, and the partially projected arc will be written to the output. It is possible for an arc to be split into several arcs if subsequent vertices are encountered that can be projected. In this case, the output retains the original IDs so attributes can be relinked. Examine this illustration; arcs 2 and 3 will be clipped by the horizon during projection of the line. The output coverage will contain one arc 2 but two arc 3s. In cases such as these, Project will generate arcs having duplicate User-IDs.

    Project vertexes
  • If regions exist in the input coverage, regions in the output coverage will be preliminary regions. When the Build tool is used to re-create the polygon topology, region topology will also be re-created.

  • List of supported map projections

  • Learn about

    • map projections
    • geographic coordinate systems
    • projected coordinate systems
    • geographic transformation methods

  • To find tables of predefined geographic coordinate system, projected coordinate system, and geographic (datum) transformations, see An overview of map projections.

Syntax

Project_arc (in_cover, out_cover, projection_file)
ParameterExplanationData Type
in_cover

The coverage whose coordinates are to be converted.

Coverage
out_cover

The output coverage whose coordinates have been converted to the new coordinate system. The output coverage may exist, but must be empty.

Coverage
projection_file

The name of a text file defining the input and output projection parameters.

File

Code Sample

Project example (stand-alone script)

The following stand-alone script demonstrates how to project a coverage from a geographic coordinate system into a projected coordinate system.

# Name: Project_Example.py
# Description: Projects a global coverage
# Requirements: ArcInfo Workstation

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inCover = "worldgrat"
outCover = "C:/output/sinusoidcov"
projectionFile = "geo_to_sinusoidal.prj"

# Execute Project
arcpy.Project_arc(inCover, outCover, projectionFile)

Environments

  • Current Workspace
  • Level Of Comparison Between Projection Files
  • Precision For Derived Coverages
  • Precision For New Coverages
  • Scratch Workspace

Licensing Information

  • ArcGIS for Desktop Basic: No
  • ArcGIS for Desktop Standard: No
  • ArcGIS for Desktop Advanced: Requires ArcInfo Workstation installed

Related Topics

  • List of supported map projections
  • About map projections
  • What are geographic coordinate systems?
  • What are projected coordinate systems?
  • Geographic transformation methods
  • An overview of the Projections toolset
  • Define Projection
  • Project
  • Transform
  • What is a coverage?
  • Storing coordinates
  • Choosing a map projection
  • Transforming coverages between NAD27 and NAD83
  • Crossing map projection zones
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal