How tranhao-wq/forget-chart-python works
Project type and purpose
• This is a lightweight, open-source Python data-visualization tool that renders the Ebbinghaus forgetting curve in 2D/3D (static and animated) and exports GIFs.
File structure
• Top-level
– README.md: project overview, usage, dependencies
• pydata/
– ebbinghaus_curve.py: generates static 2D & 3D plots
– ebbinghaus_curve_animation.py: generates 2D animations (GIF)
– ebbinghaus_curve_animation_3d.py: generates 3D animations (GIF)
No complex subdirectories or microservices—just three CLI entry-points sharing common data and logic.
README for additional insights
• Dependencies: matplotlib, numpy, pillow
• Data: built-in arrays for “labels” (time intervals) and “memory_percent”
• Outputs: on-screen plots and exported GIF files
a. Main components
1. User / CLI Interface
• The “python …py” invocation
2. Data Layer
• Built-in data arrays (labels, memory_percent)
3. Processing Engine
• Memory-retention calculation (Ebbinghaus formula or lookup)
4. Visualization Layer
• Matplotlib plotting modules
– 2D Charting
– 3D Charting (mpl_toolkits.mplot3d)
– Animation (FuncAnimation)
5. I/O / Export Module
• pillow (for saving GIF)
• File system (writes .gif)
b. Relationships and interactions
• User → Script (entry point)
• Script → Data Layer (loads labels & memory values)
• Script → Processing Engine (applies forgetting-curve logic)
• Processing Engine → Visualization Layer (provides numeric series)
• Visualization Layer → I/O Module (display vs .save for GIF)
• I/O Module → File System (writes images/GIFs)
c. Architectural patterns & principles
• Modular separation: data vs compute vs presentation vs I/O
• Single-responsibility: each script focuses on one plot type
• Reuse: common arrays & formula logic across scripts
d. Key technologies & libraries
• Python 3.x
• numpy (numeric arrays)
• matplotlib (plotting, static & animation)
• pillow (image I/O, GIF export)