foundryts.functions.unit_conversion

foundryts.functions.unit_conversion(from_unit, to_unit)

指定された単位値から指定された単位に単一のtime series内のすべての値を変換する関数を返します。

渡される単位は、以下の利用可能な単位および変換のリストからのUnitの値、または有効なAliasのいずれかです。

長さ

温度単位

圧力単位

時間単位

質量単位

サービス管理者に連絡して、ユーザーのデプロイメント用の単位と変換のリストにアクセスし、拡張してください。

• パラメーター:
  • from_unit (str) – 変換元の元の単位。
  • to_unit (str) – 変換先の目的の単位。
• 戻り値: 単一のtime seriesを入力として受け取り、指定された単位に変換された値を持つtime seriesを返す関数。
• 戻り型: (FunctionNode) -> FunctionNode

データフレームスキーマ

例

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
>>> 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",
... )
# `F.points`関数を使用して一連のデータポイントを作成します。
# 各タプルの最初の要素はタイムスタンプ、2番目の要素はその時点での値です。
# `name`引数でシリーズに名前を付けています。

>>> series.to_pandas()
# `to_pandas`メソッドを使用して、シリーズを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
# データフレームには各ポイントのタイムスタンプと対応する値が含まれています。
# タイムスタンプは1970-01-01からのナノ秒で表現されています。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
>>> unit_converted = F.unit_conversion("m", "mm")(series)
# メートル(m)からミリメートル(mm)への単位変換を行う関数を適用している
# 変換対象は'series'というデータシーケンス

>>> unit_converted.to_pandas()
# 結果をPandas DataFrame形式で表示

                      timestamp    value
# 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
# 各行は、タイムスタンプと対応する変換された値を示している