Roadmap

Roadmap to version 1

Basic plot types:

• Scatter plots.
• Line plots (connect the dots).
• Image plots / matrix heatmaps.
• Function heatmap plots.
• Progress bars.
• Basic bar charts and column charts.
• Histograms.

Basic plot furnishings:

• Basic text boxes.
• Borders.
• Axis ticks and tick labels for scatter plots.
• Axis labels and titles.
• Labels and ticks for bar/column charts and histograms.

Basic plot arrangement:

• Horizontal and vertical stacking.
• Naive layering plots on top of each other.
• Automatically wrapping plots into a grid.
• Finalise operator assignment.

Styling plots with colors:

• Basic colormaps.
• BIDS colormaps.
• Rainbow colormap.
• Cyberpunk colormap.
• Discrete colour palettes.

Specifying colors:

• Consistent API for color specification.
• Configurable colour scales and normalisation.
• Color bars, vertical or horizontal.

Rendering:

• Render to string / terminal with ANSI control codes.
• Export to image with pixel font.

Basic code improvements:

• Split up monolithic file into a small number of modules.
• Split up plotting module with one file per plot type.
• Comprehensive type annotations, static type checking with mypy.
• Robust input validation and error handling.

Testing:

• Unit tests for core modules (colors, colormaps, data, core).
• Integration smoke tests (all examples run).
• Snapshot testing for str output and image output regression detection.

Documentation:

• Minimal docstrings for everything user-facing.
• Quick start guide.
• Complete docstrings for modules, constants, etc.
• Simple generated markdown documentation on GitHub.
• Simple generated HTML/CSS documentation, hosted on web.

Repository:

• Set up project, installable via git.
• A simple example for the quick-start guide.
• Changelog.
• Version numbering and keep main branch working.
• List on PyPI.

Advanced features roadmap

More plot types:

• Advanced scatter plots:
  • Different colours for each point.
  • Multiple point clouds on a single scatter plot.
  • 3d scatter plots.
• Advanced line plots:
  • Error bars on line plots.
  • Fill plots.
• Advanced bar charts:
  • Bar/column charts with configurable sizes and spacing.
  • Bar/column charts with other alignments.
  • Bar/column charts with individual colours.
  • Negative values in bar/column charts.
• Hilbert curves:
  • Basic Hilbert curves.
  • Non-square Hilbert curves.
  • 3d Hilbert curves.
• World maps:
  • Some 2d projections.
  • 3d globe projection.
• Other:
  • Calendar heatmap plots (see calendar heatmap example for now).
  • Candlestick plots.
  • Box plots.

Advanced plot arrangement:

• Better support for animated plots (API needs thought).

Advanced furnishings:

• Axis transformations (e.g. logarithmic scale).
• Legend construction (API needs thought).
• Text embedded in borders.

Advanced rendering:

• Export animations to gifs.
• Render plots to SVG (keep console aesthetic).
• Render plots to PDF (keep console aesthetic).

Back end improvements:

• Upgrade Char backend to use arrays of codepoints and colors.
• Vectorised composition operations.
• Vectorised bitmap rendering.
• 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 -).
• Clean up backend code e.g. using JAX PyTrees and vectorisation.

More elaborate documentation:

• Tutorials and recipes.
• Freeze documentation with each version.
• Links to source code from within documentation.
• Links to mentioned functions/classes/methods/types within documentation (automatically linked to relevant release).
• Documentation search.

Future design directions.

• Reactive plots.

Related work

Matthewplotlib aspires to achieve a similar levels of functionality as covered by the following projects.

Terminal plotting in Python:

• Plotext: https://github.com/piccolomo/plotext
• Plotille: https://github.com/tammoippen/plotille
• Termgraph: https://github.com/sgeisler/termgraph
• Termplot: https://github.com/justnoise/termplot

Terminal plotting in other languages:

• Julia https://github.com/JuliaPlots/UnicodePlots.jl
  • See also https://github.com/sunetos/TextPlots.jl
• C++ https://github.com/fbbdev/plot
• R https://github.com/cheuerde/plotcli
  • See also https://github.com/bbnkmp/txtplot/ and https://github.com/geotheory/r-plot
• GNU plot (dumb terminal mode) http://gnuplot.info/docs_6.0/loc19814.html

Braille art:

• Drawille (Python): https://github.com/asciimoo/drawille
• Rsille (Rust): https://github.com/nidhoggfgg/rsille
• Drawille (Lua): https://github.com/asciimoo/lua-drawille
• Drawille (NodeJS): https://github.com/madbence/node-drawille
• Python repo documents ports to various other languages

TODO: Checklist of specific interesting target features that are and are not implemented.

Other Python plotting libraries, most of which offer some level of interactivity that there are no plans to replicate.

• Matplotlib https://github.com/matplotlib/matplotlib
• Seaborn https://github.com/mwaskom/seaborn
• Plotly.py https://github.com/plotly/plotly.py
• Pygal https://github.com/Kozea/pygal
• Bokeh https://github.com/bokeh/bokeh
• Altair https://github.com/vega/altair
  • Declarative API
• plotnine https://github.com/has2k1/plotnine
  • Compose subplots with | and /