Lineage

Lineage lets you trace how every model and artifact in a system was produced and what it was used to produce. The complete set of parent/child relationships across a system is its lineage graph.

Use lineage to answer questions like:

• Which design files and simulation results led to the part that just failed in production?
• For a multi-step workflow, what did each step produce and which downstream steps consumed it?
• Which validation results map back to which lines of a requirements document?

Concepts

• Resource — any model or artifact stored in a system.
• Parent — a resource that was used to generate another resource.
• Child — a resource that was generated from another resource.
• Lineage graph — the complete set of parent/child relationships among the resources in a system, in both directions from any starting point.

Enable Lineage

Note: Lineage is an experimental feature. Enable it in Application Settings > Experimental — Lineage.

The toggle is per-user and is remembered in your browser. Once enabled, lineage controls appear on system and resource pages.

Where Lineage Comes From

Resources become connected through lineage in two ways:

• Automatically from jobs. When a job runs, its outputs are linked to the input files it consumed. No action is required from you — the relationship is recorded as part of the job's execution.

View Lineage for a Resource

1. Open any model or artifact in a system.
2. Open the Lineage view from the resource page.
3. The graph centers on the selected resource and expands outward:
   • Parents are shown upstream of the resource.
   • Children are shown downstream of the resource.
4. Click any node to navigate to that resource. From there you can open its lineage view to continue exploring.

View Lineage for a System

1. Open a system from the Systems page.
2. Open the Lineage view from the system detail page.
3. Every resource in the system is shown as a single graph. Use this view to:
   • See how files relate across the whole system.
   • Spot resources with no upstream or downstream connections.
   • Jump directly to any resource by clicking its node.

Required role (System): Editor or above.

Lineage and Jobs

When a job completes, its output resources are automatically related to the input files of the job. Workflows run through Istari Digital build up lineage without any extra steps:

• Run a job — outputs are linked to inputs.
• Chain jobs together — each step's outputs become parents of the next step's outputs.
• View any resource's lineage to see the full execution graph that produced it.

See Jobs and Automation for more on running and reviewing jobs.

Sharing Lineage

When you share a system, collaborators with access to the underlying resources see the same lineage you do. File-level permissions still apply — users without access to a particular resource see it represented in the graph with limited information, the same way they would in the rest of the system.

See Sharing and Access Control for sharing details.