Merge Lines By Pseudo Node (Topographic Production)

Resumen

Dissolves features where pseudo nodes occur.

Uso

    Precaución:

    Esta herramienta modifica los datos de entrada. Consulte Herramientas que modifican o actualizan los datos de entrada para obtener más información y estrategias para evitar cambios de datos no deseados.

  • 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.

Parámetros

EtiquetaExplicaciónTipo de datos
Input Features

The line features from which pseudo nodes will be removed.

Feature Layer
Merge Fields
(Opcional)

The field or fields on which features will be merged.

Field
Aggregate Operations
(Opcional)

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
(Opcional)

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

Salida derivada

EtiquetaExplicaciónTipo de datos
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})
NombreExplicaciónTipo de datos
input_features

The line features from which pseudo nodes will be removed.

Feature Layer
merge_fields
[merge_fields,...]
(Opcional)

The field or fields on which features will be merged.

Field
aggregate_operations
[aggregate_operations,...]
(Opcional)

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
(Opcional)

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

Salida derivada

NombreExplicaciónTipo de datos
updated_features

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

Feature Layer

Muestra de código

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')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: No
  • Standard: Requiere Production Mapping
  • Advanced: Requiere Production Mapping

Temas relacionados