Create S-57 Exchange Set (Maritime)

获得 ArcGIS Maritime 许可后可用。

摘要

Allows a mariner to view the Electronic Navigational Chart (ENC) datasets in an Electronic Chart Display and Information System (ECDIS) for shipboard navigation.

An exchange set is a package of files that contains one catalog file and at least one S-57 dataset file (New Edition [EN] and Revised Edition [ER]). Once you export and publish the S-57 data, you need to package the S-57 dataset files into a valid S-57 exchange set.

使用情况

  • Validate the S-57 product and clear it for publishing before creating the exchange set.

  • This tool packages external files referenced by features in the following formats:

    • ENC—*.txt, *.jpg, and *.tif files
    • IENC—*.txt, *.jpg, *.tif, and *.xml files
    • AML—*.txt, *.tif, *.pdf, *.html, *.htm, .jpeg, *.jpg, *.avi, .mpeg, and *.mpg files
    • Additional file types can be configured for each product type in <install location>\Resources\Maritime\S57ISO8211.xml.

  • If an external file with the same name exists in multiple input folders, the one in the same folder as the S-57 product is given highest priority, followed by the order in which the folders appear in the input.

  • The LFIL File parameter provides a method to populate the long file description tag (LFIL) on the catalog directory field in the output exchange set. This is a text file with entries separated by new lines, conforming to the [File name pattern]|[Long file description] format.

    When a file contained in the exchange set matches the file name patterns, its long file description is populated with the text following the vertical bar character (|) on that line.

    The following are examples:

    • US5ESRI1.000|Navigable waters of Paradise Bay
    • US1Z*|General view of coast
    • US1ZABCD|North coast

    Use an asterisk (*) as a wildcard character to match several files when pattern matching. A more specific name match will take precedence over a more generic match; for example, US1ZABCD is a better match than US1Z* for a cell named US1ZABCD.000.

参数

标注说明数据类型
Input Directories

Folders that contain at least one S-57 base cell (*.000) and, optionally, any of the following:

  • S-57 update datasets
  • README.txt file
  • Any referenced files in the S-57 cells (*.txt, *.tif, and *.jpg)

Folder
Output Directory

The location of an empty folder where the ENC_ROOT folder will be written. The folder must be empty for the tool to run successfully.

Folder
Layout Format

Specifies the directory and folder structure of the exchange set.

  • VERSION_LAYOUT The exchange set will be written in the format ENC_ROOT\CATALOG.031, ENC_ROOT\<Agency>\<ProductName>\<MajorEdition>\<MinorEdition>\<S57Product>, <Referenced Files>. This is the default.
  • PRODUCT_LAYOUTThe exchange set will be written in the format ENC_ROOT\CATALOG.031, ENC_ROOT\<ProductName>\<S57Product>, <Referenced Files>.
  • FLAT_LAYOUTThe exchange set will be written in the format ENC_ROOT\CATALOG.031, <S57Product(s)>, <Referenced Files>.
String
Updates Only
(可选)

Specifies how S-57 update datasets in the input folder will be processed.

  • Checked—The output exchange set will include all the updates but not the S-57 base dataset. If there are no updates, the output will include the S-57 base dataset.
  • Unchecked—The output exchange set will include the S-57 base dataset and any update datasets. This is the default.
    注:

    An S-57 base dataset is required in the input folder when creating an update exchange set.

Boolean
LFIL File
(可选)

A text file that will be used to match file names in the output exchange set to the long file descriptions populated on the catalog file records.

File

派生输出

标注说明数据类型
S-57 Exchange Set Directory

The location of an empty folder where the ENC_ROOT folder will be written.

Folder

arcpy.maritime.CreateS57ExchangeSet(in_directories, out_directory, layout_format, {updates_only}, {lfil_file})
名称说明数据类型
in_directories
[in_directories,...]

Folders that contain at least one S-57 base cell (*.000) and, optionally, any of the following:

  • S-57 update datasets
  • README.txt file
  • Any referenced files in the S-57 cells (*.txt, *.tif, and *.jpg)

Folder
out_directory

The location of an empty folder where the ENC_ROOT folder will be written. The folder must be empty for the tool to run successfully.

Folder
layout_format

Specifies the directory and folder structure of the exchange set.

  • VERSION_LAYOUT The exchange set will be written in the format ENC_ROOT\CATALOG.031, ENC_ROOT\<Agency>\<ProductName>\<MajorEdition>\<MinorEdition>\<S57Product>, <Referenced Files>. This is the default.
  • PRODUCT_LAYOUTThe exchange set will be written in the format ENC_ROOT\CATALOG.031, ENC_ROOT\<ProductName>\<S57Product>, <Referenced Files>.
  • FLAT_LAYOUTThe exchange set will be written in the format ENC_ROOT\CATALOG.031, <S57Product(s)>, <Referenced Files>.
String
updates_only
(可选)

Specifies how S-57 update datasets in the input folder will be processed.

  • INCLUDE_ALLThe output exchange set will include the S-57 base dataset and any updates. This is the default.
  • INCLUDE_ONLY_UPDATESThe output exchange set will include all the updates but not the S-57 base dataset. If there are no updates, the output will include the S-57 base dataset.
Boolean
lfil_file
(可选)

A text file that will be used to match file names in the output exchange set to the long file descriptions populated on the catalog file records.

File

派生输出

名称说明数据类型
derived_out_directory

The location of an empty folder where the ENC_ROOT folder will be written.

Folder

代码示例

CreateS57ExchangeSet example (stand-alone script)

The following code example demonstrates how to use the CreateS57ExchangeSet function.

# Import arcpy module
import arcpy

input_directories = [r"C:\data\AML\cells", r"C:\data\AML\external_files"]
output_directory = r"C:\output"
layout_format = "FLAT_LAYOUT"
updates_only = "INCLUDE_ALL"
lfil_file = r"C:\exchange\LFIL.txt"

# Process: Create S-57 Exchange Set
arcpy.maritime.CreateS57ExchangeSet(input_directories, output_directory, layout_format, updates_only, lfil_file)

许可信息

  • Basic: 否
  • Standard: 需要 ArcGIS Maritime
  • Advanced: 需要 ArcGIS Maritime

相关主题