ArcMap

Add Representation Fields

Summary

Production Mapping configuration tool that applies representation symbology to the input features. This tool applies symbology to 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 add the necessary representation fields. The Calculate Visual Specifications tool can be used to perform additional operations, but is more suited for use with a single map sheet.

  • You can apply multiple visual specifications to multiple input features.

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

  • This tool adds fields to 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.AddRepresentationFields(in_features, in_visual_spec_workspace, in_specs)
ParameterExplanationData Type
in_features
[in_features,...]

The feature classes where the visual specifications field will be added.

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 added.

Feature Layer

Code sample

AddRepresentationFields example 1 (stand-alone script)

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

# Running Add Representation Fields with preset feature classes

# Importing arcpy module
import arcpy

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

# Setting input variables
features = 'C:\Data\MGCP_TRD_4_2.gdb\MGCP_Delta\ElevP;C:\Data\MGCP_TRD_4_2.gdb\MGCP_Delta\ContourL'
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(features, specification_database, specification)

# Checking in Production Mapping extension
arcpy.CheckInExtension('foundation')
AddRepresentationFields example 2 (stand-alone script)

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

# Running Add 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)

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

Environments

Licensing information

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

Related topics