adding line_color argument for boxplot

Author: jposada202020

circuitpython_uplot/uplot.py

@@ -55,6 +55,7 @@ class Uplot(displayio.Group):
     :param int padding: padding for the plot box in all directions
     :param bool show_box: select if the plot box is displayed
     :param int background_color: background color in HEX. Defaults to black ``0x000000``
+    :param int box_color: allows to choose the box line color. Defaults to white ''0xFFFFFF``
 
     """
 
@@ -67,6 +68,7 @@ def __init__(
         padding: int = 25,
         show_box: bool = True,
         background_color: int = 0x000000,
+        box_color: int = 0xFFFFFF,
     ) -> None:
         if width not in range(50, 481):
             print("Be sure to verify your values. Defaulting to width=100")
@@ -126,7 +128,7 @@ def __init__(
 
         self._plot_palette = displayio.Palette(14)
         self._plot_palette[0] = background_color
-        self._plot_palette[1] = 0xFFFFFF
+        self._plot_palette[1] = box_color
         self._plot_palette[2] = self._tickcolor
         self._plot_palette[3] = self._barcolor
         self._plot_palette[4] = 0x149F14  # Pie Chart color 1
@@ -439,3 +441,17 @@ def show_text(
             text_toplot.anchor_point = anchorpoint
             text_toplot.anchored_position = (x, y)
             self.append(text_toplot)
+
+
+# pylint: disable=missing-class-docstring, too-few-public-methods, invalid-name
+class color:
+    WHITE = 0xFFFFFF
+    BLACK = 0x000000
+    RED = 0xFF0000
+    GREEN = 0x00FF00
+    BLUE = 0x0000FF
+    PURPLE = 0x440044
+    YELLOW = 0xFFFF00
+    ORANGE = 0xFF9933
+    TEAL = 0x158FAD
+    GRAY = 0x808080

docs/quick_start.rst

@@ -33,6 +33,7 @@ Every one of them with different characteristics or graphs.
 
 Options available are:
     * backround_color: Allows to change the background color. The default is black.
+    * box_color: Allows to change the box color. Default is white.
 
 We tell the microcontroller to display our plot:
 
@@ -58,6 +59,7 @@ At the moment the following objects can be added to the plot area:
     * Stackplot
     * Bar graph
     * Pie Chart
+    * Colormap
 * Display_shapes library objects
 * Histograms from the uhistogram library
 * Boxplots from the uboxplot library
@@ -125,6 +127,33 @@ Gridlines are normally off. If you want visible gridlines then use:
     plot.tick_params(tickgrid=True)
 
 
+Colors
+===============
+You can choose some colors directly from the library. This can be done by importing the color class:
+
+.. code-block:: python
+
+    from circuitpython_uplot.uplot import color
+
+This will allow you to use the colors in the list as color variable definitions
+
+    * WHITE
+    * BLACK
+    * RED
+    * GREEN
+    * BLUE
+    * PURPLE
+    * YELLOW
+    * ORANGE
+    * TEAL
+    * GRAY
+
+.. code-block:: python
+
+    plot = Uplot(0, 0, display.width, display.height, background_color=color.WHITE, box_color=color.BLACK)
+
+
+
 ===========
 Cartesian
 ===========

examples/uplot_tickparameters.py

@@ -5,24 +5,34 @@
 import time
 import board
 from ulab import numpy as np
-from circuitpython_uplot.uplot import Uplot
+from circuitpython_uplot.uplot import Uplot, color
+from circuitpython_uplot.ucartesian import ucartesian
+
 
 # Setting up the display
 display = board.DISPLAY
 
 # Setting up the plot area
-plot = Uplot(0, 0, display.width, display.height)
+plot = Uplot(
+    0,
+    0,
+    display.width,
+    display.height,
+    background_color=color.WHITE,
+    box_color=color.BLACK,
+)
 
 # Setting up tick parameters
-plot.tick_params(tickheight=12, tickcolor=0xFF00FF, tickgrid=True)
-
+plot.tick_params(tickheight=12, tickcolor=color.BLACK, tickgrid=True)
 # Seeting some date to plot
 x = np.linspace(-4, 4, num=50)
 constant = 1.0 / np.sqrt(2 * np.pi)
 y = constant * np.exp((-(x**2)) / 2.0)
 
+# Drawing the graph
+ucartesian(plot, x, y, line_color=color.BLACK)
+
 # Plotting and showing the plot
-plot.draw_plot(x, y)
 display.show(plot)
 
 # Adding some wait time