Generate Cartographic Limits (Nautical)
Summary
Makes it easy to remove coincident features along a coastline and eliminates masks. This improves cartographic display of nautical digital and hard-copy charts in the following manner:
- Establishes a seaward limit of features coincident to a coastline
- Reduces the number of features rendered on a chart
- Decreases drawing and export times of nautical products
Coincident features that reside in Source Features are removed from Input Production Features. Source Features remain unchanged while Input Production Features are updated for use in your nautical charts.
This model generates cartographic limits by:
- Converting polygons to polylines,
- Splitting lines where they are coincident with the coastline, and
- Deleting segments that are coincident with the coastline.
Usage
This tool processes newly created and existing features in Input Production Features that are coincident to the coastline.
Erase Features are coastline polylines that correspond to the CoastlineL feature class in the ArcGIS for Maritime: Charting data model. These polylines are used to erase the coincident features from the polyline output of Source Features.
Input Production Features are polylines used for display. These features are joined to the output of the erase operation on Source Features. The product of this join is deleted. This removes the features that are coincident to the coastline. Anything left over is not coincident to the coastline and displays in your chart.
Syntax
| Parameter | Explanation | Data Type |
Source_Features |
Polygon features that are coincident to the coastline. The polygons are converted to polylines and then split at vertices. | Feature Layer |
Erase_Features |
Coastline polylines used to identify coincident Source Features to remove from Input Production Features. | Feature Layer |
Input_Production_Features |
The cartographic features used for display in the output chart. Source Features that are coincident to Erase Features are removed from this preexisting feature class. | Feature Layer |
Join_Fields_from_Source_to_Scratch_Features [Join_Fields_from_Source_to_Scratch_Features,...] (Optional) |
Join field used to pull in attributes from Source Features to the erased output. The default is NOID. | Field |
Code Sample
The following stand-alone script demonstrates how to use the GenerateCartographicLimits tool.
# Name: GenerateCartoLimits_Example.py
# Description: Removes edges from input production features that are coincident to the coastline.
# Requirements: Esri Nautical Solution
import arcpy
# create a feature layer for the source features
inAnno = r'C:\data\nautical.sde\Micklefirth.DBO.Nautical\Micklefirth.DBO.RegulatedAreasAndLimitsA'
# the coastline (erase) features
inEraseFeatures = r'C:\data\nautical.sde\Micklefirth.DBO.Nautical\Micklefirth.DBO.CoastlineL'
# the cartographic features (production)
inProductionFeatures = r'C:\data\nautical.sde\Micklefirth.DBO.CartographicFeatures\Micklefirth.DBO.RegulatedA_L'
# import the toolbox
print 'Importing the nautical toolbox'
arcpy.ImportToolbox(r'C:\Program Files (x86)\ArcGIS\EsriNautical\Desktop10.1\ArcToolbox\Toolboxes\Nautical Tools.tbx')
# execute the GenerateAnnotationMasks tool
print 'Executing the GenerateCartographicLimits using \n' + inAnno + '\n' + inEraseFeatures + '\n' + inProductionFeatures
arcpy.GenerateCartographicLimits_nautical(inAnno, inEraseFeatures, inProductionFeatures)
print 'Successfully generated carto limits in ' + inProductionFeatures