Expand Collapsed Contours (Maritime)

Available with ArcGIS Maritime license.

Summary

Expands (pulls apart) contour lines that are snapped together. This preserves representative depth areas.

Usage

Caution:

This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

• Collapsed vertices (either within a contour or between contours) are pulled apart where possible by pulling them toward the line made between neighboring vertices. Where the angle is too shallow to allow an offset of the specified expansion distance, that vertex will be removed.

• The tool modifies the features in the Target Contours parameter.

• The tool deletes zero-length features.

• The tool snaps points to 10 times the x,y resolution of the target contours when determining collapsed vertices.

• Duplicate vertices on contours are removed.

• The tool messages the feature object ID and collapsed vertices it expands.

• When a collapsed vertex involves an endpoint of a floating contour, a warning message is generated in the output. Ensure that you review any instances identified.

• The Expansion Distance parameter is optional. The default is five times S-57 precision (0.0000005).

Parameters

Dialog

Label	Explanation	Data Type
Target Contours	The feature class containing the contours to be expanded.	Feature Layer
Expansion Distance (Optional)	The distance that contours will be expanded based on the coordinate system of the target contours. The default is 5e-7 decimal degrees based on the WGS84 geographic coordinate system.	Double

Derived Output

Label	Explanation	Data Type
Updated Contours	The updated feature class.	Feature Layer

Python

arcpy.maritime.ExpandCollapsedContours(target_contours, {expansion_distance})

Name	Explanation	Data Type
target_contours	The feature class containing the contours to be expanded.	Feature Layer
expansion_distance (Optional)	The distance that contours will be expanded based on the coordinate system of the target contours. The default is 5e-7 decimal degrees based on the WGS84 geographic coordinate system.	Double

Derived Output

Name	Explanation	Data Type
updated_contours	The updated feature class.	Feature Layer

Code sample

ExpandCollapsedContours example (Python window)

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

# Import arcpy module  

import arcpy  

 

# Check for Nautical extension  

if arcpy.CheckExtension("nautical") == "Available": 

   arcpy.CheckOutExtension("nautical")  

   print ("License checked out successfully ....")  

   else:  

   raise ex("Maritime license is unavailable.")  

 

#Tool variables  

target_contours = r"C:\ExpandCollapsedContours\Contours.gdb\Nautical\DepthsL" 

expansion_distance = 5E-07 

 

# Run the tool  

arcpy.maritime.ExpandCollapsedContours(target_contours,expansion_distance)

Environments

This tool does not use any geoprocessing environments.

Licensing information

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