Contents x
    Gauge Node
        Contents

        Gauge Node

            Article summary

            Gauge Node

            The Gauge node displays your data in a dial animation. It works with numeric values and will display a minimum and maximum possible range. You can configure several ranges between the minimum and maximum values and assign them different colors, quickly showing whether an output value is within the desired parameters.

            The gauge node takes the latest value from your input data field to display on your dashboard widget. The dial points to the corresponding position on the gauge as the data value changes.

             

            Adding a Gauge 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 Gauge node and drag it onto the canvas.
            4. Connect the Gauge node to the relevant input node.
            5. Double click on the Gauge node to open its configuration window.

            Configuring your Gauge node

            1. You will need to give your node a name. Choose something simple that clearly explains its purpose. You must pick a name that has three or more characters.
            2. Next, select your Input Data Field: the field within the incoming JSON payload containing the data the widget will display. 
            3. 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 smaller font.
            4. Select the Device/Device Label Name checkbox if you want the device or label name visible on the widget.
            5. Enter the minimum value. This number will appear on the left end of the gauge. It must be an integer greater than or equal to 0.
            6. Enter the maximum value. This number will appear on the right end of the gauge. It must be an integer greater than 0 and should be larger than the minimum value.
            7. Choose whether you would like a symbol to appear at the end of the value. For example, if displaying temperatures, you could select °C or °F.
            8. If working with Decimal Precision, enter the number of decimal places you want your dashboard data to display.
            9. Finally, enter a Rangefor your gauge.
              • You can configure each multi-row to display a colored range inside the gauge. For example, you might want a soil temperature between 0°C and 20°C to appear as a range colored red.
              • Enter the lower value in the first textbox and the upper value in the second textbox. Then select a color for the range using the color picker.
              • Add other ranges by clicking the ⊕ Add Value button and repeating the above process.
              • You can change the order by clicking the arrow handles on the left of a row and dragging the row to its new position.
              • Delete ranges by clicking the delete button (‘X') at the end of each row.
              • Set dynamic ranges by providing a variable name in place of a numeric value. You must configure the dynamic variable using the format [[variableName]]. You can also combine dynamic and static variables in the same range. For example, you could set a range from 0 to [[max]] or from [[min]] to 100.
            10. Once you’re satisfied with your Gauge conditions, click Save to confirm the configuration.

            Grouping by device label

            If you want to group by device label, you will first need to create at least one label in the Device Labels section of the Workspace. See Creating Device Labels and Configuring Nodes Using Labels for more information.

            1. Select the label you will be using to filter devices from the dropdown list under Device label name.
            2. Select a method for grouping the widget on the dashboard:
              1. No Grouping (widget per device) will create a unique widget for each device.
              2. Group by device label value (widget per label value) will create a unique widget for each unique label value. For example, if the device label is ‘Color’ and the label values are ‘Green’ and ‘Gold’ the dashboard will show two widgets. One will contain data for devices labeled ‘Green’ and the other for devices labeled ‘Gold’.
              3. Group by device label name (one widget) will display only one widget. It will contain data from all devices with the device label specified.
            3. Next, choose a function to apply to the labeled devices. This step is important if multiple devices are sending data to a value node. The function options are:
              • Last value received,
              • Sum,
              • Average,
              • Maximum,
              • Minimum,
              • Last value from each device with common device label.
            4. If the Function field is set to Sum, Average, Maximum, Minimum, or Accumulated, enter a Calculation interval to determine how often the function runs. You will also need to select a Unit of Measurement from the dropdown menu. The options are temporal, ranging from seconds to years.
            5. If the Function field is set to ‘Last value from each device with common device label’, you must also select a Subfunction. The options are Sum, Average, Maximum, or Minimum.

            What's Next