Mandarancio Charter Save
DSL and C Library to generate SVG Plot
CHARTER
A simple markdown DSL and C Library to generate svg and pgfplot (LaTeX) plot from a minimal syntax.
Example
Few examples are available in the gallery page of the wiki.
Simple syntax example:
title: reconstruction error vs compression
x-axis:
label: compression
mode: log
y-axis:
label: mse
plot:
x: 1 10 100
y: 0 0.01 0.05
label: f_avg
marker: s
ls: --
Resutls in:
Note: as the image is an svg the rendering of it is browser dependent.
DSL Syntax
| syntax | description |
|---|---|
plot |
create a new line plot |
scatter |
create a new scatter plot |
bar |
create a new bar plot |
x-axis |
parameters for the x axis |
y-axis |
parameters for the y axis |
label |
label for axis or plot |
x |
x values of a plot |
y |
y values of a plot |
color |
colour of a plot |
line-width or lw |
plot line width |
line-style or ls |
plot line style ('--' or 'dashed', '-' or 'normal', ':' or dotted, '/' or 'none') |
bar-width or bw |
bar plot width |
line-color |
bar plot line color |
marker |
marker style of a plot ('o', 'x', '+', 's', ' ') |
range |
min and max value for an axis |
mode |
axis mode ('linear' or 'log') |
title |
plot title |
width |
plot width |
height |
plot height |
csv://file_path#tag |
load a csv and use column tag as values |
range: min max nstep |
linear range to use as values |
logrange: min max nstep |
log range to use as values |
math: f(x) |
math expression based on x to use as y value |
commas and spaces are valid separator for arrays and the sytax in general.
For the definitions spaces, tabs and : are equivalents. So x: 1 2 3 is equal to x 1,2,3.
Use as a library
if you want to include charter as a library here a simple example
#include "charter/parser.h"
#include "charter/renderer.h"
\***
* YOUR CODE
***\
chart * parsed = parse_chart(string_to_parse);
/* chart is the structure you can also create it programmatically in your code
and render it to svg using chart_to_svg */
char * svg = chart_to_svg(parsed);
chart_free(parsed);
\***\
Use as SVG generator
The build process generate as well an executable: charter. It is capable of generate an svg plot from a charter dsl file:
charter your_dsl_file > output.svg
Build and install
Use meson and ninja:
mkdir build
cd build
meson ..
ninja
sudo ninja install
Future improvements
In the next future I will improve the svg quality, the memory performance, and the look and feel of the output plus the following features:
- more options on grid
- more styling options
- better typesettings
Marker integration
At the moment charter is integrated in Marker!
Credits
Open Source Agenda Badge
