Using the Dashboard¶

Dashboard Modes (v0.6.0+)¶

Depictio dashboards operate in two distinct modes, each optimized for its specific purpose.

Viewer Mode¶

URL Pattern: /dashboard/{id}

Viewer mode provides a read-only experience optimized for data exploration:

No editing controls - Clean interface focused on data
Interactive filtering - Use filter components to explore data
Data updates - Visualizations respond to filter changes in real-time
Lightweight - Read-only rendering path, with none of the editing machinery loaded

When to Use Viewer Mode

Use Viewer mode when exploring dashboards, presenting to stakeholders, or sharing dashboard links with colleagues who don't need editing access.

Editor Mode¶

URL Pattern: /dashboard-edit/{id}

Editor mode enables full dashboard customization:

Add components - Create new figures, tables, cards, and filters
Edit components - Modify existing component configurations
Drag and drop - Reposition and resize components
Delete components - Remove unwanted elements
Save changes - Persist your layout and component settings
Tabs management - Create and organize dashboard tabs

Switching Between Modes

Click the Edit button in the dashboard header to switch from Viewer to Editor mode. Click View to return to read-only mode.

Two-Panel Layout (v0.6.0+)¶

Dashboards use a two-panel layout to organize components:

Panel	Location	Component Types
Left Panel	~20% width	Interactive filters (RangeSlider, MultiSelect, DatePicker)
Right Panel	~80% width	Visualizations (Figure, Table, Card, Text)

Components are automatically assigned to the appropriate panel based on their type when created.

Collapse it with the control at its edge. It shrinks to a narrow rail rather than disappearing, and the rail keeps showing how many filters are active, so a filtered dashboard never looks unfiltered.
Resize it by dragging its edge. The width is remembered for that dashboard, and the grid re-lays out to match.
Fold a section with its header. A folded section fetches nothing until you open it, and keeps a badge with the number of active filters inside it.
Read what is applied from the summary above the controls: one aligned row per filter, each with its own control's icon and colour. Click a row's clear button to drop just that filter. The whole summary folds to a single line.

Sections in the main grid work the same way, and a folded section of cards still shows its numbers in the header. See Sections.

Sections shown on every tab (v1.6.0+)¶

A section whose header carries a pin belongs to the whole dashboard rather than the tab you are on. In the filter panel that means the controls are the same on every tab and keep the values you set when you switch, which is what a filter the whole dashboard shares should do. In the grid it means the section is there on every tab, read-only unless you are on the tab that owns it, sitting either above or below that tab's own content.

Folding one folds it everywhere, so it stays out of your way as you move around. See Sections on every tab.

The map panel (v1.4.0+)¶

When a dashboard has a map authored as a dashboard-wide panel, it follows you across every tab rather than living in one. Use the header control to move it between floating, docked and hidden, and the panel header's menu to edit, duplicate or delete it.

Select on the map by lassoing, box-selecting or clicking; every tab of the dashboard follows the selection.
Open the rows behind it from the panel header or the tile chrome. The map's own columns come first, and ticking rows selects them on the map.
Lasso, click and row-ticking all produce the same filter, so they replace one another instead of stacking.

Dashboard settings drawer¶

Settings, at the top right, opens a read-only drawer describing the dashboard: its project, owner, visibility and last-modified date, then the dashboard and project IDs, each with a copy button. Since v1.6.0 the project name is a link to that project's page, and View ingestion report below it opens the ingestion report for any project, not just one built from a template. The same body backs the inspector's Info tab.

This replaced the Parameters panel (v1.0.0)

The Dash UI put a Parameters panel here, with switches for edit mode and interactivity and buttons to remove every component or reset every filter. Only one of those survived the React rewrite: Reset all, now at the top of the filter panel. Editing is the Edit button, and there is no global interactivity switch.

Component-wise options¶

In edit mode, hovering a component reveals three icons in its top-right corner, and resize handles on its edges and corners.

Drag handle: grab it to move the component in the grid.
Info: the component's metadata: type, data source, configuration.
Menu: Edit reopens the builder on this component, Duplicate copies it, Move to section hands it to another section, Delete removes it.

Table Component Features¶

Data Export (v0.6.0+)¶

Table components include a data export feature that allows you to download the displayed data:

Click the Export button (download icon) in the table component header
The table data will be exported as a CSV file
The export respects current filters and sorting applied to the table

Export Limits

Tables with < 100,000 rows: Instant export
Tables with 100,000 - 1,000,000 rows: Export allowed with warning
Tables with > 1,000,000 rows: Export blocked (use CLI for large exports)

How a Dashboard Loads (v1.3.0+)¶

A dashboard can hold dozens of panels, each needing its own request, so Depictio loads them as you reach them rather than all at once.

While the page opens¶

The Depictio logo animates in the centre of the page while the dashboard itself is being fetched. No panels are known yet, so there is nothing to count.
Panels load when they scroll into view. A panel below the fold shows a shimmering placeholder and costs nothing until you scroll near it, so opening a large dashboard stays responsive instead of waiting on every panel first.
A progress ring and a count (for example 6/8) sit beside the dashboard title, then disappear once everything on screen is ready. Hover it for a breakdown: how many are still loading, how many failed, and how many are further down the page.

Why the count can go backwards

The count covers what is on screen, not the whole dashboard, so it always completes. Scrolling brings more panels in and the count grows to include them, so a number that briefly drops is work which has just started, not a problem.

Reduced views and the Load-all button¶

Large data collections are not sent to the browser whole. Where a panel is showing a reduced view, it says so and offers a way out:

Hover a panel to reveal its action cluster. Load all is the bottom icon, and the badge beside the title says how much of the collection you are currently seeing.

Figures show a badge such as 9,900 / 12,011,000 pts. Hover the panel and click the Load all icon () in the action cluster to fetch every point; the badge switches to (all) and the button toggles back to the reduced view. Loading everything can be slow on a very large collection.
Tables page rows on demand. On tables past roughly a million rows, sorting is turned off: the chevron disappears from the column headers rather than offering a sort that would silently return unsorted rows.
Advanced visualisations that compute their values from the rows they receive (stacked taxonomy, DA barplot, enrichment, oncoplot, …) are normally sent the whole collection. If it is too large for that, they carry an orange estimated badge, meaning the values on screen are derived from a sample rather than being exact totals. The lollipop plot shows the same badge whenever its rows were sampled, since its per-gene counts are an aggregate.

See Performance & Scaling for the thresholds behind these behaviours and how to change them.

Interactivity¶

Interactive Actions¶

There are currently two types of interactive actions available in the dashboard:

Through the interactive components (e.g., RangeSlider, MultiSelect, etc.).
Through the graph components (only Scatter plots are handled yet).
Click mode: When you click on a point in the scatter plot, the other components will be updated according to the data point clicked.
Selection mode: When you select a region in the scatter plot (using the "Box select" option), the other components will be updated according to the data points in the selected region.

Reset Filters¶

Reset all filters You can reset all filters applied to the components by clicking the Reset all filters button in the right sidebar. This will clear all filters applied to the components and reset them to their default state.
Reset interactive component/scatter plot filter You can reset the filters applied to the graph components by clicking the orange Reset button in the component options at the top of the box. This will clear the filters applied to the graph component and reset it to its default state.
Clear one filter from the summary (v1.4.0+) Each row of the filter panel's active-filter summary has its own clear button, so you can drop a single filter without touching the rest.

Where the reset icon stays visible (v1.4.0+)

On figures, tables and maps the reset icon stays pinned while a selection is active, since a selection there is easy to miss. On an interactive control it appears on hover, so that it cannot sit on top of the select's chevron or the slider track.

Saving the Dashboard¶

Layout and section changes persist on their own, about half a second after you stop editing. There is no unsaved state to lose if you close the tab.

Save, in the editor toolbar, writes immediately instead of waiting for that delay, and queues a fresh thumbnail for the dashboard card. A short notification confirms it.

Exit Edit returns to viewer mode. The dashboard then shows up with its new thumbnail under Recently opened on the dashboards page.