TransformPart - スコープ対象、グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:17分
  • TransformPart API は、実行する変換の詳細を指定するメソッドを提供します。

    このクラスは、スコープ対象およびグローバルサーバースクリプトで呼び出すことができます。TransformPart クラスを使用する場合は、sn_clotho 名前空間識別子を使用します。

    このクラスにはコンストラクターはありません。TransformPart オブジェクトは、多くの Transformer メソッドと TransformPart メソッドによって返されます。

    このクラスのメソッドは、実行する変換を定義します。実際の変換は、 execute() メソッドが Transformer オブジェクトで呼び出されたときに行われます。

    TransformPart メソッドが呼び出される順序は重要です。
    • transform メソッドを呼び出す前に、 metric() メソッドを呼び出す必要があります。
    • transform メソッドを呼び出した後に metric() メソッドまたは groupBy() メソッドを使用することはできません。
    • 中間変換は、必要な中間結果に対して collect() メソッドが呼び出されない限り、結果に返されません。
      // where tp is a TransformPart object
      // example 1
      tp.avg().add(2);
      var tr = tp.execute(); 
      // tr contains avg+2, but not avg
       
      // example 2
      tp.avg().add(2);
      tp.avg();
      var tr = tp.execute(); 
      // tr contains both avg and avg + 2
      
      // example 3
      tp.avg().collect().add(2);
      var tr = tp.execute(); 
      // tr contains both avg and avg + 2

    このクラスは メトリックベース アプリケーションの一部です。

    TransformPart - add(数値定数)

    各タイムスタンプの値に指定された数値を追加します。

    表 : 1. パラメーター
    名前 タイプ 説明
    constant 番号 各タイムスタンプの値に追加する数値。
    表 : 2. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart:avg()

    選択したメトリクス系列を、各タイムスタンプの平均値を含む 1 つの系列にアグリゲートします。

    表 : 3. パラメーター
    名前 タイプ 説明
    なし
    表 : 4. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - bottom(番号カウント)

    タイムスタンプごとに指定された数の最低値を返す結果セットを作成します。このメソッドの結果は、系列の数が「カウント」になります。各値は、そのソース系列のラベルを保持します。

    表 : 5. パラメーター
    名前 タイプ 説明
    カウント 番号 返される系列の数。系列には 0 からカウント - 1 のラベルが付けられます。
    表 : 6. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - ceil(Number ceiling)

    指定された値より大きい任意のタイムスタンプの値を指定された値に置き換えます。

    表 : 7. パラメーター
    名前 タイプ 説明
    天井関数 番号 任意のタイムスタンプの最大許容値。
    表 : 8. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart:collect()

    この変換をコレクション対象としてマークします。

    チェーンの一部であるが、最後の変換ではない変換は、デフォルトでは収集されません。収集された変換は、変換結果の一部として返されます。

    表 : 9. パラメーター
    名前 タイプ 説明
    なし
    表 : 10. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart:count()

    選択したメトリクス系列を、各タイムスタンプの値の数を含む 1 つの系列にアグリゲートします。

    表 : 11. パラメーター
    名前 タイプ 説明
    なし
    表 : 12. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - div(数値定数)

    各タイムスタンプの値を指定された数値で除算します。

    表 : 13. パラメーター
    名前 タイプ 説明
    constant 番号 各タイムスタンプの値を除算する数値。
    表 : 14. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - filter(Object aggregator, Object duration)

    指定されたアグリゲーターを使用して、指定された期間系列を作成します。

    表 : 15. パラメーター
    名前 タイプ 説明
    集計関数 オブジェクト 可能:
    • AVG
    • カイ 2 乗
    • 最後
    • 最大
    • MEDIAN
    • 最小
    • STDDEV
    これらのオプションの定義については、「 メトリックベース変換」を参照してください。
    duration オブジェクト 系列の期間。
    表 : 16. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - floor(Number floor)

    タイムスタンプ内の指定された値よりも小さい値を、指定された値に置き換えます。

    表 : 17. パラメーター
    名前 タイプ 説明
    フロア 番号 任意のタイムスタンプの最小値。
    表 : 18. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart:fractiles(配列分数)

    指定された値のパーセンテージを下回る値で構成される系列を作成します。指定された配列内の各分数の系列を返します。

    返される系列のタイムスタンプの値は、そのタイムスタンプのサンプルの指定された部分が下回る値です。たとえば、分数が 0.5 の場合、タイムスタンプの値は、入力系列の値の半分が (中央値) を下回っている値です。

    表 : 19. パラメーター
    名前 タイプ 説明
    小数部 数値のアレイ 入力系列に使用する分数。
    表 : 20. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。指定された分数ごとに 1 つの系列が含まれます。
    // returns a single series containing the median for each time stamp, which
    // means that half a time stamp's values are below the returned value 
    fractiles([.5]) 
    // returns four series, one series for each of the 25%, 50%, 75%, and 100% quartiles 
    fractiles([.25, .5, .75, 1])
    // returns the median, 95% percentile, the max value
    fractiles([.50, .95, 1]) 

    TransformPart - getResult()

    この変換に関連する結果の部分を返します。

    collect() メソッドは execute() メソッドの前に呼び出す必要があり、execute() メソッドは getResult() メソッドを呼び出す前に呼び出す必要があります。

    表 : 21. パラメーター
    名前 タイプ 説明
    なし
    表 : 22. 返される内容
    タイプ 説明
    変換結果 変換のこの部分に関連付けられた変換結果が含まれます。
    var t = new sn_clotho.Transformer(drones);
    t.metric("mb_demo_mt_altitude");
    var avgTform = t.avg();
    t.execute();
    var avgTformResult = avgTform.getResult();

    TransformPart - groupBy(文字列フィールド)

    データをグループ化する基準となるフィールドを指定します。複数のフィールドを指定するには、呼び出しを個別に実行します。

    注:
    変換の実行後に groupBy() メソッドを呼び出すことはできません。
    表 : 23. パラメーター
    名前 タイプ 説明
    フィールド 文字列 変換結果をグループ化する基準となるテーブル内のフィールドの名前。
    表 : 24. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    次の例は、高度平均メトリクスをフリートフィールドとモデルフィールド別にグループ化する方法を示しています。

    transformer.groupBy("fleet,model").metric("mb_demo_mt_altitude").avg().label('%g:fleet: - %g:model:');
    
    var transformPart = transformer.groupBy("fleet,model")
    
    transformPart.metric("mb_demo_mt_altitude").avg().label('%g:fleet: - %g:model:');

    TransformPart - interpolate(オブジェクト数)

    隣接するデータ値から補間して、NaN データアイテムのデータ値を作成します。

    表 : 25. パラメーター
    名前 タイプ 説明
    カウント オブジェクト NaN 以外の値をチェックする各方向のデータサンプルの数を指定します。NaN 以外の値が見つからない場合は、NaN が使用されます。
    表 : 26. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - iqr()

    四分位範囲変換を実行します。

    4 つの系列の結果セットを作成します。
    • IQR (すべてのエントリの中央値)
    • IQR範囲、Q1-1.5IQRを下回る、またはQ3 + 1.5IQRを超える
    • Q1:エントリの最小半分の中央値
    • Q3:エントリの上半分の中央値
    表 : 27. パラメーター
    名前 タイプ 説明
    なし
    表 : 28. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - label(文字列ラベル)

    結果の系列のラベルを追加します。

    表 : 29. パラメーター
    名前 タイプ 説明
    label 文字列 変換結果のラベル。
    表 : 30. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - limit(Object count)

    NaN以外の最新の値から開始して、最大で指定された数の値を返します。

    表 : 31. パラメーター
    名前 タイプ 説明
    カウント オブジェクト タイムスタンプの数。
    表 : 32. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - log(数値ベース)

    各タイムスタンプの値に対して対数を実行します。この値は、結果がタイムスタンプ値の指定された基数の対数です。

    表 : 33. パラメーター
    名前 タイプ 説明
    ベース 番号 対数計算の底。
    表 : 34. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - max()

    各タイムスタンプの最大値を持つ系列を返します。

    表 : 35. パラメーター
    名前 タイプ 説明
    なし
    表 : 36. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - median()

    一連の系列全体の各タイムスタンプの値の中央値を含む系列を作成します。

    TranformPart オブジェクトに n 個の系列がある場合、n が奇数の場合、タイム スタンプの (n / 2 + 1) 値が中央値です。n が偶数の場合、タイムスタンプの (n / 2) と (n / 2 + 1) の値の平均が中央値です。

    表 : 37. パラメーター
    名前 タイプ 説明
    なし
    表 : 38. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart:metric(文字列メトリクス)

    変換で使用するメトリクスフィールドを指定します。

    変換で使用する複数のメトリクスを指定できます。変換の実行後に metric() メソッドを呼び出すことはできません。

    表 : 39. パラメーター
    名前 タイプ 説明
    メトリクス 文字列 メトリクスフィールドの名前。
    表 : 40. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart:min()

    各タイムスタンプの最小値を持つ系列を返します。

    表 : 41. パラメーター
    名前 タイプ 説明
    なし
    表 : 42. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - mul(数値定数)

    各タイムスタンプの値に指定された数値を乗算します。

    表 : 43. パラメーター
    名前 タイプ 説明
    constant 番号 各タイムスタンプの値を乗算する数字。
    表 : 44. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - partition(String aggregator, GlideDateTime duration, GlideDateTime base)

    系列を同じ期間の間隔に分割します。

    表 : 45. パラメーター
    名前 タイプ 説明
    集計関数 文字列 使用するアグリゲーター。最小、最大、平均、または最後を指定できます。
    duration GlideDateTime または ISO 8601 形式の文字列 間隔の長さ。
    ベース GlideDateTime または ISO 8601 形式の文字列 パーティショニングのゼロオフセット。たとえば、日 (24 時間) でパーティション分割する場合は、タイムゾーンの月曜日の深夜にベースを設定します。30 日でパーティション分割する場合は、ベースを直近の月の 1 日目に設定します。
    表 : 46. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - resample(Number count)

    結果に含めるデータポイントの数を指定します。

    指定された範囲内の固定数のデータポイントに系列を配置します。元の系列に指定された数よりも多くのデータポイントがある場合は、複数の値が平均化されます。元の系列のデータポイントが指定された数よりも少ない場合は、既存のデータポイント間でデータポイントを補間することによってデータポイントが追加されます。

    resample() メソッドを使用して、結果のサンプル数を減らして、表示するサンプル数により近いものにすることができます。

    表 : 47. パラメーター
    名前 タイプ 説明
    カウント 番号 結果に含めるサンプルの数。
    表 : 48. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - resample(最小数、最大数)

    結果に含めるサンプルの最小数と最大数を指定します。

    この方法は、期間 (粒度) が異なる系列を表示する場合に便利です。

    このメソッドは、系列あたりの平均ポイント数を決定し、それが指定された最小値と最大値の間に収まる場合、各系列はその平均ポイント数にリサンプリングされます。計算された平均が指定された最大値より大きい場合、または指定された最小値より小さい場合は、指定された最大値または最小値が使用されます。

    表 : 49. パラメーター
    名前 タイプ 説明
    最小 番号 結果に含めるサンプルの最小数。十分なサンプルがない場合は、補間を使用してサンプルが作成されます。
    最大 番号 結果に含めるサンプルの最大数。
    表 : 50. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - resample(String aggregator, Number numValues)

    指定したサイズの結果セットを作成するために使用するアグリゲーターを指定します。アグリゲーターは、LAST、AVG、MIN、または MAX です。

    resample() メソッドを使用して、結果のサンプル数を減らして、表示するサンプル数により近いものにすることができます。

    表 : 51. パラメーター
    名前 タイプ 説明
    集計関数 文字列 LAST、AVG、MIN、または MAX を指定できます。
    数値 番号 結果セットに含めるサンプルの数。

    要求された値の数が、要求された期間のデータ内の値の数より大きい場合、 interpolate() を使用して既存のポイント間に値を追加し、要求された値の数に達します。

    表 : 52. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - resample(String aggregator, GlideDuration duration)

    指定された期間の結果セットを作成するために使用するアグリゲーターを指定します。アグリゲーターは、LAST、AVG、MIN、または MAX です。

    基になるデータを要求された期間にリサンプリングします。
    • 時系列が 1 分間隔で保存され、 resample(AVG, new GlideDuration("1:00")) が呼び出されると、結果には、前の 60 個の値の平均を反映する 1 時間ごとに 1 つのデータポイントが含まれます。
    • 要求された期間がデータの期間よりも短い場合は、補間データポイントを計算するために内挿が使用されます。

    resample() メソッドを使用して、結果のサンプル数を減らして、表示するサンプル数により近いものにすることができます。

    表 : 53. パラメーター
    名前 タイプ 説明
    集計関数 文字列 LAST、AVG、MIN、または MAX を指定できます。
    duration GlideDuration 結果セットの期間。
    表 : 54. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - round(数値精度)

    各タイムスタンプの値を指定された精度に丸めます。

    各値に対してこの計算を実行します。
    (v / precision) * precision
    表 : 55. パラメーター
    名前 タイプ 説明
    精度 番号 丸め計算で使用される値。
    表 : 56. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - stddev()

    一連の系列全体の各タイムスタンプの値の標準偏差を含む系列を作成します。

    表 : 57. パラメーター
    名前 タイプ 説明
    なし
    表 : 58. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - sub(オブジェクト定数)

    各タイムスタンプの値から指定された数値を減算します。

    表 : 59. パラメーター
    名前 タイプ 説明
    constant オブジェクト 各タイムスタンプの値から減算する数値。
    表 : 60. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - sum()

    選択したメトリクス系列を、各タイムスタンプのすべての値の合計を含む 1 つの系列にアグリゲートします。

    表 : 61. パラメーター
    名前 タイプ 説明
    なし
    表 : 62. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。

    TransformPart - top(Number count)

    タイムスタンプごとに指定された数の上位値を返す結果セットを作成します。このメソッドの結果は、系列の数が「カウント」になります。各値は、そのソース系列のラベルを保持します。

    表 : 63. パラメーター
    名前 タイプ 説明
    カウント 番号 返される系列の数。系列には 0 からカウント - 1 のラベルが付けられます。
    表 : 64. 返される内容
    タイプ 説明
    TransformPart 変換特性を指定するために使用できる TransformPart オブジェクト。