# PyVizAnalysisNote

**Repository Path**: yohoten/py-viz-analysis-note

## Basic Information

- **Project Name**: PyVizAnalysisNote
- **Description**: 本项目是一个全面的 Python 数据可视化分析工具集，包含多个 Jupyter Notebook 教程和代码模板，涵盖了从基础到高级的各种数据可视化技术。通过本工具集，您可以快速掌握主流 Python 可视化库的使用方法，并将数据分析结果以直观、美观的图表形式呈现。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-30
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python 数据可视化分析工具集

[![Gitee](https://img.shields.io/badge/Gitee-仓库链接-c71d23?style=flat&logo=gitee)](https://gitee.com/yohoten/py-viz-analysis-note)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org/)

## 📊 项目简介

本项目是一个全面的 **Python 数据可视化分析工具集**，包含多个 Jupyter Notebook 教程和代码模板，涵盖了从基础到高级的各种数据可视化技术。通过本工具集，您可以快速掌握主流 Python 可视化库的使用方法，并将数据分析结果以直观、美观的图表形式呈现。

**🔗 Gitee 仓库**: https://gitee.com/yohoten/py-viz-analysis-note

## 🎯 核心特性

- ✅ **多库支持**：涵盖 Matplotlib、Seaborn、Pyecharts、Folium、UpSetPlot、Ggplot、Dash Bio 等主流可视化库
- ✅ **循序渐进**：从基础绘图到高级可视化，由浅入深的学习路径
- ✅ **实战案例**：包含真实数据集（警察事件、泰坦尼克号、鸢尾花等）的完整可视化案例
- ✅ **代码模板**：提供 Excel 格式的代码速查模板，方便日常开发参考
- ✅ **交互式图表**：支持静态图表和交互式 Web 可视化

## 📁 项目结构

```
py-viz-analysis-note/
├── 📘 Jupyter Notebook 教程 (notebooks/)
│   ├── 01-matplotlib-basics.ipynb          # Matplotlib 基础入门
│   ├── 02-matplotlib-data-viz.ipynb        # Matplotlib 实战应用
│   ├── 03-seaborn-data-viz.ipynb           # Seaborn 统计可视化
│   ├── 04-pyecharts-data-viz.ipynb         # Pyecharts 交互式图表
│   ├── 05-folium-geospatial.ipynb          # 地图与地理数据可视化
│   ├── 06-upsetplot-viz.ipynb              # 集合关系可视化
│   ├── 07-ggplot-data-viz.ipynb            # Ggplot 风格绘图
│   ├── 08-dash-bioinformatics.ipynb        # 生物信息学专用可视化
│   ├── 09-matplotlib-venn.ipynb            # Venn 图绘制
│   ├── 10-cluster-heatmap.ipynb            # 聚类热图绘制
│   ├── 11-advanced-50-charts.ipynb         # 50+ 高级可视化案例
│   └── 12-pandas-matplotlib.ipynb          # Pandas 与 Matplotlib 结合
│
├── 📋 代码模板（Excel格式, templates/）
│   ├── matplotlib-template.xlsx            # Matplotlib 速查表
│   ├── seaborn-template.xlsx               # Seaborn 速查表
│   └── pandas-template.xlsx                # Pandas 基础操作速查
│
├── 📊 示例数据集 (data/)
│   ├── processed/                          # 处理后的小数据集
│   │   ├── iris.csv                        # 鸢尾花数据集
│   │   ├── titanic.csv                     # 泰坦尼克号乘客数据
│   │   ├── tips.csv                        # 小费数据集
│   │   └── countryenc.npz                  # 国家编码数据
│   ├── examples/                           # 其他示例数据 (13个文件)
│   └── raw/                                # 原始大数据集（需单独下载）
│       └── README 参见 DATASETS.md
│
├── 🖼️ 输出文件 (outputs/, Git忽略)
│   ├── figures/                            # 生成的图表文件 (34个)
│   ├── images/                             # PNG 图片
│   └── maps/                               # HTML 交互地图
│
├── 📚 文档
│   ├── README.md                           # 项目说明
│   ├── QUICKSTART.md                       # 快速开始指南
│   ├── DATASETS.md                         # 数据集获取指南
│   ├── LICENSE                             # MIT 许可证
│   └── PROJECT_STRUCTURE_OPTIMIZATION.md   # 项目结构优化报告
│
├── ⚙️ 配置文件
│   ├── .gitignore                          # Git 忽略配置
│   ├── requirements.txt                    # Python 依赖清单
│   ├── environment.yml                     # Conda 环境配置
│   ├── git-cmd.ps1                         # Git 常用命令脚本（PowerShell）
│   └── git-cheatsheet.md                   # Git 命令速查表
│

└── 📂 其他目录
    ├── assets/                             # 静态资源（参考图、公式图）
    ├── docs/                               # 预留文档目录
    └── scripts/                            # 预留脚本目录
```

## 🚀 快速开始

### 1️⃣ 克隆仓库

```bash
git clone https://gitee.com/yohoten/py-viz-analysis-note.git
cd py-viz-analysis-note
```

### 2️⃣ 安装依赖

**方式 A：使用 pip**
```bash
pip install -r requirements.txt
```

**方式 B：使用 Conda**
```bash
conda env create -f environment.yml
conda activate python-viz-tools
```

### 3️⃣ 启动 Jupyter

```bash
jupyter notebook
```

浏览器会自动打开，进入 `notebooks/` 目录开始学习！

### 4️⃣ 查看教程

推荐学习路径：
- **初学者**: `01-matplotlib-basics.ipynb` → `02-matplotlib-data-viz.ipynb` → `03-seaborn-data-viz.ipynb`
- **进阶用户**: `04-pyecharts-data-viz.ipynb` → `11-advanced-50-charts.ipynb`
- **地理数据**: `05-folium-geospatial.ipynb`

详细指南请查看 [QUICKSTART.md](QUICKSTART.md)

## 📊 数据集说明

本项目包含多个经典数据集，但由于部分文件较大（>10MB），未包含在 Git 仓库中。

**✅ 已包含的数据集**：
- `data/processed/` - Iris, Titanic, Tips 等小数据集
- `data/examples/` - 13个示例数据集

**⚠️ 需单独下载的大数据集**：
- `Police_Department_Incidents_2016.csv` (31 MB)
- `user_orders_hourofday.csv` (19.8 MB)

📖 **详细下载指南**: 请查看 [DATASETS.md](DATASETS.md)

## 📚 文档导航

| 文档 | 说明 |
|------|------|
| [README.md](README.md) | 项目说明（当前文件） |
| [QUICKSTART.md](QUICKSTART.md) | 5分钟快速上手指南 |
| [DATASETS.md](DATASETS.md) | 数据集获取与使用说明 |
| [git-cheatsheet.md](git-cheatsheet.md) | Git 命令速查表 |
| [git-cmd.ps1](git-cmd.ps1) | Git 常用命令脚本（PowerShell） |
| [LICENSE](LICENSE) | MIT 开源许可证 |
| [PROJECT_STRUCTURE_OPTIMIZATION.md](PROJECT_STRUCTURE_OPTIMIZATION.md) | 项目结构优化报告 |

## 🔧 Git 工具使用

本项目提供了两个 Git 辅助工具，帮助您更高效地管理代码版本：

### 📄 git-cheatsheet.md - Git 命令速查表

包含所有常用 Git 命令的快速参考，适合：
- 初学者快速查找命令语法
- 日常开发中快速回顾常用操作
- 解决常见 Git 问题

**使用方法**：直接在项目中打开 [git-cheatsheet.md](git-cheatsheet.md) 查看

### 💻 git-cmd.ps1 - Git 命令脚本（PowerShell）

完整的 PowerShell 脚本文件，包含：
- 12 个类别的 Git 命令（初始化、提交、分支、撤销等）
- 详细的注释说明和使用示例
- Gitee 特定的大文件处理方案
- Notebook 优化技巧

**使用方法**：
```powershell
# 方式1: 直接运行脚本（会显示所有命令）
.\git-cmd.ps1

# 方式2: 复制需要的命令到终端执行
# 打开 git-cmd.ps1，复制所需命令粘贴到 PowerShell
```

### 🎯 推荐工作流

```
# 1. 查看当前状态
git status

# 2. 添加更改
git add .

# 3. 提交更改
git commit -m "描述本次更改"

# 4. 同步远程代码
git pull origin master

# 5. 推送到 Gitee
git push origin master
```

💡 **提示**：遇到 Git 问题时，先查看 [git-cheatsheet.md](git-cheatsheet.md) 中的"常见问题解决"部分！

## 💡 常用技巧

### 清除 Notebook 输出（减小文件大小）
```
pip install nbconvert
jupyter nbconvert --clear-output --inplace notebooks/*.ipynb
```

### 导出为 HTML/PDF
```
# 导出为 HTML
jupyter nbconvert --to html notebooks/01-matplotlib-basics.ipynb

# 导出为 PDF（需要 LaTeX）
jupyter nbconvert --to pdf notebooks/01-matplotlib-basics.ipynb
```

## ❓ 常见问题

### Q1: 中文显示乱码怎么办？
A: Notebook 中已包含中文字体设置代码，确保系统安装了中文字体（如 SimHei、Microsoft YaHei）。

### Q2: Pyecharts 图表不显示？
A: Pyecharts 生成的是 HTML 文件，需要在浏览器中打开。查看 `outputs/maps/` 目录。

### Q3: 如何自定义图表样式？
A: 参考 `assets/references/color-legend-guide.jpg` 颜色和图例速查表。

### Q4: 大数据集加载慢？
A: 使用 Pandas 的 `chunksize` 参数分块读取：
```python
import pandas as pd
chunks = pd.read_csv('data/raw/Police_Department_Incidents_2016.csv', chunksize=10000)
for chunk in chunks:
    process(chunk)
```

## 🔗 相关资源

- **官方文档**:
  - [Matplotlib](https://matplotlib.org/stable/contents.html)
  - [Seaborn](https://seaborn.pydata.org/)
  - [Pyecharts](https://pyecharts.org/)
  - [Folium](https://python-visualization.github.io/folium/)

- **优秀案例**:
  - [Python Graph Gallery](https://python-graph-gallery.com/)
  - [Matplotlib Examples](https://matplotlib.org/stable/gallery/index.html)

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 👨‍💻 作者

**yohoten**

- Gitee: [@yohoten](https://gitee.com/yohoten)
- 邮箱: 12990537+yohoten@user.noreply.gitee.com

---

**⭐ 如果这个项目对您有帮助，欢迎 Star！**

最后更新: 2026-07-30