mdarray-sol 0.1.0-java

data/examples/scatterplot/axes.rb

@@ -0,0 +1,111 @@
+# -*- coding: utf-8 -*-
+
+##########################################################################################
+# Copyright © 2016 Rodrigo Botafogo. All Rights Reserved. Permission to use, copy, modify, 
+# and distribute this software and its documentation, without fee and without a signed 
+# licensing agreement, is hereby granted, provided that the above copyright notice, this 
+# paragraph and the following two paragraphs appear in all copies, modifications, and 
+# distributions.
+#
+# IN NO EVENT SHALL RODRIGO BOTAFOGO BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, 
+# INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF 
+# THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF RODRIGO BOTAFOGO HAS BEEN ADVISED OF THE 
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# RODRIGO BOTAFOGO SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE 
+# SOFTWARE AND ACCOMPANYING DOCUMENTATION, IF ANY, PROVIDED HEREUNDER IS PROVIDED "AS IS". 
+# RODRIGO BOTAFOGO HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, 
+# OR MODIFICATIONS.
+##########################################################################################
+
+#=========================================================================================
+#
+#=========================================================================================
+
+class Axes
+
+  attr_reader :chart
+  attr_reader :x_axis
+  attr_reader :y_axis
+  
+  #--------------------------------------------------------------------------------------
+  # Creates the x and y axes for a chart.
+  # chart: the chart for which the axes should be added
+  # @param chart [d3 svg] the plot into which to add the x and y axis
+  # @param x_scale [d3 scale function] the x scale for the x axis
+  # @param y_scale [d3 scale function] the y scale for the y axis
+  #--------------------------------------------------------------------------------------
+
+  def initialize(chart, x_scale, y_scale)
+
+    @chart = chart
+    @x_axis = $d3.svg.axis(nil)
+    @y_axis = $d3.svg.axis(nil)
+
+    @x_axis.scale(x_scale)
+      .orient("bottom")
+      .ticks(5)
+    
+    @y_axis.scale(y_scale)
+      .orient("left")
+      .ticks(5)
+    
+  end
+
+  #--------------------------------------------------------------------------------------
+  # Set the style of the axes
+  #--------------------------------------------------------------------------------------
+
+  def style
+    Proc.new do |g|
+      g.attr("fill", "none")
+      g.attr("stroke", "gray")
+      g.attr("shape-rendering", "crisEdges")
+      g.attr("font-family", "sans-serif")
+      g.attr("font-size", "11px")
+    end
+  end
+  
+  #--------------------------------------------------------------------------------------
+  # Plot the x and y axis
+  #--------------------------------------------------------------------------------------
+
+  def plot
+
+    # add x_axis
+    @x_svg = @chart.svg.append("g")
+    @x_svg.attr("transform", "translate(0, #{@chart.height - @chart.padding})")
+      .call(&style)
+      .call(@x_axis)
+
+    # add y_axis
+    @y_svg = @chart.svg.append("g")
+    @y_svg.attr("transform", "translate(#{@chart.padding}, 0)")
+      .call(&style)
+      .call(@y_axis)
+
+  end
+
+  #--------------------------------------------------------------------------------------
+  # Updates the x and y axis
+  # @param x_scale [d3 scale function] the x scale for this axis
+  # @param y_scale [d3 scale function] the y scale for this axis
+  #--------------------------------------------------------------------------------------
+
+  def update(x_scale, y_scale)
+
+    @x_axis.scale = x_scale
+    @y_axis.scale = y_scale
+
+    # update x_axis
+    @x_svg.attr("transform", "translate(0, #{@chart.height - @chart.padding})")
+      .call(@x_axis)
+
+    # update y_axis
+    @y_svg.attr("transform", "translate(#{@chart.padding}, 0)")
+      .call(@y_axis)
+    
+  end
+  
+end

data/examples/scatterplot/scatterplot.rb

@@ -0,0 +1,221 @@
+# -*- coding: utf-8 -*-
+
+##########################################################################################
+# Copyright © 2016 Rodrigo Botafogo. All Rights Reserved. Permission to use, copy, modify, 
+# and distribute this software and its documentation, without fee and without a signed 
+# licensing agreement, is hereby granted, provided that the above copyright notice, this 
+# paragraph and the following two paragraphs appear in all copies, modifications, and 
+# distributions.
+#
+# IN NO EVENT SHALL RODRIGO BOTAFOGO BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, 
+# INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF 
+# THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF RODRIGO BOTAFOGO HAS BEEN ADVISED OF THE 
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# RODRIGO BOTAFOGO SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE 
+# SOFTWARE AND ACCOMPANYING DOCUMENTATION, IF ANY, PROVIDED HEREUNDER IS PROVIDED "AS IS". 
+# RODRIGO BOTAFOGO HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, 
+# OR MODIFICATIONS.
+##########################################################################################
+
+##########################################################################################
+# This code is based on the code presented on "Interactive Data Visualization for the Web"
+# by Scott Muray
+##########################################################################################
+
+require_relative '../../config' if @platform == nil
+require 'mdarray-sol'
+
+require_relative '../util/linear_scale'
+require_relative 'axes'
+
+#=========================================================================================
+# Implements a ScatterPlot using d3.js
+#=========================================================================================
+
+class ScatterPlot
+
+  attr_reader :dataset
+  attr_reader :width
+  attr_reader :height
+  attr_reader :svg
+  attr_reader :padding
+  attr_reader :x_scale
+  attr_reader :y_scale
+  attr_reader :axes
+
+  #--------------------------------------------------------------------------------------
+  # Initialize the scatterplot and create the main svg for the plot with the given
+  # width and height and padding
+  # @param dataset [Array] an array of points in the form of [x, y]
+  # @param width [Number] the width of the plot
+  # @param height [Number] the height of the plot
+  # @param padding [Number] a padding for the plot. Uses the same padding for x and y
+  # dimension. Could be improved by adding different paddings for x and y
+  #--------------------------------------------------------------------------------------
+  
+  def initialize(dataset, width:, height:, padding:)
+    @dataset = dataset
+    @width = width
+    @height = height
+    @padding = padding
+
+    @svg = $d3.select("body")
+           .append("svg")
+           .attr("width", @width)
+           .attr("height", @height)
+  end
+
+  #--------------------------------------------------------------------------------------
+  # @param x_scale [LinearScale] the x scale for the data, this is a Scale object that
+  # encapsulates the scale function from d3.  x_scale defauts to the scatterplot x scale.
+  # Usually this will always be the case, but we need to set it since x_scale is used
+  # inside a block
+  # @param y_scale [LinearScale] the y scale for the data, this is a Scale object that
+  # encapsulates the scale function from d3. Same observation as above to y_scale.
+  #--------------------------------------------------------------------------------------
+
+  def add_data(x_scale = @x_scale, y_scale = @y_scale)
+    @svg.selectAll("circle")
+      .data(@dataset)
+      .enter(nil)
+      .append("circle")
+      .attr("cx") { |d, i| x_scale[d[0]] }
+      .attr("cy") { |d, i| y_scale[d[1]] }
+      .attr("color", "gray")
+      .attr("r", 3)
+  end
+  
+  #--------------------------------------------------------------------------------------
+  # Defines the style for the labels in the plot.  Method style returns a Proc with the
+  # groups attributes
+  #--------------------------------------------------------------------------------------
+
+  def style
+    Proc.new do |g|
+      g.attr("font-family", "sans-serif")
+      g.attr("font-size", "10px")
+      g.attr("fill", "gray")
+    end
+  end
+
+  #--------------------------------------------------------------------------------------
+  # @param x_scale [LinearScale] the x scale for the data, this is a Scale object that
+  # encapsulates the scale function from d3.  x_scale defauts to the scatterplot x scale.
+  # Usually this will always be the case, but we need to set it since x_scale is used
+  # inside a block
+  # @param y_scale [LinearScale] the y scale for the data, this is a Scale object that
+  # encapsulates the scale function from d3. Same observation as above to y_scale.
+  #--------------------------------------------------------------------------------------
+
+  def add_labels(x_scale = @x_scale, y_scale = @y_scale)
+    @svg.selectAll("text")
+      .data(@dataset)
+      .enter(nil)
+      .append("text")
+      .call(&style)
+      .text { |d, i| "(#{d[0].to_i}, #{d[1].to_i})" }
+      .attr("x") { |d, i| x_scale[d[0]] }
+      .attr("y") { |d, i| y_scale[d[1]] }
+  end
+
+  #--------------------------------------------------------------------------------------
+  # Plots the scatterplot
+  #--------------------------------------------------------------------------------------
+
+  def plot
+    
+    x_min, x_max = @dataset.minmax_by { |d| d[0] }
+    y_min, y_max = @dataset.minmax_by { |d| d[1] }
+
+    # Creates a new x and y scale and the axes for the plot
+    @x_scale = LinearScale.new([0, x_max[0]], [@padding, @width - @padding * 2])
+    @y_scale = LinearScale.new([0, y_max[1]], [@height - @padding, @padding])
+    @axes = Axes.new(self, @x_scale.scale, @y_scale.scale)
+
+    add_data
+    add_labels
+    # add x and y axes to the plot
+    @axes.plot
+    
+  end
+
+  #--------------------------------------------------------------------------------------
+  # This method updates and plots all the points in the scatter plot. Note that we use
+  # transition, duration and each methods to animate the update process.
+  #
+  # @param x_scale [LinearScale] the x scale for the updated dataset. Uses @x_scale as
+  # default since x_scale is used inside a block.  @x_scale should have already being
+  # updated
+  # @param y_scale [LinearScale] the y scale for the updated dataset. Uses @y_scale as
+  # default since y_scale is used inside a block.  @y_scale should have already being
+  # updated
+  #--------------------------------------------------------------------------------------
+
+  def update_points(x_scale = @x_scale, y_scale = @y_scale)
+    @svg.selectAll("circle")
+      .data(@dataset)
+      .transition(nil)
+      .duration(2000)
+      .each("start") { $d3.select(@this)
+                         .attr("fill", "magenta")
+                         .attr("r", 3) }
+      .attr("cx") { |d, i| x_scale[d[0]] }
+      .attr("cy") { |d, i| y_scale[d[1]] }
+      .each("end") { $d3.select(@this)
+                       .transition(nil)
+                       .duration(1000)
+                       .attr("fill", "black")
+                       .attr("r", 2) }
+
+  end
+
+  #--------------------------------------------------------------------------------------
+  # This method updates and plots all the labels in the scatter plot.
+  #
+  # @param x_scale [Scale] the x scale for the updated dataset. Uses @x_scale as default
+  # since x_scale is used inside a block.  @x_scale should have already being updated
+  # @param y_scale [Scale] the y scale for the updated dataset. Uses @y_scale as default
+  # since y_scale is used inside a block.  @y_scale should have already being updated
+  #--------------------------------------------------------------------------------------
+
+  def update_labels(x_scale = @x_scale, y_scale = @y_scale)
+    
+    @svg.selectAll("text")
+      .data(@dataset)
+      .text { |d, i| "(#{d[0].to_i}, #{d[1].to_i})" }
+      .attr("x") { |d, i| x_scale[d[0]] }
+      .attr("y") { |d, i| y_scale[d[1]] }
+    
+  end
+  
+  #--------------------------------------------------------------------------------------
+  # This method is called when the dataset is updated.  This will trigger the update of
+  # points, labels and axes
+  #
+  # @param dataset [Array] a new dataset with the same number of elements as the previous
+  # dataset
+  #--------------------------------------------------------------------------------------
+
+  def update(dataset)
+
+    @dataset = dataset
+
+    # correct the x and y scale to the new dataset
+    x_min, x_max = @dataset.minmax_by { |d| d[0] }
+    y_min, y_max = @dataset.minmax_by { |d| d[1] }
+
+    # fix the scale to the new dataset
+    @x_scale.update([0, x_max[0]], [@padding, @width - @padding * 2])
+    @y_scale.update([0, y_max[1]], [@height - @padding, @padding])
+
+    # update the points, axes and labels
+    update_points
+    @axes.update(@x_scale.scale, @y_scale.scale)
+    update_labels
+    
+  end
+
+end
+

data/examples/us_states/map.rb

@@ -0,0 +1,90 @@
+# -*- coding: utf-8 -*-
+
+##########################################################################################
+# Copyright © 2016 Rodrigo Botafogo. All Rights Reserved. Permission to use, copy, modify, 
+# and distribute this software and its documentation, without fee and without a signed 
+# licensing agreement, is hereby granted, provided that the above copyright notice, this 
+# paragraph and the following two paragraphs appear in all copies, modifications, and 
+# distributions.
+#
+# IN NO EVENT SHALL RODRIGO BOTAFOGO BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, 
+# INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF 
+# THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF RODRIGO BOTAFOGO HAS BEEN ADVISED OF THE 
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# RODRIGO BOTAFOGO SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE 
+# SOFTWARE AND ACCOMPANYING DOCUMENTATION, IF ANY, PROVIDED HEREUNDER IS PROVIDED "AS IS". 
+# RODRIGO BOTAFOGO HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, 
+# OR MODIFICATIONS.
+##########################################################################################
+
+require 'json'
+
+require_relative '../../config' if @platform == nil
+require 'mdarray-sol'
+
+class Map
+
+  attr_reader :path
+  attr_reader :svg
+  attr_reader :us_states
+
+  #------------------------------------------------------------------------------------
+  #
+  #------------------------------------------------------------------------------------
+  
+  def initialize(width, height)
+    
+    @width = width
+    @height = height
+
+    # Create svg for the map
+    @svg = $d3.select("body")
+             .append("svg")
+             .attr("width", @width)
+             .attr("height", @height)
+    
+  end
+  
+  #------------------------------------------------------------------------------------
+  # Parses a file in GeoJson format and saves it as @us_states
+  # @param filename [String] the name of the file to parse
+  #------------------------------------------------------------------------------------
+
+  def json(filename)
+    
+    dir = File.expand_path(File.dirname(__FILE__))
+    file_name = dir + "/#{filename}"
+    file = File.read(file_name)
+    
+    # parse the json file
+    @us_states = JSON.parse(file)
+
+  end
+  
+  #------------------------------------------------------------------------------------
+  #
+  #------------------------------------------------------------------------------------
+
+  def plot(projection)
+
+    proj = projection
+             .translate([@width/2, @height/2])
+             .scale(500)
+    @path = $d3.geo.path[].projection(proj);    
+    
+    @svg.selectAll("path")
+      .data(@us_states["features"])
+      .enter[]
+      .append("path")
+      .attr("d", @path)
+      .style("fill", "steelblue")
+    
+  end
+  
+end
+
+map = Map.new(500, 500)
+map.json("us-states.json")
+map.plot($d3.geo.albersUsa[])

data/examples/us_states/us-ag-productivity2004.csv

@@ -0,0 +1,49 @@
+state,value
+Alabama,1.1791
+Arkansas,1.3705
+Arizona,1.3847
+California,1.7979
+Colorado,1.0325
+Connecticut,1.3209
+Delaware,1.4345
+Florida,1.6304
+Georgia,1.3891
+Iowa,1.5297
+Idaho,1.4285
+Illinois,1.5297
+Indiana,1.4220
+Kansas,1.0124
+Kentucky,0.9403
+Louisiana,0.9904
+Maine,1.3877
+Maryland,1.2457
+Massachusetts,1.1458
+Michigan,1.1058
+Minnesota,1.2359
+Missouri,1.0212
+Mississippi,1.1306
+Montana,0.8145
+North Carolina,1.3554
+North Dakota,1.0278
+Nebraska,1.1619
+New Hampshire,1.0204
+New Jersey,1.2831
+New Mexico,0.8925
+Nevada,0.9640
+New York,1.1327
+Ohio,1.2075
+Oklahoma,0.7693
+Oregon,1.3154
+Pennsylvania,1.0601
+Rhode Island,1.4192
+South Carolina,1.1247
+South Dakota,1.0760
+Tennessee,0.7648
+Texas,0.8873
+Utah,0.9638
+Virginia,0.9660
+Vermont,1.0762
+Washington,1.1457
+Wisconsin,1.1130
+West Virginia,0.5777
+Wyoming,0.5712