foundryts.functions.unit_conversion

foundryts.functions.unit_conversion(from_unit, to_unit)

返回一个函数，该函数将单个时间序列中的所有值从指定单位值转换为指定单位。

传入的单位可以是Unit中的一个值，也可以是以下可用单位和转换列表中的一个有效Alias：

长度

温度单位

压力单位

时间单位

质量单位

联系您的服务管理员以访问和扩展部署的单位和转换列表。

• 参数:
  • from_unit (str) – 原始单位以进行值转换。
  • to_unit (str) – 目标单位以进行值转换。
• 返回: 一个函数，接受一个单时间序列作为输入，并返回转换为指定单位的时间序列。
• 返回类型: (FunctionNode) -> FunctionNode

数据框架结构

示例

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
>>> series = F.points(
...     (1, 8.0),
...     (101, 4.0),
...     (200, 2.0),
...     (201, 1.0),
...     (299, 35.0),
...     (300, 16.0),
...     (1000, 64.0),
...     name="series",
... )
>>> series.to_pandas()
                      timestamp  value
0 1970-01-01 00:00:00.000000001    8.0
1 1970-01-01 00:00:00.000000101    4.0
2 1970-01-01 00:00:00.000000200    2.0
3 1970-01-01 00:00:00.000000201    1.0
4 1970-01-01 00:00:00.000000299   35.0
5 1970-01-01 00:00:00.000000300   16.0
6 1970-01-01 00:00:00.000001000   64.0

这个代码片段展示了如何使用 F.points 方法创建一个时间序列对象 series，其中包含一组时间戳和对应的值。接着，使用 to_pandas 方法将这个时间序列转换为一个 Pandas DataFrame，以便更方便地进行数据分析和处理。时间戳是以纳秒为单位的时间点。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
>>> unit_converted = F.unit_conversion("m", "mm")(series)
# 将单位从米("m")转换为毫米("mm")

>>> unit_converted.to_pandas()
# 将转换后的数据转换为 Pandas DataFrame 进行查看
                      timestamp    value
0 1970-01-01 00:00:00.000000001   8000.0
1 1970-01-01 00:00:00.000000101   4000.0
2 1970-01-01 00:00:00.000000200   2000.0
3 1970-01-01 00:00:00.000000201   1000.0
4 1970-01-01 00:00:00.000000299  35000.0
5 1970-01-01 00:00:00.000000300  16000.0
6 1970-01-01 00:00:00.000001000  64000.0