foundryts.functions.points

foundryts.functions.points(*list_of_points, name='point-set')

Creates a set of user-defined points that act as a time series and are not written by a sync.

This is useful for creating a reference time series for operations like interpolation or DSL formulas. This is also a helpful utility for getting familiar with FoundryTS without setting up a test time series.

• Parameters:
  • *list_of_points (Tuple *[*TimestampType , float ] | Tuple *[*TimestampType , str ]) – Tuples of timestamp and the point value at that timestamp as a non-keyword position arg.
  • name (str , optional) – Alias for the point set which will be used as the time series ID for all downstream operations.
• Returns: A point-set which acts like a time series for all downstream operations.
• Return type: FunctionNode

Dataframe schema

Examples

Copied!
1
2
3
4
5
6
7
8
9
>>> numeric_series = F.points(
...     (0, 0.0), (100, 100.0), (140, 140.0), (200, 200.0), name="numeric"
... )
>>> numeric_series.to_pandas()
                      timestamp  value
0 1970-01-01 00:00:00.000000000    0.0
1 1970-01-01 00:00:00.000000100  100.0
2 1970-01-01 00:00:00.000000140  140.0
3 1970-01-01 00:00:00.000000200  200.0

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
>>> enum_series = F.points(
...     (100, "ON"),
...     (120, "ON"),
...     (130, "OFF"),
...     (150, "ON"),
...     (160, "OFF"),
...     name="enum",
... )
>>> enum_series.to_pandas()
                      timestamp value
0 1970-01-01 00:00:00.000000100    ON
1 1970-01-01 00:00:00.000000120    ON
2 1970-01-01 00:00:00.000000130   OFF
3 1970-01-01 00:00:00.000000150    ON
4 1970-01-01 00:00:00.000000160   OFF