CARIS HPD : CARIS® Batch : HPD® Processes : SourceBuilder License : Add Features as Annotations
 

Add Features as Annotations

The AddFeaturesAsAnnotations process adds features from the input file as annotations of matching features in the output.

The coordinate reference systems and the X/Y resolutions of the input and output files must match.

Input

A HOB or S-57 file.

Output

An HPD database URI. An HPD URI must specify the project to use and either a usage or a product to update.

Alternatively, the HPD URI may specify a chart version ID, project ID and a panel number or a standalone chart containing a chart version ID and panel number.

Note: The chart version ID will always be 1 for a standalone chart.

Command Line Syntax

carisbatch --run AddFeaturesAsAnnotations --mapping-rule-file <value> [options] <input> <output>

Options

Long

Short

Description

Can Repeat

Notes

--mapping-rule-file

-M

The path to the XML mapping rule file containing mapping rules for adding the new annotation features.

FALSE

Required

--match-by

-m

A primary key. This option will create annotations for output features from input features with the same primary key.

By default, this is the feature object ID. An attribute acronym can also be used.

The AddFeaturesAsAnnotations process supports many to one matching if an attribute value is used.

FALSE

Optional

Example

.

Example

Objective

Add annotations to an HPD usage from features in input.000. The annotations will be mapped by the mapping.xml file.

Description

Command Line Syntax

Input file

Input.000

HPD URI

hpd://username:password@database?UsageId=4;ProjectId=1359

Mapping file

--mapping-rule-file

Command Line

carisbatch --run AddFeaturesAsAnnotations --mapping-rule-file D:\mapping.xml D:\input.000 hpd://username:password@database?UsageId=4;ProjectId=1359

Result

Feature information from input.000 is added as annotations to the HPD URI.