version 0.2.0

Author: matomatical

CHANGELOG.md

@@ -1,19 +1,30 @@
 In development:
 ---------------
 
+TODO
+
+Version 0.2.0:
+--------------
+
 Breaking changes:
 
+* Various argument name changes, especially for colors.
 * Inverted `cyber` colormap.
 * Move `plots.border.Style` to `core.BoxStyle`.
 
 New:
 
 * Configurable background colour for image rendering.
 * 3d scatterplot.
-* New discrete colourmaps `tableau`, `nouveau`.
 * Discrete colourmaps are now cyclic.
+* New discrete colourmaps `tableau`, `nouveau`.
 * New border styles.
 * Export animations as GIFs.
+* New configuration options for bar/column sizes.
+
+Internal:
+
+* Refactor backend to use numpy arrays rather than nested lists.
 
 Version 0.1.2:
 --------------

README.md

@@ -153,6 +153,7 @@ Basic plot arrangement:
 
 Styling plots with colors:
 
+* [ ] Consistent API for color specification.
 * [x] Basic colormaps.
 * [x] BIDS colormaps.
 * [x] Rainbow colormap.
@@ -167,6 +168,7 @@ Rendering:
 Basic code improvements:
 
 * [x] Split up monolithic file into a small number of modules.
+* [ ] Split up plotting module with one file per plot type.
 * [x] Comprehensive type annotations, static type checking with mypy.
 * [ ] Robust input validation and error handling.
 * [ ] Tests.
@@ -183,7 +185,8 @@ Repository:
 
 * [x] Set up project, installable via git.
 * [x] A simple example for the quick-start guide.
-* [x] Version numbering and changelog.
+* [x] Changelog.
+* [ ] Version numbering and keep main branch working.
 * [ ] List on PyPI.
 
 Advanced features roadmap
@@ -197,7 +200,8 @@ More plot types:
   * [ ] Error bars on line plots.
   * [ ] Fill plots.
 * Advanced bar charts:
-  * [ ] Bar/column charts with configurable sizes, spacing, alignment.
+  * [x] Bar/column charts with configurable sizes and spacing.
+  * [ ] Bar/column charts with other alignments.
   * [ ] Negative values in bar/column charts.
 * Hilbert curves:
   * [x] Basic Hilbert curves.
@@ -231,16 +235,14 @@ Advanced rendering:
 
 Back end improvements:
 
-* [ ] Upgrade Char backend to use arrays of codepoints and colors (think
-  PyTrees from JAX to replace the current nested lists of dataclasses).
-* [ ] Vectorised composition operations.
-* [ ] Vectorised bitmap rendering.
-* [ ] Faster and more intelligent ANSI rendering (only include necessary
-  control codes and resets, e.g., if several characters in a row use the same
-  colours).
+* [x] Upgrade Char backend to use arrays of codepoints and colors.
+* [x] Vectorised composition operations.
+* [x] Vectorised bitmap rendering.
+* [x] Intelligent ANSI rendering (only include necessary control codes and
+  resets, e.g., if several characters in a row use the same colours).
 * [ ] Faster animated plot redraws (e.g., differential rendering with shortcut
   `-`).
-* [ ] Consider reactive programming principles.
+* [ ] Clean up backend code e.g. using JAX PyTrees and vectorisation.
 
 More elaborate documentation:
 
@@ -251,6 +253,10 @@ More elaborate documentation:
   (automatically linked to relevant release).
 * [ ] Documentation search.
 
+Future design directions.
+
+* [ ] Reactive plots.
+
 Related work
 ------------
 

examples/braille_test.py

@@ -18,11 +18,6 @@
 print("dot patterns")
 print(dots.astype(int))
 
-braille_codepoints = mpc.braille_encode(dots)
-print("braille codepoints")
-print(braille_codepoints)
-
+braille_chars = mpc.unicode_braille_array(dots)
 print("braille characters")
-for row in braille_codepoints:
-    braille_characters = [chr(int(b)) for b in row]
-    print("".join(braille_characters))
+print(braille_chars.to_ansi_str())

examples/calendar_heatmap.py

@@ -86,11 +86,14 @@ def main():
                     continue
                 date = datetime.date(year, month, day)
                 if date not in DATA:
-                    day_plots.append(mp.text(EMPTY_DAY, color=(0,0,0)))
+                    day_plots.append(mp.text(
+                        EMPTY_DAY,
+                        fgcolor=(0,0,0),
+                    ))
                     continue
                 day_plots.append(mp.text(
                     COUNT_DAY,
-                    color=mp.cyber(1-norm_data[date]),
+                    fgcolor=mp.cyber(1-norm_data[date]),
                     bgcolor=(0,0,0),
                 ))
             week_plots.append(mp.hstack(*day_plots))
@@ -105,6 +108,7 @@ def main():
             year += 1
             month = 1
 
+    # combine
     plot = mp.wrap(*month_plots)
 
     print("printing plot...")

examples/colormaps.py

@@ -11,42 +11,54 @@
 )
 im_continuous = np.zeros((16,16), dtype=float)
 im_continuous[coords[:,0], coords[:,1]] = np.linspace(0.0, 1.0, 256)
-im_discrete = np.zeros((16, 16), dtype=int)
-im_discrete[coords[:,0], coords[:,1]] = np.arange(256) // 16
+im_discrete16 = np.zeros((16, 16), dtype=int)
+im_discrete16[coords[:,0], coords[:,1]] = np.arange(256) // 16
+im_discrete10 = np.zeros((16, 16), dtype=int)
+im_discrete10[coords[:,0], coords[:,1]] = np.arange(256) // 25.6
 
 print("generating plot...")
-plot = (
-    mp.text("test images:")
-    / mp.hstack(
+plot = mp.vstack(
+    mp.text("test images:"),
+    mp.hstack(
         mp.border(
             mp.text("linspace(0,1,256")
             / mp.image(im_continuous),
         ),
         mp.border(
-            mp.text("arange(256)//16")
-            / mp.image(im_discrete / 16),
+            mp.text("arange(256)/16")
+            / mp.image(im_discrete16 / 16),
+        ),
+        mp.border(
+            mp.text("arange(256)/25.6")
+            / mp.image(im_discrete10 / 10),
         )
-    )
-    / mp.text("continuous colormaps:")
-    / mp.wrap(*[
+    ),
+    mp.text("continuous colormaps:"),
+    mp.wrap(*[
         mp.border(
             mp.text(c.__name__)
             / mp.image(im_continuous, colormap=c),
         )
         for c in [
             mp.reds, mp.greens, mp.blues, mp.rainbow,
             mp.yellows, mp.magentas, mp.cyans, mp.cyber,
-            mp.magma, mp.inferno, mp.plasma, mp.viridis,
+            mp.magma, mp.inferno, mp.plasma, mp.viridis
         ]
-    ], cols=4)
-    / mp.text("discrete colormaps:")
-    / mp.wrap(*[
+    ], cols=4),
+    mp.text("discrete colormaps:"),
+    mp.wrap(*[
+        mp.border(
+            mp.text(c.__name__)
+            / mp.image(im_discrete16, colormap=c),
+        )
+        for c in [ mp.sweetie16, mp.pico8 ]
+    ], *[
         mp.border(
             mp.text(c.__name__)
-            / mp.image(im_discrete, colormap=c),
+            / mp.image(im_discrete10, colormap=c),
         )
-        for c in [ mp.sweetie16, mp.pico8, mp.tableau, mp.nouveau, ]
-    ], cols=4)
+        for c in [ mp.tableau, mp.nouveau ]
+    ], cols=4),
 )
 
 print("rendering plot...")