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)
Parameter | Explanation | Data 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
Name | Explanation | Data 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
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")
Environments
Licensing information
- Basic: No
- Standard: Requires ArcGIS Maritime
- Advanced: Requires ArcGIS Maritime