Skip to main content

ETL Calculation

tip

The secondary calculation solves the conversion of cumulative values for electricity and water meters into usage data. Based on business needs, it splits the main meter into virtual sub-meters to calculate usage, ensuring data accuracy. Specifically, it calculates the consumption of each meter based on the reported device data and characteristics, then splits the main meter for detailed calculation, providing a reliable foundation for energy management.

Usage Calculation

Navigate to the System Settings menu and click the ETL Calculate button to enter the secondary calculation module, as shown below.

tip

The system provides two calculation methods:

  • Usage: Calculates the difference from the cumulative values reported by devices, suitable for various electricity and water meters.
  • Virtual Device: Splits the main meter into multiple virtual sub-meters based on business rules, defining operator rules for devices involved in mixed calculations.

Image

Usage List

tip

The system supports queries based on device twins and points.

Select the desired device twin, and the system will refresh the usage calculation list, as shown below. Image

Adding Usage Calculations

Configuring Usage for Selected Devices

Image Click the “+” button to enter the add usage page, as shown below.

warning

First, select the required device twin and point, then check the devices that require usage calculation. Submit and save to complete the addition.

  • Submit Selection: Configures usage calculation for the selected devices' points.
  • Submit All: Configures usage calculation for all devices under the selected twin.

Image

Configuring Usage at the Device Model Level

Go to the Device Twins menu and select Device Twins List to access the device management module. Image In the device twins list, click the "Edit" button on the right side of the model you wish to modify. Image Modify the Function Type information in the edit page, as shown below. Image When enabling the calculation property, two options are available:

warning
  • Calc hourly usage: Automatically calculates hourly usage for devices under this function type.
  • Sync hourly usage: Automatically synchronizes hourly usage calculations for devices under this function type. Enabling this setting will apply hourly usage calculations to all points for devices under this twin.

Image

Viewing Usage Data

Image Click "Details" in the operations column of the usage list page to view usage data.

warning

By default, the system queries data for the current day. You can adjust the time range to view data for other periods.

Image

Modifying or Deleting Usage Calculations

Image

Deleting Usage for Selected Devices

Click "Edit" in the operations column of the usage list to modify usage calculations.

warning

The system allows adding or removing devices for usage calculations.

Check the devices that require usage calculations and uncheck those that do not. Save the changes to complete the modifications. Image

Deleting Usage for All Devices Under a Model

Image Click "Delete" in the operations column of the usage list to remove usage calculations for all points under the selected twin.

Virtual Devices

tip

Virtual devices are created based on business needs. They use real electricity and water meter data to calculate usage for split sub-meters. For example, when a floor only has a main meter, usage is reasonably allocated based on factors such as area, ensuring accurate measurement and fair cost allocation.

Image Click Virtual Device to switch to the virtual device list page, as shown below. Image

Adding Virtual Devices

Image Click the “+” button to enter the virtual device addition page, as shown below. Image

tip

Field descriptions:

  1. Name: Globally unique. The system generates a virtual device that can be used and viewed in the app.
  2. Project: Platform project. After binding a project, all devices under it can participate in the calculation.
  3. Calculation Dimension: Default is hourly calculation.
  4. Function Points: Name of the virtual device's calculated point.
  5. Location: Configuration of the virtual device's location.
  6. Description: Description of the device.
  7. Add Formula: Click this button to configure formulas with three types of elements: Image
    • Device: Select device points to participate in the calculation.
    • Expression: Choose operators (e.g., +, -).
    • Number: Perform fixed-value operations with expressions.
  8. Add Device: Click to view configured devices or select new devices for the calculation.

Modifying Virtual Devices

tip

Only virtual devices that have not started calculations can be modified. Devices already in calculation must be deleted and recreated.

Image Click "Edit" in the operations column for the desired virtual device to enter the modification page. Image

Viewing Virtual Device Data

tip

By default, data for the current day is displayed. You can adjust the time range to view data for other periods.

Image Click "Details" in the operations column for the desired virtual device to view the data. Image

Deleting Virtual Devices

Image Click "Delete" in the operations column for the desired virtual device. Confirm the deletion to complete the process.