Feeds:
Posts
Comments

Archive for the ‘CairoPlot’ Category

Hi there everyone.
Sorry for the long delay on posts and updates, lots of stuff happening.

So, CairoPlot now has a Mailing List as suggested by Yang. It’s actually a GoogleGroup named CairoPlot. Subscription is now open for anyone who’d like to discuss, question or suggest new features.

So… Join now!

Read Full Post »

CairoPlot 1.1

CairoPlot is on GitHub!

CairoPlot now has a Mailing List! For more information, refer to: this post.

v1.1 is out!!

CairoPlot is an API written in Python and uses PyCairo to plot 6 kinds of graphics.
Lots of changes happened since last post, CairoPlot now has a Logo, it’s not just me anymore, we have an all new repository and lots of new functions and options. Read the rest of the post to see all the changes.

LOGO

As you all must’ve seen on the beginning of this text, CairoPlot now has a logo! Actually I did two but I ended up choosing this one. What do you guys think?

CONTRIBUTOR

It’s not just me anymore! I’m happy to say that this release had GREAT help from João S. O. Bueno. It was his idea to change the code into object oriented style which turned out to be a great option for the project.

NEW REPOSITORY

I’d like to apologize to everyone who’s been using v1.0 since June. Many changes happened and no one even knew they were there. By the time the repositories where changed, João had just started helping the project and lots of things were incomplete. After that, one change lead to the other and the only stable release came out now. Again, I’m sorry but I believe you all will be pleased by the changes.
To visit the new repository, just hit CairoPlot Launchpad.

HOW TO DOWNLOAD

CairoPlot is on GitHub!

HOW TO HELP

I believe CairoPlot can grow a lot more, so if you think you can help, please contact me at alf.rodrigo@gmail.com.

NEWS

Now for the exciting ChangeLog.
All the old functions are still supported with some little but important changes.

overall changes

Every chart now has an associated class and a function.
The functions where kept to maintain backward compatibility and allow for easy use of the api.
The classes, however, provide much more customization as access to the cairo context or its surface.
All functions still have the background parameter, but now it supports colors (in tuple form, red = (255, 0, 0)) and Cairo Linear Gradients. The None option is still present and will generate the gray to white gradient of the previous version.

more output options

CairoPlot now outputs images on the following formats: pdf, ps, png and svg thanks to João.

dot_line_plot

Dot Line Plot kept most of its functions but got a little more customizable.

dot_line_plot (name,
               data,
               width,
               height,
               background = None,
               border = 0,
               axis = False,
               grid = False,
               dots = False,
               h_labels = None,
               v_labels = None,
               h_bounds = None,
               v_bounds = None)

dots – new parameter added to determine whether or not the dots are needed;
h_legend and v_legend – got renamed to h_labels and v_labels;
Note: As this function’s been present since the last version, please refer to the latest post for more detailed information.

pie_plot

The old Pizza Plot got renamed and revamped into the all new Pie Plot

pie_plot(name,
           data,
           width,
           height,
           background = None,
           gradient = False,
           shadows = False,
           colors = None)

gradient – Whether or not the slices are painted with gradient colors;
shadows – Now, it’s possible to draw a shadow behind the pie;
colors – And the user can pass a pre-selected list of colors for the slices;
Note: As this function’s been present since the last version, please refer to the latest post for more detailed information.

gantt_chart

No cosmetic changes on this one, but as the rest of the api, it got refactored on OO and the overall changes also apply.

gantt_chart(name,
            pieces,
            width,
            height,
            h_labels,
            v_labels,
            colors)

h_legend and v_legend – got renamed to h_labels and v_labels;
Note: As this function’s been present since the last version, please refer to the latest post for more detailed information.

donut_plot

Used to plot donut graphics.

donu_plot(name,
                data,
                width,
                height,
                background = None,
                gradient = False,
                shadows = False,
                colors = None,
                inner_radius = -1)

name – Name of the desired output file;
data – The list, list of lists or dictionary holding the data to be plotted;
width, height – Dimensions of the output image;
background – A 3 element tuple representing the rgb color expected for the background or a new cairo linear gradient. If left None, a gray to white gradient will be generated;
gradient – Whether or not the slices are painted with gradient colors;
shadows – It’s possible to draw a shadow behind the donut;
colors – Pre-selected list of colors for the slices;
inner_radius – The radius of the donut’s inner circle;

Example of use:

teste_data = {"carl" : 123, "fawn" : 489, "susan" : 890 , "lavon" : 235}
CairoPlot.donut_plot("donut_teste.png", teste_data, 500, 500)

Result:

function_plot

Used to plot function graphics.

function_plot (name,
                    data,
                    width,
                    height,
                    background = None,
                    border = 0,
                    axis = False,
                    grid = False,
                    dots = False,
                    h_labels = None,
                    v_labels = None,
                    h_bounds = None,
                    v_bounds = None,
                    step = 1,
                    discrete = False)

name – Name of the desired output file.;
data – The function to be plotted;
width, height – Dimensions of the output image;
background – A 3 element tuple representing the rgb color expected for the background or a new cairo linear gradient. If left None, a gray to white gradient will be generated;
border – Distance in pixels of a square border into which the graphics will be drawn;
axis – Whether or not the axis are to be drawn;
grid – Whether or not the grids is to be drawn;
dots – new parameter added to determine whether or not the dots are needed;
h_labels, v_labels – lists of strings containing the horizontal and vertical labels for the axis;
h_bounds, v_bounds – tuples containing the lower and upper value bounds for the data to be plotted;
step – the horizontal distance from one point to the other. The smaller, the smoother the curve will be;
discrete – whether or not the function should be plotted in discrete format.

Example of use:

data = lambda x : x**2
CairoPlot.function_plot('function_teste.png', data, 400, 300, grid = True, h_bounds=(-10,10), step = 0.1)

Result:

bar_plot

Used to plot bar graphics.

bar_plot (name,
              data,
              width,
              height,
              background = None,
              border = 0,
              axis = False,
              grid = False,
              dots = False,
              h_labels = None,
              v_labels = None,
              h_bounds = None,
              v_bounds = None,
              step = 1,
              discrete = False)

name – Name of the desired output file.;
data – The function to be plotted;
width, height – Dimensions of the output image;
background – A 3 element tuple representing the rgb color expected for the background or a new cairo linear gradient. If left None, a gray to white gradient will be generated;
border – Distance in pixels of a square border into which the graphics will be drawn;
grid – Whether or not the grids is to be drawn;
rounded_corners – Whether or not the bars should have rounded corners;
three_dimension – Whether or not the bars should be drawn in pseudo 3D;
h_labels, v_labels – lists of strings containing the horizontal and vertical labels for the axis;
h_bounds, v_bounds – tuples containing the lower and upper value bounds for the data to be plotted;
colors – List containing the colors expected for each of the bars.

Examples of use:

data = [3,1,10,2]
CairoPlot.bar_plot ('bar_teste.png', data, 400, 300, border = 20, grid = True, rounded_corners = True)

Result:

REMEMBER!

CairoPlot is on GitHub!

So, I hope you liked it. It’s been a while I’ve been trying to finish this release and I’m very proud of what it has become. Don’t forget to download and test it. In case any bugs surface or if you have any questions or suggestion, don’t be afraid to use the bug tracker or the answers options on the site CairoPlot Launchpad.

Thanks for the interest.

Read Full Post »

This is not anymore the most recent version of the API. Please refer to the newest post.
CairoPlot now has a Mailing List! For more information, refer to: this post.

So, a while ago, I’ve decided to code a library to plot some information I had.

The idea was to create simple graphics in a way they would be easy to create, beautiful and good to present to people with no or few backgrounds on math and computers.

For the ease one creation I, obviously, used Python :D

And, as I was already a PyCairo enthusiast (that began by the time I read Aventuras no cairo by Marcelo Lira and, as pointed out by him, this other one), I decide to use it to draw my graphics.

On this first version, the CairoPlot library provides 3 functions:

dot_line_plot()

Function to plot graphics using dots and lines as seen below.

dot_line_plot (name,
               data,
               width,
               height,
               background = None,
               border = 0,
               axis = False,
               grid = False,
               h_legend = None,
               v_legend = None,
               h_bounds = None,
               v_bounds = None)

name – Name of the desired output file, no need to input the .svg as it will be added at runtim;
data – The list, list of lists or dictionary holding the data to be plotted;
width, height – Dimensions of the output image;
background – A 3 element tuple representing the rgb color expected for the background. If left None, a gray to white gradient will be generated;
border – Distance in pixels of a square border into which the graphics will be drawn;
axis – Whether or not the axis are to be drawn;
grid – Whether or not the gris is to be drawn;
h_legend, v_legend – lists of strings containing the horizontal and vertical legends for the axis;
h_bounds, v_bounds – tuples containing the lower and upper value bounds for the data to be plotted.

Example of Use

teste_data = [0, 1, 3, 8, 9, 0, 10, 10, 2, 1]
CairoPlot.dot_line_plot('teste', teste_data, 400, 300, axis=True)

Result:

dot_line_plot - Example 01

teste_data_2 = {"john" : [10, 10, 10, 10, 30], "mary" : [0, 0, 3, 5, 15], "philip" : [13, 33, 11, 25, 2]}
teste_h_legend = ["jan/2008", "feb/2008", "mar/2008", "apr/2008", "may/2008"]
CairoPlot.dot_line_plot('teste2', teste_data_2, 400, 300, h_legend = teste_h_legend, axis = True, grid = True)

Result:

dot_line_plot - Example 02

pizza_plot()

Function to plot pizza graphics.

pizza_plot(name,
           data,
           width,
           height,
           background = None)

name – Name of the desired output file, no need to input the .svg as it will be added at runtim;
data – The list, list of lists or dictionary holding the data to be plotted;
width, height – Dimensions of the output image;
background – A 3 element tuple representing the rgb color expected for the background. If left None, a gray to white gradient will be generated;

Example of Use

teste_data = {"john" : 123, "mary" : 489, "philip" : 600 , "suzy" : 235}
CairoPlot.pizza_plot("pizza_teste", teste_data, 500, 500)

Result:

gantt_chart()

Function to create Gantt Charts.

Note: the output for this function was based on the graphic seen on this post from wired.

gantt_chart(name,
            pieces,
            width,
            height,
            h_legend,
            v_legend,
            colors)

name – Name of the desired output file, no need to input the .svg as it will be added at runtim;
pieces – A list defining the spaces to be drawn. The user must pass, for each line, the index of its start and the index of its end. If a line must have two or more spaces, they must be passed inside a list;
width, height – Dimensions of the output image;
h_legend – A list of names for each of the vertical lines;
v_legend – A list of names for each of the horizontal spaces;
colors – List containing the colors expected for each of the horizontal spaces.

Example of Use

pieces = [ (0.5,5.5) , [(0,4),(6,8)] , (5.5,7) , (7,8)]
h_legend = [ 'teste01', 'teste02', 'teste03', 'teste04']
v_legend = [ '0001', '0002', '0003', '0004', '0005', '0006', '0007', '0008', '0009', '0010' ]
colors = [ (1.0, 0.0, 0.0), (1.0, 0.7, 0.0), (1.0, 1.0, 0.0), (0.0, 1.0, 0.0) ]
CairoPlot.gantt_chart('gantt_teste', pieces, 600, 300, h_legend, v_legend, colors)

Result:

So, I think it’s ready for you guys to use. CairoPlot Google Code Project
The support is also open :D, whenever you need, feel free to contact at alf.rodrigo@gmail.com or leave a comment.

Read Full Post »

Follow

Get every new post delivered to your Inbox.