app/tool/chart_visualization/README_ko.md

차트 시각화 도구

차트 시각화 도구는 Python을 통해 데이터 처리 코드를 생성하고, 최종적으로 @visactor/vmind를 호출하여 차트 사양을 얻습니다. 차트 렌더링은 @visactor/vchart를 사용하여 구현됩니다.

설치 (Mac / Linux)

1. Node.js 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.js 설치

# 그런 다음 최신 안정 버전의 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 실행 결과, 중간 파일 저장 및 출력 결과 포함.

visualization_preparation

데이터 시각화를 위한 사전 도구로 두 가지 목적이 있습니다.

데이터 -> 차트

분석에 필요한 데이터(.csv)와 해당 시각화 설명을 데이터에서 추출하여 최종적으로 JSON 구성 파일을 출력합니다.

차트 + 인사이트 -> 차트

기존 차트와 해당 데이터 인사이트를 선택하고, 데이터 주석 형태로 차트에 추가할 데이터 인사이트를 선택하여 최종적으로 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"
}

VMind 구성

LLM

VMind는 지능형 차트 생성을 위해 LLM 호출이 필요합니다. 기본적으로 config.llm["default"] 구성을 사용합니다.

생성 설정

주요 구성에는 차트 크기, 테마 및 생성 방법이 포함됩니다.

생성 방법

기본값: png. 현재 LLM이 컨텍스트에 따라 output_type을 자동으로 선택하는 것을 지원합니다.

크기

기본 크기는 지정되지 않았습니다. HTML 출력의 경우 차트는 기본적으로 전체 페이지를 채웁니다. PNG 출력의 경우 기본값은 1000*1000입니다.

테마

기본 테마: 'light'. VChart는 여러 테마를 지원합니다. 테마를 참조하세요.

테스트

현재, 서로 다른 난이도의