From 5a0ff64403677f6a994d6b578ed7967aaee1cee4 Mon Sep 17 00:00:00 2001
From: Scott Shambaugh <14363975+scottshambaugh@users.noreply.github.com>
Date: Mon, 18 Dec 2023 20:52:46 +0000
Subject: [PATCH] generate animation and add to readme
---
CHANGELOG.md | 2 +-
README.md | 7 +++++++
docs/gen_graphics.py | 4 ++--
docs/trefoil_2d_animation.gif | Bin 0 -> 134104 bytes
4 files changed, 10 insertions(+), 3 deletions(-)
create mode 100644 docs/trefoil_2d_animation.gif
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a0a508f..300e3eb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,13 +9,13 @@
- Flesh out testing of 3D plotting
- 3D take into account roll angle
- Document derivation of offsets
-- Animated stereogram example
- GH release publish to pypi
----
## [Unreleased]
### Added
+* Animation example
### Changed
### Removed
diff --git a/README.md b/README.md
index e647d6e..3a482f9 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,13 @@ axstereo.set_xlabel('X Label')
(line_left, line_right) = axstereo.plot(x, y, z)
```
+### Animations
+See an example of how to use this with matplotlib animations in [docs/gen_graphics:animate_2d_trefoil](docs/gen_graphics.py).
+
+
+
+
+
## Viewing Stereograms
These are not [*auto*stereograms](https://en.wikipedia.org/wiki/Autostereogram), like the "Magic Eye" books that were popular in the 1990's. However, they use the same viewing technique. Below is ChatGPT's how-to guide on viewing these, but I'll try to find a better beginner-friendly resource to put here.
diff --git a/docs/gen_graphics.py b/docs/gen_graphics.py
index bffb933..b7cca9c 100644
--- a/docs/gen_graphics.py
+++ b/docs/gen_graphics.py
@@ -3,7 +3,7 @@
import matplotlib.animation as animation
import matplotlib.pyplot as plt
from pathlib import Path
-from mpl_stereo import AxesStereo2D, AxesStereo3D, AxesAnaglyph, calc_2d_offsets
+from mpl_stereo import AxesStereo2D, AxesStereo3D, AxesAnaglyph, calc_2d_offsets, sort_by_z
N_STEPS = 10
@@ -60,7 +60,7 @@ def animate(frame):
return scatter
ani = animation.FuncAnimation(axstereo.fig, animate, frames=np.arange(N_STEPS), interval=20, repeat=False)
- ani.save(savedir / "trefoil_animation.gif", fps=10, dpi=100)
+ ani.save(savedir / "trefoil_2d_animation.gif", fps=10, dpi=100)
def main():
diff --git a/docs/trefoil_2d_animation.gif b/docs/trefoil_2d_animation.gif
new file mode 100644
index 0000000000000000000000000000000000000000..f35f0fc4acc63d42152e881fe2438ac9802f64f0
GIT binary patch
literal 134104
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