8.4. Chartbox

In this section it is explained the main functionalities and interactions available within a Chartbox, a window contained in the Main Panel that displays entities data with different configurations.

To start a new Chartbox, press Display Historical Data or Display Dynamic Data in Edit or in Shortcuts Bar. These chartbox will be displayed in the central panel with the title of the DataKind they refer to. In these charts it will be displayed the Series of data that the user initialize. For how to set a new series please refer to Create Historic Series Dialog or Create Dynamic Series Chartbox.

8.4.1. Chart Menu

In the top bar of each Chartbox there is a Menu tab Chart with the following buttons.

8.4.1.1. Reset zoom

Reset the zoom of the Chartbox to the standard one. The standard zoom is calculated to fit all the data that is being currently displayed. It is also possible to take this action by clicking on the Reset Chart Zoom button displayed in the same chart box.

8.4.1.2. Set axes

This menu opens a dialog pop-up for the user to set the axes of the chart. Changing the X-axis (time axis) is disabled by default, thus maintaining the time values currently displayed on the chart. This allows dynamic charts to continue to update the value of the X-axis while the Y-axis remains fixed. It is also possible to access this dialog by clicking on the Set Axes button displayed in the same chart box.

../../../_images/set_axes.png

To return to the original time axis, and allow a dynamic update of the Y-axis, simply click on the Reset zoom button located to the right of the chart.

8.4.1.3. Clear chart

Eliminate every data configuration displayed in the Chartbox

8.4.1.4. Rename chart box

Change the name of the chart box.

8.4.1.5. Close chart box

Eliminate the Chartbox and every configuration in it. It could be removed as well pressing the x button in the top of the chart.

8.4.1.6. Export to CSV

Export the data of all series in the chart box to a CSV file. Please refer to section Export data for more information on the format of the generated CSV file.

8.4.1.7. Chart Controls

Displays an informative dialog with the key combination to execute actions on the chart. It is also possible to access this dialog by clicking on the Interactive Chart Control Info button displayed in the same chart box.

../../../_images/chartbox_info.png

8.4.2. Series Menu

In the top bar of each Chartbox there is a Menu tab Series with these buttons.

8.4.2.1. Add series

Add a new series in this Chartbox. This will open a new Create Historic Series Dialog or Create Dynamic Series Chartbox.

8.4.2.2. Hide all series

Hide all series in this Chartbox.

8.4.2.3. Display all series

Reveal all series in this Chartbox.

8.4.3. Chart Interaction

The user could interact with the Chartbox and the data in it by resizing and moving the view.

8.4.3.1. Point description

Clicking in any point of a displayed series, an info box will be prompt with the x and y label values of the data point.

8.4.3.2. Moving the view

Press and hold Ctrl key and left click in one point of the Chartbox. Move the mouse to scroll over the data.

8.4.3.3. Zoom in/out

Press and hold Ctrl key and scroll up to zoom in to the center of the Chartbox. Press and hold Ctrl key and scroll down to zoom out from the center of the Chartbox.

8.4.4. Series Configuration

Right clicking in the name of a series in the Legend will open a dialog with the available configurations for a series.

8.4.4.1. Remove series

Remove this series.

8.4.4.2. Rename series

Change the name of this series.

8.4.4.3. Change color

A Dialog will open to choose a new color for the series and the points displayed. Also available with left click on the color of the series in the Legend.

8.4.4.4. Hide/Show series

Hide a series if it is displayed, or it reveal it if it is hide. Also available with left click on the name of the series in the Legend.

8.4.4.5. Export to CSV

Export the series data to a CSV file. Please refer to section Export data for more information on the format of the generated CSV file.

8.4.5. Dynamic chartbox

The chartbox that holds dynamic series have some extra functionality. These chartbox could be stopped at any time (or played in case they are already stopped). This allows to stop the updating the axis, so zoom and move along the chart is available. The data presented in the chartbox will keep updating with the same time interval independently of the play status.

To pause the real time update of the time axis, click on the Real-Time menu or on the Enable Real-Time/Disable Real-Time button placed on the right side of the chart, or set the axes to a specific value with the Set axes button.