Summary
Changes the coordinate system of your coverage including its datum or spheroid.
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.
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.
Learn about
To find tables of predefined geographic coordinate system, projected coordinate system, and geographic (datum) transformations, see An overview of map projections.
Syntax
Project(in_cover, out_cover, projection_file)
Parameter | Explanation | Data 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
Licensing information
- Basic: No
- Standard: No
- 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