Import S-100 Feature Catalogue (Maritime)

Available with ArcGIS Maritime license.

Summary

Imports the contents of an S-100 feature catalogue to an existing geodatabase. A feature catalogue is an XML document that describes the content of a data product.

Examples of S-100 data products include the following:

  • S-101 Electronic Navigational Chart
  • S-128 Catalogue of Nautical Products
  • S-201 Aids to Navigation Information

Usage

  • The Target Workspace parameter value must already exist and be either a file or an enterprise geodatabase. To create an empty geodatabase, use the Create File Geodatabase tool.

  • The feature catalogue must be in XML format.

  • Do not use this tool to update or upgrade a geodatabase that contains existing data or schema.

  • This tool is intended for the initial import of an S-100 feature catalogue to a geodatabase. If multiple geodatabases of the same S-100 standard are needed, it is recommended that you copy the geodatabase after running this tool.

  • WGS84 is the default coordinate system. A different coordinate system can be specified for localized datasets using the Coordinate System parameter if necessary.

    Learn more about working with coordinate systems

  • For S-101, it is recommended that you use an x,y resolution of 1e-8 decimal degrees and an x,y tolerance of 3.5355339e-8 decimal degrees. You can update these values on the Environments tab of the Geoprocessing pane.

Parameters

LabelExplanationData Type
S-100 Feature Catalogue

An .xml file that follows the S-100 Feature Catalogue format as defined by the IHO. It describes the content of a data product and its specifications. The default file location for S-100 catalogue files is <installation location>\ArcGIS Maritime\Product Files\<version>\S-101\, provided the Maritime product files are installed.

File
Target Workspace

The geodatabase to which the schema will be written.

Workspace
Admin Connection
(Optional)

Legacy:

This parameter is no longer supported. It remains only for the backward compatibility of scripts and models but is not essential to the tool operation.

String
Coordinate System
(Optional)

The coordinate system of the output workspace. The default is WGS84.

Coordinate System
Subtype Mapping File
(Optional)

The subtype mapping .xml file used to specify feature classes that each S-100 feature will be subtyped in. If no parameter value is specified, the created data model will have separate feature classes for each S-100 object type. For S-101, it is recommended that you use the S-101FeatureClassMap.xml file. The default file location is C:/<ArcGIS Pro installation location>\Pro\Resources\Maritime.

File
Configuration Keyword
(Optional)

The configuration keyword applies to enterprise geodatabases data only. It determines the storage parameters of the database table.

String

Derived Output

LabelExplanationData Type
Output Workspace

The geodatabase to which the schema will be written.

Workspace

arcpy.maritime.ImportS100FeatureCatalogue(in_feature_catalogue, target_workspace, {admin_connection}, {coordinate_system}, {subtype_mapping}, {config_keyword})
NameExplanationData Type
in_feature_catalogue

An .xml file that follows the S-100 Feature Catalogue format as defined by the IHO. It describes the content of a data product and its specifications. The default file location for S-100 catalogue files is <installation location>\ArcGIS Maritime\Product Files\<version>\S-101\, provided the Maritime product files are installed.

File
target_workspace

The geodatabase to which the schema will be written.

Workspace
admin_connection
(Optional)

Legacy:

This parameter is no longer supported. It remains only for the backward compatibility of scripts and models but is not essential to the tool operation.

String
coordinate_system
(Optional)

The coordinate system of the output workspace. The default is WGS84.

Coordinate System
subtype_mapping
(Optional)

The subtype mapping .xml file used to specify feature classes that each S-100 feature will be subtyped in. If no parameter value is specified, the created data model will have separate feature classes for each S-100 object type. For S-101, it is recommended that you use the S-101FeatureClassMap.xml file. The default file location is C:/<ArcGIS Pro installation location>\Pro\Resources\Maritime.

File
config_keyword
(Optional)

The configuration keyword applies to enterprise geodatabases data only. It determines the storage parameters of the database table.

String

Derived Output

NameExplanationData Type
output_workspace

The geodatabase to which the schema will be written.

Workspace

Code sample

ImportS100FeatureCatalogue example (stand-alone script)

The following Python window script demonstrates how to use the ImportS100FeatureCatalogue 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.")
                
arcpy.env.XYResolution = "0.00000001 DecimalDegrees"
arcpy.env.XYTolerance = "0.000000035355339 DecimalDegrees"

# Tool variables
in_feature_catalogue = r"C:\profiles\ArcGIS Maritime\Product Files\3.2\S-101_FC_1.1.0.xml"
admin_connection=None
coordinate_system=None
subtype_mapping=None
config_keyword=""



target_workspace = r"C:\Data\ImportS100FC.gdb"

# Run the tool
arcpy.ImportS100FeatureCatalogue_maritime(in_feature_catalogue,target_workspace,admin_connection,coordinate_system,subtype_mapping,config_keyword)

Licensing information

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

Related topics