ドキュメントの検索
karat

+

K

APIリファレンス ↗

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

データモデル

分析構造

Quiver の分析は、互いに依存することができる1つ以上のカードで構築され、分析グラフが形成されます。

グラフモードで分析グラフを見ることができ、分析も行うことができます。カードはグラフ上のノードで表されます。入力と出力は、カード間のリンクで表されます。グラフの上部にあるカードは「データ」カードであり、分析に使用されるデータを表します。他のカードを入力として受け取るカードは、「変換」または「可視化」カードとして知られています。

キャンバスモードで分析を行う際に、カードの依存関係も確認できます。

カードの入力と出力

Quiver のすべてのパラメーター、変換、可視化カードは、0 個以上の必須入力を受け取り、0 個以上の出力を生成できます。入力と出力には、確定的なタイプがあります。

例えば:

  • ローリングアグリゲート 時系列変換は、transform table を入力として受け取り、transform table を出力として生成します。
  • 数値集約 変換は、object set を入力として受け取り、number を出力として生成します。
  • 折れ線グラフ棒グラフ円グラフは、object set を入力として受け取り、categorical chart を出力として生成します。
  • ピボットテーブルは、object set を入力として受け取り、pivot table を出力として生成します。

各カードの可能な入力タイプと返される出力タイプは、カード検索ウィンドウの各操作の隣にある [input_types > output_types] で注釈されています。

カード検索ウィンドウでの各カードの入力と出力タイプ

同じ [input_types > output_types] 注釈は、次のアクションメニューでも使用されています。

次のアクションメニューでの各カードの入力と出力タイプ

そして、パラメーターを追加する際にも使用されます。

各パラメータータイプの入力と出力タイプ

Quiver カードの出力タイプは、カードヘッダーにも表示されます。

カードヘッダーに表示されるカードの出力タイプの画像

分析の構築

分析にカードを追加する方法は、カードを検索して追加するか、次のアクションメニューから追加するかです。

カードは、あるカードの出力タイプが別のカードの入力タイプと一致する場合にのみ、チェーン化できます。Quiver は、次の方法でカードの入力と出力タイプが互換性があることを確認します。

  • Quiver カードの入力を設定する際には、互換性のある出力タイプを持つカードのみが選択肢として表示されます。
  • 選択したカードの次のアクションメニューでは、互換性のあるカードのみが表示されます。

画面スペースを節約するために、カードが2つ以上の入力タイプを受け取ることができる場合、マルチタイプ アイコン(マルチタイプデータピル)が使用され、すべての可能なタイプをインラインでリスト表示する代わりに、複数のタイプが使用されることを示します。サポートされている入力タイプの完全なリストを確認するには、マルチタイプアイコンの上にカーソルを置きます。

複数の入力タイプを受け取ることができる create array 変換を強調表示したカード検索ダイアログ。

サポートされている入力と出力のタイプ

以下に、Quiver でサポートされている入力と出力のタイプの完全なリストを示します。

値のタイプ

値のタイプは、個々の値を表し、データタイプは値のグループやセットを表します。

以下の値のタイプが存在します:

  • Number: Number として表記されます(Number data pill
  • String: String として表記されます(Number data pill
  • Boolean: Boolean として表記されます(Boolean data pill
  • Timestamp: Time として表記されます(time data pill
  • Duration unit: 日や分などの時間を表す単位で、Duration unit として表記されます(Duration unit data pill
  • Range: 開始値と終了値の間の値の範囲を表し、Time range として表記されます(Time range data pill)または Number rangeNumber range data pill
  • Array: Array として表記されます(Array data pill)、String arrayString array data pill)、Number arrayNumber array data pill)、Boolean arrayBoolean array data pill)または Time arrayTime array data pill
  • None: カードが入力を必要としない場合や出力を生成しない場合を表し、None として表記されます(None type data pill)。例として、フリーフォームの Markdown テキストを受け入れる text card や、期間単位パラメーターなどがあります。

データタイプ

データタイプは、異なる値タイプを持つ可能性のある値のグループやセットを表します。

以下のデータタイプが存在します:

  • Single objects: 特定のオントロジーオブジェクトタイプのオブジェクトタイトル、プロパティ、リンクなどのデータで、Single object として表記されます(Single object data pill
  • Sets of objects: 特定のタイプのオントロジーオブジェクトのグループのオブジェクトタイトル、プロパティ、リンクなどのデータで、Object set として表記されます(Object setdata pill
  • Materialization: オントロジーからのインデックス化されたデータで、入力データソースとユーザー編集の両方のデータを組み合わせて、各オブジェクトインスタンスの最新の状態を含むデータです。Materialization として表記されます(Materialization data pill
  • Time series: 通常は一定の間隔で、時間の経過とともに変化する英数字の値のシリーズで、Time series として表記されます(Time series data pill
  • Events: 開始と終了のタイムスタンプを持つ情報を表すデータで、Event set として表記されます(Event set data pill
  • Tabular data: 行と列の形式のデータで、Transform table として表記されます(Transform table data pill)または Pivot tablePivot table data pill

可視化

すべての可視化はデータをプロットしますが、一部は確定的なタイプの集約データも出力します。この集約データは、特定のカードの入力として使用できます。

これらの可視化タイプが存在します:

  • Categorical charts は、棒グラフ折れ線グラフ円グラフ などの可視化タイプで、データをプロットするだけでなく、変換テーブルカテゴリ別数式プロット など、カテゴリデータを入力として受け取る他のカードに使用できる集約データも出力します。Categorical chart として表記されます(Categorical charts data pill)。
  • Time series group: 複数の時系列をチャートにプロットするだけでなく、変換テーブルへの入力 として使用できる時系列のセットも出力する可視化タイプです。Time series group として表記されます(time series group data pill)。
  • Time series chart: 時系列プロットが表示されるカードコンテナ。時系列プロットとは、時系列データの特定の線形表現です。複数のプロットを同じチャートに表示できます。
  • Time series scatter plot: 2つの時系列を互いにプロットする2次元の可視化で、Time scatter plot として表記されます(Time scatter plot data pill)。
  • None: None として表記されます(None data pill)。これは、オブジェクトテーブルビューやオブジェクトリスト、vega plot、時系列ヒートグリッド、ウォーターフォールプロット、マップビュー、散布図回帰など、ビューのみが提供されるカードを指します。None 値タイプは、他のカードへの入力として使用できません

グローバル識別子(ID)

Quiver のすべてのデータカード、データソース、パラメーターには、分析に追加されるときに自動的に割り当てられる一意の Quiver グローバル識別子(または短くグローバル ID)があります。

グローバルIDの特定

特定のグローバルID値は、Quiver アプリケーション全体のさまざまな場所で見つけることができます:

  • Analysis content panel の各 カード および プロット の隣
  • parameters panel の各 パラメーター の隣
  • カード のカードヘッダーとエディターパネル
  • カードエディターパネルの パラメータ化された入力値
  • 時系列チャートの凡例の各時系列 プロット
  • 時系列チャートの各 共有軸 の軸。

"グローバルIDの画像"

グローバルIDの使用

グローバルIDは、数式Vega plot の設定で、データソース(時系列プロット、変換テーブル、チャート、配列、スカラー値など)を参照するために使用されます。例えば、Vegaプロットのデータセクションで、変換テーブルをそのグローバルID($B など)を使って参照できます。変換テーブルの特定の列を参照するには、$A.column_name という構文を使用します。同様に、数値メトリックカード($C など)のグローバルIDを使ってスカラー値を参照できます。