---
title: Dashboards
slug: dashboards
docTags: 
createdAt: 2025-05-16T14:59:36.020Z
---

The *dashboard* is designed to extract information from the data source and present them to the user. The dashbaord is made up of *dashboard items* that coexist on a page or series of pages. Where 



# Select an Existing Dashboard 

The existing dashboards are listed to the left in the "Templates" section of the side panel. Click on the dashboard to make it active in the main frame. 

::Image[]{src="https://api.archbee.com/api/optimize/susm_2FFeL_TX9U5u_7FQ/HAo6kpRgk3jr8Bm9YwThK_image.png" size="54" width="270" height="172" position="flex-start" showCaption="false"}

# Populate a Dashboard with Data  

First, [Data Model](docId\:cDqm704yCo_rXok_e_uO-) in the data model tab. A dashboard must be designed an active to populate with data. 

## Select Data

From the [Project Manager](docId\:e7hg5m6OuvBJRf2Qdzj7J) select the  



![](https://api.archbee.com/api/optimize/susm_2FFeL_TX9U5u_7FQ/MsO_u-2TQBj0RGo0dXkTE_image.png)

Change the selection:

::Image[]{src="https://api.archbee.com/api/optimize/susm_2FFeL_TX9U5u_7FQ/S6xQ3e6ZMfInlTQ3R6c6X_image.png" size="48" width="251" height="164" position="flex-start" showCaption="false"}

Select Update: 

::Image[]{src="https://api.archbee.com/api/optimize/susm_2FFeL_TX9U5u_7FQ/94dPVx5s4kzoLposfC9AB_image.png" size="12" width="50" height="72" position="flex-start" showCaption="false"}

The visualization will change:



![](https://api.archbee.com/api/optimize/susm_2FFeL_TX9U5u_7FQ/e5X7rua4HDGVCt2pwl5ur_image.png)

## Auto-update 

The auto-update function will update the visualization every time a control is changed.



::Image[]{src="https://api.archbee.com/api/optimize/susm_2FFeL_TX9U5u_7FQ/EQWu7OL5FAD0JoUZN0_Hb_image.png" size="28" width="96" height="100" position="flex-start" showCaption="false"}

:::hint{type="success"}
The Auto-update visualization is not the same as auto-update form data source. See [Watch Files](docId:1-YQA-Ac8bjaq5uzoUzYA) to set up a file to automatically updates when new data is written to it. 
:::

## Display Level 

The [Project Manager](docId\:e7hg5m6OuvBJRf2Qdzj7J) can be set up with a hierarchal orginization. At the dashboard the user can select to display data as [Experiments](docId\:HSqmvWjk7otI9XDd-xe5J), [Specimens](docId\:DGzvi-hBKTnAxln_uMJLI), [Splits](docId\:dXdMn8TIy7KL9vnHPdHlp), or [Sample](docId\:ammluQzyPl_ARuQovc6mJ) level.  



::Image[]{src="https://api.archbee.com/api/optimize/susm_2FFeL_TX9U5u_7FQ/Lmij5BjmvRQECA-WmBCyW_image.png" size="50" width="227" height="100" position="center" showCaption="false"}

## Combine 

When a layer other than Experiment is selected the values will be combined up to that level. It will have equal weights assigned. Data can only be displayed at a level if that level is present with data in the project manager.  

The order from highest to lowest is:

1. Project 
2. Sample
3. Split
4. Specimen 
5. Experiment 

Projects can be nested and have attributes that are accessible in metadata. 

- No data is combined at the experiment level 
- Data at the specimen level is always combined equally
- Split level data can have unequal weights. This level is only employed when a separation has been applied. 
- At the Sample level, data can be selected to display all data or only the data added to splits.



::Image[]{src="https://api.archbee.com/api/optimize/susm_2FFeL_TX9U5u_7FQ/tyLe0ZDRsD0OVMphJmOKD_image.png" size="26" width="88" height="96" position="flex-start" showCaption="false"}

## Grouping 

Groupings can be applied to AMICS data that include extra features required only for textural groupings:  



::Image[]{src="https://api.archbee.com/api/optimize/susm_2FFeL_TX9U5u_7FQ/zXC63w6zSISJ3CGLCO36__image.png" size="34" width="170" height="103" position="flex-start" showCaption="false"}

When applied at this level the grain table is combined when adjacent grains are grouped into the same material. This is only for data loaded from AMICS.