Rubbersheet Features (Editing)

License Level:BasicStandardAdvanced


Modifies input line features by spatially adjusting them through rubbersheeting, using the specified rubbersheet links, so they are better aligned with the intended target features.


Rubbersheet Features



RubbersheetFeatures_edit (in_features, in_link_features, {in_identity_links}, {method})
ParameterExplanationData Type

Input line features to be adjusted.

Feature Layer

Input line features representing regular links for rubbersheeting.

Feature Layer

Input point features representing identity links for rubbersheeting.

Feature Layer

Rubbersheeting method to be used to adjust features.

  • LINEARThis method is slightly faster and produces good results when you have many links spread uniformly over the data you are adjusting. This is the default.
  • NATURAL_NEIGHBORThis method should be used when you have few links spaced widely apart.

Code Sample

RubbersheetFeatures example 1 (Python window)

The following Python window script demonstrates how to use the RubbersheetFeatures function in immediate mode.

import arcpy
arcpy.env.workspace = "C:/data"
                               "rubbersheet_Links_pnt.shp", "LINEAR")
RubbersheetFeatures example 2 (stand-alone Python script)

The following stand-alone script is an example of how to apply the RubbersheetFeatures function in a scripting environment.

# Name:
# Description: Performs rubbersheeting spatial adjustment using links produced by
#              GenerateRubbersheetLinks, assuming newly updated roads are more
#              accurate than existing base roads. The links go from base road data
#              to corresponding newly updated road data. The links are then
#              analyzed for potential errors; they are finally used to adjust the
#              base roads (a copy is made) to better align with the updated roads.
# Author:      Esri
# -----------------------------------------------------------------------

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.overwriteOutput = True
env.workspace = r"D:\conflationTools\ScriptExamples\data.gdb"

# Set local variables
sourceFeatures = "baseRoads"
targetFeatures = "updateRoads"
grlOutput = "grlinks_out"
grlOutputPts = "grlinks_out_pnt"

search_distance = "300 Feet"
match_fields = "FULLNAME RD_NAME"

qaLocations = "qa_locations"

# Generate rubbersheet links
arcpy.GenerateRubbersheetLinks_edit(sourceFeatures, targetFeatures, grlOutput, search_distance, match_fields)

# ====================================================================================
# Note 1:  The result of GenerateRubbersheetLinks may contain errors; see tool reference.
#          Inspection and editing may be necessary to ensure correct links before using
#          them for rubbersheeting.
#          One of the common errors are intersecting or touching links. Their locations 
#          can be found by the process below.
# ====================================================================================

# Find locations where links intersect or touch; the result contains coincident points
arcpy.Intersect_analysis(grlOutput, qaLocations, "", "", "POINT")

# Delete coincident points
arcpy.DeleteIdentical_management(qaLocations, "Shape")

# ====================================================================================
# Note 2:  At this point you can manually inspect locations in qaLocations; delete or
#          modify links as needed.
# ====================================================================================

# Make a copy of the sourceFeatures for rubbersheeting
arcpy.CopyFeatures_management(sourceFeatures, "sourceFeatures_Copy")

# Use the links for rubbersheeting
arcpy.RubbersheetFeatures_edit("sourceFeatures_Copy", grlOutput, grlOutputPts, "LINEAR")


Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: No
ArcGIS for Desktop Advanced: Yes