com.esri.arcgis.geoprocessing.tools.coveragetools
Class Transform

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.coveragetools.Transform

All Implemented Interfaces:

GPTool

public class Transform
extends AbstractGPTool

This tool only works with an ArcInfo license and will only be available in ArcToolbox if you have installed ArcInfo Workstation. Moves all features in the coverage based on a set of from and to control points. The tool is contained in the Coverage Tools tool box.
Learn more about how Transform works

Software restrictions: ArcInfo only

Illustration:

Usage tips:

• The Output Coverage must already exist with a tic; file containing x,y coordinates for at least two in the desired location and units. Except for the tics, any existing features in the Output Coverage will be replaced by features from the Input Coverage.
• The input coverage tic file and the output coverage tic file must contain at least two that have the same Tic-IDs and represent corresponding locations in both coverages. The two coverages do not have to have identical tics; only those tics whose IDs are common to both coverages will be used in the transformation.
• The tolerances of the input coverage will be transformed and retained in the tol file of the output coverage.
• At least one more than the required minimum is needed to generate an RMS error with coordinate transformation.
• Since the default $ANGLE value is 0, label points that have not been rotated will remain unrotated in the output. However, if the $ANGLE value of some labels are set, the transform angle will be added to the label angles.
• All annotation subclasses present in the input coverage will be transformed to the output coverage. The position and size of input coverage annotation are transformed in the output coverage.
• Existing section tables will be copied to the output coverage. The relation between the sections and the arcs will be maintained by the transform process.
• Region information will be maintained.
• The coordinate precision of the output coverage may not be the same as the precision of the input coverage. Precision is determined by the value of the applicable precision environment at the time the coverage was created. This can be done with the Create Coverage (Coverage); tool.
• Feature attributes (that is, LENGTH, AREA, and PERIMETER) from the input coverage are updated after they are transformed.
• The AFFINE transformation scales, skews, rotates, and translates all coordinates in the coverage using the same equation. Based on a minimum of three control points, this transformation can scale the x coordinates differently than the y coordinates. An AFFINE transformation can perform plane reflections as well.
• The SIMILARITY transformation scales, rotates, and translates the coverage coordinates using an equation whose parameters are generated from the coordinates. If you use the SIMILARITY option, you can use two or more tics to calculate the equation parameters. This transformation cannot apply differential scaling or skewing to the x and y coordinates, but may be useful to edgematch scanner output where a scanned map has been cut into several sections to fit on the scanner.
• Use the PROJECTIVE transformation option only if your Input Coverage was digitized directly off aerial photographs. The accuracy of the transformation will depend on the surface terrain being photographed, the angle between the camera and the ground, and the elevation from which the photograph was taken. The best results are obtained when photographing from higher elevations and located directly above a portion of the surface that is relatively flat. PROJECTIVE needs at least four control points to calculate the transformation.
• The least squares solution is used to determine the transformation. To detect errors in the tic locations or Tic-IDs that could produce an incorrect transformation, it is recommended that you provide at least one more than the minimum number of tics required.
• Note that this tool scales, skews, rotates, and shifts all coordinates in a coverage, but it does not perform "rubber sheeting".
• The following environments affect this tool: derivedPrecision; newPrecision; projectCompare; scratchWorkspace; , and workspace;

Field Summary

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

vals

Constructor Summary

Transform()
Creates the tool with defaults.

Transform(Object inCover, Object outCover)
Creates the tool with the required parameters.

Method Summary

Object	getInCover() Returns the Input Coverage parameter of this tool .
Object	getOutCover() Returns the Output Coverage parameter of this tool .
Object	getOutCoverage() Returns the Output Coverage parameter of this tool (Read only).
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.
String	getTransformType() Returns the Transformation Type parameter of this tool .
void	setInCover(Object inCover) Sets the Input Coverage parameter of this tool .
void	setOutCover(Object outCover) Sets the Output Coverage parameter of this tool .
void	setTransformType(String transformType) Sets the Transformation Type 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

Transform

public Transform()

Creates the tool with defaults.

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

Transform

public Transform(Object inCover,
                 Object outCover)

Creates the 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:

inCover - Coverage, the coverage whose coordinates are to be transformed.

outCover - Coverage, . The features from the will be transformed into this coverage.

Method Detail

getInCover

public Object getInCover()

Returns the Input Coverage parameter of this tool . This parameter is Coverage, the coverage whose coordinates are to be transformed. This is a required parameter.

Returns:

the Input Coverage

setInCover

public void setInCover(Object inCover)

Sets the Input Coverage parameter of this tool . This parameter is Coverage, the coverage whose coordinates are to be transformed. This is a required parameter.

Parameters:

inCover - Coverage, the coverage whose coordinates are to be transformed.

getOutCover

public Object getOutCover()

Returns the Output Coverage parameter of this tool . This parameter is Coverage, . The features from the will be transformed into this coverage. This is a required parameter.

Returns:

the Output Coverage

setOutCover

public void setOutCover(Object outCover)

Sets the Output Coverage parameter of this tool . This parameter is Coverage, . The features from the will be transformed into this coverage. This is a required parameter.

Parameters:

outCover - Coverage, . The features from the will be transformed into this coverage.

getTransformType

public String getTransformType()

Returns the Transformation Type parameter of this tool . This parameter is String, the type of coordinate transformation to be performed: This is an optional parameter.

Returns:

the Transformation Type

setTransformType

public void setTransformType(String transformType)

Sets the Transformation Type parameter of this tool . This parameter is String, the type of coordinate transformation to be performed: This is an optional parameter.

Parameters:

transformType - String, the type of coordinate transformation to be performed:

getOutCoverage

public Object getOutCoverage()

Returns the Output Coverage parameter of this tool (Read only). This is an derived parameter.

Returns:

the Output Coverage

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