plotrb 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1cb130ede17a9ef0b2319d7eb472b67ee2e69faf
+  data.tar.gz: 94c59902102147772878189ef8fbde5f4d688adc
+SHA512:
+  metadata.gz: e144eba4faaa1d534d6359d0e85fd983e90002766bff821a2b20dffbb51bc8cf9410cd1db48606fe264b691bb217decf38946cce9a7c6ccefeae3292788cc1b9
+  data.tar.gz: 462e9b417011f6b2c58dbd10c4a4d3e87e2bfc0978f772e9dc942d43b483d713a12ea40d711f5b55e301feb4fbe8c9b3185c9da11777cbd01b68c769b7c42108

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.idea
+.DS_Store

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,38 @@
+This version of Plotrb is licensed under the BSD 2-clause license.
+
+* http://sciruby.com
+* http://github.com/sciruby/sciruby/wiki/License
+
+You *must* read the Contributor Agreement before contributing code to
+the SciRuby Project. This is available online:
+
+* http://github.com/sciruby/sciruby/wiki/Contributor-Agreement
+
+-----
+
+Copyright (c) 2010 - 2013, Wan Zuhao and the Ruby Science Foundation
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+* Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/README.rdoc

@@ -0,0 +1,77 @@
+= Plotrb
+
+Vega/D3-based plotting gem for Ruby
+
+* {sciruby.com}[http://sciruby.com]
+* {Google+}[https://plus.google.com/109304769076178160953/posts]
+* {Wan Zuhao}[http://www.wanzuhao.com]
+* {Examples on bl.ocks.org}[http://bl.ocks.org/zuhao]
+
+{<img src=https://travis-ci.org/zuhao/plotrb.png>}[https://travis-ci.org/zuhao/plotrb]
+
+== Description
+
+Plotrb is an experimental plotting library for the Ruby language. It
+brings {the simplicity of Vega}[http://trifacta.github.io/vega/] and
+{the power of D3}[http://d3js.org/] to the Ruby science community, to
+allow for {fast, customizable design; reusability and shareability; programmatic generation of visualizations; and improved performance and platform flexibility}[https://github.com/trifacta/vega/wiki/Vega-and-D3].
+
+Plotrb is in many ways the child of
+{Rubyvis}[http://github.com/SciRuby/rubyvis] (the Ruby port of
+Protovis). However, it improves upon Rubyvis in that it uses a DSL that
+will be much more familiar and natural to Ruby coders.
+
+Plotrb was created by Wan Zuhao as part of Google's Summer of Code 2013.
+It is part of {SciRuby}[http://sciruby.com].
+
+== Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'plotrb'
+
+And then execute:
+
+    bundle
+
+Or install it yourself as:
+
+    gem install plotrb
+
+== Usage
+
+Currently, Plotrb is intended to generate JSON specification for Vega. If you would like to see the visualization rendered in PNG or SVG, you will have to install {Vega}[https://github.com/trifacta/vega] and use its {Headless Mode}[https://github.com/trifacta/vega/wiki/Headless-Mode].
+
+Note that Plotrb is a work in progress, so we can't guarantee that every
+example will work exactly.
+
+* {Arc}[http://bl.ocks.org/zuhao/6663966]
+* {Area}[http://bl.ocks.org/zuhao/6663999]
+* {Bar}[http://bl.ocks.org/zuhao/6662333]
+* {Barley}[http://bl.ocks.org/zuhao/6664828]
+* {Lifelines}[http://bl.ocks.org/zuhao/6664107]
+
+Examples may also be found in the `examples/` directory.
+
+== Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+== License
+
+Copyright (c) 2013, Wan Zuhao and the Ruby Science Foundation.
+
+All rights reserved.
+
+Plotrb, along with SciRuby, is licensed under the BSD 2-clause license. See
+{LICENSE.txt}[https://github.com/SciRuby/sciruby/wiki/License] for details.
+
+== Donations
+
+Support a SciRuby Fellow:
+
+{<img src=http://pledgie.com/campaigns/15783.png?skin_name=chrome>}[http://www.pledgie.com/campaigns/15783]

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec

data/examples/arc.rb

@@ -0,0 +1,31 @@
+require 'plotrb'
+
+data = pdata.name('table').values([12,23,47,6,52,19]).transform(pie_transform)
+
+scale = sqrt_scale.name('r').from(data).to([20,100])
+
+mark = arc_mark.from(data) do
+  enter do
+    x_start { group(:width).times(0.5) }
+    y_start { group(:height).times(0.5) }
+    start_angle { from :start_angle }
+    end_angle { from :end_angle }
+    inner_radius 20
+    outer_radius { scale(scale) }
+    stroke '#fff'
+  end
+  update do
+    fill '#ccc'
+  end
+  hover do
+    fill 'pink'
+  end
+end
+
+vis = visualization.name('arc').width(400).height(400) do
+  data data
+  scales scale
+  marks mark
+end
+
+puts vis.generate_spec(:pretty)

data/examples/area.rb

@@ -0,0 +1,48 @@
+require './lib/plotrb.rb'
+
+data = pdata.name('table').values(
+	[
+        {x: 1,  y: 28}, {x: 2,  y: 55},
+        {x: 3,  y: 43}, {x: 4,  y: 91},
+        {x: 5,  y: 81}, {x: 6,  y: 53},
+        {x: 7,  y: 19}, {x: 8,  y: 87},
+        {x: 9,  y: 52}, {x: 10, y: 48},
+        {x: 11, y: 24}, {x: 12, y: 49},
+        {x: 13, y: 87}, {x: 14, y: 66},
+        {x: 15, y: 17}, {x: 16, y: 27},
+        {x: 17, y: 68}, {x: 18, y: 16},
+        {x: 19, y: 49}, {x: 20, y: 15}
+    ]
+)
+
+xs = linear_scale.name('x').from('table.x').to_width.exclude_zero
+ys = linear_scale.name('y').from('table.y').to_height.nicely
+
+xa = x_axis.scale(xs).ticks(20)
+ya = y_axis.scale(ys)
+
+mark = area_mark.from(data) do
+	enter do
+		interpolate :monotone
+		x_start {from('x').scale(xs)}
+		y_start {from('y').scale(ys)}
+		y_end {value(0).scale(ys)}
+		fill 'steelblue'
+	end
+	update do
+		fill_opacity 1
+	end
+	hover do
+		fill_opacity 0.5
+	end
+end
+
+vis = visualization.name('area').width(500).height(200) do
+	padding :top => 10, :left => 30, :bottom => 30, :right => 10
+	data data
+	scales xs, ys
+	axes xa, ya
+	marks mark
+end
+
+puts vis.generate_spec(:pretty)

data/examples/bar.rb

@@ -0,0 +1,44 @@
+require 'plotrb'
+
+data = pdata.name('table').values(
+    [
+      {x: 1,  y: 28}, {x: 2,  y: 55},
+      {x: 3,  y: 43}, {x: 4,  y: 91},
+      {x: 5,  y: 81}, {x: 6,  y: 53},
+      {x: 7,  y: 19}, {x: 8,  y: 87},
+      {x: 9,  y: 52}, {x: 10, y: 48},
+      {x: 11, y: 24}, {x: 12, y: 49},
+      {x: 13, y: 87}, {x: 14, y: 66},
+      {x: 15, y: 17}, {x: 16, y: 27},
+      {x: 17, y: 68}, {x: 18, y: 16},
+      {x: 19, y: 49}, {x: 20, y: 15}
+    ]
+)
+
+xs = ordinal_scale.name('x').from('table.x').to_width
+ys = linear_scale.name('y').from('table.y').nicely.to_height
+
+mark = rect_mark.from(data) do
+  enter do
+    x_start   { scale(xs).from('x') }
+    width     { scale(xs).offset(-1).use_band }
+    y_start   { scale(ys).from('y') }
+    y_end     { scale(ys).value(0) }
+  end
+  update do
+    fill 'steelblue'
+  end
+  hover do
+    fill 'red'
+  end
+end
+
+vis = visualization.width(400).height(200) do
+  padding top: 10, left: 30, bottom: 30, right: 10
+  data data
+  scales xs, ys
+  marks mark
+  axes x_axis.scale(xs), y_axis.scale(ys)
+end
+
+puts vis.generate_spec(:pretty)

data/examples/barley.rb

@@ -0,0 +1,66 @@
+require './lib/plotrb.rb'
+
+raw_data = pdata.name('barley').url('barley_data.json')
+variety = pdata.name('variety').source('barley').transform [
+	facet_transform.keys('variety'),
+	stats_transform.value('yield').median,
+	sort_transform.by('-median')
+]
+site = pdata.name('site').source('barley').transform [
+	facet_transform.keys('site'),
+	stats_transform.value('yield').median,
+	sort_transform.by('-median')
+]
+
+gs = ordinal_scale.name('g').padding(0.15).from('site.key').to_height
+xs = linear_scale.name('x').from('barley.yield').to_width.nicely
+cs = ordinal_scale.name('c').to_colors
+ys = ordinal_scale.name('y').from('variety.key').to_height.as_points.padding(1.2)
+xaxis = x_axis.scale(xs).offset(-12)
+yaxis = y_axis.scale(ys).tick_size(0) do
+  properties(:axis) { stroke :transparent }
+end
+
+
+tm = text_mark.from(site) do
+  enter do
+    x { group(:width).times(0.5) }
+    y { scale(gs).field(:key).offset(-2) }
+    font_weight :bold
+    text { field(:key) }
+    align :center
+    baseline :bottom
+    fill '#000'
+  end
+end
+
+sm = symbol_mark.enter do
+  x { scale(xs).field('yield') }
+  y { scale(ys).field('variety') }
+  size 50
+  stroke { scale(cs).field('year') }
+  stroke_width 2
+end
+
+gm = group_mark.from(site) do
+  scales ys
+  axes yaxis
+  marks sm
+  enter do
+    x 0.5
+    y { scale(gs).field(:key) }
+    height { scale(gs).use_band }
+    width { group(:width) }
+    stroke '#ccc'
+  end
+end
+
+vis = visualization.width(200).height(720) do
+  data raw_data, variety, site
+  scales gs, cs, xs, ys
+  axes xaxis
+  marks tm, gm
+end
+
+puts vis.generate_spec(:pretty)
+

data/examples/choropleth.rb

@@ -0,0 +1,48 @@
+require './lib/plotrb.rb'
+
+ump_data = pdata.name('unemp') do
+	url('unemployment.tsv')
+	format(:tsv) { parse :rate => :number }
+end
+cty_data = pdata.name('counties') do
+	url('us-10m.json')
+	format(:topojson) { feature 'counties' }
+	transform [
+		geopath_transform.projection(:albersUsa),
+		zip_transform.with('unemp').match('id').against('id').as('value').default(nil),
+		filter_transform.test('d.path!=null && d.value!=null')
+	]
+end
+
+cs = quantize_scale.name('color').from([0, 0.15]).to(
+	[
+		"#f7fbff",
+    "#deebf7",
+    "#c6dbef",
+    "#9ecae1",
+    "#6baed6",
+    "#4292c6",
+    "#2171b5",
+    "#08519c",
+    "#08306b"
+  ])
+
+mark = path_mark.from(cty_data) do
+	enter do
+		path { from 'path' }
+	end
+	update do
+		fill { scale(cs).from('value.data.rate') }
+	end
+	hover do
+		fill 'red'
+	end
+end
+
+vis = visualization.width(960).height(500) do
+	data ump_data, cty_data
+	scales cs
+	marks mark
+end
+
+puts vis.generate_spec(:pretty)

data/examples/lifelines.rb

@@ -0,0 +1,106 @@
+require './lib/plotrb.rb'
+
+people = pdata.name('people').values(
+  [
+    {"label" => "Washington",
+    "born" => -7506057600000,
+    "died" => -5366196000000,
+    "enter" => -5701424400000,
+    "leave" => -5453884800000},
+    {"label" => "Adams",
+    "born" => -7389766800000,
+    "died" => -4528285200000,
+    "enter" => -5453884800000,
+    "leave" => -5327740800000},
+    {"label" => "Jefferson",
+    "born" => -7154586000000,
+    "died" => -4528285200000,
+    "enter" => -5327740800000,
+    "leave" => -5075280000000},
+    {"label" => "Madison",
+    "born" => -6904544400000,
+    "died" => -4213184400000,
+    "enter" => -5075280000000,
+    "leave" => -4822819200000},
+    {"label" => "Monroe",
+    "born" => -6679904400000,
+    "died" => -4370518800000,
+    "enter" => -4822819200000,
+    "leave" => -4570358400000}
+  ]
+)
+
+events = pdata.name('events') do
+  format(:json) { parse 'when' => :date }
+  values [
+    {"name" => "Decl. of Independence", "when" => "July 4, 1776"},
+    {"name" => "U.S. Constitution",   "when" => "3/4/1789"},
+    {"name" => "Louisiana Purchase",  "when" => "April 30, 1803"},
+    {"name" => "Monroe Doctrine",     "when" => "Dec 2, 1823"}
+  ]
+end
+
+y_scale = ordinal_scale.name('y').from('people.label').to_height
+x_scale = time_scale.name('x').from(['people.born', 'people.died']).to_width.round.in_years
+
+events_mark_t = text_mark.from(events) do
+  enter do
+    x_start { scale(x_scale).from('when') }
+    y_start -10
+    angle -25
+    fill '#000'
+    text { from 'name' }
+    font 'Helvetica Neue'
+    font_size 10
+  end
+end
+
+events_mark_r = rect_mark.from(events) do
+  enter do
+    x_start { scale(x_scale).from('when') }
+    y_start -8
+    width 1
+    height { group(:height).offset(8) }
+    fill '#888'
+  end
+end
+
+people_mark_t = text_mark.from(people) do
+  enter do
+    x_start { scale(x_scale).from('born') }
+    y_start { scale(y_scale).from('label').offset(-3) }
+    fill '#000'
+    text { from('label') }
+    font 'Helvetica Neue'
+    font_size 10
+  end
+end
+
+people_mark_r = rect_mark.from(people) do
+  enter do
+    x_start { scale(x_scale).from('born') }
+    x_end { scale(x_scale).from('died') }
+    y_start { scale(y_scale).from('label') }
+    height 2
+    fill '#557'
+  end
+end
+
+people_mark_r2 = rect_mark.from(people) do
+  enter do
+    x_start { scale(x_scale).from('enter') }
+    x_end { scale(x_scale).from('leave') }
+    y_start { scale(y_scale).from('label').offset(-1) }
+    height 4
+    fill '#e44'
+  end
+end
+
+vis = visualization.name('lifelines').width(400).height(100) do
+  data people, events
+  scales x_scale, y_scale
+  axes x_axis.scale('x')
+  marks events_mark_t, events_mark_r, people_mark_t, people_mark_r, people_mark_r2
+end
+
+puts vis.generate_spec(:pretty)