matrix-heatmap/README.md

矩阵热力图可视化工具

一个简单、直观的网页工具，用于将矩阵数据（NumPy .npy 或 CSV 格式）可视化为交互式热力图，帮助您更好地理解数据分布模式。

✨ 功能特点

• 多格式支持：兼容 NumPy (.npy) 和 CSV 格式文件
• 灵活的数据输入：支持文件上传、拖放或直接粘贴 CSV 格式数据
• 交互式体验：悬停查看详细数值，支持缩放和平移操作
• 双视图模式：可在热力图视图和表格视图之间切换
• 数据导出：支持将热力图下载为 PNG 图片
• 响应式设计：适配各种屏幕尺寸，从手机到桌面设备
• 深色/浅色模式：根据偏好或环境切换显示主题

🚀 快速开始

1. 访问 在线工具 或克隆本仓库后在本地打开 index.html
2. 通过以下任一方式提供数据：
   • 拖放 .npy 或 .csv 文件到指定区域
   • 点击"选择文件"按钮上传数据
   • 点击"粘贴CSV数据"并输入矩阵数据
   • 点击"使用示例数据"查看演示效果
3. 自动生成热力图，可交互查看详细信息
4. 可切换至表格视图查看原始数据
5. 需要时可下载热力图为 PNG 图片

📋 使用说明

数据格式要求

• CSV 文件：纯数值矩阵，每行代表矩阵的一行，元素之间用逗号分隔，不包含表头
• NumPy 文件：保存为 .npy 格式的二维数组
• 粘贴数据：与 CSV 格式相同的文本内容

界面说明

• 上传区域：用于导入数据的主要区域
• 文件信息区：显示当前加载的文件信息和数据预览
• 热力图区：可视化展示区域，支持交互操作
• 控制面板：提供视图切换和导出功能
• 统计信息：显示矩阵大小、最大值和最小值

🛠️ 本地开发

1. 克隆本仓库：

   git clone https://github.com/feng-arch/matrix-heatmap.git
   

2. 进入项目目录：

   cd matrix-heatmap
   

3. 直接在浏览器中打开 index.html 文件即可运行

🤝 贡献指南

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

📧 联系我们

如有任何问题或建议，请通过以下方式联系我们：

• GitHub: @your-username
• Email: feng-arch@outlook.com

---

希望这个工具能帮助您更好地理解和分析矩阵数据！如果您觉得它有用，请给我们一个 ⭐ 支持一下。