ClickHouse/docs/ja/sql-reference/aggregate-functions/reference/largestTriangleThreeBuckets.md

slug	sidebar_position	sidebar_label
/ja/sql-reference/aggregate-functions/reference/largestTriangleThreeBuckets	159	largestTriangleThreeBuckets

largestTriangleThreeBuckets

入力データにLargest-Triangle-Three-Bucketsアルゴリズムを適用します。 このアルゴリズムは、時系列データの可視化のためのダウンサンプリングに使用されます。x座標でソートされた系列に対して動作するように設計されています。 ソートされた系列をバケットに分割し、各バケットで最も大きな三角形を見つけることで動作します。バケットの数は、結果のシリーズに含まれるポイントの数に等しいです。 この関数は、データをxでソートし、その後ソートされたデータにダウンサンプリングアルゴリズムを適用します。

構文

largestTriangleThreeBuckets(n)(x, y)

エイリアス: lttb.

引数

• x — x座標。 Integer、Float、Decimal、Date、Date32、DateTime、DateTime64。
• y — y座標。 Integer、Float、Decimal、Date、Date32、DateTime、DateTime64。

NaNは提供される系列から無視されます。つまり、NaN値は分析から除外されます。これにより、関数が有効な数値データのみに対して動作することが保証されます。

パラメータ

• n — 結果の系列に含まれるポイント数。 UInt64。

返される値

Tupleと2つの要素を持つArray。

例

入力テーブル:

┌─────x───────┬───────y──────┐
│ 1.000000000 │ 10.000000000 │
│ 2.000000000 │ 20.000000000 │
│ 3.000000000 │ 15.000000000 │
│ 8.000000000 │ 60.000000000 │
│ 9.000000000 │ 55.000000000 │
│ 10.00000000 │ 70.000000000 │
│ 4.000000000 │ 30.000000000 │
│ 5.000000000 │ 40.000000000 │
│ 6.000000000 │ 35.000000000 │
│ 7.000000000 │ 50.000000000 │
└─────────────┴──────────────┘

クエリ:

SELECT largestTriangleThreeBuckets(4)(x, y) FROM largestTriangleThreeBuckets_test;

結果:

┌────────largestTriangleThreeBuckets(4)(x, y)───────────┐
│           [(1,10),(3,15),(9,55),(10,70)]              │
└───────────────────────────────────────────────────────┘