Dashboards

In a Dashboard, you can create visual charts and graphs to help you visualize information in your scene. You create them from data reported in the CGA rules. With the Dashboard feature, you can display the results of reports in real time. You can also see the results of the reports in the Inspector.


Reports in the Inspector

Open dashboards

Open the Dashboard menu by choosing Window→Show Dashboard.


Opening the Dashboard

You will see the default Dashboard View with the Navigation Bar and one Page.


New Dashboard View

As you add cards to the dashboard, the dashboard configuration is saved in a .txt file located in ProjectName\data\confDashboard-v2-<scene>.txt . The configuration automatically saves when you save the scene.

When you open a new scene, you will start with a new configuration.

Add Cards

Click in the Navigation Bar to add a new card to the dashboard.

A Configuration Dialog will pop up.


Card Configuration Dialog

This Configuration Dialog allows you to choose the type of Card:

By clicking on the upper images, you can choose between the following types of Cards:

Configure your Card

Title with icon

The first input allows you to define an icon and a title for the Card.


Card Icon and Title Configuration

Clicking on the icon button pops up a dialog to choose the icon for the card.


Dialog to select an Icon

Choose a report

Choose from a list of reports created by the applied CGA rule(s) (e.g. Area by flooring type, Area by interior space type, Number of work places, etc.).

The drop-down menu has a text box which allow text filtering among the report names.


Report Input

A Key Number Card can display the values of all reports.

The Stack Chart, Bar Chart and Pie Chart only display the values of group reports. To create a group of reports you need to create reports with syntax Group.SubReport, for instance:

Divide by

There is also an option to divide a report by another report. By using the reportName.* notation, corresponding sub-reports (with the same sub-report name) can also be divided.

Multiply by

You can multiply the values of a report by any constant number. By default this constant is 1.

Reporter

You can choose to display the values of the reports computed on all the scene or only on the selection. By default a card displays the values on all the scene.

Additional configure options

Aggregation

The aggregation type defines how to combine all the reported values from the whole scene into a single number for each report or sub-report, that will then be shown in the chart:

Unit

You can specifiy the Unit of a report (e.g. meter, m², €, etc.). The Unit is a simple text which will be displayed in the Card.

Minimum and Maximum (for Bar Chart)

By default a bar chart will automatically scale the value axis to rounded values taking into account the maximum and minimum values of the reports. The user can still force the minimum and maximum values in a Bar Chart by setting the minimum (or maximum) to "Custom" and entering a value.


Configure the Maximum value of a Bar Chart

Scaling (for Bar Chart)

For a Bar Chart you can specifiy the axis scaling:


Bar Chart with a Logarithmic Scale

Notation

For any type of Card you can specifiy the notation used to display numbers:

Sorting

For Bar Charts, Stack Charts and Pie Charts you can sort the reports three different ways:

Legend

For Stack Charts and Pie Charts you can decide to show or not the legend of the charts.

Colors

The colors of the reports in the Dashboard are, by default, defined by the color of the scenarios set in the Scene Editor. It is possible to specifiy a color for each report in a GCA file by the hashtag #color. For instance:

Lot -->
	report("report_name",1.0)
	report("report_name#color","#ff0000")

Edit Card

When you hover over any card, a button appears on the upper right corner. Click it to display a context menu:


Card Menu

Click on Edit Card to open the Configuration Dialog for this type of Card.

Copy Values To Clipboard

Click on Copy Values To Clipboard to copy the numeric values of any cards to the clipboard.

Delete Card

Click the Delete Card item to remove the card from the dashboard.

Resize Card

Once your card is created, you can resize it by dragging the handle on the lower left corner of the card.


Card Resize Handle in the lower right corner

Move Card

Once your card is created, you can move to the page by clicking anywhere on the card and dragging it.

Scenarios

Two different modes are available in the Dashboard concerning the data to display:

Switching from one mode to anther is done by clicking on the button in the navigation bar. In the Active Scenario mode, the cards will only display the reports values of the object belonging to the scenario which has been activated in the Scene Editor:


Active Scenario Mode

In the Multi Scenario mode, the cards will display the reports values of all the scenarii of the scene :


Multi Scenario Mode

In the Multi Scenario mode, the Pie Card will display one pie chart per scenario :


Multi Scenario Pie Card

For more information about scenarios, See scenarios.

Pages

It is possible to create many pages in the Dashboard. Click on the on the right side of the Navigation Bar to display a popup dialog:


Page Menu

Click Add Page to display a popup dialog to set the name of the new page.


Add New Page Dialog

You can also rename the current page by clicking Rename Page.


Rename Page Dialog

Finally, you can delete the current page by clicking Delete Page, (except if there is only one page in the dashboard).


Delete Page Dialog

Table View

The user can display the values of reports by scenario in a Table. To display the Table View, the user has to select Table View in the menu accessible by clicking on the upper right button.


Table View Menu

The Table View displays for each report its names, aggregates, and the color if it is specified in the CGA file.


Reports in the Table View

With the three drop-down menus on top of the Table View, it is possible to filter the reports by:


Filtering Reports in the Table View

Copyright ©2008-2017 Esri R&D Center Zurich. All rights reserved.