Skip to main content
All CollectionsUser Guides
Plugins: Power Diagram
Plugins: Power Diagram

Visualize and monitor the behavior of your electric system using the four-quadrant diagram within active and reactive power.

Alejandro Mora Chica avatar
Written by Alejandro Mora Chica
Updated over a week ago

In the constant pursuit of improving the efficiency and quality of electrical systems, monitoring tools become essential.

With this purpose in mind, we have introduced a new widget plugin that illustrates the "Four-Quadrant Diagram" of electrical power, identifying the correct flow of active and reactive power within our electrical system. The purpose of this tool is to visualize energy consumption and injection into the grid, in addition to monitoring the power factor of our system in each quadrant and preventing potential penalties for energy ranges outside of standards.


  • Ubidots account (trial or licensed).

  • One device measuring electric variables, including active and reactive power.

1. What's a four-quadrant diagram?

The four-quadrant diagram is a graphical representation with two axis (P and Q) and four sections that helps to visualize and analyze the relationship between active, reactive and apparent power in an electrical alternating current (AC) system.

  • Active power (P): Is useful power that does some real work, expressed in Watts (W).

  • Reactive power (Q): Is the power, measured in Volt-ampere reactive (Var), released and stored by capacitors and inductors, affecting the power factor of a system.

  • Apparent power (S): Is the total power available in an electric system, expressed in Volt-ampere (VA). A combination of active and reactive power.

Each quadrant within the diagram corresponds to either a capacitive or inductive (positive or negative) load. Furthermore, each quadrant provides detailed insights into our system, offering valuable information for comprehensive analysis.

The horizontal axis corresponds to active power (P) and its position on the plane can be either negative or positive.

The vertical axis corresponds to reactive power (Q) and its position on the plane can also be either negative or positive.

​In addition to vectors P and Q, the vector S is displayed, representing the apparent power of the system, which is calculated from P and Q's data using the following expression:

2. Device configuration

To ensure proper utilization of the plugin, it's essential to include at least the following two variables in your device configuration.

  • Active power: its API Label must to be active-power.

  • Reactive power: its API Label must to be reactive-power.

NOTE: Consider that the diagram exhibits vectors only when the two associated variables (active and reactive power) possess values with the same timestamp. Therefore, if data is sent for only one of the variables, the diagram will not plot the vectors. Instead, it will present a message indicating this situation, as illustrated in the following image:

3. Creating a Power Diagram plugin

Step 1. In your Ubidots account, go to the "Devices" tab, click on "Plugins", and then click on the "+" button to create a new plugin. Look for the Power Diagram, click on it, and follow the steps shown in this GIF:

​​Step 2. After reading the plugin's description and moving into the next step, you must select the desired Ubidots token to create the plugin.

Step 3 (Optional). You can customize the name of your plugin and its description.

4. Configuring widget input data

To use the widget in any of your dashboards, simply click on the "+" button and scroll down to the "plugin" section. There, you will find the Power Diagram widget ready for selection. Click on it.

In the widget's settings, you will be able to change the following fields:

  • Add variables: select active and reactive power variables in your device.

  • Units: select the units to display the values on the diagram.

With these two variables (active and reactive power), the widget will calculate the power factor, Phi angle, and the apparent power (S) to display the vectors on the corresponding quadrant.

NOTE: Currently, the Power Diagram widget is only supported in dynamic dashboards.

5. Visualization

Once you've finished configuring the widget, it will perform its calculations and showcase the respective vectors for P (active power), Q (reactive power), and S (apparent power) on the diagram.

NOTE: Currently, the Widget Plugin feature only supports "last value" as aggregation method. Additionally, it does not offer support for time spans other than the one selected in the dashboard's date picker.

Did this answer your question?