Image Overlay Node

Involves placing one image on top of another, usually a base image or map, with the overlay often containing additional information or highlighting specific areas. Useful in GIS applications, or data visualization over geographic maps.

Inputs

The Image Overlay node has mandatory inputs. These are:

Input

Requirement

Comments

Areas - Location

Mandatory

This is the location of the field that is being displayed on the uploaded image

Areas - Data Field Name

Mandatory

This is the field name within the incoming JSON payload that contains the data to be displayed on the widget.


Functionality

The Image Overlay node is used to show data with a user-uploaded image as the background.

Outputs

The data value shown on the image at a location specified by the user.

How to Use

Implementation

In the Rayven Workflow Builder:

  • Select Visualizations.
  • Drag the Image Overlay node to the canvas.
  • Connect the TImage Overlay node to your input node.
  • Double click on the Image Overlay node to open the configuration window.

Configuration

Section: General

This section contains basic configuration elements required for any Image Overlay implementation

Field

Requirement

Comments

Widget Name

Mandatory

Enter a name for this node.


This provides a handle to which you and others can refer, so it should be simple but meaningful and explain the node’s purpose.

Widget Header

Mandatory

Ability to show or hide the widget’s header.

Device Name

Optional

Select this option if the device name should be shown to the dashboard viewer.

Background Color

Optional

Ability to select desired colors as the image overlay’s background color.

Edit Overlay

Mandatory

Ability to upload an image, add objects and textbox. Every object and textbox has their own unique SVG_ID.


The SVG_ID will be shown on the right hand side of the edit overlay pop up when an object is created.

Widget Subtitle

Optional

Enter a subtitle for this node.


This provides additional information to the end user regarding the information displayed on this node.

Decimal Precision

Optional

Enter a numerical value to set the decimal precision of the information displayed.



Section: Areas

This section is where the user can configure the list of fields to be displayed on the dashboard and the location of the field on the uploaded image.

Field

Requirement

Comments

Area Name

Optional

Enter a name to be shown on the tooltip message when hovered over the object or text box that is overlaid on the image.


Note: There should not be any spacing in this field.

Text

Optional

Select an option from the dropdown menu:

  • Text
  • Object

Input Data Field

Optional

This is the field name within the incoming JSON payload that contains the data to be displayed on the objects overlaid on the image.

SVG ID

Mandatory

A unique ID that allows users to tie a value to an object that is overlaid on the image. 

Decimals

Optional

Enter the number of decimal places to display on the dashboard.

Pre Symbol

Optional

Enter a symbol that will be displayed at the beginning of the value.

Post Symbol

Optional

Enter a symbol that will be displayed at the end of the value.

Thousands Comma

Optional

Select an option from the dropdown menu:

  • Commas - There will be comma separators at the thousand mark.
  • No Commas - There will be no comma separators at the thousand mark.

Dashboard to Link to

Optional

Drop down list to select a configured dashboard to link to.



Section: Tooltip Info

Field

Requirement

Comments

Show Tooltip

Optional

When checked, it allows users to display their tooltip text on the widget.

Tooltip Text

Optional

This section only exists when “Show Tooltip” is checked.

Users are able to write any tooltip message they desire which will be display on the widget.



Section: Group by Device Label

Field

Requirement

Comments

Device label name

Mandatory

There are no labels available in this box until you have saved at least one in the Device Labels section of the Workspace. 


Select a Label to use to filter devices.

Grouped

Mandatory

Select a method for grouping the widget on the dashboard from the dropdown:


No Grouping (widget per device): one widget will appear for each device


Group by device label value (Widget per label value): One widget will appear for each value of a label. For example, if the Label is ‘Color’ and there are the values ‘Green’ and ‘Gold’, then two widgets will be displayed, one with devices with Color Label equal to “Green” and one with devices with Color Label equal to “Gold”


Group by device label name (One widget): Only one widget will be displayed and this will contain data from all devices.


Steps by Steps Section

  1. Open the configuration window by double clicking the image overlay node in the workflow.
  2. Click on “Edit Overlay” on the pop-up window. You will see another pop up window as shown below.

  1. In this pop-up window, you are able to upload a photo or display your own creativity by drawing.
  2. This canvas will allow you to receive data from your data source and display on the Rayven’s dashboard.

  1. To upload a background image for your image overlay node, click on “File” and select “Image”.
  2. After uploading your desired photo as the background, you are able to create different shapes simply by choosing one of the icons on the left-hand side bar.
  3. After creating your box, you can add a Text box to the image overlay by clicking on “T” on the left-hand side of the bar.
  4. If you wish to display your data from your data source, you can create a text box and give it any name. Grab the Element Details ID (svg_5 in the photo above).
  5. Click on File, select “Save & Close” or you can use your keyboard shortcuts (ctrl + s).

  1. Click on the “Areas” section.
  2. Give your area a name, please note that there should be no spaces.
  3. Provide your input data field from the data source or the workflow.
  4. Provide the SVG ID from the Element Details ID.
  5. Once that’s done, you can save the configuration and make sure your node is connected. You will be able to see data display on the image overlay widget on the dashboard when it receives data.