Skip to content

Latest commit

 

History

History
55 lines (36 loc) · 1.2 KB

README.markdown

File metadata and controls

55 lines (36 loc) · 1.2 KB
Raw

C2PO Ruby language bindings

C2PO is a grammar of graphics implementation inspired by Hadley Wickham's ggplot2 library. This Rubygem uses the free online C2PO compiler and is limited to 1 MB of data. Plot specifications are compiled directly to an SVG string, which is returned:

require 'c2po'

#Make some random data:
data = 20.times.collect do
  {:a => 10*rand, :b => 5*rand}
end

#Specify a simple scatterplot graphic:
scatterplot_spec = {
  :data => data,
  :geom => :point,
  :mapping => {:x => :a, :y => :b}}

#Render an SVG string:
C2PO.render scatterplot_spec
  #=> '<svg height="660" width="660" ...'

Install

For the plain client library, run

gem install c2po

or add

c2po, "0.0.1"

to your Gemfile.

If you want to learn the grammar and work interactively with the examples in /examples, just clone this repo:

git clone https://github.com/keminglabs/c2po-ruby

install the deps:

cd examples
bundle install

then run:

bundle exec guard

to launch a live-reloading web server on localhost:3000 for displaying graphics. Walk through and execute the example code in examples/1-usage.rb to get started.