The UpdateFeatures process updates features in the output using features from the input that have the same primary key.
The coordinate reference systems and the X/Y resolutions of the input and output must match.
Note that the process uses a one-to-one match between feature identifiers or attributes. UpdateFeatures will fail with a many-to-one or a one-to-many match.
Input
A Shapefile, GML file, HOB file, H2O file, S-57 file, HPD database URI, or a simple oracle feature table URI.
Update
An existing HOB file, H2O file or HPD database URI. An HPD URI must specify the project to use and either a usage or a product to update.
Process Models
When an HPD URI is specified for update, UpdateFeatures only queries features from HPD that are specified by the MatchBy option. If the output of UpdateFeatures is passed to another process in a process model, features are not queried from HPD by the next process. Only features that were queried from the database with updates applied are provided by UpdateFeatures.
Command Line Syntax
carisbatch --run UpdateFeatures [options] <input> <update>
Options
The following table describes the parameters available for this process.
Long | Short | Description | Can Repeat | Notes |
|---|---|---|---|---|
--match-by | -m | A primary key by which to match features. By default, the unique feature object identifier (FOID) is used as the primary key. An attribute acronym can also be specified. The process will update output features with input features having the same primary key as the output features. | FALSE | |
--require-all | -q | Cancel the process if any feature fails to be updated. | FALSE | |
--feature-catalogue | -F | The catalogue that defines features and attributes in an output HOB or H2O file. Catalogue information is read from the Catalogue Control File. See Catalogues for a list of available catalogues. This option is required if the output is a HOB or H2O file and will be ignored if the output is not a HOB or H2O file. | FALSE | |
--update-relations | -d | Determine if relation differences will be applied. | FALSE | |
--keep-certification-status | -k | If set, the certification status of all updated features is left unchanged. If not set, the certification status of all updated features is changed to Under Construction. If the output does not support certification status, this option will be ignored. This option is only used with HPD URIs. | FALSE | |
--input-crs | -p | A string specifying the horizontal coordinate reference system key of the input. This option is only used when the input is a generic Oracle feature table that does not have a registered coordinate reference system. | FALSE | |
--map-undefined-attribute-value | -n | The attribute value to map to "undefined". All attributes with the given value will be mapped to undefined in the output. | FALSE | |
--map-unknown-attribute-value | -w | The attribute value to map to "unknown". All attributes with the given value will be mapped to unknown in the output. | FALSE | |
--tolerance | -T | A number and unit specifying the maximum distance between coordinates for geometry difference detection. This option can be used if there are slight differences in the coordinates of features in the input and output files due to transformation noise. Features whose coordinates fall within the tolerance are considered identical and are not updated. The unit is an abbreviation for a distance unit (cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, or yd). If this option is not used, the default will be 0.0. | FALSE |
Example
Stand-Alone file | ||
Objective | Update features in | |
Description | Command Line Syntax | |
Match features using the OBJNAM attribute. | --match-by OBJNAM | |
The S-57 ENC 3.1 catalogue is used to define features in the output file. | --feature-catalogue "S-57 ENC 3.1" | |
The file containing the features to use to update the original features is called UpdateFeatures.hob and is located in the root of the D: drive. | D:\UpdateFeatures.hob | |
The file containing the original features to be updated is called FeaturesToUpdate.hob and is also located in the root of the D: drive. | D:\FeaturesToUpdate.hob | |
Command Line | carisbatch --run UpdateFeatures --match-by OBJNAM --feature-catalogue "S-57 ENC 3.1" D:\UpdateFeatures.hob D:\FeaturesToUpdate.hob | |