Home → FAQ → What is a stable ID in XyzPilot?...

FAQ

What is a stable ID in XyzPilot?

A stable ID is an internal immutable identity used to track an entity across redraws, deletions, and store compaction. It is separate from the display label.

Full Answer

IdentifierPurposeChanges?
Display label (P0, L1, C2)Operator-facing identifierNever
Stable IDInternal identityNever
Backing indexCurrent array position in storageYes — can change after deletions
This architecture was introduced to fix a class of bugs where operator references were incorrectly treated as array positions. Display labels now resolve through stable IDs, not backing positions.

XyzPilot Example

Before the fix: L14 might resolve as L15 after L13 was deleted (positional lookup: index 14 → wrong entity) After the fix: L14 always resolves to the entity with label L14 (label lookup → stable ID → current backing record) Result: L14 is always L14, regardless of deletions.

Relevant Operators

Point/X,Y

Coordinate Point

Has display label P0, P1... and stable ID.
Line/P,P

Line Through Two Points

Has display label L0, L1... and stable ID.

Also See

← All FAQs Operator Reference Try in XyzPilot →