6188617037
Environment Corruption Check / test-python-versions (3.12.8) (push) Failing after 2s
Environment Corruption Check / test-python-versions (3.11.11) (push) Failing after 1s
Pre-commit checks / pre-commit-check (push) Failing after 1s
Environment Corruption Check / test-python-versions (3.13.2) (push) Failing after 4s
115 lines
3.6 KiB
Markdown
115 lines
3.6 KiB
Markdown
# グラフ可視化ツール
|
|
|
|
グラフ可視化ツールは、Pythonを使用してデータ処理コードを生成し、最終的に[@visactor/vmind](https://github.com/VisActor/VMind)を呼び出してグラフのspec結果を得ます。グラフのレンダリングには[@visactor/vchart](https://github.com/VisActor/VChart)を使用します。
|
|
|
|
## インストール (Mac / Linux)
|
|
|
|
1. Node >= 18をインストール
|
|
|
|
```bash
|
|
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. 依存関係をインストール
|
|
|
|
```bash
|
|
cd app/tool/chart_visualization
|
|
npm install
|
|
```
|
|
|
|
## インストール (Windows)
|
|
1. nvm-windowsをインストール
|
|
|
|
[GitHub公式サイト](https://github.com/coreybutler/nvm-windows?tab=readme-ov-file#readme)から最新バージョンの`nvm-setup.exe`をダウンロードしてインストール
|
|
|
|
2. nvmを使用してNodeをインストール
|
|
|
|
```powershell
|
|
# その後、最新の安定版Nodeをインストール
|
|
nvm install node
|
|
# 使用を有効化、例えば最新の安定版が22の場合、use 22
|
|
nvm use 22
|
|
```
|
|
|
|
3. 依存関係をインストール
|
|
|
|
```bash
|
|
# 現在のリポジトリで適切な位置に移動
|
|
cd app/tool/chart_visualization
|
|
npm install
|
|
```
|
|
|
|
## ツール
|
|
### python_execute
|
|
|
|
Pythonコードを使用してデータ分析(データ可視化を除く)に必要な部分を実行します。これにはデータ処理、データ要約、レポート生成、および一般的なPythonスクリプトコードが含まれます。
|
|
|
|
#### 入力
|
|
```typescript
|
|
{
|
|
// コードタイプ:データ処理/データレポート/その他の一般的なタスク
|
|
code_type: "process" | "report" | "others"
|
|
// 最終実行コード
|
|
code: string;
|
|
}
|
|
```
|
|
|
|
#### 出力
|
|
Python実行結果、中間ファイルの保存とprint出力結果を含む
|
|
|
|
### visualization_preparation
|
|
|
|
データ可視化の準備ツールで、2つの用途があります。
|
|
|
|
#### Data -> Chart
|
|
データから分析に必要なデータ(.csv)と対応する可視化の説明を抽出し、最終的にJSON設定ファイルを出力します。
|
|
|
|
#### Chart + Insight -> Chart
|
|
既存のグラフと対応するデータインサイトを選択し、データインサイトをデータ注釈の形式でグラフに追加し、最終的にJSON設定ファイルを生成します。
|
|
|
|
#### 入力
|
|
```typescript
|
|
{
|
|
// コードタイプ:データ可視化またはデータインサイト追加
|
|
code_type: "visualization" | "insight"
|
|
// 最終的なJSONファイルを生成するためのPythonコード
|
|
code: string;
|
|
}
|
|
```
|
|
|
|
#### 出力
|
|
データ可視化の設定ファイル、`data_visualization tool`で使用
|
|
|
|
## data_visualization
|
|
|
|
`visualization_preparation`の内容に基づいて具体的なデータ可視化を生成
|
|
|
|
### 入力
|
|
```typescript
|
|
{
|
|
// 設定ファイルのパス
|
|
json_path: string;
|
|
// 現在の用途、データ可視化またはインサイト注釈追加
|
|
tool_type: "visualization" | "insight";
|
|
// 最終成果物pngまたはhtml;htmlではvchartのレンダリングとインタラクションをサポート
|
|
output_type: 'png' | 'html'
|
|
// 言語、現在は中国語と英語をサポート
|
|
language: "zh" | "en"
|
|
}
|
|
```
|
|
|
|
## 出力
|
|
最終的に'png'または'html'の形式でローカルに保存され、保存されたグラフのパスとグラフ内で発見されたデータインサイトを出力
|
|
|
|
## VMind設定
|
|
|
|
### LLM
|
|
|
|
VMind自体
|