Skip to content

Measurement Additions

The Cumulocity Python SDK's measurements API (see also classes Measurements and Measurement) includes the following additions to allow easy creation of standard measurement values including units.

Effectively, each of the value classes represent a value fragment, e.g. Celsius:

{"unit": "°C", "value": 22.8}

These values can easily be combined, e.g. when constructing a measurement:

m = Measurement(
    type='cx_LevelMeasurement', source=device_id, time='now',
    cx_Levels={
        'oil': Liters(8.4),
        'gas': Liters(223.18),
        'h2o': Liters(1.2),
        'bat': Percentage(85)
    })

Units

Predefined, common units.

Celsius

Temperature datapoint (Celsius).

Centimeters

Length datapoint (Centimeters).

Count

Discrete number datapoint (number/count).

CubicMeters

Volume datapoint (Cubic Meters).

Grams

Weight datapoint (Grams).

Kelvin

Temperature datapoint (Kelvin).

Kilograms

Weight datapoint (Kilograms).

Liters

Volume datapoint (Liters).

Meters

Length datapoint (Meters).

Percent

Percent value datapoint.

Value

Generic datapoint.

__init__(value: float, unit: str | None = None)

celsius(value: int | float)

Build temperature datapoint (Celsius).

centimeters(value: int | float)

Build length datapoint (Centimeters).

count(value: int | float)

Build discrete number datapoint (number/count).

cubic_meters(value: int | float)

Build volume datapoint (Cubic Meters).

grams(value: int | float)

Build weight datapoint (Grams).

kelvin(value: int | float)

Build temperature datapoint (Kelvin).

kilograms(value: int | float)

Build weight datapoint (Kilograms).

liters(value: int | float)

Build volume datapoint (Liters).

meters(value: int | float)

Build length datapoint (Meters).

percent(value: int | float)

Build percent value datapoint.