Delete Features

The DeleteFeatures process deletes features in the output that have the same primary key as features in the input.

The process uses a one-to-one match between feature identifiers or attributes. DeleteFeatures will fail with a many-to-one or a one-to-many match.

This process cannot delete collection objects.

A Shapefile, GML file, HOB file, H2O file, S-57 file, HPD database URI, or an oracle simple feature table.

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.

When an HPD URI is specified for update, DeleteFeatures only queries features from HPD that are specified by the MatchBy option. If the output of DeleteFeatures is passed to another process in a process model, features are not queried from HPD by the next process. Only features that have been marked for deletion can be provided by DeleteFeatures when an HPD URI is specified for update.

Option	Key	Description	Can Repeat	Notes
--match-by	-m	A primary key. By default, the unique feature object identifier (FOID) is used as the primary key. An attribute acronym can also be specified. The process will delete features from the output that have the same primary key as input features.	FALSE	Optional
--proposed-deletion	-P	A flag to indicate that features are marked for deletion rather than actually deleted. This option is for formats that support proposed deletion, such as HPD features. This option is only used with HPD URIs.	FALSE	Optional
--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	Optional

Option

Key

Description

Can Repeat

Notes

--match-by

-m

A primary key. By default, the unique feature object identifier (FOID) is used as the primary key. An attribute acronym can also be specified.

The process will delete features from the output that have the same primary key as input features.

FALSE

Optional

--proposed-deletion

-P

A flag to indicate that features are marked for deletion rather than actually deleted. This option is for formats that support proposed deletion, such as HPD features.

This option is only used with HPD URIs.

FALSE

Optional

--input-crs

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

Optional

Example
Objective	Delete the features that exist in the input file from the output file.
Description		Command Line Syntax
Input file		D:\FeaturesToDelete.h2o
Output file		d:\FileToUpdate.h2o
Command Line	carisbatch --run DeleteFeatures D:\FeaturesToDelete.h2o D:\FileToUpdate.h2o
Result	Features in the output file that match features in the input file are deleted.