Skip to main content

Scene Tree

The scene tree occupies the left panel of the editor and provides a hierarchical view of all objects in the current scene. It has two tabs: Setup and Results. The Setup tab shows the design configuration; the Results tab shows solver runs and their iterations.

Tabs​

At the top of the scene tree, two tab buttons switch between Setup and Results. The active tab is highlighted with the primary accent color. The Results tab shows a badge count of solver jobs when any exist (for example, "Results (2)").

Switching from Results to Setup clears the selected run and any active visualization, and deselects all objects.

Setup tab​

The Setup tab displays the scene as a hierarchy of sections containing objects. Sections are top-level category headers; objects are the actual scene entities (preserves, parts, paths, obstacles).

Section structure​

The tree always contains these sections in order:

SectionContentsAlways present
SettingsDesign Parameters, Analysis Parameters (synthetic nodes that open configuration panels)Yes
Input / Input/OutputInput preserves (Separate mode) or I/O preserves (Combined/Flexure mode)Yes (label varies)
OutputOutput preservesOnly in Separate mode
PairsPreserve pairs linking inputs to outputsOnly for compliant, 3D compliant, metamaterials, and decoupled flexure analyses
FixedFixed preserves and boundary conditionsYes
ObstaclesKeep-out zone objectsOnly for analysis types that support obstacles (not metamaterials or flexure)
MaterialMaterial selection (synthetic node that opens the material picker)Yes

The exact sections depend on the analysis type and the current preserve mode. Flexure analyses always show a single "Input / Output" section. Metamaterials and flexure analyses never show an Obstacles section.

Object hierarchy​

Within each section, objects follow this nesting pattern:

Section
  Preserve
    Part (geometry)
    Path (motion direction)
    Path (additional, for multi-path outputs)
    [+ Add path] (placeholder)
  Preserve
    ...

Each preserve can contain:

  • A part child defining its geometry (rectangle, box, STEP, or STL).
  • One or more path children defining motion direction (linear or rotational).
  • Placeholders shown as dashed entries for missing children (for example, "Add path" when no path is attached).

Obstacles follow a simpler pattern:

Obstacles
  Obstacle
    Part (geometry)

Expand and collapse​

Every node with children has a chevron toggle. Clicking the chevron or the section header expands or collapses that subtree. New nodes are automatically expanded when they appear in the tree.

Keyboard navigation is also supported: use arrow keys to move focus between visible items, left/right arrows to collapse/expand, Enter or Space to select, and Shift+click for multi-select on objects.

Selection​

Clicking an object node selects it and displays its properties in the right panel. The selected item is highlighted with a blue border. Multi-select is supported through Shift+click, which toggles individual items in the selection.

Section headers are clickable when they have an associated panel override (for example, clicking "Settings" opens the design configuration). Clicking a section also toggles its expansion state. The Settings section contains synthetic child nodes -- "Design Parameters" and "Analysis Parameters" -- that open their respective configuration panels.

The Material section and its child node both open the material selection panel when clicked.

Validation indicators​

Each section and object can display a validation status icon to the right of its label:

IconMeaning
Green checkmarkAll required fields are filled.
Gray question markMissing required data (unfilled).
Red XConfiguration error.

Section-level indicators roll up the status of their children. When all children in a section are complete, the section shows a green checkmark.

Visibility indicators​

Objects that are hidden show a crossed-out eye icon next to their name. Suppressed objects show a ban icon and their name is displayed with a strikethrough style. Both hidden and suppressed objects have dimmed text.

Context menus​

Right-clicking a section header opens a context menu with creation options for that section type. For example, right-clicking the Input section offers "Rectangle", "STEP Model", and "STL Model" options for creating new input preserves. The Pairs section offers "Add Pair". Sections without creation options (Settings, Material) do not show a context menu.

Right-clicking an object opens a context menu with actions like Rename, Delete, and Delete All of Type (to remove all objects of the same type).

The Pairs section header also has a "+" button for adding new pairs directly without right-clicking.

Results tab​

The Results tab replaces the tree with a run list showing all solver jobs, sorted newest first. When you drill into a run, a run detail view slides in from the right, replacing the run list.

Run list​

Each row in the run list displays:

ElementDescription
Status dotColor-coded circle: gray (queued), blue/pulsing (running), green (completed), yellow (cancelled/cancelling), red (failed).
Run nameEditable name, defaults to "Untitled Run".
Iteration count / time estimateFor completed runs, shows the number of optimization iterations. For running jobs, shows an estimated time remaining.

Running jobs also show a thin progress bar beneath the row.

Single-click a run to select it and preview the final iteration result in the viewport. Double-click to drill into the run detail view.

Right-clicking a run opens a context menu with Rename and Delete options. Deleting a running or queued job cancels it first.

When no solver runs exist, the run list shows a placeholder message with a link back to the Setup tab.

Run detail​

Drilling into a run slides the view to show the run detail panel. The tab bar collapses during this transition. At the top is a back button (arrow left, labeled "Results") that slides back to the run list.

The header shows the run name, a status badge (Queued, Running, Completed, Failed, Cancelled, Cancelling), and a creation timestamp.

Below the header are visualization cards -- clickable accordion panels that switch the viewport display mode:

CardWhen shownDisplays
StressCompleted runs with an auto-test resultVon Mises stress heatmap. Shows max stress, safety factor (color-coded: green above 1.5, orange 1.0--1.5, red below 1.0), and 90th percentile stress.
DesignAlwaysDeformation visualization of the optimized design. Shows convergence status, current iteration, volume fraction, and compliance.
MetricsCompleted runsQualification analysis metrics: max input/output displacement at yield, max input/output force at yield.
Custom test resultsWhen custom test mechanism runs existApplied load, max stress, and safety factor for each custom test. Shows a pass/fail status dot.

Only one card is active at a time. The active card expands to show a specs panel with key metrics in a bordered sub-panel.

Previous iterations​

Below the visualization cards is an expandable Previous Iterations section. Clicking it toggles open a list of all optimization iterations, sorted newest first. Each row shows the iteration number.

Clicking an iteration switches the viewport to show that iteration's design. If the iteration has a result field, a fork button (branch icon) appears to the right, allowing you to start a new solver run from that iteration's state.