Calculate Symbology

Summary

Calculates representation symbology and field labels for nautical charts.

ArcGIS Maritime symbology tools are based on representations, which are the symbols that represent features and text fields in the map text display. The calculated representations and text fields use combinations of feature attributes to determine the symbols for particular features in a feature class.

Usage

• INT 1 fields are calculated using a collection of rules that are managed in the specification file named INT1.cxml in the following location:

  • For 32-bit Windows operating systems—<Install location>\Program Files\ArcGIS\MaritimeCharting\Desktop<version>\Common\Symbology
  • For 64-bit Windows operating systems—<Install location>\Program Files (x86)\ArcGIS\MaritimeCharting\Desktop<version>\Common\Symbology

• The feature class representations must already exist on the geodatabase. Representations are added by updating nautical symbology.

• Representation symbol information is managed in the style file named INT1.Style and is installed in the following location:

  • For 32-bit Windows operating systems—<Install location>\Program Files\ArcGIS\Desktop<version>\Styles
  • For 64-bit Windows operating systems—<Install location>\Program Files (x86)\ArcGIS\Desktop<version>\Styles

Syntax

arcpy.nautical.CalculateSymbology(selected_symbology, target_feature_classes, {preserve_free_representations})

Parameter	Explanation	Data Type
selected_symbology	The ArcGIS Maritime visual specification that will be calculated. All —INT1 and S-52 symbols will be calculated. INT1 —The specification for symbols, abbreviations, and terms used on hard-copy navigational charts will be calculated. S-52 —The color and symbol specification for display of Electronic Navigational Charts (ENC) in an Electronic Chart Display and Information System (ECDIS) will be calculated.	String
target_feature_classes	The feature classes in which symbols will be calculated.	Feature Class; Feature Layer
preserve_free_representations (Optional)	Specifies whether free representations will be preserved. PRESERVE_FREE_REPRESENTATIONS —Free representations will not be overwritten within any features. This is the default. OVERWRITE_FREE_REPRESENTATIONS —Free representations will be overwritten within any features.	Boolean

Code sample

CalculateSymbology example (Python window)

The following Python window script demonstrates how to use the CalculateSymbology function.

import arcpy, os, traceback

#Set workspace
arcpy.env.workspace = r'C:\Data\CalculateSymbologyTesting\ChartSchema.gdb'
prod_db = arcpy.env.workspace

#Nautical FDS path
naturalA = os.path.join(prod_db, "Nautical", "NaturalFeaturesA")

# Check for Production Mapping extension
if arcpy.CheckExtension("Foundation") == "Available":
    arcpy.CheckOutExtension("Foundation")
else:
    raise ex("Production Mapping license is unavailable.")

# Check for Nautical extension
if arcpy.CheckExtension("Nautical") == "Available":
    arcpy.CheckOutExtension("Nautical")
else:
    raise ex("Maritime: Charting license is unavailable.")


try:
	print "Running calculate symbology..."
	#Execute tool
	arcpy.CalculateSymbology_nautical("INT1",naturalA,"PRESERVE_FREE_REPRESENTATIONS")
	print "complete"

except ex, (instance):
	print "Error 1"
	arcpy.AddError(instance.parameter)

except arcpy.ExecuteError:
    # Get the geoprocessing error messages
	msgs = arcpy.GetMessage(0)
	msgs += arcpy.GetMessages(2)

	# Return gp error messages for use with a script tool
	arcpy.AddError(msgs)

except:
	# Get the traceback object
	tb = sys.exc_info()[2]
	tbinfo = traceback.format_tb(tb)[0]
	print tbinfo

Environments

• Current Workspace

Licensing information

• Basic: No
• Standard: No
• Advanced: Requires ArcGIS Maritime