Linc 1.0.0 documentation

Linc 1.0.0

AGPL-3.0
Terms of service
application/json
Linc
team@linc.world
ID: urn:linc.world:tools

Some description

Servers

mqtt.linc.world:{port}/{basePath}secure-mqttproduction
The production API server
object
basePath
required
string
Default value:"v1/tools"
Allowed values:
"v1/tools"
port
required
string
Default value:"8883"
Allowed values:
"8883"

Operations

PUB /{organisation_id}/nodes/{node_id}/device/config
Parameters for identification, information and configuration of hardware devices.

Operation IDdevice/config
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Group)
Accepts the following message:
device/config
application/json
Message IDdevice/config
oneOf
object
(gen0_4ch)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:60
Adheres to:
number
Data is reported to server at 1 minute intervals.

Const:60
Additional properties are allowed.
label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Or to:
number
Data is reported to server at 1 minute intervals.

Const:60
Additional properties are allowed.
label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Or to:
number
Data is reported to server at 1 minute intervals.

Const:60
Additional properties are allowed.
label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Additional properties are allowed.
label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Or to:
number
Data is reported to server at 1 minute intervals.

Const:60
Additional properties are allowed.
label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:60
Adheres to:
number
Data is reported to server at 1 minute intervals.

Const:60
Additional properties are allowed.
label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "linc": { "dataplan": { "mode": "platform", "reporting_interval": 60 }, "label": "Main electrical panel" } }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/device/data
Parameters for identification, information and configuration of hardware devices.

Operation IDdevice/data
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Group)
Accepts the following message:
device/data
application/json
Message IDdevice/data
oneOf
object
(gen0_4ch)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Environmental Node

Const:"gen0_4ch"
Additional properties are allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Details related to a cellular module - a hardware component that connects devices to cellular networks for wireless data transmission using standards like 4G (LTE) and 5G.

fw_version
string
The firmware version of a cellular module represents its embedded software state, dictating functionalities and network compatibility. Updates can introduce new features or fixes. Identifying the version aids in troubleshooting.

imei
string
must match: ^[0-9]{15,17}$
The IMEI (International Mobile Equipment Identity) is a unique 15-digit number assigned to mobile devices, such as smartphones and tablets. It serves as an identifier for the device and can be used by cellular networks to authenticate the device and permit or deny its access to the network. IMEI is essential for tracking and blacklisting stolen devices, ensuring they cannot be used on any network, even if the SIM card is replaced.

model
string
[ 1 .. 24 ] characters
The model of a cellular module refers to its distinct version in terms of features, capabilities, and cellular compatibility.

serial
string
[ 1 .. 24 ] characters
A serial number is a unique identifier assigned by the manufacturer to a cellular module. It helps in tracking, service support, and verifying authenticity.

Additional properties are allowed.
object
Hardware related parameters for a Linc node.

fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Electrical Node

Const:"gen1"
Additional properties are allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Details related to a cellular module - a hardware component that connects devices to cellular networks for wireless data transmission using standards like 4G (LTE) and 5G.

fw_version
string
The firmware version of a cellular module represents its embedded software state, dictating functionalities and network compatibility. Updates can introduce new features or fixes. Identifying the version aids in troubleshooting.

imei
string
must match: ^[0-9]{15,17}$
The IMEI (International Mobile Equipment Identity) is a unique 15-digit number assigned to mobile devices, such as smartphones and tablets. It serves as an identifier for the device and can be used by cellular networks to authenticate the device and permit or deny its access to the network. IMEI is essential for tracking and blacklisting stolen devices, ensuring they cannot be used on any network, even if the SIM card is replaced.

model
string
[ 1 .. 24 ] characters
The model of a cellular module refers to its distinct version in terms of features, capabilities, and cellular compatibility.

serial
string
[ 1 .. 24 ] characters
A serial number is a unique identifier assigned by the manufacturer to a cellular module. It helps in tracking, service support, and verifying authenticity.

Additional properties are allowed.
object
Hardware related parameters for a Linc node.

fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Electrical Node

Const:"gen0_8ch"
Additional properties are allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Details related to a cellular module - a hardware component that connects devices to cellular networks for wireless data transmission using standards like 4G (LTE) and 5G.

fw_version
string
The firmware version of a cellular module represents its embedded software state, dictating functionalities and network compatibility. Updates can introduce new features or fixes. Identifying the version aids in troubleshooting.

imei
string
must match: ^[0-9]{15,17}$
The IMEI (International Mobile Equipment Identity) is a unique 15-digit number assigned to mobile devices, such as smartphones and tablets. It serves as an identifier for the device and can be used by cellular networks to authenticate the device and permit or deny its access to the network. IMEI is essential for tracking and blacklisting stolen devices, ensuring they cannot be used on any network, even if the SIM card is replaced.

model
string
[ 1 .. 24 ] characters
The model of a cellular module refers to its distinct version in terms of features, capabilities, and cellular compatibility.

serial
string
[ 1 .. 24 ] characters
A serial number is a unique identifier assigned by the manufacturer to a cellular module. It helps in tracking, service support, and verifying authenticity.

Additional properties are allowed.
object
Hardware related parameters for a Linc node.

fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
P1 Electrical Node

Const:"gen0_p1"
Additional properties are allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Details related to a cellular module - a hardware component that connects devices to cellular networks for wireless data transmission using standards like 4G (LTE) and 5G.

fw_version
string
The firmware version of a cellular module represents its embedded software state, dictating functionalities and network compatibility. Updates can introduce new features or fixes. Identifying the version aids in troubleshooting.

imei
string
must match: ^[0-9]{15,17}$
The IMEI (International Mobile Equipment Identity) is a unique 15-digit number assigned to mobile devices, such as smartphones and tablets. It serves as an identifier for the device and can be used by cellular networks to authenticate the device and permit or deny its access to the network. IMEI is essential for tracking and blacklisting stolen devices, ensuring they cannot be used on any network, even if the SIM card is replaced.

model
string
[ 1 .. 24 ] characters
The model of a cellular module refers to its distinct version in terms of features, capabilities, and cellular compatibility.

serial
string
[ 1 .. 24 ] characters
A serial number is a unique identifier assigned by the manufacturer to a cellular module. It helps in tracking, service support, and verifying authenticity.

Additional properties are allowed.
object
Hardware related parameters for a Linc node.

fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Electrical Node

Const:"gen1"
Additional properties are allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

object [Device]
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Electrical Node

Const:"gen1"
Additional properties are allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "linc": { "fw_version": "v2.1.3", "hw_version": "v1.0.3", "model": "gen0_4ch" }, "wifi": { "mac_address": "00:1A:2B:3C:4D:5E" } }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/device/linc/dataplan/mode
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Operation IDdevice/linc/dataplan/mode
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
device/linc/dataplan/mode
application/json
Message IDdevice/linc/dataplan/mode
oneOf
object
(gen0_4ch)

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "platform", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/device/linc/dataplan/reporting_interval
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Operation IDdevice/linc/dataplan/reporting_interval
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
device/linc/dataplan/reporting_interval
application/json
Message IDdevice/linc/dataplan/reporting_interval
oneOf
object
(gen0_4ch)

integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:60
Adheres to:
number
Data is reported to server at 1 minute intervals.

Const:60
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Or to:
number
Data is reported to server at 1 minute intervals.

Const:60
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Or to:
number
Data is reported to server at 1 minute intervals.

Const:60
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Or to:
number
Data is reported to server at 1 minute intervals.

Const:60
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:60
Adheres to:
number
Data is reported to server at 1 minute intervals.

Const:60
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 60, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/device/linc/fw_version
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

Operation IDdevice/linc/fw_version
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
device/linc/fw_version
application/json
Message IDdevice/linc/fw_version
oneOf
object
(gen0_4ch)

data
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

data
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

data
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "v2.1.3", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/device/linc/label
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

Operation IDdevice/linc/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
device/linc/label
application/json
Message IDdevice/linc/label
oneOf
object
(gen0_4ch)

data
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

data
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

data
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Main electrical panel", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/1/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/1/config/label
application/json
Message IDelectrical/ac/circuits/1/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/1/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/1/config/phase
application/json
Message IDelectrical/ac/circuits/1/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/1/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/1/config/polarity
application/json
Message IDelectrical/ac/circuits/1/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/1/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/1/config/sensor
application/json
Message IDelectrical/ac/circuits/1/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/1/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/current/crest_factor
application/json
Message IDelectrical/ac/circuits/1/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/1/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/1/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/1/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/1/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/1/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/1/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/current/rms
application/json
Message IDelectrical/ac/circuits/1/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/1/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/current/spectrum
application/json
Message IDelectrical/ac/circuits/1/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/1/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/1/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/1/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/current/thd/rms
application/json
Message IDelectrical/ac/circuits/1/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/1/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/1/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/1/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/energy/active/exported
application/json
Message IDelectrical/ac/circuits/1/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/1/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/energy/active/imported
application/json
Message IDelectrical/ac/circuits/1/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/1/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/energy/active/net
application/json
Message IDelectrical/ac/circuits/1/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/1/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/1/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/1/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/1/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/1/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/1/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/1/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/1/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/1/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/1/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/1/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/1/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/1/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/power/active
application/json
Message IDelectrical/ac/circuits/1/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/1/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/power/apparent
application/json
Message IDelectrical/ac/circuits/1/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/1/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/1/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/1/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/1/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/1/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/1/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/1/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/1/power/reactive
application/json
Message IDelectrical/ac/circuits/1/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/10/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/10/config/label
application/json
Message IDelectrical/ac/circuits/10/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/10/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/10/config/phase
application/json
Message IDelectrical/ac/circuits/10/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/10/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/10/config/polarity
application/json
Message IDelectrical/ac/circuits/10/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/10/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/10/config/sensor
application/json
Message IDelectrical/ac/circuits/10/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/10/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/current/crest_factor
application/json
Message IDelectrical/ac/circuits/10/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/10/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/10/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/10/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/10/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/10/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/10/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/current/rms
application/json
Message IDelectrical/ac/circuits/10/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/10/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/current/spectrum
application/json
Message IDelectrical/ac/circuits/10/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/10/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/10/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/10/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/current/thd/rms
application/json
Message IDelectrical/ac/circuits/10/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/10/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/10/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/10/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/energy/active/exported
application/json
Message IDelectrical/ac/circuits/10/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/10/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/energy/active/imported
application/json
Message IDelectrical/ac/circuits/10/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/10/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/energy/active/net
application/json
Message IDelectrical/ac/circuits/10/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/10/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/10/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/10/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/10/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/10/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/10/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/10/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/10/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/10/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/10/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/10/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/10/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/10/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/power/active
application/json
Message IDelectrical/ac/circuits/10/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/10/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/power/apparent
application/json
Message IDelectrical/ac/circuits/10/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/10/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/10/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/10/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/10/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/10/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/10/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/10/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/10/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/10/power/reactive
application/json
Message IDelectrical/ac/circuits/10/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/11/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/11/config/label
application/json
Message IDelectrical/ac/circuits/11/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/11/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/11/config/phase
application/json
Message IDelectrical/ac/circuits/11/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/11/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/11/config/polarity
application/json
Message IDelectrical/ac/circuits/11/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/11/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/11/config/sensor
application/json
Message IDelectrical/ac/circuits/11/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/11/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/current/crest_factor
application/json
Message IDelectrical/ac/circuits/11/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/11/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/11/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/11/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/11/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/11/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/11/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/current/rms
application/json
Message IDelectrical/ac/circuits/11/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/11/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/current/spectrum
application/json
Message IDelectrical/ac/circuits/11/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/11/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/11/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/11/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/current/thd/rms
application/json
Message IDelectrical/ac/circuits/11/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/11/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/11/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/11/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/energy/active/exported
application/json
Message IDelectrical/ac/circuits/11/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/11/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/energy/active/imported
application/json
Message IDelectrical/ac/circuits/11/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/11/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/energy/active/net
application/json
Message IDelectrical/ac/circuits/11/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/11/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/11/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/11/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/11/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/11/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/11/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/11/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/11/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/11/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/11/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/11/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/11/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/11/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/power/active
application/json
Message IDelectrical/ac/circuits/11/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/11/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/power/apparent
application/json
Message IDelectrical/ac/circuits/11/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/11/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/11/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/11/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/11/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/11/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/11/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/11/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/11/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/11/power/reactive
application/json
Message IDelectrical/ac/circuits/11/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/12/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/12/config/label
application/json
Message IDelectrical/ac/circuits/12/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/12/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/12/config/phase
application/json
Message IDelectrical/ac/circuits/12/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/12/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/12/config/polarity
application/json
Message IDelectrical/ac/circuits/12/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/12/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/12/config/sensor
application/json
Message IDelectrical/ac/circuits/12/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/12/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/current/crest_factor
application/json
Message IDelectrical/ac/circuits/12/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/12/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/12/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/12/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/12/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/12/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/12/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/current/rms
application/json
Message IDelectrical/ac/circuits/12/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/12/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/current/spectrum
application/json
Message IDelectrical/ac/circuits/12/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/12/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/12/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/12/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/current/thd/rms
application/json
Message IDelectrical/ac/circuits/12/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/12/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/12/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/12/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/energy/active/exported
application/json
Message IDelectrical/ac/circuits/12/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/12/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/energy/active/imported
application/json
Message IDelectrical/ac/circuits/12/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/12/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/energy/active/net
application/json
Message IDelectrical/ac/circuits/12/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/12/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/12/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/12/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/12/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/12/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/12/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/12/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/12/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/12/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/12/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/12/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/12/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/12/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/power/active
application/json
Message IDelectrical/ac/circuits/12/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/12/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/power/apparent
application/json
Message IDelectrical/ac/circuits/12/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/12/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/12/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/12/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/12/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/12/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/12/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/12/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/12/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/12/power/reactive
application/json
Message IDelectrical/ac/circuits/12/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/13/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/13/config/label
application/json
Message IDelectrical/ac/circuits/13/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/13/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/13/config/phase
application/json
Message IDelectrical/ac/circuits/13/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/13/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/13/config/polarity
application/json
Message IDelectrical/ac/circuits/13/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/13/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/13/config/sensor
application/json
Message IDelectrical/ac/circuits/13/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/13/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/current/crest_factor
application/json
Message IDelectrical/ac/circuits/13/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/13/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/13/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/13/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/13/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/13/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/13/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/current/rms
application/json
Message IDelectrical/ac/circuits/13/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/13/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/current/spectrum
application/json
Message IDelectrical/ac/circuits/13/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/13/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/13/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/13/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/current/thd/rms
application/json
Message IDelectrical/ac/circuits/13/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/13/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/13/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/13/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/energy/active/exported
application/json
Message IDelectrical/ac/circuits/13/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/13/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/energy/active/imported
application/json
Message IDelectrical/ac/circuits/13/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/13/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/energy/active/net
application/json
Message IDelectrical/ac/circuits/13/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/13/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/13/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/13/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/13/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/13/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/13/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/13/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/13/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/13/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/13/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/13/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/13/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/13/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/power/active
application/json
Message IDelectrical/ac/circuits/13/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/13/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/power/apparent
application/json
Message IDelectrical/ac/circuits/13/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/13/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/13/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/13/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/13/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/13/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/13/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/13/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/13/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/13/power/reactive
application/json
Message IDelectrical/ac/circuits/13/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/14/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/14/config/label
application/json
Message IDelectrical/ac/circuits/14/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/14/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/14/config/phase
application/json
Message IDelectrical/ac/circuits/14/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/14/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/14/config/polarity
application/json
Message IDelectrical/ac/circuits/14/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/14/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/14/config/sensor
application/json
Message IDelectrical/ac/circuits/14/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/14/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/current/crest_factor
application/json
Message IDelectrical/ac/circuits/14/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/14/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/14/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/14/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/14/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/14/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/14/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/current/rms
application/json
Message IDelectrical/ac/circuits/14/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/14/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/current/spectrum
application/json
Message IDelectrical/ac/circuits/14/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/14/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/14/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/14/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/current/thd/rms
application/json
Message IDelectrical/ac/circuits/14/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/14/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/14/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/14/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/energy/active/exported
application/json
Message IDelectrical/ac/circuits/14/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/14/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/energy/active/imported
application/json
Message IDelectrical/ac/circuits/14/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/14/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/energy/active/net
application/json
Message IDelectrical/ac/circuits/14/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/14/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/14/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/14/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/14/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/14/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/14/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/14/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/14/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/14/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/14/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/14/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/14/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/14/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/power/active
application/json
Message IDelectrical/ac/circuits/14/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/14/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/power/apparent
application/json
Message IDelectrical/ac/circuits/14/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/14/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/14/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/14/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/14/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/14/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/14/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/14/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/14/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/14/power/reactive
application/json
Message IDelectrical/ac/circuits/14/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/15/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/15/config/label
application/json
Message IDelectrical/ac/circuits/15/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/15/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/15/config/phase
application/json
Message IDelectrical/ac/circuits/15/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/15/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/15/config/polarity
application/json
Message IDelectrical/ac/circuits/15/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/15/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/15/config/sensor
application/json
Message IDelectrical/ac/circuits/15/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/15/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/current/crest_factor
application/json
Message IDelectrical/ac/circuits/15/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/15/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/15/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/15/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/15/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/15/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/15/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/current/rms
application/json
Message IDelectrical/ac/circuits/15/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/15/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/current/spectrum
application/json
Message IDelectrical/ac/circuits/15/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/15/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/15/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/15/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/current/thd/rms
application/json
Message IDelectrical/ac/circuits/15/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/15/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/15/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/15/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/energy/active/exported
application/json
Message IDelectrical/ac/circuits/15/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/15/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/energy/active/imported
application/json
Message IDelectrical/ac/circuits/15/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/15/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/energy/active/net
application/json
Message IDelectrical/ac/circuits/15/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/15/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/15/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/15/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/15/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/15/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/15/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/15/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/15/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/15/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/15/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/15/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/15/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/15/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/power/active
application/json
Message IDelectrical/ac/circuits/15/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/15/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/power/apparent
application/json
Message IDelectrical/ac/circuits/15/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/15/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/15/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/15/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/15/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/15/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/15/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/15/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/15/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/15/power/reactive
application/json
Message IDelectrical/ac/circuits/15/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/16/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/16/config/label
application/json
Message IDelectrical/ac/circuits/16/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/16/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/16/config/phase
application/json
Message IDelectrical/ac/circuits/16/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/16/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/16/config/polarity
application/json
Message IDelectrical/ac/circuits/16/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/16/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/16/config/sensor
application/json
Message IDelectrical/ac/circuits/16/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/16/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/current/crest_factor
application/json
Message IDelectrical/ac/circuits/16/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/16/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/16/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/16/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/16/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/16/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/16/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/current/rms
application/json
Message IDelectrical/ac/circuits/16/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/16/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/current/spectrum
application/json
Message IDelectrical/ac/circuits/16/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/16/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/16/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/16/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/current/thd/rms
application/json
Message IDelectrical/ac/circuits/16/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/16/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/16/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/16/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/energy/active/exported
application/json
Message IDelectrical/ac/circuits/16/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/16/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/energy/active/imported
application/json
Message IDelectrical/ac/circuits/16/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/16/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/energy/active/net
application/json
Message IDelectrical/ac/circuits/16/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/16/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/16/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/16/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/16/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/16/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/16/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/16/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/16/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/16/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/16/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/16/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/16/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/16/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/power/active
application/json
Message IDelectrical/ac/circuits/16/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/16/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/power/apparent
application/json
Message IDelectrical/ac/circuits/16/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/16/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/16/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/16/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/16/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/16/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/16/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/16/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/16/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/16/power/reactive
application/json
Message IDelectrical/ac/circuits/16/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/2/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/2/config/label
application/json
Message IDelectrical/ac/circuits/2/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/2/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/2/config/phase
application/json
Message IDelectrical/ac/circuits/2/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/2/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/2/config/polarity
application/json
Message IDelectrical/ac/circuits/2/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/2/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/2/config/sensor
application/json
Message IDelectrical/ac/circuits/2/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/2/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/current/crest_factor
application/json
Message IDelectrical/ac/circuits/2/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/2/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/2/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/2/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/2/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/2/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/2/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/current/rms
application/json
Message IDelectrical/ac/circuits/2/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/2/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/current/spectrum
application/json
Message IDelectrical/ac/circuits/2/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/2/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/2/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/2/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/current/thd/rms
application/json
Message IDelectrical/ac/circuits/2/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/2/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/2/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/2/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/energy/active/exported
application/json
Message IDelectrical/ac/circuits/2/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/2/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/energy/active/imported
application/json
Message IDelectrical/ac/circuits/2/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/2/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/energy/active/net
application/json
Message IDelectrical/ac/circuits/2/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/2/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/2/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/2/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/2/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/2/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/2/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/2/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/2/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/2/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/2/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/2/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/2/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/2/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/power/active
application/json
Message IDelectrical/ac/circuits/2/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/2/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/power/apparent
application/json
Message IDelectrical/ac/circuits/2/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/2/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/2/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/2/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/2/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/2/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/2/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/2/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/2/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/2/power/reactive
application/json
Message IDelectrical/ac/circuits/2/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/3/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/3/config/label
application/json
Message IDelectrical/ac/circuits/3/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/3/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/3/config/phase
application/json
Message IDelectrical/ac/circuits/3/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/3/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/3/config/polarity
application/json
Message IDelectrical/ac/circuits/3/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/3/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/3/config/sensor
application/json
Message IDelectrical/ac/circuits/3/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/3/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/current/crest_factor
application/json
Message IDelectrical/ac/circuits/3/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/3/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/3/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/3/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/3/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/3/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/3/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/current/rms
application/json
Message IDelectrical/ac/circuits/3/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/3/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/current/spectrum
application/json
Message IDelectrical/ac/circuits/3/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/3/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/3/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/3/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/current/thd/rms
application/json
Message IDelectrical/ac/circuits/3/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/3/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/3/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/3/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/energy/active/exported
application/json
Message IDelectrical/ac/circuits/3/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/3/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/energy/active/imported
application/json
Message IDelectrical/ac/circuits/3/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/3/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/energy/active/net
application/json
Message IDelectrical/ac/circuits/3/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/3/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/3/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/3/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/3/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/3/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/3/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/3/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/3/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/3/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/3/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/3/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/3/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/3/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/power/active
application/json
Message IDelectrical/ac/circuits/3/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/3/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/power/apparent
application/json
Message IDelectrical/ac/circuits/3/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/3/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/3/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/3/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/3/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/3/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/3/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/3/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/3/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/3/power/reactive
application/json
Message IDelectrical/ac/circuits/3/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/4/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/4/config/label
application/json
Message IDelectrical/ac/circuits/4/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/4/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/4/config/phase
application/json
Message IDelectrical/ac/circuits/4/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/4/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/4/config/polarity
application/json
Message IDelectrical/ac/circuits/4/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/4/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/4/config/sensor
application/json
Message IDelectrical/ac/circuits/4/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/4/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/current/crest_factor
application/json
Message IDelectrical/ac/circuits/4/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/4/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/4/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/4/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/4/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/4/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/4/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/current/rms
application/json
Message IDelectrical/ac/circuits/4/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/4/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/current/spectrum
application/json
Message IDelectrical/ac/circuits/4/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/4/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/4/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/4/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/current/thd/rms
application/json
Message IDelectrical/ac/circuits/4/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/4/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/4/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/4/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/energy/active/exported
application/json
Message IDelectrical/ac/circuits/4/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/4/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/energy/active/imported
application/json
Message IDelectrical/ac/circuits/4/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/4/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/energy/active/net
application/json
Message IDelectrical/ac/circuits/4/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/4/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/4/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/4/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/4/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/4/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/4/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/4/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/4/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/4/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/4/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/4/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/4/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/4/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/power/active
application/json
Message IDelectrical/ac/circuits/4/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/4/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/power/apparent
application/json
Message IDelectrical/ac/circuits/4/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/4/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/4/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/4/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/4/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/4/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/4/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/4/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/4/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/4/power/reactive
application/json
Message IDelectrical/ac/circuits/4/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/5/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/5/config/label
application/json
Message IDelectrical/ac/circuits/5/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/5/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/5/config/phase
application/json
Message IDelectrical/ac/circuits/5/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/5/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/5/config/polarity
application/json
Message IDelectrical/ac/circuits/5/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/5/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/5/config/sensor
application/json
Message IDelectrical/ac/circuits/5/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/5/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/current/crest_factor
application/json
Message IDelectrical/ac/circuits/5/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/5/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/5/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/5/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/5/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/5/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/5/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/current/rms
application/json
Message IDelectrical/ac/circuits/5/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/5/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/current/spectrum
application/json
Message IDelectrical/ac/circuits/5/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/5/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/5/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/5/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/current/thd/rms
application/json
Message IDelectrical/ac/circuits/5/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/5/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/5/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/5/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/energy/active/exported
application/json
Message IDelectrical/ac/circuits/5/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/5/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/energy/active/imported
application/json
Message IDelectrical/ac/circuits/5/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/5/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/energy/active/net
application/json
Message IDelectrical/ac/circuits/5/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/5/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/5/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/5/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/5/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/5/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/5/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/5/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/5/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/5/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/5/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/5/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/5/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/5/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/power/active
application/json
Message IDelectrical/ac/circuits/5/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/5/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/power/apparent
application/json
Message IDelectrical/ac/circuits/5/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/5/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/5/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/5/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/5/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/5/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/5/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/5/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/5/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/5/power/reactive
application/json
Message IDelectrical/ac/circuits/5/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/6/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/6/config/label
application/json
Message IDelectrical/ac/circuits/6/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/6/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/6/config/phase
application/json
Message IDelectrical/ac/circuits/6/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/6/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/6/config/polarity
application/json
Message IDelectrical/ac/circuits/6/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/6/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/6/config/sensor
application/json
Message IDelectrical/ac/circuits/6/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/6/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/current/crest_factor
application/json
Message IDelectrical/ac/circuits/6/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/6/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/6/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/6/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/6/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/6/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/6/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/current/rms
application/json
Message IDelectrical/ac/circuits/6/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/6/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/current/spectrum
application/json
Message IDelectrical/ac/circuits/6/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/6/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/6/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/6/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/current/thd/rms
application/json
Message IDelectrical/ac/circuits/6/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/6/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/6/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/6/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/energy/active/exported
application/json
Message IDelectrical/ac/circuits/6/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/6/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/energy/active/imported
application/json
Message IDelectrical/ac/circuits/6/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/6/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/energy/active/net
application/json
Message IDelectrical/ac/circuits/6/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/6/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/6/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/6/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/6/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/6/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/6/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/6/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/6/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/6/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/6/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/6/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/6/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/6/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/power/active
application/json
Message IDelectrical/ac/circuits/6/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/6/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/power/apparent
application/json
Message IDelectrical/ac/circuits/6/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/6/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/6/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/6/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/6/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/6/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/6/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/6/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/6/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/6/power/reactive
application/json
Message IDelectrical/ac/circuits/6/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/7/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/7/config/label
application/json
Message IDelectrical/ac/circuits/7/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/7/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/7/config/phase
application/json
Message IDelectrical/ac/circuits/7/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/7/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/7/config/polarity
application/json
Message IDelectrical/ac/circuits/7/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/7/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/7/config/sensor
application/json
Message IDelectrical/ac/circuits/7/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/7/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/current/crest_factor
application/json
Message IDelectrical/ac/circuits/7/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/7/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/7/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/7/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/7/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/7/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/7/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/current/rms
application/json
Message IDelectrical/ac/circuits/7/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/7/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/current/spectrum
application/json
Message IDelectrical/ac/circuits/7/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/7/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/7/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/7/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/current/thd/rms
application/json
Message IDelectrical/ac/circuits/7/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/7/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/7/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/7/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/energy/active/exported
application/json
Message IDelectrical/ac/circuits/7/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/7/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/energy/active/imported
application/json
Message IDelectrical/ac/circuits/7/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/7/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/energy/active/net
application/json
Message IDelectrical/ac/circuits/7/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/7/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/7/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/7/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/7/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/7/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/7/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/7/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/7/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/7/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/7/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/7/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/7/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/7/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/power/active
application/json
Message IDelectrical/ac/circuits/7/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/7/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/power/apparent
application/json
Message IDelectrical/ac/circuits/7/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/7/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/7/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/7/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/7/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/7/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/7/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/7/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/7/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/7/power/reactive
application/json
Message IDelectrical/ac/circuits/7/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/8/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/8/config/label
application/json
Message IDelectrical/ac/circuits/8/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/8/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/8/config/phase
application/json
Message IDelectrical/ac/circuits/8/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/8/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/8/config/polarity
application/json
Message IDelectrical/ac/circuits/8/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/8/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/8/config/sensor
application/json
Message IDelectrical/ac/circuits/8/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/8/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/current/crest_factor
application/json
Message IDelectrical/ac/circuits/8/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/8/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/8/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/8/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/8/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/8/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/8/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/current/rms
application/json
Message IDelectrical/ac/circuits/8/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/8/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/current/spectrum
application/json
Message IDelectrical/ac/circuits/8/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/8/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/8/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/8/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/current/thd/rms
application/json
Message IDelectrical/ac/circuits/8/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/8/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/8/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/8/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/energy/active/exported
application/json
Message IDelectrical/ac/circuits/8/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/8/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/energy/active/imported
application/json
Message IDelectrical/ac/circuits/8/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/8/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/energy/active/net
application/json
Message IDelectrical/ac/circuits/8/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/8/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/8/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/8/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/8/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/8/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/8/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/8/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/8/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/8/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/8/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/8/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/8/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/8/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/power/active
application/json
Message IDelectrical/ac/circuits/8/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/8/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/power/apparent
application/json
Message IDelectrical/ac/circuits/8/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/8/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/8/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/8/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/8/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/8/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/8/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/8/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/8/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/8/power/reactive
application/json
Message IDelectrical/ac/circuits/8/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/config/label
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

Operation IDelectrical/ac/circuits/9/config/label
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/9/config/label
application/json
Message IDelectrical/ac/circuits/9/config/label
oneOf
object
(gen1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "Kitchen", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/config/phase
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Operation IDelectrical/ac/circuits/9/config/phase
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/9/config/phase
application/json
Message IDelectrical/ac/circuits/9/config/phase
oneOf
object
(gen1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "line_1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/config/polarity
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Operation IDelectrical/ac/circuits/9/config/polarity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/9/config/polarity
application/json
Message IDelectrical/ac/circuits/9/config/polarity
oneOf
object
(gen1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "forward", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/config/sensor
Specifies the model of current sensor installed for measurements.

Operation IDelectrical/ac/circuits/9/config/sensor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/9/config/sensor
application/json
Message IDelectrical/ac/circuits/9/config/sensor
oneOf
object
(gen1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "ct_30", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/current/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/circuits/9/current/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/current/crest_factor
application/json
Message IDelectrical/ac/circuits/9/current/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/current/demand_distortion/full_load_current
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Operation IDelectrical/ac/circuits/9/current/demand_distortion/full_load_current
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/circuits/9/current/demand_distortion/full_load_current
application/json
Message IDelectrical/ac/circuits/9/current/demand_distortion/full_load_current
oneOf
object
(gen1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

data
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 12.5, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/current/demand_distortion/tdd
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Operation IDelectrical/ac/circuits/9/current/demand_distortion/tdd
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/current/demand_distortion/tdd
application/json
Message IDelectrical/ac/circuits/9/current/demand_distortion/tdd
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "tdd" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/current/rms
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Operation IDelectrical/ac/circuits/9/current/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/current/rms
application/json
Message IDelectrical/ac/circuits/9/current/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/current/spectrum
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/circuits/9/current/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/current/spectrum
application/json
Message IDelectrical/ac/circuits/9/current/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/current/thd/fundamental
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Operation IDelectrical/ac/circuits/9/current/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/current/thd/fundamental
application/json
Message IDelectrical/ac/circuits/9/current/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/current/thd/rms
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Operation IDelectrical/ac/circuits/9/current/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/current/thd/rms
application/json
Message IDelectrical/ac/circuits/9/current/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/current/waveform_peak
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Operation IDelectrical/ac/circuits/9/current/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/current/waveform_peak
application/json
Message IDelectrical/ac/circuits/9/current/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/energy/active/exported
Energy sent back to the grid. Can generate credits or offset costs.

Operation IDelectrical/ac/circuits/9/energy/active/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/energy/active/exported
application/json
Message IDelectrical/ac/circuits/9/energy/active/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/energy/active/imported
Energy drawn from the grid. Directly impacts electricity bills.

Operation IDelectrical/ac/circuits/9/energy/active/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/energy/active/imported
application/json
Message IDelectrical/ac/circuits/9/energy/active/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/energy/active/net
Total active energy produced minus consumed.

Operation IDelectrical/ac/circuits/9/energy/active/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/energy/active/net
application/json
Message IDelectrical/ac/circuits/9/energy/active/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/energy/apparent/exported
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/9/energy/apparent/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/energy/apparent/exported
application/json
Message IDelectrical/ac/circuits/9/energy/apparent/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/energy/apparent/imported
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Operation IDelectrical/ac/circuits/9/energy/apparent/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/energy/apparent/imported
application/json
Message IDelectrical/ac/circuits/9/energy/apparent/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/energy/apparent/net
Total apparent energy produced minus consumed. Useful for system capacity planning.

Operation IDelectrical/ac/circuits/9/energy/apparent/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/energy/apparent/net
application/json
Message IDelectrical/ac/circuits/9/energy/apparent/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/energy/reactive/exported
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Operation IDelectrical/ac/circuits/9/energy/reactive/exported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/energy/reactive/exported
application/json
Message IDelectrical/ac/circuits/9/energy/reactive/exported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "exported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/energy/reactive/imported
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Operation IDelectrical/ac/circuits/9/energy/reactive/imported
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/energy/reactive/imported
application/json
Message IDelectrical/ac/circuits/9/energy/reactive/imported
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "imported" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/energy/reactive/net
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Operation IDelectrical/ac/circuits/9/energy/reactive/net
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/energy/reactive/net
application/json
Message IDelectrical/ac/circuits/9/energy/reactive/net
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "net" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/power/active
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Operation IDelectrical/ac/circuits/9/power/active
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/power/active
application/json
Message IDelectrical/ac/circuits/9/power/active
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "active" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/power/apparent
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Operation IDelectrical/ac/circuits/9/power/apparent
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/power/apparent
application/json
Message IDelectrical/ac/circuits/9/power/apparent
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "apparent" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/power/power_factor/displacement
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Operation IDelectrical/ac/circuits/9/power/power_factor/displacement
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/power/power_factor/displacement
application/json
Message IDelectrical/ac/circuits/9/power/power_factor/displacement
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "displacement" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/power/power_factor/distortion
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Operation IDelectrical/ac/circuits/9/power/power_factor/distortion
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/power/power_factor/distortion
application/json
Message IDelectrical/ac/circuits/9/power/power_factor/distortion
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "distortion" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/power/power_factor/total
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Operation IDelectrical/ac/circuits/9/power/power_factor/total
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/power/power_factor/total
application/json
Message IDelectrical/ac/circuits/9/power/power_factor/total
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "total" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/9/power/reactive
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Operation IDelectrical/ac/circuits/9/power/reactive
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/circuits/9/power/reactive
application/json
Message IDelectrical/ac/circuits/9/power/reactive
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
Examples
[ [ "timestamp", "reactive" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/fault/subnodes/{subnode_id}/channels/a/short_circuit
acb

Operation IDelectrical/ac/fault/subnodes/{subnode_id}/channels/a/short_circuit
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description

subnode_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/fault/subnodes/{subnode_id}/channels/a/short_circuit
application/json
Message IDelectrical/ac/fault/subnodes/{subnode_id}/channels/a/short_circuit
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "short_circuit" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/fault/subnodes/{subnode_id}/channels/b/short_circuit
acb

Operation IDelectrical/ac/fault/subnodes/{subnode_id}/channels/b/short_circuit
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description

subnode_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/fault/subnodes/{subnode_id}/channels/b/short_circuit
application/json
Message IDelectrical/ac/fault/subnodes/{subnode_id}/channels/b/short_circuit
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "short_circuit" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/frequency/instantaneous
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Operation IDelectrical/ac/frequency/instantaneous
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/frequency/instantaneous
application/json
Message IDelectrical/ac/frequency/instantaneous
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "instantaneous" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/frequency/nominal
Operation IDelectrical/ac/frequency/nominal
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/frequency/nominal
application/json
Message IDelectrical/ac/frequency/nominal
oneOf
object
(gen1)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": {}, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/frequency/nominal_range
Operation IDelectrical/ac/frequency/nominal_range
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/frequency/nominal_range
application/json
Message IDelectrical/ac/frequency/nominal_range
oneOf
object
(gen1)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": {}, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/frequency/transient
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

Operation IDelectrical/ac/frequency/transient
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/frequency/transient
application/json
Message IDelectrical/ac/frequency/transient
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "transient" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/nominal
Operation IDelectrical/ac/voltage/nominal
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/voltage/nominal
application/json
Message IDelectrical/ac/voltage/nominal
oneOf
object
(gen1)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": {}, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_1/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/voltage/phases/line_1/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_1/crest_factor
application/json
Message IDelectrical/ac/voltage/phases/line_1/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_1/dips_swells/event
Operation IDelectrical/ac/voltage/phases/line_1/dips_swells/event
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_1/dips_swells/event
application/json
Message IDelectrical/ac/voltage/phases/line_1/dips_swells/event
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "event" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_1/dips_swells/limits
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Operation IDelectrical/ac/voltage/phases/line_1/dips_swells/limits
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_1/dips_swells/limits
application/json
Message IDelectrical/ac/voltage/phases/line_1/dips_swells/limits
oneOf
object
(gen1)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "[property]": 123, "lower_hysteresis": 95, "lower_threshold": 90, "reference": 230, "upper_hysteresis": 105, "upper_threshold": 110 }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_1/rms
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Operation IDelectrical/ac/voltage/phases/line_1/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_1/rms
application/json
Message IDelectrical/ac/voltage/phases/line_1/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_1/spectrum
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/voltage/phases/line_1/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_1/spectrum
application/json
Message IDelectrical/ac/voltage/phases/line_1/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_1/thd/fundamental
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Operation IDelectrical/ac/voltage/phases/line_1/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_1/thd/fundamental
application/json
Message IDelectrical/ac/voltage/phases/line_1/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_1/thd/rms
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Operation IDelectrical/ac/voltage/phases/line_1/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_1/thd/rms
application/json
Message IDelectrical/ac/voltage/phases/line_1/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_1/waveform_peak
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Operation IDelectrical/ac/voltage/phases/line_1/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_1/waveform_peak
application/json
Message IDelectrical/ac/voltage/phases/line_1/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_2/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/voltage/phases/line_2/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_2/crest_factor
application/json
Message IDelectrical/ac/voltage/phases/line_2/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_2/dips_swells/event
Operation IDelectrical/ac/voltage/phases/line_2/dips_swells/event
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_2/dips_swells/event
application/json
Message IDelectrical/ac/voltage/phases/line_2/dips_swells/event
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "event" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_2/dips_swells/limits
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Operation IDelectrical/ac/voltage/phases/line_2/dips_swells/limits
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_2/dips_swells/limits
application/json
Message IDelectrical/ac/voltage/phases/line_2/dips_swells/limits
oneOf
object
(gen1)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "[property]": 123, "lower_hysteresis": 95, "lower_threshold": 90, "reference": 230, "upper_hysteresis": 105, "upper_threshold": 110 }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_2/rms
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Operation IDelectrical/ac/voltage/phases/line_2/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_2/rms
application/json
Message IDelectrical/ac/voltage/phases/line_2/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_2/spectrum
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/voltage/phases/line_2/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_2/spectrum
application/json
Message IDelectrical/ac/voltage/phases/line_2/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_2/thd/fundamental
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Operation IDelectrical/ac/voltage/phases/line_2/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_2/thd/fundamental
application/json
Message IDelectrical/ac/voltage/phases/line_2/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_2/thd/rms
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Operation IDelectrical/ac/voltage/phases/line_2/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_2/thd/rms
application/json
Message IDelectrical/ac/voltage/phases/line_2/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_2/waveform_peak
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Operation IDelectrical/ac/voltage/phases/line_2/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_2/waveform_peak
application/json
Message IDelectrical/ac/voltage/phases/line_2/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_3/crest_factor
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Operation IDelectrical/ac/voltage/phases/line_3/crest_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_3/crest_factor
application/json
Message IDelectrical/ac/voltage/phases/line_3/crest_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "crest_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_3/dips_swells/event
Operation IDelectrical/ac/voltage/phases/line_3/dips_swells/event
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_3/dips_swells/event
application/json
Message IDelectrical/ac/voltage/phases/line_3/dips_swells/event
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "event" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_3/dips_swells/limits
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Operation IDelectrical/ac/voltage/phases/line_3/dips_swells/limits
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_3/dips_swells/limits
application/json
Message IDelectrical/ac/voltage/phases/line_3/dips_swells/limits
oneOf
object
(gen1)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Limits]
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "[property]": 123, "lower_hysteresis": 95, "lower_threshold": 90, "reference": 230, "upper_hysteresis": 105, "upper_threshold": 110 }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_3/rms
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Operation IDelectrical/ac/voltage/phases/line_3/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_3/rms
application/json
Message IDelectrical/ac/voltage/phases/line_3/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_3/spectrum
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

Operation IDelectrical/ac/voltage/phases/line_3/spectrum
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_3/spectrum
application/json
Message IDelectrical/ac/voltage/phases/line_3/spectrum
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "centroid", "range", "magnitude" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_3/thd/fundamental
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Operation IDelectrical/ac/voltage/phases/line_3/thd/fundamental
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_3/thd/fundamental
application/json
Message IDelectrical/ac/voltage/phases/line_3/thd/fundamental
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "fundamental" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_3/thd/rms
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Operation IDelectrical/ac/voltage/phases/line_3/thd/rms
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_3/thd/rms
application/json
Message IDelectrical/ac/voltage/phases/line_3/thd/rms
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rms" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/phases/line_3/waveform_peak
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Operation IDelectrical/ac/voltage/phases/line_3/waveform_peak
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/phases/line_3/waveform_peak
application/json
Message IDelectrical/ac/voltage/phases/line_3/waveform_peak
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "waveform_peak" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/ac/voltage/unbalance_factor
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Operation IDelectrical/ac/voltage/unbalance_factor
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
electrical/ac/voltage/unbalance_factor
application/json
Message IDelectrical/ac/voltage/unbalance_factor
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "unbalance_factor" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/config
Parameters related to electrical systems.

Operation IDelectrical/config
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Group)
Accepts the following message:
electrical/config
application/json
Message IDelectrical/config
oneOf
object
(gen1)

object [Electrical]
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

object
Additional properties are allowed.
object
Additional properties are allowed.
Additional properties are allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
Additional properties are allowed.
object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object [Electrical]
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

object
Additional properties are allowed.
object
Additional properties are allowed.
Additional properties are allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
Additional properties are allowed.
object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Electrical]
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

object
Additional properties are allowed.
object
Additional properties are allowed.
Additional properties are allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
Additional properties are allowed.
object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Electrical]
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

object
Additional properties are allowed.
object
Additional properties are allowed.
Additional properties are allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
Additional properties are allowed.
object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
object
object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "ac": { "circuits": { "1": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "2": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "3": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "4": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "5": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "6": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "7": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "8": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "9": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "10": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "11": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "12": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "13": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "14": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "15": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } }, "16": { "config": { "label": "Kitchen", "phase": "line_1", "polarity": "forward", "sensor": "ct_30" }, "current": { "demand_distortion": { "full_load_current": 12.5 } } } }, "frequency": { "nominal": {}, "nominal_range": {} }, "voltage": { "nominal": {}, "phases": { "line_1": { "dips_swells": { "limits": {} } }, "line_2": { "dips_swells": { "limits": {} } }, "line_3": { "dips_swells": { "limits": {} } } } } } }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/electrical/data
Parameters related to electrical systems.

Operation IDelectrical/data
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Group)
Accepts the following message:
electrical/data
application/json
Message IDelectrical/data
oneOf
object
(gen1)

object [Electrical]
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

instantaneous
number
[ 0 .. 100 ]decimal places <= 3
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

object
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

min
number
[ 0 .. 100 ]decimal places <= 3
The highest transient value within a 1-second timeframe.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

std_dev
number
[ 0 .. 100 ]decimal places <= 3
The measure of dispersion in transient values within a 1-second timeframe, indicating how much they deviate from the mean.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
Additional properties are allowed.
unbalance_factor
number
[ 0 .. 100 ]decimal places <= 3
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object [Electrical]
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

instantaneous
number
[ 0 .. 100 ]decimal places <= 3
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

object
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

min
number
[ 0 .. 100 ]decimal places <= 3
The highest transient value within a 1-second timeframe.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

std_dev
number
[ 0 .. 100 ]decimal places <= 3
The measure of dispersion in transient values within a 1-second timeframe, indicating how much they deviate from the mean.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
Additional properties are allowed.
unbalance_factor
number
[ 0 .. 100 ]decimal places <= 3
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Electrical]
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

instantaneous
number
[ 0 .. 100 ]decimal places <= 3
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

object
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

min
number
[ 0 .. 100 ]decimal places <= 3
The highest transient value within a 1-second timeframe.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

std_dev
number
[ 0 .. 100 ]decimal places <= 3
The measure of dispersion in transient values within a 1-second timeframe, indicating how much they deviate from the mean.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
Additional properties are allowed.
unbalance_factor
number
[ 0 .. 100 ]decimal places <= 3
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Electrical]
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

Additional properties are allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are allowed.
Additional properties are allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
object
abc

object
Additional properties are allowed.
Additional properties are allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

instantaneous
number
[ 0 .. 100 ]decimal places <= 3
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

object
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

min
number
[ 0 .. 100 ]decimal places <= 3
The highest transient value within a 1-second timeframe.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

std_dev
number
[ 0 .. 100 ]decimal places <= 3
The measure of dispersion in transient values within a 1-second timeframe, indicating how much they deviate from the mean.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
Additional properties are allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are allowed.
Additional properties are allowed.
unbalance_factor
number
[ 0 .. 100 ]decimal places <= 3
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "ac": { "circuits": { "1": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "2": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "3": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "4": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "5": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "6": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "7": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "8": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "9": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "10": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "11": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "12": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "13": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "14": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "15": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } }, "16": { "config": {}, "current": { "crest_factor": 1.41, "demand_distortion": { "tdd": 4.2 }, "rms": 12.5, "spectrum": [ { "centroid": 100, "magnitude": 12.5, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 12.5 }, "energy": { "active": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "apparent": { "exported": 134.3, "imported": 134.3, "net": 187.4 }, "reactive": { "exported": 134.3, "imported": 134.3, "net": 187.4 } }, "power": { "active": 1482.6, "apparent": 1739.4, "power_factor": { "displacement": 0.91, "distortion": 0.91, "total": 0.91 }, "reactive": 1482.6 } } }, "frequency": { "instantaneous": 50.01, "transient": { "min": 50.01, "std_dev": 50.01 } }, "voltage": { "phases": { "line_1": { "crest_factor": 1.41, "dips_swells": { "event": { "duration": null, "magnitude": 230, "start_time": 0 } }, "rms": 230, "spectrum": [ { "centroid": 100, "magnitude": 230, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 230 }, "line_2": { "crest_factor": 1.41, "dips_swells": { "event": { "duration": null, "magnitude": 230, "start_time": 0 } }, "rms": 230, "spectrum": [ { "centroid": 100, "magnitude": 230, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 230 }, "line_3": { "crest_factor": 1.41, "dips_swells": { "event": { "duration": null, "magnitude": 230, "start_time": 0 } }, "rms": 230, "spectrum": [ { "centroid": 100, "magnitude": 230, "range": 50.01 } ], "thd": { "fundamental": 12.7, "rms": 4.2 }, "waveform_peak": 230 } }, "unbalance_factor": 1.3 } } }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/air_quality/gas/co2
Operation IDenvironment/air_quality/gas/co2
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
environment/air_quality/gas/co2
application/json
Message IDenvironment/air_quality/gas/co2
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "co2" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/air_quality/gas/nox
Operation IDenvironment/air_quality/gas/nox
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
environment/air_quality/gas/nox
application/json
Message IDenvironment/air_quality/gas/nox
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "nox" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/air_quality/gas/voc
Operation IDenvironment/air_quality/gas/voc
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
environment/air_quality/gas/voc
application/json
Message IDenvironment/air_quality/gas/voc
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "voc" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/air_quality/humidity
abc

Operation IDenvironment/air_quality/humidity
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
environment/air_quality/humidity
application/json
Message IDenvironment/air_quality/humidity
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "humidity" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/air_quality/particulate/coarse
Operation IDenvironment/air_quality/particulate/coarse
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
environment/air_quality/particulate/coarse
application/json
Message IDenvironment/air_quality/particulate/coarse
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "coarse" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/air_quality/particulate/fine
Operation IDenvironment/air_quality/particulate/fine
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
environment/air_quality/particulate/fine
application/json
Message IDenvironment/air_quality/particulate/fine
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "fine" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/air_quality/particulate/medium
Operation IDenvironment/air_quality/particulate/medium
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
environment/air_quality/particulate/medium
application/json
Message IDenvironment/air_quality/particulate/medium
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "medium" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/air_quality/particulate/ultrafine
Operation IDenvironment/air_quality/particulate/ultrafine
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
environment/air_quality/particulate/ultrafine
application/json
Message IDenvironment/air_quality/particulate/ultrafine
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "ultrafine" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/config
Parameters related to environmental systems.

Operation IDenvironment/config
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Group)
Accepts the following message:
environment/config
application/json
Message IDenvironment/config
object
object [Environment]
Parameters related to environmental systems.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": {}, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/environment/data
Parameters related to environmental systems.

Operation IDenvironment/data
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Group)
Accepts the following message:
environment/data
application/json
Message IDenvironment/data
object
object [Environment]
Parameters related to environmental systems.

object
object
object
Additional properties are allowed.
object
Additional properties are allowed.
object
Additional properties are allowed.
Additional properties are allowed.
humidity
number
[ 0 .. 100 ]decimal places <= 1
abc

Unit:

Percent (%)

abc

object
object
Additional properties are allowed.
object
Additional properties are allowed.
object
Additional properties are allowed.
object
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "air_quality": { "gas": { "co2": {}, "nox": {}, "voc": {} }, "humidity": 97.2, "particulate": { "coarse": {}, "fine": {}, "medium": {}, "ultrafine": {} } } }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/mechanical/channels/a/level
abc

Operation IDmechanical/channels/a/level
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
mechanical/channels/a/level
application/json
Message IDmechanical/channels/a/level
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "level" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/mechanical/channels/b/level
abc

Operation IDmechanical/channels/b/level
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
mechanical/channels/b/level
application/json
Message IDmechanical/channels/b/level
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "level" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/mechanical/channels/c/level
abc

Operation IDmechanical/channels/c/level
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
mechanical/channels/c/level
application/json
Message IDmechanical/channels/c/level
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "level" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/mechanical/channels/d/level
abc

Operation IDmechanical/channels/d/level
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
mechanical/channels/d/level
application/json
Message IDmechanical/channels/d/level
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "level" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/mechanical/config
Parameters related to mechanical systems.

Operation IDmechanical/config
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Group)
Accepts the following message:
mechanical/config
application/json
Message IDmechanical/config
object
object [Mechanical]
Parameters related to mechanical systems.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": {}, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/mechanical/data
Parameters related to mechanical systems.

Operation IDmechanical/data
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Group)
Accepts the following message:
mechanical/data
application/json
Message IDmechanical/data
object
object [Mechanical]
Parameters related to mechanical systems.

object
object
object oneOf
abc

object
depth
number
[ 0 .. 100000000 ]decimal places <= 6
abc

Default value:0
Additional properties are NOT allowed.
object
string oneOf
abc

Adheres to:
string
abc

Const:"low"
Or to:
string
abc

Const:"high"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are allowed.
object
object oneOf
abc

object
depth
number
[ 0 .. 100000000 ]decimal places <= 6
abc

Default value:0
Additional properties are NOT allowed.
object
string oneOf
abc

Adheres to:
string
abc

Const:"low"
Or to:
string
abc

Const:"high"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are allowed.
object
object oneOf
abc

object
depth
number
[ 0 .. 100000000 ]decimal places <= 6
abc

Default value:0
Additional properties are NOT allowed.
object
string oneOf
abc

Adheres to:
string
abc

Const:"low"
Or to:
string
abc

Const:"high"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are allowed.
object
object oneOf
abc

object
depth
number
[ 0 .. 100000000 ]decimal places <= 6
abc

Default value:0
Additional properties are NOT allowed.
object
string oneOf
abc

Adheres to:
string
abc

Const:"low"
Or to:
string
abc

Const:"high"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "[channels]": { "a": { "level": { "depth": 7.3 } }, "b": { "level": { "depth": 7.3 } }, "c": { "level": { "depth": 7.3 } }, "d": { "level": { "depth": 7.3 } } } }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/connection/iccid
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

Operation IDnetwork/cellular/connection/iccid
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/connection/iccid
application/json
Message IDnetwork/cellular/connection/iccid
oneOf
object
(gen1)

data
string
must match: ^[0-9]{18,22}$
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
must match: ^[0-9]{18,22}$
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
must match: ^[0-9]{18,22}$
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "string", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/connection/imsi/mcc
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

Operation IDnetwork/cellular/connection/imsi/mcc
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/connection/imsi/mcc
application/json
Message IDnetwork/cellular/connection/imsi/mcc
oneOf
object
(gen1)

data
string
must match: ^[0-9]{3}$
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
must match: ^[0-9]{3}$
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
must match: ^[0-9]{3}$
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "string", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/connection/imsi/mnc
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

Operation IDnetwork/cellular/connection/imsi/mnc
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/connection/imsi/mnc
application/json
Message IDnetwork/cellular/connection/imsi/mnc
oneOf
object
(gen1)

data
string
must match: ^[0-9]{2,3}$
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
must match: ^[0-9]{2,3}$
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
must match: ^[0-9]{2,3}$
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "string", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/connection/imsi/msin
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

Operation IDnetwork/cellular/connection/imsi/msin
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/connection/imsi/msin
application/json
Message IDnetwork/cellular/connection/imsi/msin
oneOf
object
(gen1)

data
string
must match: ^[0-9]{10}$
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
must match: ^[0-9]{10}$
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
must match: ^[0-9]{10}$
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "string", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/connection/mode
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Operation IDnetwork/cellular/connection/mode
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/connection/mode
application/json
Message IDnetwork/cellular/connection/mode
oneOf
object
(gen1)

string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "cat_m1", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/connection/status
The connection status refers to whether or not a connection is enabled.

Operation IDnetwork/cellular/connection/status
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/connection/status
application/json
Message IDnetwork/cellular/connection/status
oneOf
object
(gen1)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "enabled", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/signal/rsrp
RSRP (Reference Signal Received Power) gauges the power level of specific LTE reference signals in dBm. Closer to -80 dBm signifies a strong signal, while figures around -100 dBm indicate weak ones. RSRP helps determine LTE cell coverage and connection robustness.

Operation IDnetwork/cellular/signal/rsrp
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/signal/rsrp
application/json
Message IDnetwork/cellular/signal/rsrp
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rsrp" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/signal/rsrq
RSRQ (Reference Signal Received Quality) evaluates the quality of LTE reference signals by comparing the received power of a reference signal to the total received power. A value closer to -10 dB suggests superior signal quality, while values nearing -20 dB indicate poorer quality. RSRQ helps understand the LTE signal's relative quality in the context of surrounding interference.

Operation IDnetwork/cellular/signal/rsrq
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/signal/rsrq
application/json
Message IDnetwork/cellular/signal/rsrq
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rsrq" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/signal/rssi
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Operation IDnetwork/cellular/signal/rssi
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/signal/rssi
application/json
Message IDnetwork/cellular/signal/rssi
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "rssi" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/cellular/signal/sinr
SINR (Signal-to-Interference-plus-Noise Ratio) contrasts the power of a desired signal against the combined power of interference and noise, represented in dB. Higher values, like 20 dB, suggest a better signal quality, whereas values close to 0 dB suggest a compromised signal due to interference. SINR helps gauge LTE connection clarity.

Operation IDnetwork/cellular/signal/sinr
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/cellular/signal/sinr
application/json
Message IDnetwork/cellular/signal/sinr
oneOf
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "sinr" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/config
Parameters related to connectivity and network protocols.

Operation IDnetwork/config
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Group)
Accepts the following message:
network/config
application/json
Message IDnetwork/config
oneOf
object
(gen0_4ch)

object [Network]
Parameters related to connectivity and network protocols.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

object [Network]
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

apn
string
<= 100 characters
The APN (Access Point Name) is a setting that identifies a cellular data network the node can connect to. It provides the necessary information to connect to the internet and defines the type of service it can access. Cellular providers specify the APN settings for their networks, ensuring users can send and receive data correctly.

pin
string
must match: ^[0-9]{4}$
The PIN (Personal Identification Number) for a SIM card is a security code, typically 4 to 8 digits long, that protects the card from unauthorized access. When enabled, users must enter the PIN to use the SIM for accessing cellular data. If entered incorrectly multiple times, the SIM locks, requiring a PUK (Personal Unblocking Key) to unlock.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object [Network]
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

apn
string
<= 100 characters
The APN (Access Point Name) is a setting that identifies a cellular data network the node can connect to. It provides the necessary information to connect to the internet and defines the type of service it can access. Cellular providers specify the APN settings for their networks, ensuring users can send and receive data correctly.

pin
string
must match: ^[0-9]{4}$
The PIN (Personal Identification Number) for a SIM card is a security code, typically 4 to 8 digits long, that protects the card from unauthorized access. When enabled, users must enter the PIN to use the SIM for accessing cellular data. If entered incorrectly multiple times, the SIM locks, requiring a PUK (Personal Unblocking Key) to unlock.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Network]
Parameters related to connectivity and network protocols.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Network]
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

apn
string
<= 100 characters
The APN (Access Point Name) is a setting that identifies a cellular data network the node can connect to. It provides the necessary information to connect to the internet and defines the type of service it can access. Cellular providers specify the APN settings for their networks, ensuring users can send and receive data correctly.

pin
string
must match: ^[0-9]{4}$
The PIN (Personal Identification Number) for a SIM card is a security code, typically 4 to 8 digits long, that protects the card from unauthorized access. When enabled, users must enter the PIN to use the SIM for accessing cellular data. If entered incorrectly multiple times, the SIM locks, requiring a PUK (Personal Unblocking Key) to unlock.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

object [Network]
Parameters related to connectivity and network protocols.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": {}, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/connectivity/status
The connection status shows whether or not a device is currently online.

Operation IDnetwork/connectivity/status
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/connectivity/status
application/json
Message IDnetwork/connectivity/status
oneOf
object
(gen0_4ch)

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "online", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/connectivity/uptime/average_6h
Moving average of the device uptime in the past 6 hours.

Operation IDnetwork/connectivity/uptime/average_6h
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/connectivity/uptime/average_6h
application/json
Message IDnetwork/connectivity/uptime/average_6h
oneOf
array<array<any>>
(gen0_4ch)

Items:
array<any>
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
array<array<any>>
(gen1_environment)

Items:
array<any>
Examples
[ [ "timestamp", "average_6h" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/data
Parameters related to connectivity and network protocols.

Operation IDnetwork/data
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Group)
Accepts the following message:
network/data
application/json
Message IDnetwork/data
oneOf
object
(gen0_4ch)

object [Network]
Parameters related to connectivity and network protocols.

object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

object [Network]
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

iccid
string
must match: ^[0-9]{18,22}$
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

object
The IMSI (International Mobile Subscriber Identity) is a unique number associated with every user of a cellular network. It's stored in the SIM card and used to identify the subscriber to the network for services like calls and SMS. Typically 15 digits long, the IMSI is a combination of MCC (mobile country code), MNC (mobile network code), and MSIN (mobile subscriber identification number).

mcc
string
must match: ^[0-9]{3}$
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

mnc
string
must match: ^[0-9]{2,3}$
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

msin
string
must match: ^[0-9]{10}$
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

Additional properties are allowed.
string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rsrp
number
[ -128 .. 0 ]multiple of 1
RSRP (Reference Signal Received Power) gauges the power level of specific LTE reference signals in dBm. Closer to -80 dBm signifies a strong signal, while figures around -100 dBm indicate weak ones. RSRP helps determine LTE cell coverage and connection robustness.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

rsrq
number
[ -32 .. 0 ]multiple of 1
RSRQ (Reference Signal Received Quality) evaluates the quality of LTE reference signals by comparing the received power of a reference signal to the total received power. A value closer to -10 dB suggests superior signal quality, while values nearing -20 dB indicate poorer quality. RSRQ helps understand the LTE signal's relative quality in the context of surrounding interference.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

sinr
number
[ -32 .. 32 ]multiple of 1
SINR (Signal-to-Interference-plus-Noise Ratio) contrasts the power of a desired signal against the combined power of interference and noise, represented in dB. Higher values, like 20 dB, suggest a better signal quality, whereas values close to 0 dB suggest a compromised signal due to interference. SINR helps gauge LTE connection clarity.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

Additional properties are allowed.
Additional properties are allowed.
object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

object [Network]
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

iccid
string
must match: ^[0-9]{18,22}$
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

object
The IMSI (International Mobile Subscriber Identity) is a unique number associated with every user of a cellular network. It's stored in the SIM card and used to identify the subscriber to the network for services like calls and SMS. Typically 15 digits long, the IMSI is a combination of MCC (mobile country code), MNC (mobile network code), and MSIN (mobile subscriber identification number).

mcc
string
must match: ^[0-9]{3}$
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

mnc
string
must match: ^[0-9]{2,3}$
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

msin
string
must match: ^[0-9]{10}$
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

Additional properties are allowed.
string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rsrp
number
[ -128 .. 0 ]multiple of 1
RSRP (Reference Signal Received Power) gauges the power level of specific LTE reference signals in dBm. Closer to -80 dBm signifies a strong signal, while figures around -100 dBm indicate weak ones. RSRP helps determine LTE cell coverage and connection robustness.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

rsrq
number
[ -32 .. 0 ]multiple of 1
RSRQ (Reference Signal Received Quality) evaluates the quality of LTE reference signals by comparing the received power of a reference signal to the total received power. A value closer to -10 dB suggests superior signal quality, while values nearing -20 dB indicate poorer quality. RSRQ helps understand the LTE signal's relative quality in the context of surrounding interference.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

sinr
number
[ -32 .. 32 ]multiple of 1
SINR (Signal-to-Interference-plus-Noise Ratio) contrasts the power of a desired signal against the combined power of interference and noise, represented in dB. Higher values, like 20 dB, suggest a better signal quality, whereas values close to 0 dB suggest a compromised signal due to interference. SINR helps gauge LTE connection clarity.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

Additional properties are allowed.
Additional properties are allowed.
object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Network]
Parameters related to connectivity and network protocols.

object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Network]
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

iccid
string
must match: ^[0-9]{18,22}$
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

object
The IMSI (International Mobile Subscriber Identity) is a unique number associated with every user of a cellular network. It's stored in the SIM card and used to identify the subscriber to the network for services like calls and SMS. Typically 15 digits long, the IMSI is a combination of MCC (mobile country code), MNC (mobile network code), and MSIN (mobile subscriber identification number).

mcc
string
must match: ^[0-9]{3}$
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

mnc
string
must match: ^[0-9]{2,3}$
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

msin
string
must match: ^[0-9]{10}$
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

Additional properties are allowed.
string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rsrp
number
[ -128 .. 0 ]multiple of 1
RSRP (Reference Signal Received Power) gauges the power level of specific LTE reference signals in dBm. Closer to -80 dBm signifies a strong signal, while figures around -100 dBm indicate weak ones. RSRP helps determine LTE cell coverage and connection robustness.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

rsrq
number
[ -32 .. 0 ]multiple of 1
RSRQ (Reference Signal Received Quality) evaluates the quality of LTE reference signals by comparing the received power of a reference signal to the total received power. A value closer to -10 dB suggests superior signal quality, while values nearing -20 dB indicate poorer quality. RSRQ helps understand the LTE signal's relative quality in the context of surrounding interference.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

sinr
number
[ -32 .. 32 ]multiple of 1
SINR (Signal-to-Interference-plus-Noise Ratio) contrasts the power of a desired signal against the combined power of interference and noise, represented in dB. Higher values, like 20 dB, suggest a better signal quality, whereas values close to 0 dB suggest a compromised signal due to interference. SINR helps gauge LTE connection clarity.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

Additional properties are allowed.
Additional properties are allowed.
object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

object [Network]
Parameters related to connectivity and network protocols.

object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are allowed.
Additional properties are allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "connectivity": { "status": "online", "uptime": { "average_6h": 97.2 } }, "linc_mesh": { "connection": { "hop_count": 1, "ip_address": "192.168.1.10", "parent_node": "100P", "status": "enabled" }, "signal": { "rssi": -62 } }, "wifi": { "connection": { "ip_address": "192.168.1.10", "status": "enabled" }, "signal": { "rssi": -62 } } }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/linc_mesh/connection/hop_count
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

Operation IDnetwork/linc_mesh/connection/hop_count
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/linc_mesh/connection/hop_count
application/json
Message IDnetwork/linc_mesh/connection/hop_count
oneOf
object
(gen0_4ch)

data
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

data
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

data
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": 1, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/linc_mesh/connection/ip_address
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Operation IDnetwork/linc_mesh/connection/ip_address
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/linc_mesh/connection/ip_address
application/json
Message IDnetwork/linc_mesh/connection/ip_address
oneOf
object
(gen0_4ch)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "192.168.1.10", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/linc_mesh/connection/parent_node
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

Operation IDnetwork/linc_mesh/connection/parent_node
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/linc_mesh/connection/parent_node
application/json
Message IDnetwork/linc_mesh/connection/parent_node
oneOf
object
(gen0_4ch)

data
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

data
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

data
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

data
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

data
string
must match: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "100L", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/linc_mesh/connection/status
The connection status refers to whether or not a connection is enabled.

Operation IDnetwork/linc_mesh/connection/status
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/linc_mesh/connection/status
application/json
Message IDnetwork/linc_mesh/connection/status
oneOf
object
(gen0_4ch)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "enabled", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/linc_mesh/signal/rssi
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Operation IDnetwork/linc_mesh/signal/rssi
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/linc_mesh/signal/rssi
application/json
Message IDnetwork/linc_mesh/signal/rssi
oneOf
array<array<any>>
(gen0_4ch)

Items:
array<any>
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
array<array<any>>
(gen1_environment)

Items:
array<any>
Examples
[ [ "timestamp", "rssi" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/wifi/connection/ip_address
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Operation IDnetwork/wifi/connection/ip_address
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/wifi/connection/ip_address
application/json
Message IDnetwork/wifi/connection/ip_address
oneOf
object
(gen0_4ch)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "192.168.1.10", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/wifi/connection/status
The connection status refers to whether or not a connection is enabled.

Operation IDnetwork/wifi/connection/status
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/wifi/connection/status
application/json
Message IDnetwork/wifi/connection/status
oneOf
object
(gen0_4ch)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_8ch)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": "enabled", "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/network/wifi/signal/rssi
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Operation IDnetwork/wifi/signal/rssi
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
network/wifi/signal/rssi
application/json
Message IDnetwork/wifi/signal/rssi
oneOf
array<array<any>>
(gen0_4ch)

Items:
array<any>
array<array<any>>
(gen1)

Items:
array<any>
array<array<any>>
(gen0_8ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
array<array<any>>
(gen1_environment)

Items:
array<any>
Examples
[ [ "timestamp", "rssi" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/thermal/channels/a/temperature
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Operation IDthermal/channels/a/temperature
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
thermal/channels/a/temperature
application/json
Message IDthermal/channels/a/temperature
oneOf
array<array<any>>
(gen0_4ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "temperature" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/thermal/channels/b/temperature
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Operation IDthermal/channels/b/temperature
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
thermal/channels/b/temperature
application/json
Message IDthermal/channels/b/temperature
oneOf
array<array<any>>
(gen0_4ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "temperature" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/thermal/channels/c/temperature
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Operation IDthermal/channels/c/temperature
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
thermal/channels/c/temperature
application/json
Message IDthermal/channels/c/temperature
oneOf
array<array<any>>
(gen0_4ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "temperature" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/thermal/channels/d/temperature
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Operation IDthermal/channels/d/temperature
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
thermal/channels/d/temperature
application/json
Message IDthermal/channels/d/temperature
oneOf
array<array<any>>
(gen0_4ch)

Items:
array<any>
array<array<any>>
(gen0_p1)

Items:
array<any>
array<array<any>>
(gen1_industrial)

Items:
array<any>
Examples
[ [ "timestamp", "temperature" ] ]

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/thermal/config
Parameters related to thermal systems.

Operation IDthermal/config
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Config (Group)
Accepts the following message:
thermal/config
application/json
Message IDthermal/config
oneOf
object
(gen0_4ch)

object [Thermal]
Parameters related to thermal systems.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Thermal]
Parameters related to thermal systems.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Thermal]
Parameters related to thermal systems.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

object [Thermal]
Parameters related to thermal systems.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": {}, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/thermal/data
Parameters related to thermal systems.

Operation IDthermal/data
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Group)
Accepts the following message:
thermal/data
application/json
Message IDthermal/data
oneOf
object
(gen0_4ch)

object [Thermal]
Parameters related to thermal systems.

object
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen0_p1)

object [Thermal]
Parameters related to thermal systems.

object
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_industrial)

object [Thermal]
Parameters related to thermal systems.

object
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
Additional properties are allowed.
Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
object
(gen1_environment)

object [Thermal]
Parameters related to thermal systems.

temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are allowed.
Examples
{ "data": { "[channels]": { "a": { "temperature": 27.2 }, "b": { "temperature": 27.2 }, "c": { "temperature": 27.2 }, "d": { "temperature": 27.2 } } }, "timestamp": 1696010102 }

This example has been generated automatically.
PUB /{organisation_id}/nodes/{node_id}/thermal/temperature
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Operation IDthermal/temperature
Available only on servers:
- production
object
node_id
required
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Some description

organisation_id
required
string
format: uuid
Some description
- #Data (Individual)
Accepts the following message:
thermal/temperature
application/json
Message IDthermal/temperature
array<array<any>>
Items:
array<any>
Examples
[ [ "timestamp", "temperature" ] ]

This example has been generated automatically.

Schemas

object
object
abc

object
object
abc

object
Parameters for identification, information and configuration of hardware devices.

object
Details related to a cellular module - a hardware component that connects devices to cellular networks for wireless data transmission using standards like 4G (LTE) and 5G.

fw_version
string
The firmware version of a cellular module represents its embedded software state, dictating functionalities and network compatibility. Updates can introduce new features or fixes. Identifying the version aids in troubleshooting.

imei
string
must match: /^[0-9]{15,17}$/
The IMEI (International Mobile Equipment Identity) is a unique 15-digit number assigned to mobile devices, such as smartphones and tablets. It serves as an identifier for the device and can be used by cellular networks to authenticate the device and permit or deny its access to the network. IMEI is essential for tracking and blacklisting stolen devices, ensuring they cannot be used on any network, even if the SIM card is replaced.

model
string
[ 1 .. 24 ] characters
The model of a cellular module refers to its distinct version in terms of features, capabilities, and cellular compatibility.

serial
string
[ 1 .. 24 ] characters
A serial number is a unique identifier assigned by the manufacturer to a cellular module. It helps in tracking, service support, and verifying authenticity.

Additional properties are NOT allowed.
object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Additional properties are NOT allowed.
fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Electrical Node

Const:"gen0_8ch"
Additional properties are NOT allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

instantaneous
number
[ 0 .. 100 ]decimal places <= 3
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

object
Additional properties are NOT allowed.
object
Additional properties are NOT allowed.
object
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

min
number
[ 0 .. 100 ]decimal places <= 3
The highest transient value within a 1-second timeframe.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

std_dev
number
[ 0 .. 100 ]decimal places <= 3
The measure of dispersion in transient values within a 1-second timeframe, indicating how much they deviate from the mean.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
Additional properties are NOT allowed.
object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
unbalance_factor
number
[ 0 .. 100 ]decimal places <= 3
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

apn
string
<= 100 characters
The APN (Access Point Name) is a setting that identifies a cellular data network the node can connect to. It provides the necessary information to connect to the internet and defines the type of service it can access. Cellular providers specify the APN settings for their networks, ensuring users can send and receive data correctly.

iccid
string
must match: /^[0-9]{18,22}$/
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

object
The IMSI (International Mobile Subscriber Identity) is a unique number associated with every user of a cellular network. It's stored in the SIM card and used to identify the subscriber to the network for services like calls and SMS. Typically 15 digits long, the IMSI is a combination of MCC (mobile country code), MNC (mobile network code), and MSIN (mobile subscriber identification number).

mcc
string
must match: /^[0-9]{3}$/
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

mnc
string
must match: /^[0-9]{2,3}$/
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

msin
string
must match: /^[0-9]{10}$/
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

Additional properties are NOT allowed.
string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
pin
string
must match: /^[0-9]{4}$/
The PIN (Personal Identification Number) for a SIM card is a security code, typically 4 to 8 digits long, that protects the card from unauthorized access. When enabled, users must enter the PIN to use the SIM for accessing cellular data. If entered incorrectly multiple times, the SIM locks, requiring a PUK (Personal Unblocking Key) to unlock.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rsrp
number
[ -128 .. 0 ]multiple of 1
RSRP (Reference Signal Received Power) gauges the power level of specific LTE reference signals in dBm. Closer to -80 dBm signifies a strong signal, while figures around -100 dBm indicate weak ones. RSRP helps determine LTE cell coverage and connection robustness.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

rsrq
number
[ -32 .. 0 ]multiple of 1
RSRQ (Reference Signal Received Quality) evaluates the quality of LTE reference signals by comparing the received power of a reference signal to the total received power. A value closer to -10 dB suggests superior signal quality, while values nearing -20 dB indicate poorer quality. RSRQ helps understand the LTE signal's relative quality in the context of surrounding interference.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

sinr
number
[ -32 .. 32 ]multiple of 1
SINR (Signal-to-Interference-plus-Noise Ratio) contrasts the power of a desired signal against the combined power of interference and noise, represented in dB. Higher values, like 20 dB, suggest a better signal quality, whereas values close to 0 dB suggest a compromised signal due to interference. SINR helps gauge LTE connection clarity.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
abc

object
Parameters for identification, information and configuration of hardware devices.

object
Details related to a cellular module - a hardware component that connects devices to cellular networks for wireless data transmission using standards like 4G (LTE) and 5G.

fw_version
string
The firmware version of a cellular module represents its embedded software state, dictating functionalities and network compatibility. Updates can introduce new features or fixes. Identifying the version aids in troubleshooting.

imei
string
must match: /^[0-9]{15,17}$/
The IMEI (International Mobile Equipment Identity) is a unique 15-digit number assigned to mobile devices, such as smartphones and tablets. It serves as an identifier for the device and can be used by cellular networks to authenticate the device and permit or deny its access to the network. IMEI is essential for tracking and blacklisting stolen devices, ensuring they cannot be used on any network, even if the SIM card is replaced.

model
string
[ 1 .. 24 ] characters
The model of a cellular module refers to its distinct version in terms of features, capabilities, and cellular compatibility.

serial
string
[ 1 .. 24 ] characters
A serial number is a unique identifier assigned by the manufacturer to a cellular module. It helps in tracking, service support, and verifying authenticity.

Additional properties are NOT allowed.
object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Additional properties are NOT allowed.
fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
P1 Electrical Node

Const:"gen0_p1"
Additional properties are NOT allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

instantaneous
number
[ 0 .. 100 ]decimal places <= 3
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

object
Additional properties are NOT allowed.
object
Additional properties are NOT allowed.
object
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

min
number
[ 0 .. 100 ]decimal places <= 3
The highest transient value within a 1-second timeframe.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

std_dev
number
[ 0 .. 100 ]decimal places <= 3
The measure of dispersion in transient values within a 1-second timeframe, indicating how much they deviate from the mean.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
Additional properties are NOT allowed.
object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
unbalance_factor
number
[ 0 .. 100 ]decimal places <= 3
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to connectivity and network protocols.

object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to thermal systems.

object
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
abc

object
Parameters for identification, information and configuration of hardware devices.

object
Details related to a cellular module - a hardware component that connects devices to cellular networks for wireless data transmission using standards like 4G (LTE) and 5G.

fw_version
string
The firmware version of a cellular module represents its embedded software state, dictating functionalities and network compatibility. Updates can introduce new features or fixes. Identifying the version aids in troubleshooting.

imei
string
must match: /^[0-9]{15,17}$/
The IMEI (International Mobile Equipment Identity) is a unique 15-digit number assigned to mobile devices, such as smartphones and tablets. It serves as an identifier for the device and can be used by cellular networks to authenticate the device and permit or deny its access to the network. IMEI is essential for tracking and blacklisting stolen devices, ensuring they cannot be used on any network, even if the SIM card is replaced.

model
string
[ 1 .. 24 ] characters
The model of a cellular module refers to its distinct version in terms of features, capabilities, and cellular compatibility.

serial
string
[ 1 .. 24 ] characters
A serial number is a unique identifier assigned by the manufacturer to a cellular module. It helps in tracking, service support, and verifying authenticity.

Additional properties are NOT allowed.
object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Additional properties are NOT allowed.
fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Electrical Node

Const:"gen1"
Additional properties are NOT allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

instantaneous
number
[ 0 .. 100 ]decimal places <= 3
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

object
Additional properties are NOT allowed.
object
Additional properties are NOT allowed.
object
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

min
number
[ 0 .. 100 ]decimal places <= 3
The highest transient value within a 1-second timeframe.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

std_dev
number
[ 0 .. 100 ]decimal places <= 3
The measure of dispersion in transient values within a 1-second timeframe, indicating how much they deviate from the mean.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
Additional properties are NOT allowed.
object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
unbalance_factor
number
[ 0 .. 100 ]decimal places <= 3
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

apn
string
<= 100 characters
The APN (Access Point Name) is a setting that identifies a cellular data network the node can connect to. It provides the necessary information to connect to the internet and defines the type of service it can access. Cellular providers specify the APN settings for their networks, ensuring users can send and receive data correctly.

iccid
string
must match: /^[0-9]{18,22}$/
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

object
The IMSI (International Mobile Subscriber Identity) is a unique number associated with every user of a cellular network. It's stored in the SIM card and used to identify the subscriber to the network for services like calls and SMS. Typically 15 digits long, the IMSI is a combination of MCC (mobile country code), MNC (mobile network code), and MSIN (mobile subscriber identification number).

mcc
string
must match: /^[0-9]{3}$/
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

mnc
string
must match: /^[0-9]{2,3}$/
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

msin
string
must match: /^[0-9]{10}$/
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

Additional properties are NOT allowed.
string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
pin
string
must match: /^[0-9]{4}$/
The PIN (Personal Identification Number) for a SIM card is a security code, typically 4 to 8 digits long, that protects the card from unauthorized access. When enabled, users must enter the PIN to use the SIM for accessing cellular data. If entered incorrectly multiple times, the SIM locks, requiring a PUK (Personal Unblocking Key) to unlock.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rsrp
number
[ -128 .. 0 ]multiple of 1
RSRP (Reference Signal Received Power) gauges the power level of specific LTE reference signals in dBm. Closer to -80 dBm signifies a strong signal, while figures around -100 dBm indicate weak ones. RSRP helps determine LTE cell coverage and connection robustness.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

rsrq
number
[ -32 .. 0 ]multiple of 1
RSRQ (Reference Signal Received Quality) evaluates the quality of LTE reference signals by comparing the received power of a reference signal to the total received power. A value closer to -10 dB suggests superior signal quality, while values nearing -20 dB indicate poorer quality. RSRQ helps understand the LTE signal's relative quality in the context of surrounding interference.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

sinr
number
[ -32 .. 32 ]multiple of 1
SINR (Signal-to-Interference-plus-Noise Ratio) contrasts the power of a desired signal against the combined power of interference and noise, represented in dB. Higher values, like 20 dB, suggest a better signal quality, whereas values close to 0 dB suggest a compromised signal due to interference. SINR helps gauge LTE connection clarity.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
object
abc

object
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:60
Adheres to:
number
Data is reported to server at 1 minute intervals.

Const:60
Additional properties are NOT allowed.
fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Environmental Node

Const:"gen0_4ch"
Additional properties are NOT allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to connectivity and network protocols.

object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to thermal systems.

object
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
abc

object
Parameters for identification, information and configuration of hardware devices.

object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:60
Adheres to:
number
Data is reported to server at 1 minute intervals.

Const:60
Additional properties are NOT allowed.
fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Electrical Node

Const:"gen1"
Additional properties are NOT allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to environmental systems.

object
object
object
Additional properties are NOT allowed.
object
Additional properties are NOT allowed.
object
Additional properties are NOT allowed.
Additional properties are NOT allowed.
humidity
number
[ 0 .. 100 ]decimal places <= 1
abc

Unit:

Percent (%)

abc

object
object
Additional properties are NOT allowed.
object
Additional properties are NOT allowed.
object
Additional properties are NOT allowed.
object
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to connectivity and network protocols.

object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to thermal systems.

temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
object
abc

object
Parameters for identification, information and configuration of hardware devices.

object
Details related to a cellular module - a hardware component that connects devices to cellular networks for wireless data transmission using standards like 4G (LTE) and 5G.

fw_version
string
The firmware version of a cellular module represents its embedded software state, dictating functionalities and network compatibility. Updates can introduce new features or fixes. Identifying the version aids in troubleshooting.

imei
string
must match: /^[0-9]{15,17}$/
The IMEI (International Mobile Equipment Identity) is a unique 15-digit number assigned to mobile devices, such as smartphones and tablets. It serves as an identifier for the device and can be used by cellular networks to authenticate the device and permit or deny its access to the network. IMEI is essential for tracking and blacklisting stolen devices, ensuring they cannot be used on any network, even if the SIM card is replaced.

model
string
[ 1 .. 24 ] characters
The model of a cellular module refers to its distinct version in terms of features, capabilities, and cellular compatibility.

serial
string
[ 1 .. 24 ] characters
A serial number is a unique identifier assigned by the manufacturer to a cellular module. It helps in tracking, service support, and verifying authenticity.

Additional properties are NOT allowed.
object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Additional properties are NOT allowed.
fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
Linc Electrical Node

Const:"gen1"
Additional properties are NOT allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
A specific circuit in a multi-channel measurement system.

object
Configuration parameters for an individual circuit, including its phase assignment, polarity, rating and sensor selection.

label
string
[ 0 .. 32 ] characters
User-specified name or identifier for a channel, allowing for easy differentiation of circuits in a system or network.

string oneOf
The phase designation (L1, L2, L3 or N) in an AC system indicates the specific limb of the three-phase system to which a circuit is connected.

Default value:"line_1"
Adheres to:
string
Also referred to as Phase 1, present in both single-phase and three-phase systems. Typically brown as per the IEC standard.

Const:"line_1"
Or to:
string
Also referred to as Phase 2 in a three-phase system. Typically black as per the IEC standard.

Const:"line_2"
Or to:
string
Also referred to as Phase 3 in a three-phase system. Typically grey as per the IEC standard.

Const:"line_3"
Or to:
string
Conductor that carries unbalanced current; provides return path to source. Typically blue as per the IEC standard.

Const:"neutral"
string oneOf
Signifies the direction of current flow in the circuit. Generally, in bidirectional circuits, positive polarity indicates current flow from source to load. Negative polarity signifies current flow from load to source. Essential for accurate energy accounting.

Default value:"forward"
Adheres to:
string
Current flows in the same direction as the arrow on the sensor, usually from source to load.

Const:"forward"
Or to:
string
Current flows in the direction opposite to the arrow on the sensor, necessitating reversal to adjust for correct data.

Const:"reverse"
string oneOf
Specifies the model of current sensor installed for measurements.

Adheres to:
string
Linc 30A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (3A to 36A).

Const:"ct_30"
Or to:
string
Linc 50A CT (Current Transformer). Clamp-on design with ⌀10mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (5A to 60A).

Const:"ct_50"
Or to:
string
Linc 100A CT (Current Transformer). Clamp-on design with ⌀16mm window and 1.2m cable. Accuracy of ±0.5% between 10% and 120% of rated current (10A to 120A).

Const:"ct_100"
Or to:
string
Linc 200A CT (current transformer). Clamp-on design with ⌀[Specify size] window and [Specify cable length]. Accuracy of ±0.5% between 20A and 240A (10-120% of rated current).

Const:"ct_200"
Or to:
string
Linc 400A CT (Current Transformer). Clamp-on design with ⌀36mm window and 2.0m cable. Accuracy of ±0.5% between 10% and 120% of rated current (40A to 480A).

Const:"ct_400"
Or to:
string
Linc 1500A RC (Rogowski Coil). Flexible, clamp-on design with ⌀70mm window and 2m cable. Accuracy Class 0.5 as per IEC 61869-2 with ±0.2% linearity between 1% and 120% (15A to 1800A). Positional error less than 1% of reading.

Const:"rc_1500"
Additional properties are NOT allowed.
object
Measures related to the the flow of electric charge in a circuit.

crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Demand Distortion measures harmonic current as a percentage of fixed full-load current, unlike THD-I, which is based on fluctuating fundamental or RMS currents. Expressed as a percentage of max ssytem current, it helps evaluate system inefficiencies and prevent equipment wear.

full_load_current
number
[ 0 .. 1000000 ]decimal places <= 3
Full-load current is the maximum current a system or device draws when operating at full capacity. This user-specified value is usually provided by the system manufacturer.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

tdd
number
[ 0 .. 100 ]decimal places <= 3
TDD (Total Demand Distortion) measures harmonic current as a percentage of full-load current. More stable and equipment-specific than THD-I, better for evaluating system performance.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
rms
number
[ 0 .. 1000000 ]decimal places <= 3
Current RMS (Root Mean Square) is the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of current in an AC system.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

array<object>
Representation of current RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 1000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-I (Total Harmonic Distortion in Current) indicates how much the current waveform strays from a sine wave. Often caused by demand-side nonlinear loads. Can result in overheating and equipment stress.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-I based on Fundamental frequency. Useful for targeting specific harmonics causing issues in a system.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-I based on RMS. Shows distortion in current flow. High values can cause heating in conductors.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 1000000 ]decimal places <= 3
Maximum value of the current within individual cycles during a 1-second timeframe. In a 10A AC line, the nominal peak current may reach 14.14A.

Unit:

Ampere (Ampere (A) is the unit of electric current in AC systems, indicating the flow of charge.)

A

Additional properties are NOT allowed.
object
Energy in an AC system quantifies the total work done over a period. It encompasses active, reactive, and apparent energy components.

object
Active energy represents the actual work done. Directly impacts billing as utilities usually charge based on this consumption.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy sent back to the grid. Can generate credits or offset costs.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Energy drawn from the grid. Directly impacts electricity bills.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total active energy produced minus consumed.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work, directly linked to billing.

Additional properties are NOT allowed.
object
Apparent energy is the vector sum of active and reactive energy. Although not directly billed, high levels may necessitate system upgrades, leading to additional costs. Generally quantified in kilovolt-ampere-hours (kVAh).

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy sent back to the grid. Rarely credited, but informs system's export capacity. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Apparent energy drawn from the grid. Can be a factor in demand or capacity charges. Typically measured in kVAh.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total apparent energy produced minus consumed. Useful for system capacity planning.

Unit:

Volt-Ampere hour (VAh)

Volt-Ampere hour (VAh) units measure the vector sum of active and reactive energy, provides overall view of energy flow.

Additional properties are NOT allowed.
object
Reactive energy signifies energy stored and released back to the grid. Some utilities may charge for excessive reactive energy since it can burden the system without doing useful work.

exported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy sent back to the grid. Not usually credited. May indicate over-compensation of power factor correction devices.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

imported
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Reactive energy drawn from the grid to maintain magnetic fields in inductive loads. Could lead to power factor penalties.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

net
number
[ -1000000000000000 .. 1000000000000000 ]decimal places <= 3
Total reactive energy produced minus consumed. Can indicate wasted power and potential system inefficiency.

Unit:

Volt-Ampere Reactive hour (VARh)

Volt-Ampere Reactive hour (VARh) units measure energy stored and returned to the system.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Power in an AC system is the rate of energy transfer, affected by both voltage and current. It consists of active, reactive, and apparent components, each measured in specific units.

active
number
[ -10000000 .. 10000000 ]decimal places <= 6
Active power is the real power that does actual work, like turning a motor or powering a device. Measured in watts (W), it's the primary factor for energy billing.

Unit:

Watt (W)

Watt (W) is the unit of active power in AC electrical systems, used to quantify the rate of energy transfer.

apparent
number
[ 0 .. 10000000 ]decimal places <= 6
Apparent power represents the total power flow in an AC circuit, combining active and reactive power. Measured in volt-amperes (VA), it's useful for sizing equipment and wiring but doesn't reflect real energy use.

Unit:

Volt-Ampere (VA)

Volt-Ampere (VA) is the unit for apparent power in an AC electrical system.

object
Power factor measures the efficiency of converting electrical power to useful work, combining both the phase displacement between current and voltage and harmonic distortion. A low power factor necessitates larger network infrastructure to manage inefficiencies.

displacement
number
[ -1 .. 1 ]decimal places <= 6
Indicates the phase angle difference between current and voltage, affecting real power transfer. Ideal in purely resistive circuits, it may degrade in systems with inductive or capacitive elements, requiring phase-correcting equipment.

Unit:

Displacement Power Factor (undefined)

Cosine of angle between current and voltage waveforms.

distortion
number
[ -1 .. 1 ]decimal places <= 6
Reflects the impact of harmonics on system efficiency. A poor distortion power factor can lead to overheating and damage to equipment, necessitating harmonic filters for correction.

Unit:

Distortion Power Factor (undefined)

Dimensionless measure of how harmonics distort the AC waveforms.

total
number
[ -1 .. 1 ]decimal places <= 6
The overall measure of electrical system efficiency, considering both displacement and distortion factors. A low total power factor may require infrastructure upgrades or power factor correction devices.

Unit:

Power Factor (λ)

Dimensionless ratio of active power (W) to apparent power (VA) in an AC circuit. It combines both displacement and distortion effects.

Additional properties are NOT allowed.
reactive
number
[ -10000000 .. 10000000 ]decimal places <= 6
Reactive power doesn't do work but supports the magnetic and electric fields in AC systems. Measured in volt-amperes reactive (VAR), it's essential for system stability but can lead to inefficiencies.

Unit:

Volt-Ampere Reactive (VAR)

Volt-Ampere Reactive (VAR) measures reactive power in AC systems. Important in systems with inductive loads like motors and transformers; excessive VAR can lead to higher utility charges and necessitates more robust infrastructure.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
abc

object
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

instantaneous
number
[ 0 .. 100 ]decimal places <= 3
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

object
Additional properties are NOT allowed.
object
Additional properties are NOT allowed.
object
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

min
number
[ 0 .. 100 ]decimal places <= 3
The highest transient value within a 1-second timeframe.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

std_dev
number
[ 0 .. 100 ]decimal places <= 3
The measure of dispersion in transient values within a 1-second timeframe, indicating how much they deviate from the mean.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
Additional properties are NOT allowed.
object
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
object
crest_factor
number
[ 0 .. 1000 ]decimal places <= 3
Ratio of the peak value to the RMS value of a waveform. A pure sine wave has a crest factor of 1.414.

Unit:

Crest factor (undefined)

Crest factor is a dimensionless ratio between the peak and RMS values of a waveform.

object
Short-term changes in voltage level, below or above the normal. For example, a dip to 180V or a swell to 260V on a 230V line.

object
duration
any

Unit:

Second (s)

abc

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Measurement of the severity of the event. Represented as the minimum (dip) or maximum (swell) value during the event.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

start_time
integer
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

Additional properties are NOT allowed.
object
Prescribed bounds for acceptable voltage variation. An event triggers when voltage exceeds the upper or lower thresholds relative to the reference voltage. It triggers off when voltage returns to within hysteresis limits.

[property]
number
[ 123 .. 123 ]multiple of 123
abc

Unit:

abc (abc)

abc

Default value:123
lower_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the hysteresis. For example, at 95%, the dip event will trigger off once above 218.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:95
lower_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Lower limit of the threshold. For example, at 90%, a dip event will trigger on below 207V on a 230V reference.

Unit:

Percent (%)

abc

Default value:90
reference
number
[ 0 .. 100000000 ]decimal places <= 3
The reference voltage for determining dips and swells. Typically the nominal grid voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

upper_hysteresis
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the hysteresis. For example, at 105%, the swell event will trigger off once below 241.5V on a 230V reference.

Unit:

Percent (%)

abc

Default value:105
upper_threshold
number
[ 0 .. 1000 ]decimal places <= 1
Upper limit of the threshold. For example, at 110%, a swell event will trigger on above 253V on a 230V reference.

Unit:

Percent (%)

abc

Default value:110
Additional properties are NOT allowed.
Additional properties are NOT allowed.
rms
number
[ 0 .. 100000000 ]decimal places <= 3
Voltage RMS (Root Mean Square), the square root of the arithmetic mean of the squared values of a periodic waveform. It represents the effective value of voltage in an AC system.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

array<object>
Representation of voltage RMS in the frequency domain, showing distribution across various frequency components.

object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
THD-V (Total Harmonic Distortion in Voltage) measures how much voltage waveform deviates from a pure sine wave. High levels usually originate from supply distortions or nonlinear loads. Can affect sensitive devices.

fundamental
number
[ 0 .. 10000 ]decimal places <= 3
THD-V based on fundamental frequency (typically 50 or 60Hz). Focuses on distortion from base AC frequency. Useful for filtering decisions.

Unit:

Percent (%)

abc

rms
number
[ 0 .. 100 ]decimal places <= 3
THD-V based on RMS. Indicates quality of voltage. High values can affect sensitive equipment.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
waveform_peak
number
[ 0 .. 100000000 ]decimal places <= 3
Maximum value of the voltage within individual cycles during a 1-second timeframe. In a 230V AC line, the nominal peak voltage may reach 325 V.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
unbalance_factor
number
[ 0 .. 100 ]decimal places <= 3
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to mechanical systems.

object
object
object oneOf
abc

object
depth
number
[ 0 .. 100000000 ]decimal places <= 6
abc

Default value:0
Additional properties are NOT allowed.
object
string oneOf
abc

Adheres to:
string
abc

Const:"low"
Or to:
string
abc

Const:"high"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
object oneOf
abc

object
depth
number
[ 0 .. 100000000 ]decimal places <= 6
abc

Default value:0
Additional properties are NOT allowed.
object
string oneOf
abc

Adheres to:
string
abc

Const:"low"
Or to:
string
abc

Const:"high"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
object oneOf
abc

object
depth
number
[ 0 .. 100000000 ]decimal places <= 6
abc

Default value:0
Additional properties are NOT allowed.
object
string oneOf
abc

Adheres to:
string
abc

Const:"low"
Or to:
string
abc

Const:"high"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
object oneOf
abc

object
depth
number
[ 0 .. 100000000 ]decimal places <= 6
abc

Default value:0
Additional properties are NOT allowed.
object
string oneOf
abc

Adheres to:
string
abc

Const:"low"
Or to:
string
abc

Const:"high"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

apn
string
<= 100 characters
The APN (Access Point Name) is a setting that identifies a cellular data network the node can connect to. It provides the necessary information to connect to the internet and defines the type of service it can access. Cellular providers specify the APN settings for their networks, ensuring users can send and receive data correctly.

iccid
string
must match: /^[0-9]{18,22}$/
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

object
The IMSI (International Mobile Subscriber Identity) is a unique number associated with every user of a cellular network. It's stored in the SIM card and used to identify the subscriber to the network for services like calls and SMS. Typically 15 digits long, the IMSI is a combination of MCC (mobile country code), MNC (mobile network code), and MSIN (mobile subscriber identification number).

mcc
string
must match: /^[0-9]{3}$/
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

mnc
string
must match: /^[0-9]{2,3}$/
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

msin
string
must match: /^[0-9]{10}$/
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

Additional properties are NOT allowed.
string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
pin
string
must match: /^[0-9]{4}$/
The PIN (Personal Identification Number) for a SIM card is a security code, typically 4 to 8 digits long, that protects the card from unauthorized access. When enabled, users must enter the PIN to use the SIM for accessing cellular data. If entered incorrectly multiple times, the SIM locks, requiring a PUK (Personal Unblocking Key) to unlock.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rsrp
number
[ -128 .. 0 ]multiple of 1
RSRP (Reference Signal Received Power) gauges the power level of specific LTE reference signals in dBm. Closer to -80 dBm signifies a strong signal, while figures around -100 dBm indicate weak ones. RSRP helps determine LTE cell coverage and connection robustness.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

rsrq
number
[ -32 .. 0 ]multiple of 1
RSRQ (Reference Signal Received Quality) evaluates the quality of LTE reference signals by comparing the received power of a reference signal to the total received power. A value closer to -10 dB suggests superior signal quality, while values nearing -20 dB indicate poorer quality. RSRQ helps understand the LTE signal's relative quality in the context of surrounding interference.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

sinr
number
[ -32 .. 32 ]multiple of 1
SINR (Signal-to-Interference-plus-Noise Ratio) contrasts the power of a desired signal against the combined power of interference and noise, represented in dB. Higher values, like 20 dB, suggest a better signal quality, whereas values close to 0 dB suggest a compromised signal due to interference. SINR helps gauge LTE connection clarity.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to thermal systems.

object
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object [Properties]
abc

object
Parameters for identification, information and configuration of hardware devices.

object
Details related to a cellular module - a hardware component that connects devices to cellular networks for wireless data transmission using standards like 4G (LTE) and 5G.

fw_version
string
The firmware version of a cellular module represents its embedded software state, dictating functionalities and network compatibility. Updates can introduce new features or fixes. Identifying the version aids in troubleshooting.

imei
string
must match: /^[0-9]{15,17}$/
The IMEI (International Mobile Equipment Identity) is a unique 15-digit number assigned to mobile devices, such as smartphones and tablets. It serves as an identifier for the device and can be used by cellular networks to authenticate the device and permit or deny its access to the network. IMEI is essential for tracking and blacklisting stolen devices, ensuring they cannot be used on any network, even if the SIM card is replaced.

model
string
[ 1 .. 24 ] characters
The model of a cellular module refers to its distinct version in terms of features, capabilities, and cellular compatibility.

serial
string
[ 1 .. 24 ] characters
A serial number is a unique identifier assigned by the manufacturer to a cellular module. It helps in tracking, service support, and verifying authenticity.

Additional properties are NOT allowed.
object
Hardware related parameters for a Linc node.

object
Settings and parameters that define how a Linc node communicates and transfers data, including factors like the frequency of transmissions, storage preferences, platform access and more.

string oneOf
Choice of data handling strategy for a Linc node, influencing both how the data is processed and the associated costs.

Default value:"platform"
Adheres to:
string
All collected data is stored, analysed, and visualised on the Linc platform, with full programmatic access through API and MQTT.

Const:"platform"
Or to:
string
Data access only via API or MQTT channels for third-party storage and processing.

Const:"relay"
Or to:
string
On-premise data handling via the local network. The node has no connection to the Linc server.

Const:"local"
integer oneOf
The frequency at which a Linc node sends data, determining how often updates or readings are provided.

Unit:

Second (s)

Duration of reporting interval measured in seconds.

Default value:1
Adheres to:
number
Data is reported to server at 1 second intervals.

Const:1
Or to:
number
Data is reported to server at 1 minute intervals.

Const:60
Additional properties are NOT allowed.
fw_version
string
The software revision number associated with a Linc node, reflecting updates, enhancements, or fixes.

hw_version
string
The version number corresponding to physical components and design of a Linc node. This helps in identifying different production runs or hardware iterations.

label
string
[ 1 .. 32 ] characters
User-specified name or identifier for a Linc node, allowing for easy differentiation within a system or network.

string oneOf
Type and variant of a Linc node, indicating its capabilities and features.

Adheres to:
string
P1 Electrical Node

Const:"gen0_p1"
Or to:
string
Linc Electrical Node

Const:"gen1"
Or to:
string
Linc Electrical Node

Const:"gen0_8ch"
Or to:
string
Linc Environmental Node

Const:"gen0_4ch"
Or to:
string
Linc w-MBus Node

Const:"wmbus"
Or to:
string
Linc LoRa Node

Const:"lora"
Or to:
string
Linc Cellular Node

Const:"cellular"
Or to:
string
Linc Modbus Node

Const:"modbus"
Additional properties are NOT allowed.
object
Details related to device that employs LoRa (Long Range) technology, enabling long-distance data transmission with low power consumption, typically used in Internet of Things (IoT) networks and remote sensors.

dev_eui
string
must match: /^(?:[0-9A-Fa-f]{2}([-:]))(?:[0-9A-Fa-f]{2}\1){6}[0-9A-Fa-f]{2}$/
A globally unique identifier for the end-device. It's essentially the MAC address of the device and ensures that each LoRaWAN device in the world has a unique identifier. Typically represented as 16 hexadecimal characters.

Additional properties are NOT allowed.
object
Details related to a device that adheres to the Modbus protocol, a standard serial communication method widely used for connecting industrial electronic devices, facilitating data exchange between controllers and sensors or actuators in automation systems.

fw_version
string
[ 1 .. 24 ] characters
The software revision number associated with a Modbus device, reflecting updates, enhancements, or fixes. This version helps in tracking compatibility, performance improvements, or bug fixes in the device's software.

model
string
[ 1 .. 32 ] characters
The specific make or variant of a Modbus-compatible device, indicating its design, capabilities, and features.

Additional properties are NOT allowed.
object
Detailes related to the Wi-Fi module - a hardware component that allows devices to connect to Wi-Fi networks for wireless data communication using standards like 802.11b/g/n.

mac_address
string
A MAC (Media Access Control) address is a unique identifier assigned to network interfaces for communications on a physical network segment. Typically consisting of six pairs of hexadecimal numbers, it's used to ensure devices on a local network can communicate with one another effectively. Unlike IP addresses which can change based on network settings, a device's MAC address is usually fixed and manufacturer-assigned.

Additional properties are NOT allowed.
object
Details related to a wM-Bus device that is compliant with the wireless Meter-Bus protocol (EN 13757-4), designed primarily for remote reading of utility meters in smart metering solutions.

device_type
string
must match: /^[0-9A-Fa-f]{1,2}$/
Specifies the kind of meter (e.g., water, gas, electricity) and can influence how the data is interpreted.

id_number
string
must match: /^[0-9A-Fa-f]{2,8}$/
A unique 4-byte (8-character) hexadecimal number assigned to each wM-Bus device, ensuring distinct identification within a wireless network.

manufacturer
string
must match: /^[0-9A-Z]{3}$/
A code that specifies the company that made the meter. This often helps in interpreting proprietary data or understanding specific device behaviours.

model
string
[ 1 .. 24 ] characters
Represents the specific model identifier of the wM-Bus device. Typically an alphanumeric string specified by the manufacturer to denote a product variant.

version
string
must match: /^[0-9A-Fa-f]{1,2}$/
Indicates the version of the device or the software it's running, useful for ensuring compatibility and correct data interpretation.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to electrical systems.

object
AC (Alternating Current), common in power grids, facilitate the long-distance transmission of electricity and is the standard for household and commercial electrical outlets.

object
An electrical circuit in an AC system provides a path for the flow of electric current. Each circuit is associated to a voltage phase (L1, L2, L3) or to Neutral (N).

Additional properties are NOT allowed.
object
abc

object
acb

string oneOf
Adheres to:
string
abc

Const:"line_1"
Or to:
string
abc

Const:"line_2"
Or to:
string
abc

Const:"line_3"
string oneOf
Adheres to:
string
abc

Const:"none"
Or to:
string
abc

Const:"fault"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

instantaneous
number
[ 0 .. 100 ]decimal places <= 3
The number of cycles per second in an alternating current (AC) system, measured in Hertz (Hz).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

object
The standard frequency range within which the electrical grid is designed to operate, typically around 50 Hz or 60 Hz.

maximum
number
[ 0 .. 100 ]decimal places <= 3
Rated maximum grid frequency. For example, 50.5 Hz rated maximum for a 50 Hz system.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

minimum
number
[ 0 .. 100 ]decimal places <= 3
Rated minimum grid frequency. For example, 49.5 Hz rated minimum for a 50 Hz system.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

nominal
number
[ 0 .. 100 ]decimal places <= 3
Nominal grid frequency. 50 Hz in most of Europe, Asia, Africa, Australia, and parts of South America. 60 Hz in North America, parts of South America, Japan, South Korea, the Philippines, and a few other territories.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
object
Transient values in grid frequency at 200ms intervals correspond to 10 cycles in a 50 Hz system and 12 cycles in a 60 Hz system. These brief deviations are vital for electrical grid stability.

min
number
[ 0 .. 100 ]decimal places <= 3
The highest transient value within a 1-second timeframe.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

std_dev
number
[ 0 .. 100 ]decimal places <= 3
The measure of dispersion in transient values within a 1-second timeframe, indicating how much they deviate from the mean.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Voltage in an AC system is the electric potential difference between two points in the circuit. It oscillates between positive and negative values and can be measured as line-to-line (L-L) or line-to-neutral (L-N).

object
<= 3 properties
A voltage phase refers to one of the three AC voltage waveforms (L1, L2, L3) generated 120 degrees apart. All phase parameters are measured relative to neutral (L-N).

Additional properties are NOT allowed.
object
The rated nominal voltage range expressed in root mean square (RMS) terms. It represents the voltage range that the system is designed to operate within under normal conditions.

maximum
number
[ 0 .. 100000000 ]decimal places <= 3
abc

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

minimum
number
[ 0 .. 100000000 ]decimal places <= 3
abc

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

nominal
number
[ 0 .. 100000000 ]decimal places <= 3
Rated nominal voltage.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

Additional properties are NOT allowed.
unbalance_factor
number
[ 0 .. 100 ]decimal places <= 3
Voltage Unbalance Factor (VUF) in a three-phase system quantifies the deviation among the RMS values of the three phases. It is calculated as the ratio of the maximum deviation from the average voltage to the average voltage itself, expressed as a percentage. Higher VUF values indicate a greater imbalance in the system.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to environmental systems.

object
object
co2
number
[ 0 .. 50000 ]decimal places <= 3
Carbon dioxide is the fourth most abundant gas in the earth's atmosphere. At room temperature, carbon dioxide (CO2) is a colorless, odorless, non-flammable gas.

Unit:

Parts per million (ppm)

abc

nox
number
[ 1 .. 500 ]decimal places <= 3
The NOx Index describes the current NOx condition relative to the past 24 hours.

Unit:

NOx Index (undefined)

abc

voc
number
[ 1 .. 500 ]decimal places <= 3
The VOC Index describes the current VOC condition relative to the past 24 hours.

Unit:

VOC Index (undefined)

abc

Additional properties are NOT allowed.
humidity
number
[ 0 .. 100 ]decimal places <= 1
abc

Unit:

Percent (%)

abc

object
coarse
number
[ 0 .. 1000 ]decimal places <= 3
These are typically from natural sources like dust, pollen, and mould spores, and human activities like construction, mining, and agriculture. They can cause respiratory irritation and exacerbate allergies.

Unit:

Microgram per Cubic Meter (μg/m³)

Unit of airborne particle concentration. Measures mass of particles in a cubic meter of air. Used in air quality assessment.

fine
number
[ 0 .. 1000 ]decimal places <= 3
These particles, smaller than typical dust or pollen, can easily be inhaled, affecting the respiratory and cardiovascular systems. Sources include combustion processes, such as motor vehicle emissions, power plants, and residential heating, as well as some industrial processes.

Unit:

Microgram per Cubic Meter (μg/m³)

Unit of airborne particle concentration. Measures mass of particles in a cubic meter of air. Used in air quality assessment.

medium
number
[ 0 .. 1000 ]decimal places <= 3
Common sources are natural, like dust and pollen, but they can also come from construction sites and agricultural activities. They pose inhalation risks, particularly for those with respiratory conditions.

Unit:

Microgram per Cubic Meter (μg/m³)

Unit of airborne particle concentration. Measures mass of particles in a cubic meter of air. Used in air quality assessment.

ultrafine
number
[ 0 .. 1000 ]decimal places <= 3
These are the smallest airborne particles, capable of deep lung penetration and bloodstream absorption, posing significant health risks. These originate from combustion processes, industrial emissions, and vehicle exhausts.

Unit:

Microgram per Cubic Meter (μg/m³)

Unit of airborne particle concentration. Measures mass of particles in a cubic meter of air. Used in air quality assessment.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to mechanical systems.

object
General term for movement rate of substance through a system. Unit varies by context.

mass
number
[ -10000000 .. 10000000 ]decimal places <= 6
Description: Rate at which mass moves through a system, critical in process engineering.

Unit:

Gram Per Second (g/s)

Suitable for lab experiments or specialized industrial processes where small mass flow rates are crucial.

volumetric
number
[ -10000000 .. 10000000 ]decimal places <= 6
Rate at which fluid volume moves through a system.

Unit:

Cubic Metre per Second (m³/s)

Measures large-scale fluid flow, such as in ducts and pipelines. Standard in engineering and hydrology.

Additional properties are NOT allowed.
force
number
[ -10000000 .. 10000000 ]decimal places <= 3
The push or pull applied on an object, crucial in motion and structural integrity assessments.

Unit:

Newton (N)

Standard metric unit for measuring force, essential in physics and engineering. One Newton is the force needed to accelerate a one-kilogram mass by one metre per second squared.

object oneOf
abc

object
depth
number
[ 0 .. 100000000 ]decimal places <= 6
abc

Default value:0
Additional properties are NOT allowed.
object
string oneOf
abc

Adheres to:
string
abc

Const:"low"
Or to:
string
abc

Const:"high"
Additional properties are NOT allowed.
Additional properties are NOT allowed.
mass
number
[ 0 .. 1000000000 ]decimal places <= 6
Represents how much matter is in an object, fundamental in mechanical calculations.

Unit:

Kilogram (kg)

Basic unit of mass in the metric system.

pressure
number
[ -10000000 .. 10000000 ]decimal places <= 6
Force exerted per unit area, key in understanding fluid behaviour, mechanical equilibrium, and material strength.

Unit:

Pascal (Pa)

Metric unit for pressure. Used in scientific research and fluid mechanics.

quantity
number
[ 0 .. 1000000000000 ]decimal places <= 3
Specifies the number countable items or amount of a substance.

Unit:

Quantity (undefined)

abc

array<object>
Periodic oscillation of an object around an equilibrium point, important in machinery health monitoring and structural engineering.

object
string oneOf
Adheres to:
string
Horizontal axis, typically aligns with the length of the machine or structure.

Const:"x"
Or to:
string
Vertical axis, often perpendicular to the X-axis and aligns with the height.

Const:"y"
Or to:
string
Perpendicular to both X and Y, usually representing the depth or breadth.

Const:"z"
rms
number
[ 0 .. 100000000 ]decimal places <= 6
Vibration RMS (Root Mean Square) along a given axis quantifies the effective magnitude of vibrations in that direction. It's useful for assessing overall vibration levels and comparing system health.

Unit:

Meter (m)

The fundamental unit of length in the International System of Units (SI).

Default value:0
array<object>
object
centroid
number
[ 0 .. 1000000 ]decimal places <= 3
Central value for a given frequency component range. For instance, a value of 100000 mHz implies a frequency component centered at 100Hz.

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

magnitude
number
[ 0 .. 100000000 ]decimal places <= 3
Magnitude of RMS allocated to a specific frequency component.

Unit:

Volt (line-to-neutral) (V_{LN})

Volt (V) is a unit of electric potential difference between two points in an AC circuit.

range
number
[ 0 .. 100 ]decimal places <= 3
The frequency component defined by a range value equally above and below the centroid. For instance, a value of 5 Hz would imply a 95 to 105 Hz frequency component (around a 100 Hz centroid).

Unit:

Hertz (Hz)

Hertz (Hz) measures the frequency of oscillationin the electrical grid, indicating the number of cycles per second. In standard systems, common frequencies are 50 Hz or 60 Hz.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to connectivity and network protocols.

object
Parameters related to cellular network connectiviity.

object
Parameters related to the status and configuration of a network connection.

apn
string
<= 100 characters
The APN (Access Point Name) is a setting that identifies a cellular data network the node can connect to. It provides the necessary information to connect to the internet and defines the type of service it can access. Cellular providers specify the APN settings for their networks, ensuring users can send and receive data correctly.

iccid
string
must match: /^[0-9]{18,22}$/
The ICCID (Integrated Circuit Card Identifier) is a unique serial number assigned to each SIM card used in mobile devices. Typically 19 to 20 digits long, it's used to identify the SIM internationally, helping operators and service providers manage their subscribers. The ICCID provides information about the card's origin, network, and other specific details.

object
The IMSI (International Mobile Subscriber Identity) is a unique number associated with every user of a cellular network. It's stored in the SIM card and used to identify the subscriber to the network for services like calls and SMS. Typically 15 digits long, the IMSI is a combination of MCC (mobile country code), MNC (mobile network code), and MSIN (mobile subscriber identification number).

mcc
string
must match: /^[0-9]{3}$/
The MCC (Mobile Country Code) is a three-digit number used to identify a mobile device's country of origin or the country of the cellular network it's operating in. It's a component of the IMSI (International Mobile Subscriber Identity) and is essential for international roaming, ensuring the device can connect to networks outside its home country.

mnc
string
must match: /^[0-9]{2,3}$/
The MNC (Mobile Network Code) is a two or three-digit number used in conjunction with the Mobile Country Code (MCC) to identify a specific mobile network operator within a country. Together, the MCC and MNC form a unique identifier for cellular networks, allowing devices to connect to the correct local network and ensuring proper routing of communications, especially in international roaming scenarios.

msin
string
must match: /^[0-9]{10}$/
The MSIN (Mobile Subscription Identification Number) is a unique number typically consisting of 9 to 10 digits, representing an individual subscriber in a mobile network. It's the last part of the IMSI (International Mobile Subscriber Identity) and, when combined with the MCC (Mobile Country Code) and MNC (Mobile Network Code), creates a unique identifier for each mobile user globally. MSIN ensures individual subscribers are distinguished within a specific network operator's service.

Additional properties are NOT allowed.
string oneOf
Cellular modes like Cat M1, Cat NB2 refer to different categories of 4G (LTE) and 5G technologies.

Adheres to:
string
LTE-M, also known as Cat-M1, is a low-power wide-area (LPWA) technology tailored for IoT applications. Offering data rates up to 1.12 Mbps uplink and 589 kbps downlink, it ensures reliable connectivity, especially in challenging environments like deep inside buildings.

Const:"cat_m1"
Or to:
string
NB2, an evolution of NB-IoT, is a low-power wide-area (LPWA) technology designed specifically for IoT devices. With data rates around 150 kbps uplink and 136 kbps uplink, it's optimized for minimal bandwidth applications and offers excellent penetration for connectivity in challenging locations, such as deep within buildings.

Const:"cat_nb2"
pin
string
must match: /^[0-9]{4}$/
The PIN (Personal Identification Number) for a SIM card is a security code, typically 4 to 8 digits long, that protects the card from unauthorized access. When enabled, users must enter the PIN to use the SIM for accessing cellular data. If entered incorrectly multiple times, the SIM locks, requiring a PUK (Personal Unblocking Key) to unlock.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rsrp
number
[ -128 .. 0 ]multiple of 1
RSRP (Reference Signal Received Power) gauges the power level of specific LTE reference signals in dBm. Closer to -80 dBm signifies a strong signal, while figures around -100 dBm indicate weak ones. RSRP helps determine LTE cell coverage and connection robustness.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

rsrq
number
[ -32 .. 0 ]multiple of 1
RSRQ (Reference Signal Received Quality) evaluates the quality of LTE reference signals by comparing the received power of a reference signal to the total received power. A value closer to -10 dB suggests superior signal quality, while values nearing -20 dB indicate poorer quality. RSRQ helps understand the LTE signal's relative quality in the context of surrounding interference.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

sinr
number
[ -32 .. 32 ]multiple of 1
SINR (Signal-to-Interference-plus-Noise Ratio) contrasts the power of a desired signal against the combined power of interference and noise, represented in dB. Higher values, like 20 dB, suggest a better signal quality, whereas values close to 0 dB suggest a compromised signal due to interference. SINR helps gauge LTE connection clarity.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to the status and stability of device connectivity to server.

string oneOf
The connection status shows whether or not a device is currently online.

Adheres to:
string
Device is connected to server.

Const:"online"
Or to:
string
Device is disconnected from server.

Const:"offline"
object
The proportion of time that a network device has been connected to server in a given timeframe.

average_6h
number
[ 0 .. 100 ]decimal places <= 1
Moving average of the device uptime in the past 6 hours.

Unit:

Percent (%)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
The Linc Mesh provides internet access throughout a building by relaying data through Linc nodes. It uses the 2.4 GHz frequency for Wi-Fi-like range and speed. It self-routes data across nodes, reducing reliance on central access points and making the connection more resilient.

object
Parameters related to the status and configuration of a network connection.

hop_count
number
[ 1 .. 24 ]multiple of 1
Hop count in a mesh network refers to the number of intermediate nodes that data must pass through between its originating node and the root node with internet access. It serves as a metric to determine the path's length and potential latency. As the hop count increases, it can impact the overall bandwidth availability and network efficiency due to increased chances of congestion and interference.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
parent_node
string
must match: /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{1}[0123456789ABCDEFGHJKLMNPQRSTUVWXYZ]{3,5}$/
Parent node in a mesh network refers to an immediate upstream node to which another node (typically referred to as the child node) is directly connected. The parent node helps the child node with tasks like routing data, establishing connectivity, or maintaining the network hierarchy within the mesh topology.

string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
LoRa (Long Range) is a low-power wide-area (LPWA) modulation technology optimized for long-distance communication with minimal power consumption. Designed for IoT applications, LoRa operates at different regional frequencies, including 868 MHz in Europe, 915 MHz in North America, and 433 MHz in parts of Asia. With extended coverage even in challenging environments and modest data rates, it's ideal for applications like remote sensing, metering and asset tracking.

object
Parameters related to the status and configuration of a network connection.

app_eui
string
must match: /^(?:[0-9A-Fa-f]{2}([-:]))(?:[0-9A-Fa-f]{2}\1){6}[0-9A-Fa-f]{2}$/
A globally unique identifier for the application. It helps in identifying which application on the network server the device wants to join. Typically represented as 16 hexadecimal characters.

dev_addr
string
must match: /^(?:[0-9A-Fa-f]{2}([-:]))(?:[0-9A-Fa-f]{2}\1){2}[0-9A-Fa-f]{2}$/
A network-specific address assigned to the device after it joins the network. It's a shorter form of addressing the device in the network and is not globally unique. Typically represented as 8 hexadecimal characters.

Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -256 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

snr
number
[ -64 .. 64 ]multiple of 1
SNR quantifies the clarity of a signal against the background noise, expressed in decibels (dB). In LoRaWAN networks, a higher SNR indicates a clearer signal, allowing for reliable data transmission. Given LoRa's resilience, it can operate effectively even at negative SNRs, but a better SNR typically means fewer transmission errors and retransmissions.

Unit:

Decibel (dB)

Signal quality and clarity in a wireless network quantified in dB (decibels) on a logarithmic scale.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Modbus is a communication protocol for transmitting information between electronic devices. It operates in TCP mode for networked connections using Ethernet, and in RTU mode for serial communication over RS-485 or RS-232. Widely used in industrial settings, Modbus enables interaction among various devices like sensors, controllers, and actuators.

object
Parameters related to the status and configuration of a network connection.

device_id
integer
[ 1 .. 247 ]
A unique identifier for a Modbus device within a network, typically between 1 and 247.

object
Serial communication parameters related to an RTU Modbus connection.

baud_rate
integer
multiple of 8
The data transmission speed for Modbus RTU, in bits per second.

string oneOf
Error-checking mechanism in Modbus RTU, set as even, odd, or none.

Adheres to:
string
Parity check: even

Const:"even"
Or to:
string
Parity check: odd

Const:"odd"
Or to:
string
Parity check: none

Const:"none"
stop_bits
number
[ 1 .. 4 ]multiple of 1
Signals the end of data in Modbus RTU, usually 1 or 2.

Additional properties are NOT allowed.
object
Parameters related to TCP Modbus connection.

string anyOf
An identifier for a Modbus TCP device on a network.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
port_number
integer
[ 1 .. 65535 ]
Port on which the Modbus device is communicating, typically 502.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Wi-Fi is a wireless technology that allows devices to connect to the internet or local networks using radio waves, typically in the 2.4 GHz and 5 GHz bands, without physical cables. It's facilitated by wireless routers that broadcast internet connections to devices like computers, smartphones, and tablets.

object
Parameters related to the status and configuration of a network connection.

string anyOf
An IP (Internet Protocol) address is a unique numerical label assigned to devices for identification and location on a network, ensuring they can communicate with each other. It acts as a digital address, allowing data to be directed and received by the correct device on both local networks and the internet.

Can adhere to:
any
format: ipv4
Or to:
any
format: ipv6
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Wireless M-Bus (Wireless Meter-Bus) is a standard (EN 13757-4) primarily adopted in Europe for wireless meter reading in utility sectors. Designed for communication with gas, water, and electricity meters, it operates in various frequency bands: 868 MHz in Europe, 169 MHz for specific regions in Europe, and other frequencies such as 433 MHz and 915 MHz in different parts of the world. With modest data rates suited for periodic meter readings, it ensures reliable data transmission even in challenging environments, such as basements or utility pits.

object
Parameters related to the status and configuration of a network connection.

string oneOf
wM-Bus modes define specific communication patterns:

Mode S (Stationary mode) provides a data rate of 16.384 bit/s at a greater communication distance than Mode T. Optimized for low power. Intended for meters that are read out less frequently. Primarily initiated by reader.

Mode T (Transmit frequently) provides a data rate of 66.667 bit/s. This is approximately four times higher than Mode S and for a given battery size allows more frequent transmissions without decreasing battery lifetime or increasing collision rate.

Mode C (data rate 50.000 resp. 100.000 bit/s) combines the advantages of Mode S and Mode T. It has a more compact data format and therefore allows transmission of more data within the same energy budget and with the same duty cycle.

Adheres to:
string
One-way communication for static meters, standard data transmission.

Const:"s1"
Or to:
string
Two-way communication for static meters.

Const:"s2"
Or to:
string
One-way communication for frequent data transmission, often used for heat meters.

Const:"t1"
Or to:
string
Two-way communication for frequent data transmission.

Const:"t2"
Or to:
string
Compact mode, one-way communication, designed for low-cost meters.

Const:"c1"
string oneOf
The connection status refers to whether or not a connection is enabled.

Adheres to:
string
Network is enabled.

Const:"enabled"
Or to:
string
Network is disabled.

Const:"disabled"
Additional properties are NOT allowed.
object
Parameters related to the strength and quality of a network signal.

rssi
number
[ -128 .. 0 ]multiple of 1
RSSI (Relative Signal Strength Indicator) measures the power level of received signals in dBm. A value closer to 0, like -60 dBm, indicates a strong received signal, while a lower value, like -90 dBm, indicates a weaker one. Each 3 dBm increase indicates an approximate doubling in power. RSSI helps assess wireless network coverage and connection quality.

Unit:

Decibel-milliwatt (dBm)

dBm denotes signal strength, measured in decibels relative to one milliwatt.

Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Spatial parameters to define the location and dimentions of physical structures.

object
abc

area
number
[ 0 .. 10000000000000 ]decimal places <= 6
Extent of a surface such as a floor, wall, or plot within a built environment.

Unit:

Square meter (m²)

Standard unit of area in the metric system. Used globally for scientific, educational, and everyday measurements.

Default value:0
distance
number
[ 0 .. 100000000 ]decimal places <= 6
Length between features or points.

Unit:

Meter (m)

The fundamental unit of length in the International System of Units (SI).

Default value:0
volume
number
[ 0 .. 10000000000000 ]decimal places <= 6
[object Object]

Unit:

Cubic meter (m³)

Standard unit for measuring volume in construction and engineering, often used for large building spaces and material quantities.

Default value:0
Additional properties are NOT allowed.
object
abc

azimuth
number
[ 0 .. 360 ]decimal places <= 3
Horizontal angle from true north. Measured in degrees, increasing clockwise from north to east.

Unit:

Degree (°)

Degree (°) is the unit for measuring orientation.

tilt
number
[ -90 .. 90 ]decimal places <= 3
Inclination angle from horizontal plane. Positive for upward tilt, negative for downward.

Unit:

Degree (°)

Degree (°) is the unit for measuring orientation.

Additional properties are NOT allowed.
object
The exact place where something is situated in relation to its environment.

object
abc

city
string
[ 1 .. 32 ] characters
country
string
2 characters
postal_code
string
[ 1 .. 16 ] characters
state
string
[ 1 .. 3 ] characters
street_name
string
[ 1 .. 32 ] characters
street_number
string
[ 1 .. 32 ] characters
subdivision
string
[ 1 .. 32 ] characters
unit_number
string
[ 1 .. 32 ] characters
Additional properties are NOT allowed.
object
X, Y, Z values pinning an object's location within a room or system.

x
number
[ -123 .. 123 ]multiple of 123
Horizontal coordinate. Left-right axis.

Unit:

Meter (m)

The fundamental unit of length in the International System of Units (SI).

Default value:0
y
number
[ -123 .. 123 ]multiple of 123
Vertical coordinate. Up-down axis.

Unit:

Meter (m)

The fundamental unit of length in the International System of Units (SI).

Default value:0
z
number
[ -123 .. 123 ]multiple of 123
Depth coordinate. Front-back axis.

Unit:

Meter (m)

The fundamental unit of length in the International System of Units (SI).

Default value:0
Additional properties are NOT allowed.
object
Latitude and longitude marking a spot on Earth's surface (as per WGS84 datum), plus elevation to indicate height above sea level.

elevation
number
[ -100000 .. 100000 ]decimal places <= 3
Height relative to sea level.

Unit:

Meter (m)

The fundamental unit of length in the International System of Units (SI).

Default value:0
latitude
number
[ -90 .. 90 ]decimal places <= 6
Angular distance north or south of the equator, measured in degrees (°). Positive values indicate northern hemisphere; negative values indicate southern hemisphere.

Unit:

Degree (°)

Degree (°) is the unit for measuring latitude and longitude.

Default value:0
longitude
number
[ -180 .. 180 ]decimal places <= 6
Angular distance east or west of the Prime Meridian, measured in degrees (°). Positive values indicate east; negative values indicate west.

Unit:

Degree (°)

Degree (°) is the unit for measuring latitude and longitude.

Default value:0
Additional properties are NOT allowed.
Additional properties are NOT allowed.
Additional properties are NOT allowed.
object
Parameters related to thermal systems.

energy
number
[ 0 .. 1000000000000000 ]decimal places <= 3
Defines the amount of thermal energy transferred between different systems.

Unit:

Watt-hour (Wh)

Watt-hour (Wh) units measure energy doing useful work.

flow
number
[ -10000000 .. 10000000 ]decimal places <= 6
Heat flow is the rate of heat energy transfer between systems.

Unit:

Watt (W)

Watt (W) is the unit of power used to quantify the rate of energy transfer.

flow_density
number
[ -40000000 .. 40000000 ]decimal places <= 6
Heat flow density describes the rate at which heat energy is transferred across a specific surface area. It is often used in thermal engineering and climate studies to understand how heat moves through materials or across boundaries.

Unit:

Watt per Square Meter (W/m²)

Measures heat flow rate per unit area.

specific_capacity
number
[ 0 .. 10000 ]decimal places <= 6
Specific capacity, or specific heat capacity, describes how much energy is needed to raise the temperature of a unit mass of a material by one degree Kelvin. It is crucial for understanding how substances absorb and release energy.

Unit:

Joule per Kilogram Kelvin (J/kg⋅K)

Indicates energy needed to change temperature of a kilogram of material by one Kelvin.

temperature
number
[ -274 .. 5000 ]decimal places <= 3
Numeric values representing heat level. Measured in specified units like Celsius, Fahrenheit, or Kelvin.

Unit:

Celsius (°C)

Celsius, also known as centigrade, is a scale and unit of measurement for temperature.

Additional properties are NOT allowed.
object
Temporal parameters to specify the moment or duration of an event.

object
abc

Unit:

Second (s)

abc

Additional properties are NOT allowed.
object
abc

day_of_month
string
must match: /^(((?:[1-9]|[12][0-9]|3[01]))(-(?:[1-9]|[12][0-9]|3[01]))?(,|$))+$/[ 0 .. 32 ] characters
day_of_week
string
must match: /^((mo|tu|we|th|fr|sa|su)(-(mo|tu|we|th|fr|sa|su))?(,|$))+$/[ 0 .. 32 ] characters
month
string
must match: /^((1(?:[0-2])|[1-9])(-1(?:[0-2])|-[1-9])?(,|$))+$/[ 0 .. 32 ] characters
time_of_day
string
[ 0 .. 128 ] characters
week
string
must match: /^(((?:[1-9]|[1-4][0-9]|5[0-6]))(-(?:[1-9]|[1-4][0-9]|5[0-6]))?(,|$))+$/[ 0 .. 32 ] characters
year
string
must match: /^(((19(?:7[0-9]|[8-9][0-9])|2[0-9][0-9][0-9]|[3-9][0-9][0-9][0-9]))((-19(?:7[0-9]|[8-9][0-9])|-2[0-9][0-9][0-9]|[3-9][0-9][0-9][0-9]))?(,|$))+$/[ 0 .. 32 ] characters
Additional properties are NOT allowed.
timestamp
number
[ 0 .. 10000000000 ]decimal places <= 6
abc... unix

Unit:

Second (s)

abc

Additional properties are NOT allowed.
Additional properties are NOT allowed.

Linc 1.0.0

Servers

Operations

PUB /{organisation_id}/nodes/{node_id}/device/config

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/device/data

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/device/linc/dataplan/mode

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/device/linc/dataplan/reporting_interval

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/device/linc/fw_version

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/device/linc/label

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/config/label

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/config/phase

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/config/polarity

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/config/sensor

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/crest_factor

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/demand_distortion/full_load_current

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/demand_distortion/tdd

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/rms

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/spectrum

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/thd/fundamental

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/thd/rms

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/current/waveform_peak

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/active/exported

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/active/imported

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/active/net

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/apparent/exported

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/apparent/imported

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/apparent/net

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/reactive/exported

Examples

This example has been generated automatically.

PUB /{organisation_id}/nodes/{node_id}/electrical/ac/circuits/1/energy/reactive/imported

Examples