adding koch example

Author: jposada202020

.gitignore

@@ -14,3 +14,4 @@ _build
 .vscode
 *~
 mpy-cross
+.ipynb_checkpoints

circuitpython_uplot/plot.py

@@ -346,7 +346,7 @@ def _draw_ticks(self, x: int, y: int, ticksx=None, ticksy=None) -> None:
                 self.show_text(
                     "{:.{}f}".format(ticksxnorm[i], self._decimal_points),
                     tick,
-                    self._newymin,
+                    self._newymin + 5,
                     (0.5, 0.0),
                 )
         for i, tick in enumerate(ticksyrenorm):
@@ -361,7 +361,7 @@ def _draw_ticks(self, x: int, y: int, ticksx=None, ticksy=None) -> None:
             if self._showtext:
                 self.show_text(
                     "{:.{}f}".format(ticksynorm[i], self._decimal_points),
-                    self._newxmin,
+                    self._newxmin - 5,
                     tick,
                     (1.0, 0.5),
                 )
@@ -546,3 +546,10 @@ class color:
     ORANGE = 0xFF9933
     TEAL = 0x158FAD
     GRAY = 0x808080
+    PINK = 0xFF40C0
+    LIGHT_GRAY = 0xAAAAAA
+    BROWN = 0xCA801D
+    DARK_GREEN = 0x008700
+    TURQUOISE = 0x00C0C0
+    DARK_BLUE = 0x0000AA
+    DARK_RED = 0x800000

docs/examples.rst

@@ -184,7 +184,15 @@ Cartesian animation example
 .. image:: ../docs/cartesian_logging_data.gif
 
 
+Cartesian Koch Snowflake
+---------------------------
+
+Cartesian koch snowflake example
 
+.. literalinclude:: ../examples/cartesian_koch.py
+    :caption: examples/cartesian_koch.py
+    :lines: 5-
+.. image:: ../docs/koch.jpg
 
 ==================
 Bar Examples

docs/koch.jpg

@@ -180,6 +180,14 @@ This will allow you to use the colors in the list as color variable definitions
     * ORANGE
     * TEAL
     * GRAY
+    * PINK
+    * LIGHT_GRAY
+    * BROWN
+    * DARK_GREEN
+    * TURQUOISE
+    * DARK_BLUE
+    * DARK_RED
+
 
 .. code-block:: python
 
@@ -264,10 +272,10 @@ And needs to be defined in the first cartesian graph added to the plot.
 Line styles
 ============
 You can select the line style of your Cartesian graph. The following line styles are available:
-    * LineStyle.SOLID
-    * LineStyle.DOTTED
-    * LineStyle.DASHED
-    * LineStyle.DASH_DOT
+    * SOLID
+    * DOTTED
+    * DASHED
+    * DASH_DOT
 
 This can be done by importing the color class, from the cartesian library:
 
@@ -345,10 +353,10 @@ There are some parameters that you can customize:
 Pointer styles
 ==============
 You can select the pointer style of your Scatter graph. The following pointer styles are available:
-    * Pointer.CIRCLE
-    * Pointer.SQUARE
-    * Pointer.TRIANGLE
-    * Pointer.DIAMOND
+    * CIRCLE
+    * SQUARE
+    * TRIANGLE
+    * DIAMOND
 
 This can be done by importing the color class, from the cartesian library:
 

docs/quick_start.rst

@@ -0,0 +1,63 @@
+# SPDX-FileCopyrightText: Copyright (c) 2023 Jose D. Montoya
+#
+# SPDX-License-Identifier: MIT
+
+# Example adapted to use in CircuitPython and Microplot from
+# https://github.com/TheAlgorithms/Python/blob/master/fractals/koch_snowflake.py
+# License MIT
+
+import board
+from circuitpython_uplot.plot import Plot
+from circuitpython_uplot.cartesian import Cartesian
+from ulab import numpy
+
+
+def iterate(initial_vectors: list[numpy.ndarray], steps: int) -> list[numpy.ndarray]:
+    vectors = initial_vectors
+    for _ in range(steps):
+        vectors = iteration_step(vectors)
+    return vectors
+
+
+def iteration_step(vectors: list[numpy.ndarray]) -> list[numpy.ndarray]:
+    new_vectors = []
+    for i, start_vector in enumerate(vectors[:-1]):
+        end_vector = vectors[i + 1]
+        new_vectors.append(start_vector)
+        difference_vector = end_vector - start_vector
+        new_vectors.append(start_vector + difference_vector / 3)
+        new_vectors.append(
+            start_vector + difference_vector / 3 + rotate(difference_vector / 3, 60)
+        )
+        new_vectors.append(start_vector + difference_vector * 2 / 3)
+    new_vectors.append(vectors[-1])
+
+    return new_vectors
+
+
+def rotate(vector: numpy.ndarray, angle_in_degrees: float) -> numpy.ndarray:
+    theta = numpy.radians(angle_in_degrees)
+    c, s = numpy.cos(theta), numpy.sin(theta)
+    rotation_matrix = numpy.array(((c, -s), (s, c)))
+    return numpy.dot(rotation_matrix, vector)
+
+
+# Setting up the display
+display = board.DISPLAY
+plot = Plot(0, 0, 200, 200, padding=0)
+
+# initial triangle of Koch snowflake
+VECTOR_1 = numpy.array([0, 0])
+VECTOR_2 = numpy.array([0.5, 0.8660254])
+VECTOR_3 = numpy.array([1, 0])
+INITIAL_VECTORS = [VECTOR_1, VECTOR_2, VECTOR_3, VECTOR_1]
+# uncomment for simple Koch curve instead of Koch snowflake
+# INITIAL_VECTORS = [VECTOR_1, VECTOR_3]
+
+# Due to memory restrictions the maximum number of iterations is 3.
+processed_vectors = iterate(INITIAL_VECTORS, 3)
+x_coordinates, y_coordinates = zip(*processed_vectors)
+
+# Adding the Cartesian plot
+Cartesian(plot, x_coordinates, y_coordinates)
+display.show(plot)