README.md

---
title: 進階數據可視化工具
emoji: 📊
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.24.0
app_file: app.py
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
# 🎨 進階數據可視化工具

這是一個功能強大且界面友好的數據可視化工具，專為在Hugging Face Spaces上部署而設計。本工具採用現代UI設計，結合智能推薦功能，讓用戶可以輕鬆創建高品質的專業圖表。

![應用截圖](https://i.imgur.com/ph7JXXX.png)

## ✨ 主要特點

- **現代化界面**：簡潔、美觀的用戶界面，提供流暢的使用體驗
- **智能推薦**：自動分析數據結構，推薦最適合的圖表類型和設置
- **多樣化數據輸入**：支持CSV、Excel文件上傳或直接文本輸入
- **豐富的圖表類型**：支持20多種專業圖表，滿足各種可視化需求
- **高度自定義**：
  - 控制圖表尺寸、顏色、網格等外觀
  - 自定義數據聚合方式（計數、求和、平均值等）
  - 豐富的顏色方案和自定義顏色選項
  - 為黑白印刷提供圖案填充功能
- **多格式導出**：支持PNG、SVG、PDF、JPEG格式導出

## 🚀 使用方法

1. **數據輸入**：
   - 上傳CSV或Excel文件，或直接在文本框中粘貼數據
   - 系統會自動添加「計數」列，方便統計分析

2. **智能圖表創建**：
   - 點擊「智能推薦圖表」按鈕，系統會根據您的數據結構自動推薦最適合的圖表設置
   - 或者手動選擇圖表類型並配置參數

3. **自定義圖表**：
   - 選擇顏色方案，或為特定類別設置自定義顏色
   - 添加填充圖案（適用於黑白印刷）
   - 調整圖表尺寸、是否顯示網格和圖例等

4. **導出結果**：
   - 將創建的圖表導出為PNG、SVG、PDF或JPEG格式
   - 可導出原始數據為CSV、Excel或JSON格式

## 🧠 智能推薦功能

系統會自動分析您的數據結構，推薦最適合的：
- 圖表類型（如堆疊長條圖、圓餅圖、折線圖等）
- X軸和Y軸映射
- 分組設置
- 聚合函數

這一功能特別適合不確定哪種圖表最適合您數據的用戶，讓數據可視化變得更加簡單直觀。

## 🎨 自定義顏色功能

- **預設顏色方案**：提供20多種精心設計的顏色方案，包括漸變色、科技感配色等
- **顏色參考面板**：直觀的顏色選擇器，點擊即可複製顏色代碼
- **自定義類別顏色**：為特定數據類別指定顏色，格式為`類別名:#顏色代碼`

## 📊 支持的圖表類型

- 基礎圖表：長條圖、折線圖、圓餅圖、散點圖
- 複合圖表：堆疊長條圖、群組長條圖、多重折線圖
- 特殊圖表：雷達圖、熱力圖、箱型圖、漏斗圖、樹狀圖等
- 科學圖表：直方圖、小提琴圖、極座標圖

## 🔧 技術細節

- 使用Gradio框架構建用戶界面
- 使用Plotly繪製高質量互動式圖表
- 使用Pandas進行數據處理和聚合
- 使用現代CSS技術實現美觀的界面設計

## 📦 安裝與部署

### 在Hugging Face Spaces上部署

1. 在Hugging Face創建新的Space，選擇Gradio作為框架
2. 上傳以下文件：
   - `app.py`：主應用程序代碼
   - `requirements.txt`：依賴庫列表
   - `README.md`：說明文檔

### 本地運行

```bash
pip install -r requirements.txt
python app.py
```

## 📝 使用建議

- 使用「智能推薦」功能作為起點，然後根據需要進行微調
- 對於不同的數據類型，嘗試不同的圖表類型以找到最佳表達方式
- 利用自定義顏色功能使圖表更有辨識度
- 對於需要打印的圖表，考慮使用圖案填充而非僅靠顏色區分