派生シリーズの設定

派生シリーズを使用すると、ユーザーは通常の時系列データに適用される計算や変換を保存および複製できます。これらをPalantirリソースとして保存することで、ロジックを共有し、オントロジーにバインドすることができます。結果として得られる派生シリーズは、生の時系列データとして振る舞いますが、その場で計算されます。これにより、派生データの管理やストレージ、プラットフォーム全体での計算の複製が不要になります。

次のガイドでは、Quiverで派生シリーズを作成し、プラットフォームで使用するためにオントロジーに保存する方法について説明します。

派生シリーズの要件

派生シリーズを作成する際には、以下の要件を念頭に置いておく必要があります。

1. 派生シリーズのロジックは、_単一の_ルートオブジェクトで動作する必要があります。このロジックはテンプレート化されており、バインドされたオブジェクトから解決できます。
2. 派生シリーズは、単一の ルート オブジェクトの視点から作成する必要があります。ロジックが別のオブジェクトタイプの時系列入力を必要とする場合、そのオブジェクトタイプを センサー オブジェクトタイプとして設定し、その時系列データをQuiverのセンサーオブジェクトとして利用できるようにする必要があります。

たとえば、Quiverの オブジェクト時系列プロパティカード では、現在のオブジェクトタイプの時系列プロパティと、センサーオブジェクトの時系列データの両方を選択できます。

派生シリーズを設定する際には、 オブジェクト検索周辺 カードや変換を使用することはできません。

以下の例では、仮想の Machine オブジェクトタイプのマシンの圧力損失を計算する派生シリーズを作成します。

1. ルートオブジェクトの選択

Quiverで、関連するオブジェクトタイプ（この例では Machine）を選択し、オブジェクトセレクタ カードを使用してリストから個々のルートオブジェクトを選択します。以下の例では、 Machine 1 オブジェクトを選択しています。

2. 時系列プロパティを入力として選択

以下の例では、 Machine オブジェクトタイプには2つの時系列プロパティ（TSP）があります： Inlet pressure と Outlet pressure。Quiverキャンバスに オブジェクト時系列プロパティ カードを使用して、希望するTSPを追加します。これらのTSPは、次のステップでの派生シリーズ計算の入力となります。

3. 時系列変換の適用

Quiverでは、導関数や移動平均など、さまざまな時系列変換が提供されています。Quiver変換について詳しく学びましょう。

この例では、時系列数式 カードを使用して、 Machine 1 オブジェクトの入口圧と出口圧の差を計算する変換を追加します。

4. 派生シリーズをリソースとして保存

時系列数式カードの設定パネルから、派生シリーズオプション セクションに移動し、派生シリーズの保存 を選択します。ダイアログが表示され、派生シリーズをリソースとして保存する手順が案内されます。

ステップ1：詳細

結果として得られる派生シリーズリソースに名前、説明、フォルダーの場所を選択します。次に、派生シリーズロジックで使用される操作と入力を確認します。

ステップ2：バウンドオブジェクトタイプの選択

派生シリーズがバインドされるオブジェクトタイプを選択します。保存後、このオブジェクトタイプからのみ派生シリーズロジックを解決できます。派生シリーズは、ルートオブジェクトタイプまたはルートオブジェクトタイプにリンクされたセンサーオブジェクトタイプのいずれかに保存できます。

派生シリーズは、すべてのルートオブジェクトで適用される場合、ルート オブジェクトタイプにバインドする必要があります。つまり、すべてのルートオブジェクトで同じ入力が存在し、派生がすべてのルートオブジェクトで有効です。派生シリーズがルートオブジェクトの小さなサブセットに適用される場合は、センサーオブジェクトタイプにバインドすることをお勧めします。

派生シリーズを保存する場所については、時系列オントロジー設定のドキュメントを確認してください。

派生シリーズをオントロジー化するセクションで、ルートオブジェクトタイプへのバインドとセンサーオブジェクトタイプへのバインドの違いについて学びます。

ステップ3：レビュー

最後に、オントロジー出力とリソースの場所情報を保存する前に確認します。

派生シリーズを保存した後、今後の変更は派生シリーズ管理ページから行う必要があります。

5. 派生シリーズをオントロジー化する

これまでの手順では、派生シリーズを管理するための ロジックリソース の設定方法について説明しました。 コーデックステンプレート は、ロジックリソースをテンプレート化された形式に変換したもので、時系列入力を持つルートオブジェクトであればどのルートオブジェクトでもロジックを解決できるようになります。

これで、オントロジーに派生シリーズを追加することができます。テンプレート化されたロジックへの参照を、バインドされたオブジェクトタイプの時系列プロパティに追加します。オントロジーに追加されると、派生シリーズは生の時系列データと同じように動作し、Palantirアプリケーションで使用できるようになります。

ステップ1：コーデックステンプレートIDの取得

コーデックステンプレートは、テンプレート化された派生シリーズロジックを格納するために使用される非表示のPalantirリソースです。次に進む前に、派生シリーズのコーデックステンプレートIDを見つける必要があります。

まず、派生シリーズリソースを見つけます。名前で検索するか、派生シリーズの保存 ダイアログで指定したフォルダーを探してください。リソースを開くと、派生シリーズ管理ページが表示されます。

テンプレートRID を 派生シリーズの詳細 セクションからコピーします。

ステップ2：オントロジーのオブジェクトタイプに派生シリーズをバインドする

バウンド時系列オブジェクトタイプ は、派生シリーズ管理ページの詳細セクションに表示されます：

派生シリーズは、生の 時系列と同様に時系列プロパティ（TSP）を使用します。ただし、シリーズIDの代わりに、コーデックステンプレートのリソース識別子（RID）が時系列プロパティ値として使用されます。 以下のオプションを確認し、派生シリーズをルートオブジェクトタイプにバインドするか、センサーオブジェクトタイプにバインドするかを選択します。

オプション1：ルートオブジェクトタイプにバインドする

派生シリーズをルートオブジェクトタイプにバインドするには、ルートオブジェクトタイプの基となるデータソースに新しい文字列タイプの列を作成し（既存の列を使用しても構いません）、コーデックステンプレートRIDを追加します。以下の例では、Delta Pressure 派生シリーズテンプレートRIDが10台のマシンに追加されています。

オントロジーマネージャーアプリケーションに移動し、新しいコーデックステンプレートRIDを含む列を時系列プロパティにマッピングします（まだマッピングされていない場合）。時系列プロパティの設定方法について詳しく説明しています。

オプション2：センサーオブジェクトタイプにバインドする

この派生シリーズが適用されるすべてのルートオブジェクトに対して1つのセンサーオブジェクトを作成する必要があります。

バウンドオブジェクトタイプの基となるデータソースのTSPの列にコーデックステンプレートRIDを入力します。この例では、行1から10は生のシリーズIDを参照し、行11から15はコーデックステンプレートRIDを介して派生シリーズを参照しています。以下の例では、Delta Pressure 派生シリーズテンプレートRIDが含まれる5つのセンサーオブジェクトが追加されています。

派生シリーズプロパティデータソース

現在、派生シリーズ用のデータソースは、含まれる時系列プロパティのデータソースにリストされる必要はありません。