Cartesian Chart Node

Cartesian Chart Node

The Cartesian Chart node receives two inputs and plots them against each other on the x- and y-axes. The value of both inputs determines the location of each data point on the chart.

A Cartesian Chart is used to create a scatter plot when you have multiple data points to display.

Inputs

To create a cartesian chart node, you will require two inputs:

1. X-axis field name: this determines the value of each data point on the x-axis.
2. Y-axis field name: this determines the value of each data point on the y-axis. 
   

Adding a Cartesian Chart node to your workflow

1. First, select your desired solution and navigate to Rayven Workflow.
2. Select ‘Visualizations’ from the left-hand panel. 
3. Find the cartesian chart node and drag it onto the canvas. 
4. Connect the cartesian chart node to your input nodes.
5. Double click on the cartesian chart node to open its configuration window.

Configuring your cartesian chart node

1. First, give your node a Name. Choose something simple that clearly explains its purpose.
2. If you want, you can add a Widget Subtitle. This additional text helps explain the data presented in the node. Anything added here will appear directly under the Widget Name in a smaller font.
3. Select the Device/Device Label Name checkbox if you want the device or label name displayed on the widget.
4. If working with Decimal Precision, enter the number of decimal places you want the dashboard data to display.
5. Selecting Auto-Scale by Min/Max Values will enable the minimum and maximum ranges on both axes to be automatically adjusted. 
6. Finally, you can choose how often the chart widget will refresh using the Widget Refresh Interval. The unit of measurement is seconds, with a default of every sixty. 

Configuring the x-axis

1. Enter a name for the x-axis label.
2. Select the minimum and maximum values for the x-axis.
3. Enter the center value on the x-axis. The widget will display a vertical line that crosses this point. 
4. Enter the x-axis field name to determine the value of each data point on the x-axis. This value must exactly match the field name in the JSON payload. 
5. Select an x-axis function from the dropdown menu to select what calculation you want the node to perform. This calculation will determine the value displayed by each data point. You can choose from the following options:
   1. Last value received,
   2. Average,
   3. Minimum,
   4. Maximum,
   5. Sum.

Configuring the y-axis

1. Enter a name for the y-axis label.
2. Select the minimum and maximum values for the y-axis.
3. Enter the center value on the y-axis. The dashboard will display a horizontal line that crosses this point. 
4. Enter the y-axis field name to determine the value of each data point on the y-axis. This value must exactly match the field name in the JSON payload.
   
5. Select a y-axis functionfrom the dropdown menu to select what calculation you want the node to perform. This calculation will determine the value displayed by each data point. You can choose from the following options:
   1. Last value received,
   2. Average,
   3. Minimum,
   4. Maximum,
   5. Sum.

Adding data point colors

You can configure Rayven’s cartesian charts with different colors to help visualize data.

To add colors for each data set:

1. Select ‘Add color’.
2. Enter the input data field name.
3. Create a rule to determine the color of the corresponding data points on the cartesian chart.
4. Enter the hex code for the desired color.
5. Select ‘Add color’ again to add additional color rules.

Linking to a dashboard

Linking your cartesian chart node to a dashboard will open that dashboard when a user clicks a data point on the chart. To do so, select a dashboard from the dropdown menu under ‘Link to Dashboard’. For more information on drill-down dashboards, see Creating a dashboard.

Configuring quadrants

You can select background colors for different chart quadrants to better visualize your data.

There are four options available for each quadrant:

1. The default white background indicates the data is neutral.
2. Green shows the data is normal. 
3. Yellow suggests a minor issue or variance. 
4. Red signals there is a critical issue or variance.

Each quadrant has a field where you can select your desired color option. The different quadrants are top left, top right, bottom left, and bottom right. The center values of the x-axis and y-axis determine the size of each quadrant.

Grouping by device label

You will need to save at least one label in the Device Labels section of the Workspace before configuring this section. See Creating Device Labels for more information.

1. Enter your chosen device label under Device Label Name. 
2. Select a method for grouping the widget on the dashboard from the dropdown options:
   • No Grouping (widget per device) will create a unique widget for each device.
   • Group by device label value (widget per label value) will create a unique widget for each unique label value that exists. For example, if the device label is ‘Color’ and the label values are ‘Green’ and ‘Gold’, the dashboard will display two widgets. One will show data for devices labeled ‘Green’, and the other for devices labeled ‘Gold’.
   • Group by device label name (one widget) will display only one widget. It will contain data from all devices that have the device label specified.

See Also: Creating a dashboard, Creating device labels, Configuring nodes using labels