Key performance index (KPI) factors determine critical measures when evaluating an urban design proposal. Using CityEngine Dashboards, you can create charts of custom-defined key numbers. The Charts are driven by CGA report variables. With every change of a CGA model through an attribute change in the Inspector, a handle, or a local edit, the Dashboard is updated automatically and always in sync with the 3D model in the Viewport.
- Dashboards can consist of multiple pages that can hold multiple cards.
- There are multiple card types to choose from: Key Number, Bar Chart, Stacked Bar Chart, and Pie Chart.
- Use the Title and Text Card to provide static information about the charts.
- Cards can be resized and placed freely in a grid system using the mouse.
- The menu in the corner of a card allows you to edit, duplicate, or delete a card as well as copy values to the clipboard.
- Cards can display data coming from various scenarios.
Check out the Example Philadelphia 2020.0 in the main menu (Help > Download Tutorials and Examples). This scene is a good example of how scenarios, CGA reports, and Dashboards interact.
Configure a dashboard
To configure a dashboard, complete the following steps:
- Click Window > Dashboard in the main menu to configure a Dashboard.
- Click the Add card tool in the Navigation Bar.
- Choose a card type.
Dashboards have the following parameters:
Icon & Title
Choose an icon and title.
Multiply the values of a report by a constant number.
You can choose to display the values of the reports computed on the entire scene or only on the selection. By default, a card displays the values on the entire scene.
The aggregation type defines how to combine all the reported values from the whole scene into a single number for each report or subreport, that will then be shown in the chart:
The Unit displayed next to the value in the card. Has no influence on the calculation or the value displayed.
Minimum and Maximum (for Bar Chart)
Defines the range of the value axis.
Scaling (for Bar Chart)
Specifies the scaling of the axis:
Decimal places—Specifies the number of decimals to display.
Sorting (Pie Chart)
Sorting of reports:
Legend (Stack Charts and Pie 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 specify a color for each report in a CGA file by the hashtag #color, for example:
Lot --> report("report_name",1.0) report("report_name#color","#ff0000")
Dashboards and scenarios
Two modes are available in the Dashboard concerning the data to display:
- Active Scenario
- Compare Scenarios
Switching from one mode to anther is done by clicking the button in the navigation bar. In the Active Scenario mode, the cards will only display the report values of the object belonging to the scenario activated in the Scene Editor.
Active scenario mode
Compare Scenarios mode
In the Compare Scenarios mode, the cards will display the report values of all the scenarios of the scene:
In the Compare Scenarios mode, the Pie Card displays one pie chart per scenario:
For more information about scenarios, see Scenarios.
Manage the Dashboard
It is possible to create many pages in the Dashboard. Click the Options tool on the Navigation Bar to display a menu with the following options:
- Add pages—Add a new page where you can set the name.
- Rename Current Page—Rename the current page.
- Duplicate Current Page—Duplicate the current page.
- Delete Current Page—Delete the current page (except if there is only one page in the dashboard).
- Table View—Display the values of reports by scenario in a table.
The Table View displays for each report its names, aggregates, and the color when 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 the following:
- Report or Group of Reports
- All Scene or Selected Objects