Event on Event

Available with Data Reviewer license.

Summary

The Event on Event check finds linear referenced events that overlay other events based on a defined relationship. Optionally, you can also find events not in the specified relationship.

Overview

The Event on Event check identifies invalid overlay combinations involving two or more event features. It can help determine whether a location requires event coverage given other events' values.

Industry scenarios

The following are scenarios in which you can use this check:

  • In roadway management, event features must be compliant with highway performance monitoring system (HPMS) guidelines.
  • In roadway management, a speed limit event representing a 55 mph zone cannot overlay a local road section or an event representing the ramp section of a route.
  • In pipeline management, the protective coating must be appropriate for the material type, pressure, and diameter of the pipeline.

Supported workflows

ArcGIS Data Reviewer checks support multiple methods for implementing automated review of data. The following table identifies the supported implementation methods for this check:

ValidationConstraint

Reviewer batch job

Reviewer map rule

Attribute (validation) rule

No

No

Yes

Yes

(ArcGIS Pro 2.6 or later)

Note:

Map-based Reviewer rules are deprecated as of ArcGIS Pro 2.8 and are no longer recommended for use. This functionality will be removed in the next major release of ArcGIS Pro. It is recommended that you migrate automated review workflows to Data Reviewer capabilities available in attribute rules.

Syntax

Parameter Required DescriptionWorkflow

Route Identifier

Yes

The name of the field that contains values used to associate events to routes.

Validation

Route From Date

Yes

The name of the field that contains values that define the starting date for a route.

The field must be of a date data type.

Validation

Route To Date

Yes

The name of the field that contains values that define the ending date for a route.

The field must be a date data type.

Validation

Overlay Events

Yes

The events that are overlaid and evaluated by the rule.

Valid inputs for this rule type are polyline feature layers.

Validation

Search Goal

Yes

The query expression that is applied to overlay events.

Each event with values that match those defined in the SQL query is returned as a Reviewer result.

Validation

Invert Relationship

No

After the search goal is evaluated, this parameter determines whether the result should be used as-is or inverted. For example, this parameter can be used to identify events that don't match the Search Goal query expression.

  • Unchecked—The result of the validation is not inverted. This is the default.
  • Checked—The result of the validation is inverted.

Validation

Title/Name

No

A unique title or name for the rule.

This information is used to support data quality requirement traceability, automated reporting, and corrective workflows.

Validation

Notes/Description

No

A description you define of the error when a noncompliant feature is found.

This information is used to provide guidance to facilitate corrective workflows.

Validation

Severity

No

The severity of the error assigned when a noncompliant feature is found.

This value indicates the importance of the error relative to other errors. Values range from 1 to 5, with 1 being the highest priority and 5 being the lowest.

Validation

Tags

No

The tag property of the rule.

This information is used in rule authoring and management workflows to support traceability and reporting of data quality requirements.

Validation

Input layer settings (map rules only)

ParameterRequiredDescriptionWorkflow

Input Route Layers

Yes

The input feature layers to which the events are referenced.

Valid inputs for this rule type are m-enabled polyline feature layers. Click the Forward button Forward to define route field settings and to apply filtering to specific features in the feature layer.

Validation (map rules)

Overlay Events

Yes

The events that are overlaid and evaluated by the rule.

Valid inputs for this rule type are polyline feature layers.

Map rules: Click the Forward button Forward to define event field settings and to apply filtering to specific features in the feature layer.

Validation (map rules)

Search Goal

Yes

The query expression that is applied to overlay events.

Each event with values that match those defined in the SQL query is returned as a Reviewer result.

Validation (map rules)

Invert Relationship

Yes

After the search goal is evaluated, this parameter determines whether the result should be used as-is or inverted. For example, you can use this parameter to identify events that don't match the Search Goal query expression.

  • Unchecked—The result of the validation is not inverted. This is the default.
  • Checked—The result of the validation is inverted.

Validation (map rules)

Notes

Keep the following in mind when using the check:

  • Validation of line events that are registered with the location referencing system (LRS) of either ArcGIS Roads and Highways or ArcGIS Pipeline Referencing is supported.
  • Route features must be m-enabled and registered with the location referencing system (LRS) of either Roads and Highways or Pipeline Referencing.
  • A route identifier field (numeric data type) is required for all route and event layers.
  • An attribute index on the route identifier field speeds up the dynamic segmentation process.
  • Events associated with nonmonotonic route features are not evaluated by this check. Nonmonotonic routes are routes that contain measure values that are either continuous or do not strictly increase or decrease in value.

    The Monotonicity check is used to find nonmonotonic routes that require correction.

  • Events that do not have an associated route (orphaned events) are not evaluated by this check. Orphan events are event features that do not have a corresponding route feature (as identified by the event’s route identifier attribute value).

    The Invalid Events check is used to find orphaned events that require correction.

  • Events that contain invalid measure values are not evaluated by this check. Invalid event values are event measure values that are greater than, less than, or within a gap in a related route’s measure values.

    The Invalid Events check is used to find events that contain invalid measure values.

  • The following conditions apply when this check is authored as an attribute (validation) rule:
    • The Validation Status attribute value of both the input data source and the events included in the Search Goal parameter are ignored during evaluation. For example, input route features with a validation status of 0 (No calculation required, no validation required, no error), 1 (No calculation required, no validation required, has error(s)), 4 (Calculation required, no validation required, no error), or 5 (Calculation required, no validation required, has error(s)) are still included during rule evaluation.
    • Include the data sources for the Overlay Events parameter when sharing web layers with the Validation capability enabled.
  • When this check is authored as a map-based rule, verify that the filter parameters using database-specific SQL functions are the same as from those supported in your production environment.

Related topics