メインコンテンツへスキップ
データフレームから、アナリティクス(回帰、分類、クラスタリングなど)を作り、結果を読みます。

前提

  • Exploratory Desktop が起動していて、プロジェクトが開いています(プロジェクトを選ぶ)。expl status で確認できます。
  • データフレームの id と列名が分かっています(expl dataframe list、expl dataframe get-schema <dataframe_id>)。
  • analytics add と analytics edit は、システム設定 > MCP / CLI の「作成、変更、削除を許可する」がオンのときだけ使えます。確認は出ません。アナリティクスの削除は、確認が出ます。確認と時間のかかる操作を参照してください。

手順

1. アナリティクスの種類を選ぶ

結果に、アナリティクスの種類ごとに、id、ラベル、枠が並びます。ラベルと、知りたいことで選びます。id は推測しません。

2. 枠と設定を調べる

<analysis_type> は、手順 1 の id に置き換えます。結果に、その種類の枠(列を置く場所)と設定が、名前と指定できる値つきで出ます。有効なのは、この名前だけです。

3. 作る

--analysis-type と --slots が必須です。--slots は、枠の名前をキーにして、列名を入れた JSON オブジェクトです。列が 1 つの枠は文字列、複数の列の枠は配列にします。--settings には、手順 2 の設定の名前の JSON オブジェクトを渡します(真偽値の設定は、文字列の “TRUE” か “FALSE” です)。
slots.json は、get-template が返した枠の名前と、get-schema の列名を使って書きます。例えば相関の種類(do_cor)には、複数の列を入れる columns という枠が 1 つあります。
設定も同じ形で settings.json に書きます。例: {"cor_method": "spearman"}。種類によって枠や設定の名前は違うので、get-template の結果から写します。コマンドは、アナリティクスを作って実行します。結果に、id(analyticsId)と、出力ごとの状態が入ります。

4. 結果を読む

list は、データフレームのアナリティクスを、それぞれが持つ出力の種類(availableOutputTypes)つきで返します。get は、種類、設定、出力を、データを CSV にして返します。ほかの出力を読むときは、availableOutputTypes の値を --output-type に渡します。

5. 変更する

変えるものだけを渡します(--slots、--settings、--title、--analysis-type など)。アナリティクスを実行し直します。実行し直しに失敗したときは、直す前の定義に戻ります。

失敗したとき

コマンドの引数は、expl <コマンド> --help または expl tools describe "<コマンド>" で確認します。

関連するページ

同じことを MCP で行う例は、使い方の「アナリティクスを作る」を参照してください。