Union Creator Processor

Summary

The Union Creator Processor can be used to produce a geometric union of an event record’s associated geometry with one or more geometries imported as geofences.

Illustration

Examples

• The Union Creator Processor can be used to enhance the geometry of an event record with the geofence(s) it intersects. The union of the geometries can be used in a post-processing workflow to indicate an overlay of geofences (or areas) where the event occurred.
• The processor can be used to create a multipoint feature from the real-time observations of a point event. Inbound point events can be sent to a feature service to be stored as geofences. Simultaneously, each new point event received can be used to union with the previous observations as geofences. The resulting geometry will be a multipoint feature combining the current point event observation with the near real-time collection of previous geofence event observations.

Usage notes

• The Union Creator Processor requires the event record field containing the geometry be specified. A geometry field name can be specified or a GEOMETRY tag applied to a field within a GeoEvent Definition can be used to identify the geometry field.
• The processor can be configured to either replace the event record's geometry with the union of the specified geometries or place the union into a new geometry field using the Replace Geometry parameter. Adding a new field to a GeoEvent alters the event record's schema, which requires GeoEvent Server to create a new GeoEvent Definition. The new GeoEvent Definition will be managed by GeoEvent Server and deleted if changes are made to the processor or the GeoEvent Service in which the processor is used.
• Unlike other processors such as the Difference Creator Processor and the Symmetric Difference Creator Processor, which only operate with two discrete geometries, the Union Creator Processor accepts a regular expression, allowing several different geofences to be specified. Consequently, the union of a received event record's geometry can be obtained with one or more geometries that have been imported as geofences.

Parameters

Parameter	Description
Name	A descriptive name for the processor used for reference in GeoEvent Manager.
Processor	The name of the selected processor.
Geometry Field	The name of the geometry field or the GEOMETRY tagged field from the inbound event record the processor uses to calculate a union with geofence(s).
Replace Geometry	Specifies whether to replace the current event record geometry with the union of the event record’s geometry and the geofence(s). The default is Yes. Yes - The event record geometry will be replaced with the geometry of the union between the event record and geofence(s). No - The event record geometry will remain the same. The geometry of the union between the event record and geofence(s) will be stored in a new geometry field as part of the event record. Altering an event record’s schema by adding a new field requires a new GeoEvent Definition.
New Geometry Field Name (Conditional)	The name of the new geometry field where the union of the event record and geofence(s) geometry will be stored. Property is shown when Replace Geometry is set to No and is hidden when set to Yes.
Tag the New Geometry Field as Geometry (Conditional)	Specifies whether the new geometry field created by the processor will be tagged as GEOMETRY. The GEOMETRY tag is used by GeoEvent Server to identify the event record’s realized geometry when multiple geometry fields are present. The default is No. Property is shown when Replace Geometry is set to No and is hidden when set to Yes.
New GeoEvent Definition Name (Conditional)	The name assigned to the new GeoEvent Definition. The new GeoEvent Definition will combine the schema of the inbound event record with the additional new geometry field. Property is shown when Replace Geometry is set to No and is hidden when set to Yes.
Geofence(s)	The category and name of the geofence(s). The processor uses the geofence to calculate the geometric union with the event record’s geometry. The processor supports regular expressions, allowing multiple geofences of a category, or multiple categories of geofences to be specified. The required format for specifying a geofence is category/name, for example: .*/.* unions all geofences of all categories with the event record geometry. Oceans/.* unions all geofences of the category Oceans with the event record geometry. Oceans/Pacific unions the geofence Pacific of the category Oceans with the event record geometry.

Considerations and limitations

• Consider the geometry of the participating event record and geofence(s) when configuring the Union Creator Processor. For example, the union of an event record’s point geometry with a geofence whose geometry is a polygon will result in the polygon geometry only. In contrast, the union of an event record’s polygon geometry with a geofence whose geometry is also a polygon will result in the polygon geometry of both.
• Consider replacing the existing event record geometry with the union geometry prior to sending the event data to a feature service. Feature services only support one geometry type field and therefore whichever field has not been tagged as GEOMETRY will be converted and kept as a string.