Update Annotation Reference Scale (Cartography Tools)

Summary

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

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.

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

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

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

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

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)

This tool does not use any geoprocessing environments.