Exercise: Violations on what should be related facilities
This exercise demonstrates a common siting pattern: two facilities that look like a violation under default unrelated assumptions, but resolve cleanly once they are assigned the relationship code that reflects how they actually operate. The exercise reinforces the artifact-first triage from the Violations lesson — many early-stage violations are data-completeness issues.
By the end of this exercise you should be able to:
- Identify a violation that may be an artifact of an incorrect relationship code
- Convert the violation into a related-Exposure-Type evaluation
- Confirm the result via the criteria-path trace
Prerequisites
- Module 6 topics: project results and violations
- Familiarity with calculator-side relationships (Module 1: Relationships)
Setup
[TODO: FILL IN — provide a starter project ID or shapefile/GeoJSON dataset that reproduces the scenario reliably. For now, instructions below assume the user constructs the scenario manually.]
-
Open or create a project with two PES candidates that operationally belong to the same operation but have no relationship configured
-
Set both facilities to a multi-face type code (e.g., ECM7) and assign fronts so they do not land in Requires Analysis
-
Place them at a distance that exceeds barricaded ILD but is less than IBD for the NEW you intend to use
-
Enter the same NEW on each
-
Run analysis and confirm a violation appears between them — the engine treated the pair as
unrelated, so IBD applied
Diagnose
- Open the feature dashboard for one of the facilities and review the Spatial Analysis tab
- Note the analysis code that produced the violation — likely an IBD-Exposure-Type code
- Open the analysis path for the violating pair and identify where the engine treated the pair as
unrelated - Confirm that the operational relationship in real life would be
samelineorrelated, notunrelated
Mitigate
-
Assign the two facilities to a relationship group (see Module 7: Relationship groups)
-
Set the group's relationship to
samelineif the facilities are part of the same operating line, orrelatedif they are on parallel operating lines -
Re-run analysis
-
Confirm the violation is replaced with an ILD-Exposure-Type result, and review the new analysis path
-
(Optional) If the relationship is
sameline, add an effective barricade between PES and ES and re-run. The required distance should drop further as the K18 → K9 reduction activates.
Discussion
A violation is not always a siting problem — sometimes it is a data-completeness problem. Before redesigning a layout to clear an arc, walk the analysis path and confirm the engine reached the verdict it should have under the correct operational picture. The cheapest mitigation is usually a relationship assignment that was missing from the start, and the difference between IBD and ILD for the same pair can be a factor of several.
The discipline this exercise builds: relationships before geometry. Always.
Related
- Violations — the broader artifact-vs-real triage
- Module 7: Relationships
- Calculator: Tracing analysis paths
- Calculator: Barricaded related vs barricaded sameline — the calculator-side cousin of this exercise