ArcMap

Calculate Representation Fields

Summary

Production Mapping configuration tool that calculates representation symbology to the input features. This tool calculates symbology for many layers and links feature attributes to representation rules and label expressions.

Usage

  • This tool can be run in batch, on large datasets, or on a server, but will only calculate the necessary representation fields. The Calculate Visual Specifications geoprocessing tool can be used to perform additional operations, but is more suited for use with a single map sheet.

  • You can calculate multiple visual specifications to multiple input feature layers.

  • The Input Visual Specifications Workspace contains the visual specifications you can apply to input features.

  • This tool calculates fields for the input features. The number and names of the fields will vary but will include the following:

    • A field that holds the representation rule number. This is known as the representation rule field.
    • An Override field associated with the representation to store symbol exception information. The Override field contains exception information on an individual representation.

  • The Representation Rule field contains the number of the symbol being used for the feature class in association with feature class representations.

Syntax

arcpy.production.CalculateRepresentationFields(in_features, in_visual_spec_workspace, in_specs)
ParameterExplanationData Type
in_features
[in_features,...]

The feature classes for which you want the visual specifications field calculated.

Feature Layer
in_visual_spec_workspace

The location of the workspace that contains the visual specifications table (VST_Specification). This table can be stored in a personal, file, or enterprise geodatabase.

Workspace
in_specs
[in_specs,...]

The visual specifications you want to apply to the selected feature layers and feature classes.

String

Derived Output

NameExplanationData Type
out_features

Input Features with representation fields calculated.

Code sample

CalculateRepresentationFields example 1 (stand-alone script)

The following code example demonstrates how to execute the CalculateRepresentationFields tool.

# Running Calculate Representation Fields on preset feature classes

#Importing arcpy module
import arcpy

# Checking out Production Mapping extension
arcpy.CheckOutExtension('foundation')

# Set up input features, visual specification database, and specification
features = "C:\Data\MGCP_TRD_4_2.gdb\MGCP\AerofacA;C:\Data\MGCP_TRD_4_2.gdb\MGCP\AerofacP"
visualSpecification = r'C:\MGCP\Cartography\Symbology\MGCP_TRD_4_2_MTM_Visual_Specification.gdb'
specification = "'MGCP_50K :: MGCP TRD 4.3 Visual Specification for MGCP Topographic Map (MTM)'"

# Running Add Representation Fields tool (if the representation fields do not already exist)
arcpy.AddRepresentationFields_production(features, visualSpecification, specification)

# Running Calculate Representation Fields tool
arcpy.CalculateRepresentationFields_production(features, visualSpecification, specification)
CalculateRepresentationFields example 2 (stand-alone script)

The following code example demonstrates how to execute the CalculateRepresentationFields tool.

# Running Calculate Representation Fields while getting the features from a database

# Importing arcpy, os and string modules
import arcpy, os, string

# Checking out Production Mapping extension
arcpy.CheckOutExtension('foundation')

# Setting input database
input_database = r'C:\Data\MGCP_TRD_4_2.gdb'

# Getting feature classes from database
arcpy.env.workspace = input_database
feature_classes = []
feature_datasets = arcpy.ListDatasets('*', 'Feature')
for dataset in feature_datasets:
    fclass = arcpy.ListFeatureClasses('*', '', dataset)
    for fc in fclass:
        feature_classes.append(os.path.join(input_database, dataset, fc))

# Converting feature classes into layers
layer_list = []
for feat_class in feature_classes:
    class_name = string.split(os.path.split(feat_class)[1], '.')[-1]
    arcpy.management.MakeFeatureLayer(feat_class, class_name)
    layer_list.append(class_name)

# Creating string for input to Add Representation Fields tool
feature_string = ''
for layer in layer_list:
    feature_string += '{};'.format(layer)

# Setting input variables
specification_database = r'C:\MGCP\Cartography\Symbology\MGCP_TRD_4_2_MTM_Visual_Specification.gdb'
specification = 'MGCP_50K :: MGCP TRD 4.2 Visual Specification for MGCP Topographic Map (MTM)'

# Calling Add Representation Fields tool
arcpy.AddRepresentationFields_production(feature_string, specification_database, specification)

# Calling Calculate Representation Fields tool
arcpy.CalculateRepresentationFields_production(feature_string, specification_database, specification)

# Checking in Production Mapping extension
arcpy.CheckInExtension('foundation')

Environments

Licensing information

  • Basic: No
  • Standard: Requires Production Mapping
  • Advanced: Requires Production Mapping

Related topics