Update Annotation Reference Scale (Cartography)

Summary

Updates the reference scale of an existing annotation or dimension feature class.

Usage

• Before you can update the reference scale of a feature class, the feature class must be upgraded to the current release using the Upgrade Dataset tool.

Caution:

This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

• You can't update the reference scale of versioned feature classes.

• Changing the reference scale of a feature class is a computationally intensive operation that requires an update of every feature's bounding box geometry.

Parameters

Dialog

Label	Explanation	Data Type
Input Annotation Features	The input annotation or dimension features.	Annotation Layer; Dimension Layer
Reference Scale	The feature class reference scale that will be updated.	Double

Derived Output

Label	Explanation	Data Type
Updated Annotation	The updated annotation or dimensions.	Annotation Layer; Dimension Layer

Python

arcpy.cartography.UpdateAnnotationReferenceScale(in_anno_features, reference_scale)

Name	Explanation	Data Type
in_anno_features	The input annotation or dimension features.	Annotation Layer; Dimension Layer
reference_scale	The feature class reference scale that will be updated.	Double

Derived Output

Name	Explanation	Data Type
updated_annotation	The updated annotation or dimensions.	Annotation Layer; Dimension Layer

Code sample

UpdateAnnotationReferenceScale example (Python window)

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

import arcpy
arcpy.cartography.UpdateAnnotationReferenceScale("C:/data/Canada.gdb/cities", 
                                                 4000000)

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: Yes
• Standard: Yes
• Advanced: Yes