Merge Lines By Pseudo Node (Topographic Production)

サマリー

Dissolves features where pseudo nodes occur.

使用法

    注意:

    このツールを実行すると、入力データが変更されます。 詳細と不要なデータの変更を回避するための方法については、「入力データを変更または更新するツール」をご参照ください。

  • Each field from the Input Features parameter value can only be used once as a Merge Field parameter value or as part of an Aggregate Operation parameter value.

  • When a field is used in the Merge Field parameter value, the features on either side of a pseudo node will only be combined if the values in the field match.

  • When a field is used as the Aggregate Operation parameter value, the values from two or more features will be calculated using the statistic specified and the new value will be applied to the combined feature.

  • For fields that aren't chosen as Merge Field or Aggregate Operations parameter values, the Merge Feature Rule parameter value will be used to determine the value applied to the combined feature.

  • Null values are excluded from all statistical calculations.

  • The Aggregate Operations parameter supports Minimum, Maximum, First, and Last options for string fields.

  • Multipart features will be skipped and not processed. You can run the Multipart To Singlepart tool before using this tool to convert multipart features to single-part features.

パラメーター

ラベル説明データ タイプ
Input Features

The line features from which pseudo nodes will be removed.

Feature Layer
Merge Fields
(オプション)

The field or fields on which features will be merged.

Field
Aggregate Operations
(オプション)

Specifies the fields that will be used to calculate the specified statistic. Multiple statistic and field combinations can be specified. Null values are excluded from all statistical calculations.

Text attribute fields can be summarized using first and last statistics. Numeric attribute fields can be summarized using any statistic.

Available statistic types are as follows:

  • Sum—The total value for the specified field will be calculated.
  • Mean—The average for the specified field will be calculated.
  • Minimum—The smallest value for all records of the specified field will be found.
  • Maximum—The largest value for all records of the specified field will be found.
  • Range—The range of values (maximum minus minimum) for the specified field will be calculated.
  • Standard deviation—The standard deviation of values in the specified field will be calculated.
  • Count—The number of values included in statistical calculations will be found. Each value will be counted except null values. To determine the number of null values in a field, create a count on the field in question, create a count on a different field that does not contain null values (for example, the OID if present), and subtract the two values.
  • First—The value of the first record in the input will be used.
  • Last—The value of the last record in the input will be used.
  • Median—The median for all records of the specified field will be calculated.
  • Variance—The variance for all records of the specified field will be calculated.
  • Unique—The number of unique values of the specified field will be counted.

Value Table
Merge Feature Rule
(オプション)

Specifies which feature's attributes will be maintained when two features are merged at a pseudo node.

  • FirstThe feature with the lowest ObjectID and its attributes will be maintained while merging. The value for the fields with a specified aggregation operation will be updated with the calculated value.
  • LastThe feature with the highest ObjectID and its attributes will be maintained while merging. The value for the fields with a specified aggregation operation will be updated with the calculated value.
  • By lengthThe feature with the longest length and its attributes will be maintained while merging. The value for the fields with a specified aggregation operation will be updated with the calculated value.
  • Use defaultsThe feature with the lowest ObjectID will be maintained while merging. The value for the fields with a specified aggregation operation will be updated with the calculated value. The value for fields that are not merge fields or calculated with an aggregation operation will have the value assigned with the default value from the field or subtype when applicable.
String

派生した出力

ラベル説明データ タイプ
Updated Features

The derived output that returns the Input Features with the chosen fields updated.

Feature Layer

arcpy.topographic.MergeLinesByPseudoNode(input_features, {merge_fields}, {aggregate_operations}, {merge_feature_rule})
名前説明データ タイプ
input_features

The line features from which pseudo nodes will be removed.

Feature Layer
merge_fields
[merge_fields,...]
(オプション)

The field or fields on which features will be merged.

Field
aggregate_operations
[aggregate_operations,...]
(オプション)

Specifies the fields that will be used to calculate the specified statistic. Multiple statistic and field combinations can be specified. Null values are excluded from all statistical calculations.

Text attribute fields can be summarized using first and last statistics. Numeric attribute fields can be summarized using any statistic.

Available statistic types are as follows:

  • SUM—The total value for the specified field will be calculated.
  • MEAN—The average for the specified field will be calculated.
  • MIN—The smallest value for all records of the specified field will be found.
  • MAX—The largest value for all records of the specified field will be found.
  • RANGE—The range of values (maximum minus minimum) for the specified field will be calculated.
  • STD—The standard deviation of values in the specified field will be calculated.
  • COUNT—The number of values included in statistical calculations will be found. Each value will be counted except null values. To determine the number of null values in a field, create a count on the field in question, create a count on a different field that does not contain null values (for example, the OID if present), and subtract the two values.
  • FIRST—The value of the first record in the input will be used.
  • LAST—The value of the last record in the input will be used.
  • MEDIAN—The median for all records of the specified field will be calculated.
  • VARIANCE—The variance for all records of the specified field will be calculated.
  • UNIQUE—The number of unique values of the specified field will be counted.

Value Table
merge_feature_rule
(オプション)

Specifies which feature's attributes will be maintained when two features are merged at a pseudo node.

  • FIRSTThe feature with the lowest ObjectID and its attributes will be maintained while merging. The value for the fields with a specified aggregation operation will be updated with the calculated value.
  • LASTThe feature with the highest ObjectID and its attributes will be maintained while merging. The value for the fields with a specified aggregation operation will be updated with the calculated value.
  • BY_LENGTHThe feature with the longest length and its attributes will be maintained while merging. The value for the fields with a specified aggregation operation will be updated with the calculated value.
  • USE_DEFAULTSThe feature with the lowest ObjectID will be maintained while merging. The value for the fields with a specified aggregation operation will be updated with the calculated value. The value for fields that are not merge fields or calculated with an aggregation operation will have the value assigned with the default value from the field or subtype when applicable.
String

派生した出力

名前説明データ タイプ
updated_features

The derived output that returns the in_features with the chosen fields updated.

Feature Layer

コードのサンプル

MergeLinesByPseudoNode example (stand-alone script)

The following code sample demonstrates how to use the MergeLinesByPseudoNode function.

# Name: MergeLinesByPseudoNode_sample.py
# Description: Merges rail line features where pseudo nodes occur

# Import System Modules
import arcpy

# Check Out Extensions
arcpy.CheckOutExtension('Foundation')

# Set workspace
arcpy.env.workspace = r'C:\Data\Transportation.gdb'

# Setting Local Variables
input_features = r'RailLines'
merge_fields = 'FCSubtype;FNA;OnBoundary;RWC'
aggregate_operations = 'LZN SUM'
merge_feature_rule = 'FIRST'

# Execute Merge Lines By Pseudo Node
arcpy.topographic.MergeLinesByPseudoNode(input_features, merge_fields, aggregate_operations, merge_feature_rule)

# Check In Extensions
arcpy.CheckInExtension('Foundation')

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: No
  • Standard: 次のものが必要 Production Mapping
  • Advanced: 次のものが必要 Production Mapping

関連トピック