chart-animation

版本：1.0.0

基于时间序列数据生成动态趋势图表，输出 GIF/MP4 动画（深色主题样式）及静态概览图。

使用方法

# 从数据生成动画
chart-animation --data  --output 

# 指定自定义选项
chart-animation --data data.json --output ./output --title "Temperature Trends" --fps 15

数据格式

输入 JSON 应符合以下结构：

{
  "metadata": {
    "generated_at": "2026-06-06",
    "source": "your data source"
  },
  "dates": ["2025-06-01", "2025-06-08", ...],
  "series": {
    "Series A": {
      "values": [12.5, 14.2, ...],
      "color": "#E74C3C"
    },
    "Series B": {
      "values": [15.0, 16.8, ...],
      "color": "#3498DB"
    }
  }
}

输出内容

• /animation.gif
  — 动画图表（GIF 格式）
• /animation.mp4
  — 高质量视频（需系统已安装 ffmpeg）
• /overview.png
  — 静态多面板概览图

功能特性

• 深色主题：采用专业深色背景，适用于演示场景
• 多序列支持：最多支持 4 组数据序列，每组使用独立配色
• 自适应 X 轴：自动格式化日期标签
• 概览图表：以网格布局分别展示各数据序列
• 极值标记：在概览图中标注最小值与最大值

依赖项

• Python 3.8+
• matplotlib
• numpy
• pillow（用于生成 GIF）
• ffmpeg（可选，用于生成 MP4）

安装命令：

pip install matplotlib numpy pillow
# 如需 MP4 支持：
# macOS: brew install ffmpeg
# Ubuntu: sudo apt install ffmpeg

示例

# 生成示例数据
python3 -c "
import json
data = {
  'metadata': {'source': 'example'},
  'dates': ['2025-01', '2025-02', '2025-03', '2025-04'],
  'series': {
    'Revenue': {'values': [100, 120, 115, 140], 'color': '#27AE60'},
    'Cost': {'values': [80, 85, 90, 88], 'color': '#E74C3C'}
  }
}
print(json.dumps(data, indent=2))
" > data.json

# 生成动画
chart-animation --data data.json --output ./charts

命令行选项

注意事项

• 如需显示中文字符，请确保系统已安装字体（例如 "PingFang SC" 或 "SimHei"）
• Y 轴范围由工具根据输入数据自动检测
• 概览图表采用 2×2 网格布局，最多支持 4 组数据序列