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

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

All Implemented Interfaces:

GPTool

public class RegionClass
extends AbstractGPTool

This tool only works with an ArcInfo license and will only be available in ArcToolbox if you have installed ArcInfo Workstation. Converts arcs to preliminary regions in a new or existing coverageor appends preliminary regions to an existing region subclass. Arcs are grouped into preliminary regions based on the unique value of the Line item and must form closed loops. The unique values are saved in the output subclass Region item. The Line Coverage To Region tool is contained in the Coverage Tools tool box.
Learn more about how Line Coverage To Region works

Software restrictions: ArcInfo only

Illustration:

Usage tips:

• The Input Coverage must have an AAT to specify the Input Region Item.
• To create fully built regions from the preliminary regions, use Clean; (or Build; ) with the POLY option on the Output Coverage.
• The arcs in each group, which are determined by the unique value of the Input Region Item, must form closed loops. When the Input Region Item is not specified, each arc in the Input Coverage becomes a preliminary region and should form a closed loop.
• Depending on the Input Region Item, arcs may be reused in any grouping with repeated use of this command. In this way, duplicate or overlapping preliminary regions may be appended to the same subclass or to different subclasses.
• The Output Region Item may be the same as the Input Region Item.
• If the selection file has no arcs selected, the command will consider all arcs as selected. If the selection file has everything selected, everything is also selected for Line Coverage To Region.
• If a selection file is not specified, all arcs are selected and available for grouping into regions. However, arcs in the Input Coverage that are already part of one or more fully structured regions are not available for appending to the subclass since they may not form closed rings when grouped.
• If the Output Region Item already exists in the PATsubclass, the specified Output Region Item must have the same item definition as the existing one.
• Region subclass names may be from 1 to 13 characters and cannot start with a numeric character.
• When preliminary regions are appended to a subclass, the polygon topology is removed from the Output Coverage (or the Input Coverage) because it needs to be rebuilt.
• Line Coverage To Region does not compute the area of the preliminary regions but sets the area values in the PATsubclass to zero and computes the perimeter. Building; with the POLY option will calculate the area values.
• 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

RegionClass()
Creates the Line Coverage To Region tool with defaults.

RegionClass(Object inCover, String outSubclass)
Creates the Line Coverage To Region tool with the required parameters.

Method Summary

Object	getInCover() Returns the Input Coverage parameter of this tool .
Object	getInRegionItem() Returns the Input Region Item parameter of this tool .
String	getMethod() Returns the Create Regions From parameter of this tool .
Object	getOutCover() Returns the Output Coverage parameter of this tool .
String	getOutRegionItem() Returns the Output Region Item parameter of this tool .
String	getOutSubclass() Returns the Output Subclass parameter of this tool .
Object	getSelectionFile() Returns the Selection File 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	setInCover(Object inCover) Sets the Input Coverage parameter of this tool .
void	setInRegionItem(Object inRegionItem) Sets the Input Region Item parameter of this tool .
void	setMethod(String method) Sets the Create Regions From parameter of this tool .
void	setOutCover(Object outCover) Sets the Output Coverage parameter of this tool .
void	setOutRegionItem(String outRegionItem) Sets the Output Region Item parameter of this tool .
void	setOutSubclass(String outSubclass) Sets the Output Subclass parameter of this tool .
void	setSelectionFile(Object selectionFile) Sets the Selection File 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

RegionClass

public RegionClass()

Creates the Line Coverage To Region tool with defaults.

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

RegionClass

public RegionClass(Object inCover,
                   String outSubclass)

Creates the Line Coverage To Region 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 containing the arcs from which the preliminary regions are created.

outSubclass - String, the name of the region subclass to be created or appended.

Method Detail

getInCover

public Object getInCover()

Returns the Input Coverage parameter of this tool . This parameter is Coverage, the coverage containing the arcs from which the preliminary regions are created. 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 containing the arcs from which the preliminary regions are created. This is a required parameter.

Parameters:

inCover - Coverage, the coverage containing the arcs from which the preliminary regions are created.

getOutCover

public Object getOutCover()

Returns the Output Coverage parameter of this tool . This parameter is Coverage, the coverage that will contain the preliminary regions. If the {out_cover} is not specified, the preliminary regions are created in the . This is an optional parameter.

Returns:

the Output Coverage

setOutCover

public void setOutCover(Object outCover)

Sets the Output Coverage parameter of this tool . This parameter is Coverage, the coverage that will contain the preliminary regions. If the {out_cover} is not specified, the preliminary regions are created in the . This is an optional parameter.

Parameters:

outCover - Coverage, the coverage that will contain the preliminary regions. If the {out_cover} is not specified, the preliminary regions are created in the .

getOutSubclass

public String getOutSubclass()

Returns the Output Subclass parameter of this tool . This parameter is String, the name of the region subclass to be created or appended. This is a required parameter.

Returns:

the Output Subclass

setOutSubclass

public void setOutSubclass(String outSubclass)

Sets the Output Subclass parameter of this tool . This parameter is String, the name of the region subclass to be created or appended. This is a required parameter.

Parameters:

outSubclass - String, the name of the region subclass to be created or appended.

getInRegionItem

public Object getInRegionItem()

Returns the Input Region Item parameter of this tool . This parameter is ArcInfo Item, item in the AAT of the whose values are used to group arcs into preliminary regions. The item is appended to the region PATsubclass. If not specified, each group of arcs becomes a preliminary region. This is an optional parameter.

Returns:

the Input Region Item

setInRegionItem

public void setInRegionItem(Object inRegionItem)

Sets the Input Region Item parameter of this tool . This parameter is ArcInfo Item, item in the AAT of the whose values are used to group arcs into preliminary regions. The item is appended to the region PATsubclass. If not specified, each group of arcs becomes a preliminary region. This is an optional parameter.

Parameters:

inRegionItem - ArcInfo Item, item in the AAT of the whose values are used to group arcs into preliminary regions. The item is appended to the region PATsubclass. If not specified, each group of arcs becomes a preliminary region.

getOutRegionItem

public String getOutRegionItem()

Returns the Output Region Item parameter of this tool . This parameter is String, output name for the {in_region_item} to be used in the region PATsubclass instead of the {in_region_item} name. This is an optional parameter.

Returns:

the Output Region Item

setOutRegionItem

public void setOutRegionItem(String outRegionItem)

Sets the Output Region Item parameter of this tool . This parameter is String, output name for the {in_region_item} to be used in the region PATsubclass instead of the {in_region_item} name. This is an optional parameter.

Parameters:

outRegionItem - String, output name for the {in_region_item} to be used in the region PATsubclass instead of the {in_region_item} name.

getSelectionFile

public Object getSelectionFile()

Returns the Selection File parameter of this tool . This parameter is File, the name of a selection file that can be used to specify a subset of the arcs to be grouped into preliminary regions. This is an optional parameter.

Returns:

the Selection File

setSelectionFile

public void setSelectionFile(Object selectionFile)

Sets the Selection File parameter of this tool . This parameter is File, the name of a selection file that can be used to specify a subset of the arcs to be grouped into preliminary regions. This is an optional parameter.

Parameters:

selectionFile - File, the name of a selection file that can be used to specify a subset of the arcs to be grouped into preliminary regions.

getMethod

public String getMethod()

Returns the Create Regions From parameter of this tool . This parameter is String, determines whether regions will be created from multiple rings of arcs or single rings of arcs. This is an optional parameter.

Returns:

the Create Regions From

setMethod

public void setMethod(String method)

Sets the Create Regions From parameter of this tool . This parameter is String, determines whether regions will be created from multiple rings of arcs or single rings of arcs. This is an optional parameter.

Parameters:

method - String, determines whether regions will be created from multiple rings of arcs or single rings of arcs.

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