Skip to main content

Relationship Groups

Relationship groups are named groupings of features — typically production lines, missions, or operational sets — used to drive feature-to-feature relationships in bulk. Instead of authoring relationships pair-by-pair on each Relationships tab, define a Group × Group × Criteria matrix once and let Siter generate every individual pair's relationship for you. The matrix says, for example, "Line 1 features are sameline with each other, related to Line 2, and unrelated to Line 3."

Added in v0.20.

Prerequisites​

  • Your project must contain features grouped into operational sets
  • You must have the Project Edit Permission or higher
  • A criteria standard must be applied to the project

How to open the Relationship Group Editor​

  1. Click apps in the toolbar

  2. Select Relationship Group Editor

    Relationship Group Editor dialog showing three groups (Line 1, Line 2, Line 3) with feature counts and a 3×3 sameline/related/unrelated criteria matrix for DCMA

The dialog has two main areas:

  • Relationship Groups on the left — the named groups and how many features each contains
  • The matrix on the right — for the selected criteria, every Group × Group pair has a relationship value (sameline, related, unrelated, or a specific type code like B for Barricaded)

How to add a relationship group​

  1. Click Add Group in the editor
  2. Name the group (e.g., "Line 1", "Mission Alpha", "Sundown Production")
  3. Save

The new group appears in the list with 0 features.

How to assign features to relationship groups​

There are two routes:

Per-feature — open the feature's dashboard, click the Relationships tab, and use the Relationship Groups chips section to add or remove memberships.

In bulk — click apps > Bulk Edit > Relationship Group Assignment, select features in the footbar, and choose the groups to apply. See Bulk editing.

How to author the relationship matrix​

  1. Open the Relationship Group Editor
  2. Select the criteria standard from the Criteria dropdown — each criteria gets its own matrix
  3. For each Group × Group cell, choose the relationship value:
    • sameline — features in the same group treat each other as sites of the same operation (typically same operating area, related to but not subordinate to each other)
    • related — features are related across groups under the criteria's normal pairing rules
    • unrelated — exclude this pair from analysis entirely
    • A specific type code (such as B for Barricaded) — force this code between every member of these two groups
  4. Repeat for any other criteria the project uses

How to build relationships from the matrix​

  1. With assignments and the matrix set, click Build Relationships in the editor
  2. Siter generates one auto-relationship row per pair on the Relationships tab of every member feature
  3. After the build, a Conflict Report dialog surfaces any ambiguous or unrelated-resolution pairs — click a row to fly to that pair on the map

The build itself lands on the project's undo stack as a single command, so you can undo a problematic build without manually unwinding rows.

How to override an auto-generated relationship​

Auto-generated relationships are marked with an auto_awesome icon on the Relationships tab. To override one:

  1. Open the feature's Relationships tab
  2. Edit the row — the icon flips to lock indicating the row is now user-overridden
  3. Save

Subsequent builds preserve overrides — they do not get re-derived from the matrix.

You can also review and override every relationship in the project at once from the All relationships dashboard.

How to clear overrides​

  1. Open the Relationship Group Editor
  2. Click Clear Overrides (with the dropdown to limit scope to a single group or criteria if desired)
  3. Confirm

Cleared overrides revert to whatever the matrix specifies on the next build.

Spatial-only analysis with relationship groups​

When you make sweeping changes to the matrix or assignments, you can re-analyze spatial relationships without re-running every QD calculation:

  1. Open the project dashboard's settings gear
  2. Select Spatial-only Analysis

Spatial-only runs are persisted on the analysis set and do not advance the per-feature analysis timestamps, so a spatial-only completion is not mistaken for a full analysis. Follow it with Build Relationships to refresh auto-relationships, then re-run a full analysis when ready.

How to reset all relationships​

If the matrix gets out of hand and you want to wipe every auto-relationship in the project:

  1. Open the project dashboard's settings gear
  2. Select Reset All Relationships
  3. Type the confirmation phrase and submit

This removes every auto-generated and user-overridden relationship row across every feature. Use with care.

Export, import, and copy behavior​

Relationship groups, their matrices, and per-feature assignments are preserved when you copy or export/import a project. Build runs and conflict reports are intentionally not carried over since those are transient run artifacts.