CARIS HPD : Support Files : Catalogues : Catalogue Control File
 

Catalogue Control File

The catalogue control file links dictionaries and profiles to related products. The default file, cataloguecontrol.xml, is located in...\\CARIS\<version>\System.

The structure of the file is shown here.

The file must contain the following header information:

<?xml version="1.0" encoding="UTF-8" ?>

<CatalogueControlFactory Version="1.0">

Products are listed with their corresponding dictionaries and profiles. An entry for Digital Nautical Charts (DNC) is shown below.

<CatalogueControlFactory Version="1.0">

...

   <Product Name="VPF DNC" Id="1000" Version="1.0">

      <Profile Type="XML" Name="%VPFConfig%\system\vpfDNCProfile.xml"/>

      <Dictionary Type="XML" Name="%VPFConfig%\system\vpfDNCPool.xml"/>

   </Product>

...

</CatalogueControlFactory>

When a DNC file is opened in CARIS, chart features and attributes are defined through vpfDNCPool.xml and vpfDNCProfile.xml.

Below is a Contour Layer Bathymetry (CLB) AML 3.0 product specification.

<CatalogueControlFactory Version="1.0">

...

   <Product Name="S-57 CLB 3.0" Id="57" Version="3.0" ProductSpecDescription="CLB">

      <Profile Type="XML" Name="%S57Config%\system\AML_3_0_CLB_Profile.xml"/>

      <Dictionary Type="XML" Name="%S57Config%\system\s5731Pool.xml"/>

      <Dictionary Type="XML" Name="%S57Config%\system\AML_3_0_ExtensionDict.xml"/>

   </Product>

...

</CatalogueControlFactory>

Two dictionaries are used to define an AML 3.0 CLB chart (s5731Pool.xml and AML_3_0_ExtensionDict.xml). The chart is further defined by the ProductSpecDescription (product specification description or PSDN) attribute.1

This table lists the tags and associated attributes in a catalogue control file.

Tags

Description

<CatalogueControlFactory>

Root element for all other tags in this file.

Attributes:

Version: Version of the catalogue file. The version is set to 1.1.

Example:

<CatalogueControlFactory Version="1.1"

<Catalogue>

Parent tag for the products that are combined in a compound catalogue.

<Product>

Parent tag for the product profile and dictionary tags. When a product or external file is opened, the metadata from the file is compared to the Name, ID, Version or (if necessary) Product Specification Description attributes.

Attributes:

Name: Product type for the profile and dictionary.

ID: Product specification (PRSP) value.

Version: Application profile ID (PROF) value.

ProductSpecDescription: Product specification description (PSDN) value. This attribute is necessary only for AML 3.0 products.

Example:

<Product Name="S-57 ENC 3.1" Id="1" Version="2.0">

<Profile>

Path and name for the product profile.

Attributes:

Type: Format of the file. In all cases it is XML.

Name: Path and name of the profile file.

Example:

<Profile Type="XML" Name="%S57Config%\system\enc31Profile.xml"/>

<Dictionary>

Tag that contains the path and name of the product dictionary.

Attributes:

Type: Format of the file. In all cases it is XML.

Name: Path and name of the dictionary file.

Example:

<Dictionary Type="XML" Name="%S57Config%\system\s5731Pool.xml" />

<Schema>

Path and name of the schema definition file for S-100 dictionaries.

Example:

<Schema>%S100Config%\system\S100FC.xsd</Schema>


1 Product Specification Description is used only for AML 3.0 products.