Units and Conversions
In the absence of units, time series values are only a collection of numbers, with no meaning. Units can be used to add meaning to numbers and determine how to interpret numbers in relation to other numbers having other units (unit conversions).
PowerTSM provides a set of standard units and unit conversions as part of the installation. Additionally custom unit and unit conversion configuration is supported as described in the following chapter. Units and unit conversion are defined separately for each data source (repository) in PowerTSM.
The units provide information about the data in terms of data transformation. Time series and time series data objects contain a unit property. For a time series object, it provides information about the unit in which the data is stored in the repository and therefore how the data is transformed if no other interval transformation method is specified. When reading data from a time series, the unit in the read options specifies how the data should be read from the repository (e.g. conversion to a different unit than the unit specified in the time series). In addition, the unit specified in the time series data that is returned when reading data provides information on how the data can be interpreted. When writing data to a time series, the unit in the time series data is required for converting the data to the unit of the time series.
A unit has the following properties:
| Property | Meaning | Example kW (Kilowatt) | Example F (Fahrenheit) |
|---|---|---|---|
| Symbol | Symbol of the unit | kW | F |
| Interval Transformation | Interval transformation method used when transforming the interval of time series data of this unit. | Average | Sum |
| Storage | The storage information of the unit, containing in which repository this unit is stored. | Example_Repository | Example_Repository |
See Interval Transformation for more information on interval transformation methods and their effect with different intervals.
Time Series with Arbitrary Unit
Section titled “Time Series with Arbitrary Unit”When creating a time series, not only existing (pre-defined or created) units can be used, but also arbitrary units by simply specifying the unit symbol. If a unit with the specified symbol does not exist in the repository, it will be treated as a unit without any constant unit conversion paths. For interval transformation, the default method Average will be applied for such units. Unit conversions with conversion time series can be created the same way as for other units.
Time Series Without Unit
Section titled “Time Series Without Unit”A time series can be configured without a unit by setting the unit to null.
Unit Conversions
Section titled “Unit Conversions”For conversions between units, unit conversion rules are required to provide information on how to perform the conversion. There are two different types of unit conversions.
- Constant unit conversion
- Time-dependent unit conversion
Constant Unit Conversions
Section titled “Constant Unit Conversions”Constant unit conversions contain information for conversions which do not change over time (e.g. a conversion from MW to kW is always performed with the factor 1000). There is a set of pre-defined constant unit conversion as part of the installation. Additionally custom unit conversions can be stored to extend the pre-defined constant unit conversions.
A constant unit conversion has the following properties:
| Property | Meaning | Example kW (Kilowatt) | Example F (Fahrenheit) | Example W (Watt) |
|---|---|---|---|---|
| Unit | A reference to an unit to which the conversion rule applies. | kW | F | W |
| Conversion Unit | A reference to an unit to which the conversion can be made. | W | °C | Wh |
| Offset | Constant that is added to the value before the multiplication factor is applied | 0.0 | -32.0 | 0.0 |
| Factor | Multiplication factor to convert from the unit to the conversion unit | 1000.0 | 0.555555555555556 | 1 |
| Integration Interval | If the conversion from a power unit to a volumetric unit is required, the integration interval can be set. If the integration interval is null, no integration will be performed. | null | null | 1 Hour |
| Storage | The storage information of the unit, containing in which repository this unit is stored. | Example_Repository | Example_Repository | Example_Repository |
Time-Dependent Unit Conversions
Section titled “Time-Dependent Unit Conversions”In some cases a conversion using a constant factor and offset is not feasible. This is the case with variable conversion factors, such as price data, currency conversions or temperature-dependent calorific value conversions.
For such cases PowerTSM supports the definition of so-called time-dependent unit conversions. In its core a time-dependent unit conversion is also a time series but with a specific unit: “numerator/denominator notation”, where the target unit is given in the numerator and the source unit in the denominator. Examples: USD/EUR, “EUR/MWh” or “kWh/Nm3”. In case of USD/EUR the values of the time series are the dollar conversion rates for 1 euro.
From a time series with that specific unit a time-dependent unit conversion can be created and has following properties:
| Property | Meaning | Example $/€ (Dollar per Euro) | Example €/MW (Euro per Megawatt) |
|---|---|---|---|
| Unit | A reference to a unit to which the conversion rule applies. | $ | € |
| Conversion Unit | A reference to a unit to which the conversion can be made. | € | MW |
| Storage | The storage information of the unit, containing in which repository this unit is stored. | Example_Repository | Example_Repository |
In order for the conversion time series to be used for conversions, it can either be assigned to a specific time series or defined as a default conversion time series and thus available for all time series.
When reading data from a time series all conversion time series assigned to that time series and all default conversion time series are used for calculating the conversion path.
Conversion Paths
Section titled “Conversion Paths”The system automatically determines a conversion path between two units using existing unit conversion definitions. For example, it is sufficient if the system has a definition for W, kW (with conversion unit W) and MW (with conversion unit W) to be able to convert from MW to kW. No explicit definition of kW to MW is required.
Conversion of a Time Series Without Unit
Section titled “Conversion of a Time Series Without Unit”Unit conversions without a unit (null) are not possible. Therefore, if the unit of a time series is null, only data without a unit (null) can be written to or read from such a time series.