Calculate Visual Specifications (Production Mapping)
Summary
Contains rules that determine the way features should be depicted. This tool assigns representation rules and builds calculated fields on features for symbolization and labeling using a predefined specification.
Usage
-
Multiple visual specifications can be applied to data layers.
-
The visual specifications table contains all the available visual specifications you can apply to the data.
-
The calculation of the visual specification adds fields to the target feature classes or tables. The number and names of the columns will vary but will include:
- A field that holds the representation rule number
- An override field associated with the representation to store symbol exception information
- An optional new or existing field that holds calculated values
-
The representation rule field contains the number of the symbol being used for the feature class in association with feature class representations.
-
The override field contains exception information on an individual representation.
-
The calculated field contains the value that is produced as part of the selected specification.
Syntax
| Parameter | Explanation | Data Type |
input_layers [input_layers,...] |
The feature layers, feature classes, or tables to which you want to apply the visual specifications. | Feature Layer ; Table |
selected_only |
Indicates whether only selected features from the input_layers parameter are processed.
| Boolean |
input_vs_table_location |
The location of the workspace that contains the visual specifications table. The VST_Specification table can be stored in a personal, file, or enterprise geodatabase. | Workspace |
input_specifications [input_specifications,...] |
The visual specifications you want to apply to the selected feature layers and feature classes. | String |
show_representations |
Indicates whether calculated representations in input_layers are displayed.
| Boolean |
create_label_classes |
Indicates whether calculated fields are displayed as labels.
| Boolean |
preserve_free_representations |
Indicates whether free representations are preserved when the Calculate Visual Specifications tool is run.
| Boolean |
output_layers (Optional) |
Derived output parameter that represents the table after visual specifications have been calculated. | Table View |
Code Sample
The following ArcGIS Python window script calculates visual specifications on Production Mapping sample data.
# import the production mapping toolbox - you may have to alter this path
arcpy.ImportToolbox(r'C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Production Mapping Tools.tbx')
# paths to data
SoCal_ProductLibrary_gdb = "C:\\data\\SoCal_ProductLibrary.gdb"
RoadL = "C:\\data\\SoCal_Sample.gdb\\SoCal\\RoadL"
RoadL_Layer = "RoadL_Layer"
# make a feature layer and add it to the display
arcpy.MakeFeatureLayer_management(RoadL, RoadL_Layer)
# execute the calc visual spec
arcpy.CalculateVisualSpecification_production("RoadL_Layer", "ALL_FEATURES", SoCal_ProductLibrary_gdb, "'SoCal :: 1:250K specification'", "SHOW", "CREATE", "PRESERVE")