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

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

All Implemented Interfaces:

GPTool

public class Renode
extends AbstractGPTool

Updates arc–node topology by renumbering nodes for the input coverage arcs and identifies arcs that share the same node locations. The Renumber Nodes tool is contained in the Coverage Tools tool box.

Usage tips:

• If you specify one elevation item, you must specify the other. These items must be numeric.
• Using From Node Elevation Item and To Node Elevation Item can create more nodes than are actually present. To delete unwanted nodes, run the tool again without specifying these items.
• If the input coverage has a node attribute table (NAT), Renumber Nodes does the same thing as with the NODE option.
• All nodes in the input coverage are sequentially renumbered starting with 1.
• All feature attribute tables as well as polygon topology and arc–node topology are maintained by Renumber Nodes.
• Renumber Nodes updates the arc–node topology by renumbering the From Node Elevation Item and To Node Elevation Item of each arc and identifying arcs that share the same node locations. Renumber Nodes renumbers the internal node numbers for each arc, assigns the same node number for arcs that share a common node location, and updates the FNODE# and TNODE# items in the AAT when it exists.If you want to run Renumber Nodes on a coverage in the AAT, both of these items must be present and specified for the Renumber Nodes process to work while building nodes.
• Renumber Nodes dissolves coincident and duplicate nodes into single nodes. Use Renumber Nodes with caution. For example, while modeling freeway ramps, you may run into situations having coincident arcs in different planes with multiple nodes sharing the same x,y coordinates. Running with the LINE option will preserve this topology. However, running Renumber Nodes will collapse the coincident nodes into single nodes and destroy the topology.
• with POLY will eliminate overpass/underpass situations. Coincident nodes at different elevations will dissolve.
• The term "elevation" as referenced here is relative. It doesn't need to be the real world or three dimensional elevation. Rather, it signifies the elevation of the ends of an arc relative to another arc that it may meet or cross. Its primary use is in building the arc-node topology to reflect transportation network situations, such as an overpass/underpass.
• You can model an underpass/overpass situation by giving one set of node elevation values to arcs AB, BC, while arcs XY, YZ could share a different set of node elevation values. Running Renumber Nodes with the elevation arguments will actually retain two distinct nodes at the cross point. As in real life, this will prevent a path between nodes A and Z. Many transportation data vendors make such information available in their data products.
• The "elevation" values for all nodes where there is no conflict could be set to zero. Only in cases where there are multiple nodes sharing the same x,y coordinates will the elevation values be looked up to determine whether they are in the same plane and dissolved or in different planes and retained.
• The coordinate precision of the coverage is unaffected by Renumber Nodes.
• Overlay commands, such as and will honor these extra nodes and preserve topology.

Field Summary

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

vals

Constructor Summary

Renode()
Creates the Renumber Nodes tool with defaults.

Renode(Object inCover)
Creates the Renumber Nodes tool with the required parameters.

Method Summary

String	getFromItem() Returns the From Node Elevation Item parameter of this tool .
Object	getInCover() Returns the Input Coverage parameter of this tool .
Object	getOutCover() Returns the Output Coverage parameter of this tool (Read only).
String	getToItem() Returns the To Node Elevation Item 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.
void	setFromItem(String fromItem) Sets the From Node Elevation Item parameter of this tool .
void	setInCover(Object inCover) Sets the Input Coverage parameter of this tool .
void	setToItem(String toItem) Sets the To Node Elevation Item 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

Renode

public Renode()

Creates the Renumber Nodes tool with defaults.

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

Renode

public Renode(Object inCover)

Creates the Renumber Nodes 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 - the coverage whose nodes will be renumbered.

Method Detail

getInCover

public Object getInCover()

Returns the Input Coverage parameter of this tool . This parameter is the coverage whose nodes will be renumbered. 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 the coverage whose nodes will be renumbered. This is a required parameter.

Parameters:

inCover - the coverage whose nodes will be renumbered.

getFromItem

public String getFromItem()

Returns the From Node Elevation Item parameter of this tool . This parameter is the item signifying the elevation of the from_node of each arc. This is an optional parameter.

Returns:

the From Node Elevation Item

setFromItem

public void setFromItem(String fromItem)

Sets the From Node Elevation Item parameter of this tool . This parameter is the item signifying the elevation of the from_node of each arc. This is an optional parameter.

Parameters:

fromItem - the item signifying the elevation of the from_node of each arc.

getToItem

public String getToItem()

Returns the To Node Elevation Item parameter of this tool . This parameter is the item signifying the elevation of the to_node of each arc. This is an optional parameter.

Returns:

the To Node Elevation Item

setToItem

public void setToItem(String toItem)

Sets the To Node Elevation Item parameter of this tool . This parameter is the item signifying the elevation of the to_node of each arc. This is an optional parameter.

Parameters:

toItem - the item signifying the elevation of the to_node of each arc.

getOutCover

public Object getOutCover()

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