Skip to main content

Layouts

With layouts, you can reuse a workspace for a recurring task or share it with a teammate solving a similar problem.

A perception engineer may develop layouts for calibrating various sensors, a planning engineer may have a few for visualizing different routing algorithm outputs, and a controls engineer may build one for plotting robot kinematics.

Use the "Layouts" menu to create, edit, and share layouts.

Layouts menu

Personal layouts

Personal layouts are accessible to only you – they cannot be viewed, loaded, or edited by anyone else.

When signed in, personal layouts are synced across all your devices, and can be shared with your organization.

Create

Use the "Layouts" menu's "Create new layout" option to start building a custom workspace.

Layouts glossary

Add and position panels, configure their settings, adjust playback settings, and set variable values.

Edit

When switching layouts after making edits to your current personal layout, you can take either of the following actions:

  • "Save changes" – Save your changes to the layout
  • "Revert" – Discard changes and revert to the last explicitly saved layout version
Modified personal layout menu

Import and export

Use a layout's context menu to "Export..." it as a JSON file. Alternatively, open the app menu's "View" submenu to "Export layout to file...".

Use the "Layouts" menu's "Import from file..." option to load an exported layout JSON file. Alternatively, open the app menu's "View" submenu to "Import layout from file...".

Share

Use a layout's context menu to "Share with team..." – this will make a personal layout accessible to your entire organization.

Other

Use each layout's details menu to rename, duplicate, or delete any personal layout.

To perform a batch action on multiple layouts:

  • Use Cmd to multi-select individual layouts
  • Use Shift to select a range of adjacent layouts
  • Right-click any selected layout's context menu to select a batch action

Organization layouts

Organization layouts allow teams to curate a set of canonical layouts to accomplish common tasks – e.g. for calibrating radar sensors, visualizing planning algorithm outputs, or viewing logs. Instead of maintaining marginally different setups for different tasks, teammates can use layouts preconfigured by workflow experts to avoid redundant work and accelerate development.

Organization layouts work very similarly to personal layouts – i.e. you can rename, copy, export, and delete them – but operate more as templates than evolving snapshots of a workspace.

Modified team layout menu

Edit

After editing an organization layout, you can take any of the following actions:

  • "Save changes" – Overwrite the organization layout with your changes
  • "Revert" – Discard changes and revert to the last explicitly saved layout version
  • "Make a personal copy" – Save changes as a separate personal layout (reverts changes to organization layout)

Share

Use a personal layout's context menu to "Share with team..." – this will make it accessible to your entire organization.

Organization layouts can be edited, renamed, or deleted by any team member.

Organization layouts

Layout Management

The layout manager allows for individual or batch changes to layouts:

Layout Manager

Add

Use the "Add" button to either create a new layout or import an existing one.

Layout Manager

  • "New Layout" will prompt for a name, personal or organizational, and an optional folder to store the layout under:

    Layout Manager

  • "Import Personal Layout" will prompt to select a layout JSON file from the computer's file system.

Browsing layout folders can be performed directly from the left panel. They are categorized at the top level by: all, personal, and organizational. Additionally, navigation can be performed from the right panel by clicking a folder row to move into it, or by clicking the breadcrumb at the top of the right panel to move out of it.

Searching & Filtering

Searching and filtering can be performed from the top of the right panel. Providing values to these controls will limit the shown layouts in the currently selected folder or top level category to those that match.

Individual Actions

To perform similar actions from the layout menu, clicking the "ellipsis" button will provide a dropdown revealing them. The actions listed will depend on the layout type and status. Clicking "Open" will navigate you to visualization with the opened layout preselected.

Layout Manager

Batch Actions

Batch actions are performed by selecting at least one row using the checkboxes in the left most column. Once selected the actions will appear above the table.

Layout Manager

Move to Folder

Only layouts of the same type, personal or organizational, can be selected to move to a new folder. Additionally, only a folder that exists under that same layout type can be chosen as a destination.

Layout Manager