I have just pushed v0.3.0 to Hex. The changes are listed below. I would first like to thank various contributors for their help in improving the library - @srowley in particular has done a lot of work on getting comprehensive in place, putting together the shortcut plotting API and improving the data mapping into plot elements. @Eiji has provided numerous suggestions to tighten up the code, as has @elcritch. @axelson has added a couple of features, has encouraged use of Elixir standard formatting so that it is easier to contribute and gave me a nudge to get this release out the door (I would have liked to have got line plots in first but things happened and there are lots of valuable improvements since the last release). Thanks too, to @tobstarr for the doco fix and @rodrigues for setting up github workflows.

So what’s new? The changelog has the full list, but here are the highlights:

1. The DataSet module can now use a list of maps - this reduces translation work from Ecto output and was really a massive oversight in the original version.
2. Added a short-cut API over the top of the existing API - you can supply the chart type module in Plot.new along with the data and options and have the plot constructed in a single pass, rather than constructing the PlotContent separately and passing it to the Plot to layout.
3. Big improvements to the code quality, e.g in TypeSpecs & for the SVG generation so hopefully others will be able to navigate the codebase a little easier.
4. Various bug fixes. Apologies for the clanger in Sparklines that @jimsynz found !
5. Basic input sanitisation for possible user inputs (e.g. titles, axis labels, category names).

A heads up - there are quite a few changes in master ahead of the next release, including:

• Line Charts (at last)
• All options can be set in new/2 options parameter for each of the chart types
• Other ways of setting options have been marked as deprecated - any feedback on this decision would be appreciated. I know there would be some advantage in maintaining the existing option setting functions to allow a pipeline type interface
• Minimal default style is there so labels show if no CSS is set
• It is now possible to explicitly set scales
• BarChart now has phx-target option for events so it can be used in LiveComponents

The changes are reflected in the accompanying sample project, and are up on the https://contex-charts.org/ website.

You can access these changes prior to release by point the dependency in mix.exs to github:

{:contex, git: "https://github.com/mindok/contex"},

It’s been a while since 0.3.0. We’ve had some great community contributions and although there is still plenty to do, a 0.4.0 was well overdue so I have just pushed an update to hex.

0.4.0 contains the following changes:

• Add SimplePie - a sparkline-like Pie Chart. Thanks @zdenal.
• Add PieChart - a Pie Chart with more control over labels, colour palette, legend generation etc. Thanks @zdenal
• Added LinePlot (finally). And with smooth lines (sounds easy but the maths gets quite tricky and there are still a few overshoots in certain circumstances
• Add target option when setting BarChart event handler.
• Refactor BarChart to honour all options passed in new.
• Refactor PointPlot to honour all options passed in new.
• Refactor GanttChart to honour all options passed in new.
• Provide minimal default style so labels don’t disappear unexpectedly if no CSS is set. Thanks @srowley.
• XML declaration added to generated SVG so the output can be served as an image. Thanks @srowley.
• Custom tick formatting enabled for PointPlot
• Added :custom_value_scale to BarChart to allow overriding of the automatically generated scale
• Added :custom_x_scale and :custom_y_scale to PointPlot to allow overriding of the automatically generated scales
• Make stroke width for LinePlot adjustable through options. Thanks @littleStudent.
• Handle nil values in LinePlot by creating gaps in line.
• Stop crash on timescales when interval clashes with days in month resulting in invalid date. Thanks @imsoulfly.
• Fix colour palette option in GanttChart.

Deprecated

• Most of the options set via functions, e.g. BarChart.colours/2. Use the options in the relevant new functions instead.

Hi all,

Version 0.5.0 of Contex has just been released. Details are in the changelog.

Highlights include:

• A nifty new auto-generated gallery in the documentation. Look out for module names containing Gallery. Thanks to @l3nz for this. Whether you use Context or not, it’s worth taking a look at the code behind it if you want to jazz up your docs. Github user @travelmissive (sorry - can’t find you on Elixir Forums) provided a number of examples.
• New Contex.ContinuousLogScale, again thanks to @l3nz. This was a couple of options for handling negative numbers.
• New legend positioning options
• A couple of various bug fixes, and fixes to tests & docs - thanks @axelson, gh user @kianmeng, gh user @ruimfernanded
• With a nudge from @axelson, I finally got around to figuring out how tagging works, so this version is the first tagged release

Also, CI works now. I thought I’d put this screenshot up as I know I’m not alone!!

image1279×483 60.6 KB

v0.2.0 out now and pushed to hex.

The big news is documentation and type specs, which shouldn’t really be news!

There are notes in the changelog in the git repo, but the main breaking change is a rename of BarPlot to BarChart (more generally acceptable terminology).