feat: add matplotlib example

Author: agoose77

README.md content/README.mdREADME.md renamed to content/README.md

@@ -11,6 +11,10 @@ MyST supports embedding plots from other pages and site! Here are some such plot
 
 ![](#fig-bokeh)
 
+## A Matplotlib Figure
+
+![](#fig-matplotlib)
+
 ## An External Figure!
 
 ![](xref:guide#img:altair-horsepower)

bokeh.md content/bokeh.mdbokeh.md renamed to content/bokeh.md

@@ -0,0 +1,57 @@
+---
+kernelspec:
+  name: python3
+  display_name: Python 3
+---
+
+# Matplotlib
+
+```{code-cell} python3
+import matplotlib.pyplot as plt
+import numpy as np
+
+
+def koch_snowflake(order, scale=10):
+    """
+    Return two lists x, y of point coordinates of the Koch snowflake.
+
+    Parameters
+    ----------
+    order : int
+        The recursion depth.
+    scale : float
+        The extent of the snowflake (edge length of the base triangle).
+    """
+    def _koch_snowflake_complex(order):
+        if order == 0:
+            # initial triangle
+            angles = np.array([0, 120, 240]) + 90
+            return scale / np.sqrt(3) * np.exp(np.deg2rad(angles) * 1j)
+        else:
+            ZR = 0.5 - 0.5j * np.sqrt(3) / 3
+
+            p1 = _koch_snowflake_complex(order - 1)  # start points
+            p2 = np.roll(p1, shift=-1)  # end points
+            dp = p2 - p1  # connection vectors
+
+            new_points = np.empty(len(p1) * 4, dtype=np.complex128)
+            new_points[::4] = p1
+            new_points[1::4] = p1 + dp / 3
+            new_points[2::4] = p1 + dp * ZR
+            new_points[3::4] = p1 + dp / 3 * 2
+            return new_points
+
+    points = _koch_snowflake_complex(order)
+    x, y = points.real, points.imag
+    return x, y
+```
+
+```{code-cell} python3
+:name: fig-matplotlib
+x, y = koch_snowflake(order=5)
+
+plt.figure(figsize=(8, 8))
+plt.axis('equal')
+plt.fill(x, y)
+plt.show()
+```

index.md content/index.mdindex.md renamed to content/index.md

@@ -6,9 +6,10 @@ project:
   references:
     guide: https://mystmd.org/guide
   toc:
-    - file: index.md
-    - file: bokeh.md
-    - file: plotly.md
+    - file: content/index.md
+    - file: content/bokeh.md
+    - file: content/plotly.md
+    - file: content/matplotlib.md
 site:
   template: book-theme
   options:

content/matplotlib.md

@@ -2,5 +2,7 @@ scipy
 numpy
 plotly
 bokeh
+matplotlib
+
 jupyter-server
 ipykernel