CARIS BASE Editor : Support Files Guide : Mapping : Mapping CARIS Objects : Object Mapping
 

Object Mapping

Object mapping instructions are contained between the <Object> tags. Each CARIS feature code in this section is mapped to a HPD feature. There must be at least one mapping in this section.

Entries are ordered from the most specific to the least specific. The structure and syntax of the object mapping section is similar to other mapping files. To find out more about how object mapping works, see Object Mapping.

The basic structure of the mapping file is shown below.

<Object FeatureCode="DRGARE_*" WildCards="True"

Description="An area of the bottom which has been deepened

by dredging">

  <Filter>

    <PrimitiveIsEqualTo Primitive="Polygon"/>

  </Filter>

  <MapObject>

    <MapObjectAcronym Acronym="DRGARE"/>

    <ExecuteAttributeScript Script="assign_depthdrgare"From="CARIS_FCODE"/>

  </MapObject>

</Object>

The following table describes the tags in the object mappings section.

Tag

Attributes

Status

<Object>

The FeatureCode attribute is the feature code of the CARIS feature.

The Description attribute is a sentence describing the feature being mapped.

The Wildcards attribute indicates if FeatureCode contains a wildcard (* or %). This parameter must be set to True or False. If this parameter is not included, the default value is False.

The Formatted= parameter indicates if the FeatureCode is a C-like string. It must be set to True or False. If the property is not listed, the default is False

Mandatory

Optional


Optional

Optional

<Filter>

The <Filter> tag contains filter functions that determine if the object being mapped meets the criteria for mapping. The filter can be complex or simple. The object can only contain one filter.

Optional

<MapObject>

The <MapObject> tag contains a list of functions for mapping the object. One feature will be mapped for each <MapObject> element. This section is where the scripts for attribute mapping can be called.

Mandatory

Wildcards

In this example, all CARIS objects with a feature code NASTPHR with one character following the acronym will be matched. For example, NASHTPHR1, NASTPHRA, NASTPHR.

<Object FeatureCode="NASTPHR%" Wildcards="True"

In this example, all CARIS objects with a feature code NASTPHR with any number of characters following the acronym will be matched. For example, NASHTPHR1, NASHTPHRABC, NASTPHR1A1B2

<Object FeatureCode="NASTPHR*" Wildcards="True"

Formatted Example

This example matches all CARIS objects with a feature code that starts with one or more digits followed by an underscore and at least one more digits plus a character at the end. For example, 10_20M would match while 10_20MH would not.

<Object FeatureCode="%[0-9]_%[0-9]%1s" Formatted="True"

Description="An area of water whose depth is within

a defined range of values">

</Object>

The CARIS mapping file mostly uses the same functions as other mapping files. See Mapping Functions.