Holarch

Requirements

Program Map

See how your projects link to each other, with link counts per pair of projects, and follow one item's chain of links through other projects.

How to use it →

On this page
  1. Overview
  2. Concepts
    1. What the map shows
    2. Who sees what
    3. Colours
  3. How to use it
    1. See how your projects link
    2. Start from one project
    3. Trace one item through the program
    4. Worked example: the CubeSat EO-1 demo and a payload project
    5. Worked example: the Hybrid Car and its battery pack
    6. Tips and good practice
    7. Common mistakes
    8. How it connects to other features
  4. The Program Map page
    1. Bar
    2. Graph
    3. Table
    4. Inspector
  5. API and MCP
  6. Messages
  7. Limits
  8. Related

Overview

A program that spans several projects (a system project, subsystem projects, a test project, libraries) is tied together by links to other projects. Each link is stored in the project that makes it, so no single project shows the whole picture. The Program Map does: it draws one box per project you can open and one arrow per pair of projects, labelled with the relation and the number of links.

The page has two views:

  • Projects: every project you can open and the links between them, as a graph or a table.
  • Item Trace: one item in the middle and the items linked to it in other projects, ring by ring, up to six steps out.

The Program Map is open to everyone signed in. Links themselves are made on the Team plan; links stored in a project whose owner's plan does not include them are drawn grey. The links between the Hybrid Car and Hybrid Car Battery Pack demo projects work on every plan.

Concepts

What the map shows

ElementMeaning
BoxA project you can open: its name, its project type and its number of items; its accessible name adds the links it holds and receives
ArrowLinks stored in the project at the tail that point at items in the project at the head
Arrow labelrelation · links · deleted, for example traced from · 12 · 1 deleted
Projects you can't open (N links)One dashed box that counts every link into a project you cannot open
Library release boxA library release you can read, linked to from your projects

Arrows usually point up: subsystem projects store traced from and satisfies links to the system project, and test projects store verifies links. The map places the projects that hold links below the projects they point at.

Who sees what

The map is built only from the projects you can open: a project where you are a member with any role, not in the Trash, and whose organization's two-step sign-in rule you meet.

  • A link into a project you cannot open is counted in Projects you can't open (N links). That box never names the project or item, and it looks the same whether the project exists, is in the Trash, or never existed.
  • Links stored in a project you cannot open are not counted anywhere, even when they point at your projects.
  • Being an organization admin adds nothing: the map uses project membership.
  • Exports (CSV, SVG, PNG) hold exactly what the page shows.

Colours

ColourMeaning
Blue arrowLinks between projects you can open
Amber arrowSome of the targets are deleted (in the Trash or gone)
Grey arrowLinks into projects you can't open, to a library release, or stored in a project whose owner's plan doesn't include links to other projects

How to use it

  1. Click Manage Projects, then Program Map. The Projects view opens with every project that holds or receives links.
  2. Read the arrows. Point at a box to dim everything not connected to it.
  3. Click an arrow. The inspector lists its links, 100 at a time: the item that holds each link, the relation and the target item. Click either item to open it in its project, or Show More for the next 100.
  4. Click Export CSV in the inspector to save that arrow's links, or Export ▾ in the bar to save the whole map as CSV, SVG or PNG.

Start from one project

  1. Open the project, then Verification → Program Coverage, and click Open Program Map.
  2. The map shows only that project and the projects linked to it, directly or through others.
  3. Click Show All Projects to see everything you can open.

You can also click a box and choose Show Linked Projects Only.

Trace one item through the program

  1. Select the item. In the inspector's Trace section, open Other projects ⋯ and choose Show in Program Map. From an arrow's link list, click Trace This Item instead.
  2. The Item Trace view shows the item in the middle and the items linked to it in rings: the first ring one step out, the second two steps out. Links are followed in both directions.
  3. Choose Steps (1 to 6, default 3) to go further or stay closer.
  4. Items are coloured by project, with a dashed box around each project's items. Clear Group by project to remove the boxes.
  5. Click an item for Open Item and Trace From Here, which puts it in the middle.

Worked example: the CubeSat EO-1 demo and a payload project

  1. Create the CubeSat EO-1 demo, then a second project EO-1 Payload with the requirement PL.1 Imager resolution.
  2. In EO-1 Payload, select PL.1. In Trace → Other projects, click +, choose traced from, the CubeSat project and its imaging requirement, and click Add Link.
  3. Create a third project EO-1 Test Campaign with the test case TC.4 Resolution test, and link it with verifies to PL.1 in EO-1 Payload.
  4. Open Manage Projects → Program Map. The map shows EO-1 Test Campaign at the bottom, EO-1 Payload above it and the CubeSat project at the top, with the arrows verifies · 1 and traced from · 1.
  5. Click PL.1 → Trace ⋯ → Show in Program Map: the test case and the CubeSat requirement sit one step out, on either side.

Worked example: the Hybrid Car and its battery pack

  1. On Manage Projects, click Project Files ▾ → New Demo Project → Hybrid Car (SysML v2).
  2. Then create Project Files ▾ → New Demo Project → Hybrid Car Battery Pack (SysML v2). The battery supplier's pack requirements PackCapacity, PackMass and ChargeAcceptance are linked with traced from to the car's requirements VR-3, VR-6 and VR-5 in your newest Hybrid Car demo, whichever of the two you create first; creating the Hybrid Car demo again moves the links to the new one. These demo links work on every plan. Without a Hybrid Car project the pack demo has no links.
  3. Open Manage Projects → Program Map. The map shows the two SysML v2 projects with the arrow traced from · 3.

Tips and good practice

  • Agree on the relations that subprojects use (traced from or satisfies for requirements, verifies for tests) so the arrows read the same everywhere.
  • Turn off Group relations to see one arrow per relation, for example to tell requirement links from test links between the same two projects.
  • Drag boxes to arrange the map. The positions are kept in this browser for each scope.
  • Use the Table view to sort pairs of projects by number of links or deleted targets.
  • An amber arrow means links that need repair: open its link list, then fix or remove the links in the item's Trace → Other projects.

Common mistakes

ProblemCauseFix
A project is missingYou are not a member of it, it is in the Trash, or it has no linksAsk its owner for access; tick Show unlinked projects to list projects without links
Everything goes to Projects you can't openThe links point at projects you are not a member ofAsk a project's owner for access
Grey arrows in the middle of the mapThe project that holds the links has an owner without the Team planThe owner upgrades in Account Settings → Plan & Billing
A new link does not show yetThe map is still reading recent changesClick Refresh after a minute

How it connects to other features

  • Links to other projects: the map reads them; it adds or changes nothing. Make links in an item's Trace → Other projects (see Links to Other Projects).
  • Program Coverage: the per-item view of the links into one project, with gaps (see Program Coverage). Open Program Map there starts the map from that project.
  • Libraries: links to an item of a library release appear as arrows to the release's box (see Libraries).
  • Spider Diagram: the trace inside a project, with dashed boxes for linked items elsewhere. The Item Trace uses the same ring layout.
  • API and MCP: the same map and trace for tools (see API and MCP).

The Program Map page

Bar

ControlWhat it does
Projects / Item TraceSwitches the view
ScopeAll my projects, one organization (when you belong to one), or one folder with its subfolders (when you have folders; see Project Folders)
Show All ProjectsShown after opening the map from a project; leaves that project's linked set
Show unlinked projectsAlso shows projects with no links
Group relationsOne arrow per pair of projects (labels list each relation), or one arrow per relation
StepsItem Trace: 1 to 6 steps out
Group by projectItem Trace: dashed boxes around each project's items
Graph / TableThe diagram or a sortable table; on a narrow screen the table opens first
RefreshReads the links again
Export ▾Export CSV, Export SVG, Export PNG

Graph

  • Click a box to show its project in the inspector: Open Project and Show Linked Projects Only. Double-click a box, or press Shift+Enter on it, to open the project.
  • Click an arrow to list its links in the inspector.
  • Drag boxes to move them; scroll or pinch to zoom; drag the background to pan.
  • Press Tab to reach the map, then the arrow keys to move between boxes and arrows; Enter goes to the inspector. Each box and arrow has a name that a screen reader reads, such as "EO-1 Payload, LML project, 1 link out, 1 in".

Table

ViewColumns
ProjectsSource project, Relation, Target project, Links, Deleted
Item TraceProject, Number, Name, Class, Steps from the item, State

Click a column heading to sort.

Inspector

SelectionContents
Project boxName, type, number of items, links out and in; Open Project, Show Linked Projects Only
ArrowSource and target project, links per relation, the link list (100 at a time, Show More), Export CSV, Trace This Item per row
Item (Item Trace)Number and name, class, project, steps from the traced item, state; Open Item, Trace From Here
Projects you can't open"Links to projects you can't open. Ask a project's owner for access."

API and MCP

The REST API and MCP give the same answers with the token's own access and project list. Projects of an organization that turned API access off are left out, like projects you cannot open.

CallReturns
GET /api/v1/program-mapProjects, releases, arrows (from, to, relation, links, deleted, plan) and the hidden count; from, unlinked, org as in the page
GET /api/v1/projects/<project>/items/<item>/traceThe Item Trace: nodes with project, number, name, class and steps, the links between them, and the hidden count; steps 1–6 (default 3)
MCP program_mapThe same as GET /program-map
MCP trace_chainThe same as the trace call; items in projects with regulated-data markings answer withheld

See API and MCP.

Messages

MessageMeaning
No links between your projects. Add one from an item's Trace section.None of your projects holds or receives a link you can see
This project has no links to other projects. Add one from an item's Trace section.The map was opened from a project without links
This item has no links to other projects. Add one from its Trace section.The traced item has no links
Some projects are still being read. Refresh in a minute.Recent changes in large projects are still being read; the map shows what is ready
Showing the first 500 items. Reduce the steps.The Item Trace reached its limit
N links from projects whose owner's plan doesn't include links to other projects are not followed.The Item Trace skipped links stored under a plan without them
The program map could not be read. Reload the page.The request failed

Limits

LimitValue
Item Trace steps1 to 6
Items in an Item Trace500
Links listed per page in an arrow's list100
Links per project20,000 (see Links to Other Projects)