Skip to content
Documentation

PowerTSM Core Concepts

This page gives a short overview of what a time series is and of the features a PowerTSM time series offers, such as intervals, function types, units, flags and time dimensions.

A time series is a list of values (such as measured values, forecast values, events, etc.) each assigned to a specific point in time.

On top of time value pairs PowerTSM time series offer further information to model the simplest to the most complex tasks.

A time series has basic properties which must be provided when creating a time series. These properties influence the behavior of the respective time series in many ways. Some properties can be changed at any point after creation, for other properties a data migration is necessary in order to be able to change them.

See What Is a Time Series? for more information about time series and their properties.

In PowerTSM a time series can have any interval. The smallest interval step is millisecond. Higher intervals, can be specified either in number of milliseconds or in other intervals (such as second, minute, hour, day, week, month, quarter, half-year or year).

See Intervals for more information about time series grids.

For StepRight functions, a value is always valid from a specified time.

In the context of the energy industry these are, for example, time series that track the power a device or power plant provides.

For StepLeft functions, a value is always valid until the specified time.

Most time series storing sensor data such as measured energy quantity etc. are set up as left-aligned functions, since their value is fixed at the time of measurement.

For spontaneously changing values that are valid until the next change without using a fixed interval on the time axis. This saves storage space.

For rarely changing parameters or constants saved in time series, acyclic time series are the right choice.

Cyclic time series have time synchronous, equidistant interval lengths in which data is stored.

See Function and Cyclicality for more information about function types and cyclicality.

Free definable units can be assigned to time series. A unit defines interval transformation methods and is used for unit conversions. See Units and Conversions for more information about units.

To interpret the meaning of any value in relation to other values of the same (or other) time series, in PowerTSM each value carries a quality mark, the so-called “flag”. This flag shows the current status of a value (valid, invalid, missing etc.) or signals how this value was created (predicted, manually added etc.). Thus, in PowerTSM a time series is a list of values, which are provided with a certain quality characteristic at a certain time.

See Data Quality Annotation Using Flags for more information about data quality and the behavior of flags when aggregating time series.

Interval Transformation methods can be set directly on the time series, these overwrite interval transformation methods derived from their respective units.

See Interval Transformation for more information about interval transformation methods.

A time series is often not an immutable value chain of events, but a living image of real processes. As such it is subject to certain changes that need to be considered when working with time series.

The following different time dimensions are available for time series:

  • Simple time series without any additional dimension
  • Audit time series with historization of data
  • Quotation time series - allows values on a time series with a validity for a given date/time

The time dimensions of a time series can be controlled via the properties “Audit” and “Quotation”. These settings can also be combined. The following table provides an overview:

Dimension of Time Series Audit Quotation
Standard time series without historization false false
Standard time series with historization true false
Time series with quotations true true

Every change of a time series is audited in PowerTSM. It is recorded who has changed which time series in which time period.

If required, the changed values can also be historized.

Timeline with three change dates, each historizing the values changed at that date in a different color

In PowerTSM any time series can be obtained at any point of its change timeline with exactly the data changed, or data valid at the time of change (called “not exact”).

See Audit and Historization for more information about the time dimensions and the historization of time series.

It is possible to store time series data compressed in the database to save storage space and speed up read and save operations. In order to create a compressed time series, the compression mode has to be set in the definition of the time series.

See Time Series Compression for more information about time series compression.

The correct assignment to a time zone is crucial if transmitted data should be stored in larger interval than 1 hour and the period of the data contains a time change (plus or minus hour), which must be resolved according to a given time zone.

Data points can be written on any timestamp between 0001-01-02T00:00:00Z and 9999-12-30T23:59:59.9999999Z (both inclusive). This applies to time series data as well as to attribute data.

The range keeps a margin of one day to the technical limits of .NET’s DateTimeOffset, which guarantees that every valid timestamp can be expressed in any time zone without exceeding those limits. Writing a timestamp outside the range is rejected.

Reading is not restricted by this range, but it is bounded by the start of time of the time series (1970-01-01T00:00:00 by default), which anchors the interval grid a read is aligned to. A period to read is always required and must not begin before the start of time, otherwise the read is rejected with error code HK15035 - even though the timestamp itself lies within the valid time range.

© 2026 Volue.Version v0.6.38017 November 2026