app/tool/chart_visualization/README_ja.md

グラフ可視化ツール

グラフ可視化ツールは、Pythonを使用してデータ処理コードを生成し、最終的に@visactor/vmindを呼び出してグラフのspec結果を得ます。グラフのレンダリングには@visactor/vchartを使用します。

インストール (Mac / Linux)

1. Node >= 18をインストール

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# nvmを有効化、例としてBashを使用
source ~/.bashrc
# その後、最新の安定版Nodeをインストール
nvm install node
# 使用を有効化、例えば最新の安定版が22の場合、use 22
nvm use 22

2. 依存関係をインストール

cd app/tool/chart_visualization
npm install

インストール (Windows)

1. nvm-windowsをインストール

   GitHub公式サイトから最新バージョンのnvm-setup.exeをダウンロードしてインストール

2. nvmを使用してNodeをインストール

# その後、最新の安定版Nodeをインストール
nvm install node
# 使用を有効化、例えば最新の安定版が22の場合、use 22
nvm use 22

3. 依存関係をインストール

# 現在のリポジトリで適切な位置に移動
cd app/tool/chart_visualization
npm install

ツール

python_execute

Pythonコードを使用してデータ分析（データ可視化を除く）に必要な部分を実行します。これにはデータ処理、データ要約、レポート生成、および一般的なPythonスクリプトコードが含まれます。

入力

{
  // コードタイプ：データ処理/データレポート/その他の一般的なタスク
  code_type: "process" | "report" | "others"
  // 最終実行コード
  code: string;
}

出力

Python実行結果、中間ファイルの保存とprint出力結果を含む

visualization_preparation

データ可視化の準備ツールで、2つの用途があります。

Data -> Chart

データから分析に必要なデータ(.csv)と対応する可視化の説明を抽出し、最終的にJSON設定ファイルを出力します。

Chart + Insight -> Chart

既存のグラフと対応するデータインサイトを選択し、データインサイトをデータ注釈の形式でグラフに追加し、最終的にJSON設定ファイルを生成します。

入力

{
  // コードタイプ：データ可視化またはデータインサイト追加
  code_type: "visualization" | "insight"
  // 最終的なJSONファイルを生成するためのPythonコード
  code: string;
}

出力

データ可視化の設定ファイル、data_visualization toolで使用

data_visualization

visualization_preparationの内容に基づいて具体的なデータ可視化を生成

入力

{
  // 設定ファイルのパス
  json_path: string;
  // 現在の用途、データ可視化またはインサイト注釈追加
  tool_type: "visualization" | "insight";
  // 最終成果物pngまたはhtml;htmlではvchartのレンダリングとインタラクションをサポート
  output_type: 'png' | 'html'
  // 言語、現在は中国語と英語をサポート
  language: "zh" | "en"
}

出力

最終的に'png'または'html'の形式でローカルに保存され、保存されたグラフのパスとグラフ内で発見されたデータインサイトを出力

VMind設定

LLM

VMind自体