Convert S-57 to S-101 Cell (Maritime)

Available with Maritime Charting license.

Summary

Converts the S-57 vector product for storing nautical charting data to the new vector S-101 format.

Usage

  • If you want to load updates, and you do not have a CATALOG file, the updates must be in the same folder as the .000 file. This allows the updates to be automatically applied during the loading process.

  • CATALOG files are supported as an input format.

  • Once the tool runs successfully, a log file will be written to the output location with warning and error messages.

    Note:

    These messages are expected in the log file, because S-57 features and attributes are no longer supported in S-101.

  • The S57to101Configuration.xml file in the resource folder allows you to customize configurable settings such as dataset name when converting to S-101.

    Note:

    Each section in the S57to101Configuration.xml file has information about the section and how to populate the value.

Syntax

arcpy.maritime.ConvertS57ToS101(in_feature_catalogue, in_config_file, input_s57, out_location)
ParameterExplanationData Type
in_feature_catalogue

The S-101 feature catalogue (XML document) from the International Hydrographic Organization (IHO) containing the schema of the features, attributes, and relationships used for encoding the hydrographic data in the S-101 cells.

File
in_config_file

The input XML file that can be used to customize some aspects of the conversion process.

File
input_s57

The input S-57 file with a .000 extension or a CATALOG.031 file that references a collection of S-57 files.

File; Folder
out_location

The directory where the converted cell will be written.

Folder

Derived Output

NameExplanationData Type
out_s101

The full path of the converted S-101 cell if the input is a single S-57 dataset, or the output location if the input is a catalog file.

File; Folder

Code sample

ConvertS57toS101Cell example (Python window)

The following Python window script demonstrates how to use the ConvertS57toS101Cell tool.

import arcpy
arcpy.CheckOutExtension("Nautical")
# Input Feature Catalog
inFeatureCatalog = r"C:\Program Files\ArcGIS\Pro\Resources\Maritime\S-101FC_1.0.0_20180918_esri_spatial_association.xml"
# Input Configuration File
in_config_file= r"C:\Program Files\ArcGIS\Pro\Resources\Maritime\S57to101Configuration.xml"
# Input S-57 file
inS57Cell = r"C:\test_data\converter\ENC_ROOT\US2MI01M\US2MI01M.000"
# Input output location
inOutputLocation = r"C:\test_data\converter\converted_cells"
arcpy.ConvertS57ToS101_maritime(inFeatureCatalog, in_config_file, inS57Cell, inOutputLocation)
arcpy.CheckInExtension("Nautical")

Licensing information

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

Related topics