com.esri.arcgis.geoprocessing.tools.datamanagementtools
Class UnsplitLine
java.lang.Object
com.esri.arcgis.geoprocessing.AbstractGPTool
com.esri.arcgis.geoprocessing.tools.datamanagementtools.UnsplitLine
- All Implemented Interfaces:
- GPTool
public class UnsplitLine
- extends AbstractGPTool
Aggregates line features based on specified attributes.
The Unsplit Line tool is contained in the Data Management Tools tool box.
Usage tips:
- The attributes of the features which become aggregated by this tool can be summarized or described using a variety of statistic types. The statistic type used to summarize attributes is added to the output feature class as a single field with the following naming standard of statistic type + underscore + input field name. For example, if the input has a field named POP that is summarized, using the SUM statistics type will result in a field named SUM_POP in the output feature class.
- The availability of physical memory may limit the amount (and complexity) of input features that can be processed and dissolved into a single output feature. This limitation could cause an error to occur, as the dissolve process may require more memory than is available. To prevent this, input features may be cut and processed using an adaptive tiling algorithm. To determine the features that have been tiled, run the FREQUENCY tool on the result of this tool, specifying the same field(s) used in the dissolve process for the Frequency Field(s) parameter. Any record with a frequency value of 2 has been tiled. Tile boundaries are preserved in the output features to prevent the creation of features that are too large to be used by ArcGIS. These can be evaluated and removed using either a second dissolve operation or using the merge edit task in ArcMap (1. start editing; 2. select the two features; 3. click Editor\Merge...)
- Null values are excluded from all statistical calculations. For example, the AVERAGE of 10, 5, and NULL is 7.5 ((10+5)/2). The COUNT tool returns the number of values included in the statistical calculation, which in this case is 2.
- The Dissolve Field(s) parameter's Add Field button is used only in ModelBuilder. In ModelBuilder, where the preceding tool has not been run, or its derived data does not exist, the Dissolve Field(s) parameter may not be populated with field names. The Add Field button allows you to add expected fields so you can complete the tool's dialog and continue to build your model.
Constructor Summary |
UnsplitLine()
Creates the Unsplit Line tool with defaults. |
UnsplitLine(java.lang.Object inFeatures,
java.lang.Object outFeatureClass)
Creates the Unsplit Line tool with the required parameters. |
Method Summary |
java.lang.Object |
getDissolveField()
Returns the Dissolve_Field(s) parameter of this tool . |
java.lang.Object |
getInFeatures()
Returns the Input Features parameter of this tool . |
java.lang.Object |
getOutFeatureClass()
Returns the Output Feature Class parameter of this tool . |
java.lang.Object |
getStatisticsFields()
Returns the Statistics Field(s) parameter of this tool . |
java.lang.String |
getToolboxAlias()
Returns the alias of the tool box containing this tool. |
java.lang.String |
getToolboxName()
Returns the name of the tool box containing this tool. |
java.lang.String |
getToolName()
Returns the name of this tool. |
void |
setDissolveField(java.lang.Object dissolveField)
Sets the Dissolve_Field(s) parameter of this tool . |
void |
setInFeatures(java.lang.Object inFeatures)
Sets the Input Features parameter of this tool . |
void |
setOutFeatureClass(java.lang.Object outFeatureClass)
Sets the Output Feature Class parameter of this tool . |
void |
setStatisticsFields(java.lang.Object statisticsFields)
Sets the Statistics Field(s) parameter of this tool . |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
UnsplitLine
public UnsplitLine()
- Creates the Unsplit Line tool with defaults.
Initializes the array of tool parameters with the default values specified when the tool was created.
UnsplitLine
public UnsplitLine(java.lang.Object inFeatures,
java.lang.Object outFeatureClass)
- Creates the Unsplit Line 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:
inFeatures
- the line features to be aggregrated.outFeatureClass
- the feature class to be created that will contain the aggregated features.
getInFeatures
public java.lang.Object getInFeatures()
- Returns the Input Features parameter of this tool .
This parameter is the line features to be aggregrated.
This is a required parameter.
- Returns:
- the Input Features
setInFeatures
public void setInFeatures(java.lang.Object inFeatures)
- Sets the Input Features parameter of this tool .
This parameter is the line features to be aggregrated.
This is a required parameter.
- Parameters:
inFeatures
- the line features to be aggregrated.
getOutFeatureClass
public java.lang.Object getOutFeatureClass()
- Returns the Output Feature Class parameter of this tool .
This parameter is the feature class to be created that will contain the aggregated features.
This is a required parameter.
- Returns:
- the Output Feature Class
setOutFeatureClass
public void setOutFeatureClass(java.lang.Object outFeatureClass)
- Sets the Output Feature Class parameter of this tool .
This parameter is the feature class to be created that will contain the aggregated features.
This is a required parameter.
- Parameters:
outFeatureClass
- the feature class to be created that will contain the aggregated features.
getDissolveField
public java.lang.Object getDissolveField()
- Returns the Dissolve_Field(s) parameter of this tool .
This parameter is the field or fields on which to aggregate features. the Add Field button, which is used only in ModelBuilder, allows you to add expected fields so you can complete the dialog and continue to build your model.
This is an optional parameter.
- Returns:
- the Dissolve_Field(s)
setDissolveField
public void setDissolveField(java.lang.Object dissolveField)
- Sets the Dissolve_Field(s) parameter of this tool .
This parameter is the field or fields on which to aggregate features. the Add Field button, which is used only in ModelBuilder, allows you to add expected fields so you can complete the dialog and continue to build your model.
This is an optional parameter.
- Parameters:
dissolveField
- the field or fields on which to aggregate features. the Add Field button, which is used only in ModelBuilder, allows you to add expected fields so you can complete the dialog and continue to build your model.
getStatisticsFields
public java.lang.Object getStatisticsFields()
- Returns the Statistics Field(s) parameter of this tool .
This parameter is the fields and statistics with which to summarize attributes. Text attribute fields may be summarized using the statistics FIRST or LAST. Numeric attribute fields may be summarized using any statistic. Nulls are excluded from all statistical calculations.
This is an optional parameter.
- Returns:
- the Statistics Field(s)
setStatisticsFields
public void setStatisticsFields(java.lang.Object statisticsFields)
- Sets the Statistics Field(s) parameter of this tool .
This parameter is the fields and statistics with which to summarize attributes. Text attribute fields may be summarized using the statistics FIRST or LAST. Numeric attribute fields may be summarized using any statistic. Nulls are excluded from all statistical calculations.
This is an optional parameter.
- Parameters:
statisticsFields
- the fields and statistics with which to summarize attributes. Text attribute fields may be summarized using the statistics FIRST or LAST. Numeric attribute fields may be summarized using any statistic. Nulls are excluded from all statistical calculations.
getToolName
public java.lang.String getToolName()
- Returns the name of this tool.
- Returns:
- the tool name
getToolboxName
public java.lang.String getToolboxName()
- Returns the name of the tool box containing this tool.
- Returns:
- the tool box name
getToolboxAlias
public java.lang.String getToolboxAlias()
- Returns the alias of the tool box containing this tool.
- Returns:
- the tool box alias