Update (Analysis)

License Level:BasicStandardAdvanced

Summary

Computes a geometric intersection of the Input Features and Update Features. The attributes and geometry of the input features are updated by the update features in the output feature class.

Illustration

Update illustration

Usage

Syntax

Update_analysis (in_features, update_features, out_feature_class, {keep_borders}, {cluster_tolerance})
ParameterExplanationData Type
in_features

The input feature class or layer. Geometry type must be polygon.

Feature Layer
update_features

The features that will be used to update the Input Features. Geometry type must be polygon.

Feature Layer
out_feature_class

The feature class to contain the results. Do not set this to be the same as the Input Features.

Feature Class
keep_borders
(Optional)

Specifies whether the boundary of the update polygon features will be kept.

  • BORDERSThe outside border of the Update Features will be kept in the Output Feature Class. This is the default option.
  • NO_BORDERSThe outside border of the Update Features are dropped after they are inserted into the Input Features. Item values of the Update Features take precedence over Input Features attributes.
Boolean
cluster_tolerance
(Optional)

The minimum distance separating all feature coordinates (nodes and vertices) as well as the distance a coordinate can move in X or Y (or both).

Linear unit

Code Sample

Update Example (Python Window)

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

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Update_analysis ("city_lots.shp", "data.gdb/flood_levels", "data.gdb/low_lots", 
                       "DROP_BORDER", 0.0003)
Update Example 2 (Stand-alone Script)

The following stand-alone script shows how to use the Update function in a scripting environment.

# Name: UpdateZones.py
# Purpose: Update the "lots" feature class with features from "cutzones"
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env
 
# Set the workspace
env.workspace = "c:/data/city.gdb"

# Set local parameters
inFeatures = "lots"
updateFeatures = "cutzones"
outFeatures = "futurecut"

#Process: Update
arcpy.Update_analysis(inFeatures, updateFeatures, outFeatures, "only_fid", 0.25)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: No
ArcGIS for Desktop Advanced: Yes
5/6/2013