Show Navigation | Hide Navigation
You are here:
Geoprocessing tool reference > Data Management toolbox > Generalization toolset > Tools

Simplify Line (Data Management) (ArcInfo and ArcEditor only)

Release 9.2
Last modified November 29, 2010
E-mail This Topic Printable Version Give Us Feedback

Print all topics in : "Tools"


Related Topics

Simplifies a line by removing small fluctuations or extraneous bends from it while preserving its essential shape.

Learn more about how Simplify Line works


Illustration

Simplify Line illustration

Usage tips

Command line syntax
An overview of the Command Line window
SimplifyLine_management <in_features> <out_feature_class> <POINT_REMOVE | BEND_SIMPLIFY> <tolerance> {FLAG_ERRORS | RESOLVE_ERRORS} {KEEP_COLLAPSED_POINTS | NO_KEEP} {CHECK | NO_CHECK}

Parameter Explanation Data Type
<in_features>

The line features to be simplified.

Feature Layer
<out_feature_class>

The output line feature class to be created.

Feature Class
<POINT_REMOVE | BEND_SIMPLIFY>

Specifies the line simplification algorithm.

  • POINT_REMOVE — Keeps the so-called critical points that depict the essential shape of a line and removes all other points. This is the default.
  • BEND_SIMPLIFY — Keeps the main shape of a line and removes extraneous bends.

String
<tolerance>

The tolerance that determines the degree of simplification. A tolerance must be specified, and it must be greater than zero. You can specify a preferred unit; the default is the feature unit.

  • For POINT_REMOVE algorithm, the tolerance you specify is the maximum allowable offset.
  • For BEND_SIMPLIFY algorithm, the tolerance you specify is the length of the reference bend baseline.

Linear unit
{FLAG_ERRORS | RESOLVE_ERRORS}

Specifies how the topological errors (possibly introduced in the process, including line crossing, line overlapping, and collapsed zero-length lines) will be handled. This parameter will be in effect when the error_checking_option is CHECK (the default).

  • FLAG_ERRORS — Specifies to flag topological errors, if any are found. This is the default.
  • RESOLVE_ERRORS — Specifies to resolve topological errors, if any are found.

String
{KEEP_COLLAPSED_POINTS | NO_KEEP}

Specifies whether to keep collapsed zero-length lines as points if any are found in the process. This option applies only when NO_CHECK is specified or when both FLAG_ERRORS and CHECK options are specified.

  • KEEP_COLLAPSED_POINTS — Specifies to keep the collapsed zero-length lines as points. The endpoints of the collapsed lines will be stored in a point feature class at the output feature class location, taking the name of the output feature class plus a suffix _Pnt. This is the default.
  • NO_KEEP — Specifies not to keep the collapsed zero-length lines as points even if they are found in the process; therefore, the point feature class will be empty.

Boolean
{CHECK | NO_CHECK}

Specifies how the topological errors (possibly introduced in the process, including line crossing, line overlapping, and collapsed zero-length lines) will be handled.

  • CHECK — Specifies to check for topological errors and puts the error_resolving_option parameter in effect. This is the default.
  • NO_CHECK — Specifies not to check for topological errors and disables the error_resolving_option parameter.

String
Data types for geoprocessing tool parameters


Command line example

simplifyline c:\workspace.mdb\roads c:\workspace.mdb\newroads POINT_REMOVE 5

Scripting syntax
About getting started with writing geoprocessing scripts
SimplifyLine_management (in_features, out_feature_class, algorithm, tolerance, error_resolving_option, collapsed_point_option, error_checking_option)

Parameter Explanation Data Type
in_features (Required)

The line features to be simplified.

Feature Layer
out_feature_class (Required)

The output line feature class to be created.

Feature Class
algorithm (Required)

Specifies the line simplification algorithm.

  • POINT_REMOVE — Keeps the so-called critical points that depict the essential shape of a line and removes all other points. This is the default.
  • BEND_SIMPLIFY — Keeps the main shape of a line and removes extraneous bends.

String
tolerance (Required)

The tolerance that determines the degree of simplification. A tolerance must be specified, and it must be greater than zero. You can specify a preferred unit; the default is the feature unit.

  • For POINT_REMOVE algorithm, the tolerance you specify is the maximum allowable offset.
  • For BEND_SIMPLIFY algorithm, the tolerance you specify is the length of the reference bend baseline.

Linear unit
error_resolving_option (Optional)

Specifies how the topological errors (possibly introduced in the process, including line crossing, line overlapping, and collapsed zero-length lines) will be handled. This parameter will be in effect when the error_checking_option is CHECK (the default).

  • FLAG_ERRORS — Specifies to flag topological errors, if any are found. This is the default.
  • RESOLVE_ERRORS — Specifies to resolve topological errors, if any are found.

String
collapsed_point_option (Optional)

Specifies whether to keep collapsed zero-length lines as points if any are found in the process. This option applies only when NO_CHECK is specified or when both FLAG_ERRORS and CHECK options are specified.

  • KEEP_COLLAPSED_POINTS — Specifies to keep the collapsed zero-length lines as points. The endpoints of the collapsed lines will be stored in a point feature class at the output feature class location, taking the name of the output feature class plus a suffix _Pnt. This is the default.
  • NO_KEEP — Specifies not to keep the collapsed zero-length lines as points even if they are found in the process; therefore, the point feature class will be empty.

Boolean
error_checking_option (Optional)

Specifies how the topological errors (possibly introduced in the process, including line crossing, line overlapping, and collapsed zero-length lines) will be handled.

  • CHECK — Specifies to check for topological errors and puts the error_resolving_option parameter in effect. This is the default.
  • NO_CHECK — Specifies not to check for topological errors and disables the error_resolving_option parameter.

String

Data types for geoprocessing tool parameters


Script example

# Simplifying rivers followed by smoothing rivers

import arcgisscripting
gp = arcgisscripting.create()

# Set the workspace
gp.workspace = "d:/data/mapDB.mdb/hydrography"

# Simplifying rivers followed by smoothing rivers
gp.simplifyline("rivers", "rivers_simplified", "BEND_SIMPLIFY", "80", "RESOLVE_ERRORS")
gp.smoothline("rivers_simplified", "rivers_smoothed", "PAEK", "150")

Please visit the Feedback page to comment or give suggestions on ArcGIS Desktop Help.
Copyright © Environmental Systems Research Institute, Inc.