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.
Open the Dashboard menu by choosing
You will see the default Dashboard View with the Navigation Bar and one Page.
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.
Click in the Navigation Bar to add a new card to the dashboard.
A Configuration Dialog will pop up.
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:
- Key Number
- Bar Chart
- Stacked Bar Chart
- Pie chart
- Text Field
Configure your Card
Title with icon
The first input allows you to define an icon and a title for the Card.
Clicking on the icon button pops up a dialog to choose the icon for the card.
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.
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:
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.
You can multiply the values of a report by any constant number. By default this constant is 1.
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
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:
- Number Of Objects of
- Sum of
- Percentage of
- Average of
- Minimum of
- Maximum of
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.
Scaling (for Bar Chart)
For a Bar Chart you can specifiy the axis scaling:
- Uniform (by default)
For any type of Card you can specifiy the notation used to display numbers:
- Decimal (e.g. 48'876'592)
- Scientific (e.g. 4.888e+7)
For Bar Charts, Stack Charts and Pie Charts you can sort the reports three different ways:
For Stack Charts and Pie Charts you can decide to show or not the legend of the charts.
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")
When you hover over any card, a button appears on the upper right corner. Click it to display a context 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.
Click the Delete Card item to remove the card from the dashboard.
Once your card is created, you can resize it by dragging the handle on the lower left corner of the card.
Once your card is created, you can move to the page by clicking anywhere on the card and dragging it.
Two different modes are available in the Dashboard concerning the data to display:
- Active Scenario
- All Scenarii
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:
In the Multi Scenario mode, the cards will display the reports values of all the scenarii of the scene :
In the Multi Scenario mode, the Pie Card will display one pie chart per scenario :
For more information about scenarios, See scenarios.
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:
Click Add Page to display a popup dialog to set the name of the new page.
You can also rename the current page by clicking Rename Page.
Finally, you can delete the current page by clicking Delete Page, (except if there is only one page in the dashboard).
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.
The Table View displays for each report its names, aggregates, and the color if it is specified in the CGA file.
With the three drop-down menus on top of the Table View, it is possible to filter the reports by:
- Report or Group of Reports
- All Scene or Selected Objects
Copyright ©2008-2017 Esri R&D Center Zurich. All rights reserved.