ProductTable

Root tag for all tags in this file. This tag is mandatory.

<ProductTable version="2.0" title="Product Descriptions" type="S-57 ENC, AML, IENC">

version

Product information file version. It must currently be set at 2.0

title

Description for the file.

type

The product type that can created using this file. If you add custom products, make sure to add the product to this list

product

Identification of the product. This tag is mandatory.

Example:

<product id="ENC" version="3.1" key="ENC">

The product information file can be extended to include custom products from generic S-57 products. Below is an entry for a PENC product that is built from a generic S-57 product.

<product id="PENC" version="1.0" key="GENERIC">

ID

Product acronym. ID can be used with a version attribute to retrieve particular product information or it can used by itself to retrieve a set of product information data. This attribute is mandatory.

version

The version of the product. This attribute is mandatory.

key

Product type. The tag is a keyword to group products into different types. It is used by the Create Product wizard to list products and to provide information about which dialog boxes to show and which data to be filed.

The following valid keys can be used:

• AML (S-57 AML products)

• ENC (S-57 ENC products)

• IENC (inland ENC)

• IENC_Overlay (IENC overlay)

• GENERIC (S-57 generic products)

This attribute is mandatory

prsp

value

The product specification number. This tag is mandatory. The value can be between 0 and 255.

Example:

<prsp value="1" />

psdn

value

The product specification description. This tag is mandatory.

Example:

<psdn value="Contour Line Bathymetry" />

prof

The value to export to the S-57 file’s application profile identification field (PROF). Values for the base and update cells must be provided.

<prof base="1" revision="2" />

base

A value between 0 and 255.

revision

A value between 0 and 255

sted

value

The S-57 edition number. This tag is mandatory.

Example:

<sted value="3.1" />

pred

value

The product edition number. This tag is mandatory.

Example:

<pred value="2.0" />

usageChar

value

A character to describe an IENC overlay. The value attribute can be set to L or IENC overlay 2.0 or A for IENC Overlay. This tag is optional and is only used with IENC overlay products.

Example:

<usageChar value="L" />

lines_as_arcs

value

A flag to indicate if lines should be treated as arcs. This is an optional tag. The attribute is a Boolean value – T for true or F for false.

Example:

<lines_as_arcs value="T" />

dsid_comt*

value

A tag that contains dataset identification (DSID) value. The value is displayed in the Create Product wizard.

Example:

<dsid_comt value="STED:3.1.1;" mandatory="T" />

mandatory

A flag to indicate whether the value attribute is included in the New S-57 Product wizard. The attribute is a Boolean value – T for true (the string is included in the wizard) or F for false (the string is not included in the wizard).

dspm_comt*

value

A tag that contains the dataset parameter (DSPM) values.

Example

<dspm_comt value="comments" />

COMF*

value

The default coordinate multiplication factor. If this tag is omitted, the default value is 10,000,000.

Example:

<COMF value="1000000" />

SOMF*

value

The sounding multiplication factor. If this tag is omitted, the default is 10

Example:

<SOMF value="100" />

usages

Parent tag for a list of valid usages associated with the product. This tag is mandatory and must contain at least one child layer.

Example:

<usages>

  <band value="1" intu="1" description="Overview" />

  <band value="2" intu="2" description="General" />

  <band value="3" intu="3" description="Coastal" />

  <band value="4" intu="4" description="Approach" />

  <band value="5" intu="5" description="Harbour" />

  <band value="6" intu="6" description="Berthing" />

</usages>

band

Child tag of the usages tag that defines each usage associated with the product.

value

Value for the usage band

intu

Intended usage value of the band (from 0-255)

description

Short description of the band

full_precision*

—

A flag to indicate if float-type attributes will be exported using full precision. If this tag is omitted, attributes are rounded using the precision in the feature catalogue.

Example:

<full_precision />

catalogue

value

A reference to the catalogue ID that maps to the catalogue control file. This enables the selection of product information (for example, AML plus matching catalogue) in a single step. This field is mandatory.

Example

<catalogue value="S-57 CLB 1.0" />

group_table

value

The full path to the group lookup table. This tag is mandatory.

<group_table value="%S57Config%/system/ENCGroupTable.xml" />

national_attributes

Parent tag for a list of valid national attributes for each product. This is an optional tag.

Example:

<national_attributes>

  <acronym value="NINFOM" />

  <acronym value="NOBJNM" />

  <acronym value="NPLDST" />

  <acronym value="$NTXST" />

  <acronym value="NTXTDS" />

</national_attributes>

acronym

value

national attributes.

units

Type

Type of unit and description for exporting depth, height, position accuracy, and Z values to the S-57 file. These are optional tags. If they are not included, then metres is used as the default unit of measurement.

Examples:

<units type="depth">

<units type="height">

<units type="positional accuracy">

ApplySoundingRoundingToDepthAttributes*

Apply the sounding rounding rule to depth attribute values when the product is exported to an S-57 exchange set.

Example:

<ApplySoundingRoundingToDepthAttributes />

unit

A child tag to further define the units tag.

Example of the depth units tag:

<units type="depth">

  <unit id="1" description="metres" />

</units>

Other depth unit examples are shown below.

<unit id="2" description="fathoms and feet" />

<unit id="3" description="feet" />

<unit id="4" description="fathoms and fractions" />

Height unit example for metres:

<units type="height">

  <unit id="1" description="metres" />

</units>

Height unit example for feet:

<unit id="2" description="feet" />

Example of the position unit tag:

<units type="positional accuracy">

  <unit id="1" description="metres" />

</units>

Position unit example for feet:

<unit id="4" description="feet" />

ID

Numeric value for positional accuracy unit. The values are as follows:

• 1 - metres

• 2 - fathoms and feet

• 3 - feet

• 4 - fathoms and fractions

The ID values can be applied to the following unit types

• Depth units - 1,2, 3, or 4.

• Height units - 1 or 2.

• Positional accuracy units - 1, 3, or 4

description

A brief description of the unit.

RoundingRules

A parent tag containing sounding rounding rules.

Example:

<RoundingRules>

  <Rule>Default Feet</Rule>

  <Rule>NOAA Feet</Rule>

</RoundingRules>

Rule

A child tag for individual sounding rounding rules.

datums

type

Parent tag for horizontal, vertical, and sounding datum information. Each datum type must have at least one entry.

Example:

<datums type="horizontal">

dat

Child tag of the datum tag for individual horizontal, vertical, and sounding datum entries

Example:

<datums type="horizontal">

  <dat id="2" description="WGS 84" />

</datums>

ID

A numerical value for the datum. It must be 0 and 255. If the datum type is horizontal then it must be set to 2.

description

A description that is shown in the Create Product wizard dialog box.

lexicalLevel

type

Parent tag for the lexical level for the product. Each lexical level type must have one entry.

Example:

<lexicalLevels type="ATTF">

or

<lexicalLevels type="NATF">

level

Child tag of lexicalLevel.

Example

<lexicalLevels type="ATTF">

  <level id="0" description="Lexical Level 0" />

  <level id="1" description="Lexical Level 1" />

</lexicalLevels>

ID

Numerical value for the lexical level entry.

description

Textual description of the level.

security Classification

A parent tag for security classification of AML products. The tag is mandatory and must contain at least one entry.

Example:

<securityClassifications>

  <classification id="501" value="N"    description="cosmic top secret" />

  <classification id="502" value="W"    description="focal top secret" />

  <classification id="503" value="T" description="top    secret" />

  <classification id="504" value="S"    description="secret" />

  <classification id="505" value="C"    description="confidential" />

  <classification id="506" value="R"    description="restricted" />

  <classification id="507" value="U"    description="unclassified" />

  <default/>

</securityClassifications>

classification

A child tag of securityClassification tag. It contains specific classification levels.

ID

Numeric value for the security rating (must be greater than 0).

value

The enumerated value for the security classification.

description

Textual description of the classification.

default

A child tag of the securityClassification tag. This sets the classification level that is displayed in the Security Classification field in Create S-57 Product wizard dialog box. The default tag can be applied only to a single classification level. In the above example, the classification with the value "U" is made the default.

IDOStatusList

A parent tag for listing International Defense Organization (IDO) status information for AML. This tag is mandatory for AML products and contain at least one entry.

Example:

<IDOStatusList>

  <status id="501" description="NATO: North Atlantic    Treaty Organisation" />

  <status id="502" description="NACC: North Atlantic    Co-operation Council" />

  <status id="503" description="PfP: Partnership for    Peace" />

  <status id="504" description="WEU: Western European    Union" />

</IDOStatusList>

status

A child tag to IDOStatusList for IDO types.

ID

The enumerated status entry (must be greater than 0).

description

Textual description of the IDO type.

dataSetName

A tag to set the total number of characters that can be used in a file name.

Example:

<dataSetName minIDCodeLen="1" maxIDCodeLen="99"/>

  <prefixes>

    <prefix value="1C80"/>

    <prefix value="1C81"/>

    <prefix value="1C82"/>

    <prefix value="1C83"/>

    <prefix value="1C84"/>

    <prefix value="1C85"/>

  </prefixes>

</dataSetName>

minID CodeLen

The minimum number of characters that can be entered in a file name.

maxID CodeLen

The maximum number of characters that can be entered in a file name.

prefixes*

The parent tag for listing prefixes.

prefix*

value

Child tag of prefixes. Agency code to be appended to the file name.

ExchangeSet

Type

A tag declaring that an exchange set is for a Generic product type. The Generic exchange has only one level and does not include an ENC_ROOT folder.

Example:

<ExchangeSet type="GENERIC"/>

natoCodesFile

value

The path and name of the file containing a list of NATO country codes for AML products. The default file is natocodes.txt in ...System\S57Config\system

Example:

<natoCodesFile value="%objXs57parms%/natocodes.txt"/>

riverCodes

Parent tag for waterway codes in an Inland ENC (IENC) or Inland ENC overlay. This tag is mandatory for IENC and IENC overlays.

Example:

<riverCodes>

  <code id="D0" description="Danube" remark="km 0 -    1000 (with Sulina Branch)" />

  <code id="D1" description="Danube" />

</riverCodes>

code

Child tag for the riverCodes tag. This tag contains specific river codes.

ID

Enumerated value for the waterway. It must be 1 to 3 characters.

remark

Textual comment that viewed by the user (optional).

description

Textual description for the waterway.

metaObjects

Parent tag to set the meta object features for a product. When the product is created, the meta objects listed in the file are automatically included.

Two tags are used, <dataArea> and <noDataArea>. The coverage of the <dataArea> objects are the same as the products data extent. The coverage of <noDataArea> objects are the difference between data areas and the product extents, this only applies to database products.

Example:

<metaObjects>

  <dataArea>

    <object acronym="M_COVR">

      <attribute acronym="CATCOV" value="1"/>

    </object>

    <object acronym="m_conf">

      <attribute acronym="catcnf" value="501"/>

    </object>

  </dataArea>

  <noDataArea>

    <object acronym="M_COVR">

      <attribute acronym="CATCOV" value="2"/>

    </object>

  </noDataArea>

</metaObjects>

object

acronym

Child tag of the metaObjects tag. The feature acronym of the meta object.

attribute

acronym

Child tag of the Object tag. The acronym of an attribute associated with the meta object.

value

The value of the attribute.

productFileZ Resolution

value

This tag sets the precision for depth units in the product HOB file.

Example:

<ProductFileZResolution value="0.001" />

<securityClassification>

AML.

<IDOStatusList>

AML

<natoCodesFile>

AML

<riverCodes>

Inland ENC (IENC) and IENC overlays

<usageChar>

IENC overlays

productSpecificationVersion

The product specification version of the product.

Attribute

• value: The format is product specific. S-101 1.0 uses "010000" (2 digits version, 2 digits major, 2 digits minor (for example, 010000 for version 1.0.0))

productSpecificationDate

The publication date of the product specification that this product is compliant with.

Attribute

value: date

productSpecificationNumber

The product specification number. This is product specific. S-101 uses "101".

Attribute

value: number

Datatype

The data type used for this product when exported.

Attribute

value: Can be GML or ISO 8211 BINARY

ens

The encoding specification that this product is compliant with.

Attribute

value: A product-specific value. S-101 uses S-100 Part 10a.

ened

The encoding specification edition that this product is compliant with.

Attribute

value: A product-specific value. S-101 uses 1.1.

dsl

The dataset language code.

Attribute

value: EN for English.

exchangeSetSupportFolder

The name of the folder within the exported exchange set where support files will be placed on export. The default value is "support" but this can be changed if another folder name is desired.

Attribute

value: Folder name.

datasetDiscoveryMetadata

The dataset discovery metadata for this product. The dataset discovery metadata is stored with the product and is written to the exchange set catalogue when exchange sets are being created/updated on export. This tag uses multiple attributes:

Attributes

• catalogue: The catalogue that defines the dataset discovery metadata attributes for this product. This attribute tag uses multiple attributes. Format: <catalogue name= schema= /> Attributes:

• name:The catalogue XML file. Includes full file path and file name with extension.

• schema: The schema to use when opening the catalogue file. Includes full file path and file name with extension.

• attribute: The metadata attribute to include for the dataset discovery metadata. This attribute is repeated for each dataset discovery metadata attribute. The order of the attribute tags depicts the order the attributes are displayed in the dataset discovery metadata attribute grid which is displayed in the product creation wizard and from the product properties. This attribute tag uses multiple attributes which define how the attribute will be displayed to the user. Format: <attribute code minOccurs maxOccurs defaultValue hidden /> Attributes:

• code: The attribute code for the meta data attribute.

• minOccurs: The minimum number of times the attribute will be used. This value defines if the attribute is mandatory or optional. This should be 0 if the attribute is optional.

• maxOccurs: The maximum number of times the attribute will be used. This should be 1 unless the attribute supports multiplicity.

• defaultValue: The default value for the meta data attribute. This value will be displayed by default in the meta data attribute grid.

• hidden: Boolean value (true or false). Indicates if the attribute should be hidden from the meta data attribute grid. Default is false. Set this value to true if a default value will always be used or if this value is calculated within the application and the attribute should not be displayed in the attribute grid.

• readOnly: Boolean value (true or false). Indicates the attribute should be displayed as read-only in the meta data attribute grid. Default is false. Set this value to true if a default value will always be used but the attribute should still be displayed in the attribute grid.

• allowUnknown: Boolean value (true or false). Indicates if the value unknown should be allowed for the attribute. Default is false.

The order the attributes are listed in is important as this is the order in which they will be exported to the exchange set catalogue file.

exchangeCatalogueMetadata

The exchange catalogue metadata for this product. The exchange catalogue metadata is stored with the product and is written to the exchange set catalogue when exchange sets are being created on export. This tag uses multiple attributes:

Attributes

• catalogue: The catalogue that defines the exchange catalogue metadata attributes for this product. Format: <catalogue name schema/>. Attributes:

• name: The catalogue XML file. Includes full file path and file name with extension.

• schema: The schema to use when opening the catalogue file. Includes full file path and file name with extension.

• attribute: The metadata attribute to include for the exchange catalogue metadata. This attribute is repeated for each exchange catalogue metadata attribute. The order of the attribute tags depicts the order the attributes are displayed in the exchange catalogue metadata attribute grid which is displayed in the product creation wizard and from the product properties. This attribute tag uses multiple attributes which define how the attribute will be displayed to the user. Format: <attribute code minOccurs maxOccurs hidden defaultValue />. Attributes:

• code: The attribute code for the meta data attribute.

• minOccurs: The minimum number of times the attribute will be used. This value defines if the attribute is mandatory or optional. This should be 0 if the attribute is optional.

• maxOccurs: The maximum number of times the attribute will be used. This should be 1 unless the attribute supports multiplicity.

• defaultValue: The default value for the meta data attribute. This value will be displayed by default in the meta data attribute grid.

• hidden: Boolean value (true or false). Indicates if the attribute should be hidden from the meta data attribute grid. Default is false. Set this value to true if a default value will always be used or if this value is calculated within the application and the attribute should not be displayed in the attribute grid.

• readOnly: Boolean value (true or false). Indicates the attribute should be displayed as read-only in the meta data attribute grid. Default is false. Set this value to true if a default value will always be used but the attribute should still be displayed in the attribute grid.

• allowUnknown: Boolean value (true or false). Indicates if the value unknown should be allowed for the attribute. Default is false.

The order the attributes are listed in is important as this is the order in which they will be exported to the exchange set catalogue file.

supportFileDiscoveryMetadata

The support file discovery metadata for this product. The support file discovery metadata is created on export for each external support file referenced by feature attributes and is written to the exchange set catalogue when exchange sets are being created/updated on export. This tag uses multiple attributes:

Attributes

• catalogue: The catalogue that defines the support file discovery metadata attributes for this product. Format: <catalogue name schema/> Attributes:

• name: The catalogue XML file. Includes full file path and file name with extension.

• schema: The schema to use when opening the catalogue file. Includes full file path and file name with extension.

• attribute: The metadata attribute to include for the support file discovery metadata. This attribute is repeated for each support file discovery metadata attribute. This attribute tag uses multiple attributes which define how the attribute will be displayed to the user. Format: <attribute code minOccurs maxOccurs defaultValue/> Attributes:

• code: The attribute code for the meta data attribute.

• minOccurs: The minimum number of times the attribute will be used. This value defines if the attribute is mandatory or optional. This should be 0 if the attribute is optional.

• maxOccurs: The maximum number of times the attribute will be used. This should be 1 unless the attribute supports multiplicity.

• defaultValue: The default value for the meta data attribute. This value will be displayed by default in the meta data attribute grid.

• hidden: Boolean value (true or false). Indicates if the attribute should be hidden from the meta data attribute grid. Default is false. Set this value to true if a default value will always be used or if this value is calculated within the application and the attribute should not be displayed in the attribute grid.

• readOnly: Boolean value (true or false). Indicates the attribute should be displayed as read-only in the meta data attribute grid. Default is false. Set this value to true if a default value will always be used but the attribute should still be displayed in the attribute grid.

• allowUnknown: Boolean value (true or false). Indicates if the value unknown should be allowed for the attribute. Default is false.

The order the attributes are listed in is important as this is the order in which they will be exported to the exchange set catalogue file.