Copy S-57 Features (Maritime)

Available with ArcGIS Maritime license.

Summary

Copies features from a layer or multiple layers to a target geodatabase.

This tool also finds S-57 structure-equipment and collection relationships from the source layers and copies them to the target workspace. The existing compilation scale attribute value can be either preserved or overridden with a custom value.

Usage

• If no value is specified for the Compilation Scale parameter, the attribute value of the input feature will be preserved.

• This tool copies related structure-equipment and collections records.

• The Input Features and Target Workspace values must be Maritime schemas.

  Tip:

  Choose the Maritime workspace .xml file to create a Maritime database based on the S-57 product you want to use. For example, NAUTICAL_ENC_TEMPLATE_GX_EXTCLSID.xml provides the schema for an ENC product. The default file location is <ArcGIS Maritime installation_location>\ArcGIS Maritime\Product Files\<version>\S-57, provided the Maritime product files are installed.

• The NIS_VERIFIED field attribute is set to Not Verified on copied features.

Parameters

Dialog

Label	Explanation	Data Type
Input Features	The input features that will be copied to the Target Workspace parameter value.	Feature Layer
Target Workspace	The geodatabase where the output data will be written.	Workspace
Compilation Scale (Optional)	The compilation scale attribute value that will be applied to the copied features.	Long
Copy Dataset Name Field (Optional)	Specifies whether the dataset name attribute will be included when features are copied. Checked—The dataset name field will be included in the attributes of copied S-57 features. Unchecked—The dataset name field will not be included in the attributes of copied S-57 features. This is the default.	Boolean

Derived Output

Label	Explanation	Data Type
Updated Workspace	The updated workspace.	Output

Python

arcpy.maritime.CopyS57Features(in_features, target_workspace, {compilation_scale}, {copy_dsnm_field})

Name	Explanation	Data Type
in_features [in_features,...]	The input features that will be copied to the target_workspace parameter value.	Feature Layer
target_workspace	The geodatabase where the output data will be written.	Workspace
compilation_scale (Optional)	The compilation scale attribute value that will be applied to the copied features.	Long
copy_dsnm_field (Optional)	Specifies whether the dataset name attribute will be included when features are copied. COPY_DSNM_FIELD—The dataset name field will be included in the attributes of copied S-57 features. NO_DSNM_FIELD—The dataset name field will not be included in the attributes of copied S-57 features. This is the default.	Boolean

Derived Output

Name	Explanation	Data Type
updated_workspace	The updated workspace.	Output

Code sample

CopyS57Features example (Python window)

The following code sample demonstrates how to use the CopyS57Features function with a database with the Nautical Chart schema.

# Import arcpy module
import arcpy

# Tool variables
in_features = [r"C:\Data\Import\NIS.gdb\AidsToNavigationP", r"C:\Data\Import\NIS.gdb\OffshoreInstallationsP"]
target_workspace = r"C:\Data\Import\NIS.gdb"
compilation_scale = 20000
copy_dsnm_field = COPY_DSNM_FIELD

#Run the tool
arcpy.maritime.CopyS57Features(in_features, target_workspace, compilation_scale, copy_dsnm_field)

Environments

This tool does not use any geoprocessing environments.

Licensing information

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