com.esri.arcgis.geoprocessing.tools.datamanagementtools
Class Project

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.datamanagementtools.Project

All Implemented Interfaces:

GPTool

public class Project
extends AbstractGPTool

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. The Project tool is contained in the Data Management Tools tool box.

Software restrictions: none

Usage tips:

• All input feature classes; and/or feature layers; feature datasets; in 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; (s) may also be defined within the environment settings, if needed.
• Coverage, VPF Coverage, CAD dataset, raster dataset and catalog are not supported. For projecting Coverage use Project tool in Coverage; toolbox. For projecting CAD dataset, browse properties from the context menu and click on Edit button on General tab. Use Project Raster to project raster dataset.
• 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 become required. Many coordinate system conversions do not require a transformation, which is why the option to provide 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 besides 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.
• 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;

Field Summary

Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

vals

Constructor Summary

Project()
Creates the Project tool with defaults.

Project(Object inDataset, Object outDataset, Object outCoorSystem)
Creates the Project tool with the required parameters.

Method Summary

Object	getInCoorSystem() Returns the Input Coordinate System parameter of this tool .
Object	getInDataset() Returns the Input Dataset or Feature Class parameter of this tool .
Object	getOutCoorSystem() Returns the Output Coordinate System parameter of this tool .
Object	getOutDataset() Returns the Output Dataset or Feature Class parameter of this tool .
String	getToolboxAlias() Returns the alias of the tool box containing this tool.
String	getToolboxName() Returns the name of the tool box containing this tool.
String	getToolName() Returns the name of this tool.
Object	getTransformMethod() Returns the Geographic Transformation parameter of this tool .
void	setInCoorSystem(Object inCoorSystem) Sets the Input Coordinate System parameter of this tool .
void	setInDataset(Object inDataset) Sets the Input Dataset or Feature Class parameter of this tool .
void	setOutCoorSystem(Object outCoorSystem) Sets the Output Coordinate System parameter of this tool .
void	setOutDataset(Object outDataset) Sets the Output Dataset or Feature Class parameter of this tool .
void	setTransformMethod(Object transformMethod) Sets the Geographic Transformation parameter of this tool .

Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

getParameterValues, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Project

public Project()

Creates the Project tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.

Project

public Project(Object inDataset,
               Object outDataset,
               Object outCoorSystem)

Creates the Project tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:

inDataset - Feature Layer | Feature Dataset, the feature class whose coordinates are to be converted.

outDataset - Geodataset, the feature class whose coordinates have been converted into the new coordinate system.

outCoorSystem - Coordinate System, the coordinate system to be applied to the Output Dataset or Feature Class.

Method Detail

getInDataset

public Object getInDataset()

Returns the Input Dataset or Feature Class parameter of this tool . This parameter is Feature Layer | Feature Dataset, the feature class whose coordinates are to be converted. This is a required parameter.

Returns:

the Input Dataset or Feature Class

setInDataset

public void setInDataset(Object inDataset)

Sets the Input Dataset or Feature Class parameter of this tool . This parameter is Feature Layer | Feature Dataset, the feature class whose coordinates are to be converted. This is a required parameter.

Parameters:

inDataset - Feature Layer | Feature Dataset, the feature class whose coordinates are to be converted.

getOutDataset

public Object getOutDataset()

Returns the Output Dataset or Feature Class parameter of this tool . This parameter is Geodataset, the feature class whose coordinates have been converted into the new coordinate system. This is a required parameter.

Returns:

the Output Dataset or Feature Class

setOutDataset

public void setOutDataset(Object outDataset)

Sets the Output Dataset or Feature Class parameter of this tool . This parameter is Geodataset, the feature class whose coordinates have been converted into the new coordinate system. This is a required parameter.

Parameters:

outDataset - Geodataset, the feature class whose coordinates have been converted into the new coordinate system.

getOutCoorSystem

public Object getOutCoorSystem()

Returns the Output Coordinate System parameter of this tool . This parameter is Coordinate System, the coordinate system to be applied to the Output Dataset or Feature Class. This is a required parameter.

Returns:

the Output Coordinate System

setOutCoorSystem

public void setOutCoorSystem(Object outCoorSystem)

Sets the Output Coordinate System parameter of this tool . This parameter is Coordinate System, the coordinate system to be applied to the Output Dataset or Feature Class. This is a required parameter.

Parameters:

outCoorSystem - Coordinate System, the coordinate system to be applied to the Output Dataset or Feature Class.

getTransformMethod

public Object getTransformMethod()

Returns the Geographic Transformation parameter of this tool . This parameter is String, 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 This is an optional parameter.

Returns:

the Geographic Transformation

setTransformMethod

public void setTransformMethod(Object transformMethod)

Sets the Geographic Transformation parameter of this tool . This parameter is String, 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 This is an optional parameter.

Parameters:

transformMethod - String, 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

getInCoorSystem

public Object getInCoorSystem()

Returns the Input Coordinate System parameter of this tool . This parameter is Coordinate System, the coordinate system of the Input Dataset or Feature Class. This is an optional parameter.

Returns:

the Input Coordinate System

setInCoorSystem

public void setInCoorSystem(Object inCoorSystem)

Sets the Input Coordinate System parameter of this tool . This parameter is Coordinate System, the coordinate system of the Input Dataset or Feature Class. This is an optional parameter.

Parameters:

inCoorSystem - Coordinate System, the coordinate system of the Input Dataset or Feature Class.

getToolName

public String getToolName()

Returns the name of this tool.

Returns:

the tool name

getToolboxName

public String getToolboxName()

Returns the name of the tool box containing this tool.

Returns:

the tool box name

getToolboxAlias

public String getToolboxAlias()

Returns the alias of the tool box containing this tool.

Returns:

the tool box alias