chartx 0.0.1

data/.gitignore

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

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "vendor/assets/javascripts/nvd3"]
+	path = vendor/assets/javascripts/nvd3
+	url = https://github.com/xianhengma/nvd3.git

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in chartx.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Xianheng Ma
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,145 @@
+# Chartx 
+
+Chartx is a Ruby gem helps you to develop fancy interactive data visualizations with one line of Ruby code!:) 
+It's a ruby wrapper of nvd3, which is an attempt to build re-usable charts and chart components for d3.js without taking away the power that d3.js gives you.    
+
+## Installation
+
+To include Chartx into your rails project, add this line to your application's Gemfile:
+
+    gem 'chartx'
+
+And then execute:
+
+    $ bundle install
+
+To add the necessary javascript files into your asset pipeline add
+
+    //= require chartx
+
+in ```app/assets/javascripts/application.js```
+
+If you only need a subset of models e.g. lineChart you can add 
+
+    //= require nvd3/lib/d3.v2
+    //= require nvd3/src/core
+    //= require nvd3/src/tooltip
+    //= require nvd3/src/utils.js
+    //= require nvd3/src/models/lineChart
+    //= require nvd3/src/models/legend.js
+    //= require nvd3/src/models/axis.js
+    //= require nvd3/src/models/scatter.js
+    //= require nvd3/src/models/line.js
+
+to your ```application.js```. All the models can be found in https://github.com/xianhengma/nvd3/tree/chartx-branch/src/models
+
+## Examples
+
+Pie Chart:
+
+```erb
+<%= pie_chart @pie_data %>
+```
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/piechart.png)
+
+Line Chart:
+
+```erb
+<%= line_chart @line_data %>
+```
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/linechart.png)
+
+Discrete Bar Chart:
+```erb
+<%= discrete_bar_chart @discrete_bar_data %>
+```
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/barchart.png)
+
+Line Chart with Focus (View Finder):
+```erb
+<%= line_with_focus_chart @line_with_focus_data %>
+```
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/linewithfocuschart.png)
+
+Scatter Chart:
+```erb
+<%= scatter_chart @scatter_data %>
+```
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/scatterchart.png)
+
+Bullet Chart:
+```erb
+<%= bullet_chart @bullet_data %>
+```
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/bulletchart.png)
+
+Stacked Area Bar Chart:
+```erb
+<%= stacked_area_chart @stacked_area_data %>
+```
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/stackedareachart.png)
+
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/stackedareachart3.png)
+
+Multi Bar Chart:
+```erb
+<%= multi_bar_chart @multi_bar_data %>
+```
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/multibarchart2.png)
+
+Multi Horizontal Bar Chart:
+```erb
+<%= multi_bar_horizontal_chart @multi_bar_horizontal_data %>
+```
+![ScreenShot](https://raw.github.com/xianhengma/chartx/master/screenshots/horizontalbarchart.png)
+
+## Data Format
+
+Data for Chartx (except Pie Chart) are in the following format:
+
+```js
+@data = [
+	{
+		:key => "<Series name>",
+		:color => "<CSS color>"
+		:values => [
+			{:label => 0, :value => 10},
+			{:label => 1, :value => 20},
+			{:label => 2, :value => 30}
+			....
+		]
+	},
+	{
+		key: "<Series name>"
+		...
+	}
+]
+```
+
+Data for Pie Chart is in the following format:
+
+```js
+@data = [
+	{
+		:label => "<name1>",
+		:value => 31
+	},
+	{
+		:label => "<name2>",
+		:value => 31
+
+	},
+	{
+		...
+	}
+		
+]
+```
+
+## 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

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/chartx.gemspec

@@ -0,0 +1,40 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'chartx/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "chartx"
+  spec.version       = Chartx::VERSION
+  spec.platform      = Gem::Platform::RUBY
+  spec.authors       = ["Xianheng Ma"]
+  spec.email         = ["xianheng.ma@gmail.com"]
+  spec.description   = "Generate beautiful charts in rails"
+  spec.summary       = "Generate beautiful charts in rails"
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_dependency "railties", ">= 3.2.0", "< 5.0"
+  
+  `git submodule --quiet foreach pwd`.split($\).each do |sub_path|
+    Dir.chdir(sub_path) do
+ 
+      sub_files = `git ls-files`.split($\)
+      sub_files_fullpaths = sub_files.map do |filename|
+        "#{sub_path}/#{filename}"
+      end
+
+      sub_files_paths = sub_files_fullpaths.map do |filename|
+        filename.gsub "#{File.dirname(__FILE__)}/", ""
+      end
+
+      spec.files += sub_files_paths
+    end
+  end
+end

data/lib/chartx/engine.rb

@@ -0,0 +1,11 @@
+module Chartx
+  class Engine < ::Rails::Engine
+    
+    initializer "helper" do |app|
+      ActiveSupport.on_load(:action_view) do
+        include Helper
+      end
+    end
+  
+  end
+end

data/lib/chartx/helper.rb

@@ -0,0 +1,184 @@
+require "json"
+require "erb"
+
+module Chartx
+  module Helper
+    
+    #pie_chart has different input data format LoL
+    #TODO: fix the input data format
+    def pie_chart(data_source, options = {})
+      chartx "pie", data_source, options
+    end
+    
+    def discrete_bar_chart(data_source, options = {})
+      chartx "discrete_bar", data_source, options
+    end
+    
+    def multi_bar_chart(data_source, options = {})
+      chartx "multi_bar", data_source, options
+    end
+    
+    def multi_bar_horizontal_chart(data_source, options = {})
+      chartx "multi_bar_horizontal", data_source, options
+    end
+    
+    def line_chart(data_source, options = {}) 
+      chartx "line", data_source, options
+    end
+    
+    def line_with_focus_chart(data_source, options = {})
+      chartx "line_with_focus", data_source, options
+    end
+    
+    def scatter_chart(data_source, options = {})
+      chartx "scatter", data_source, options
+    end
+    
+    def stacked_area_chart(data_source, options = {})
+      chartx "stacked_area", data_source, options
+    end
+    
+    def bullet_chart(data_source, options = {})
+      chartx "bullet", data_source, options
+    end
+    
+    def chartx(chart_type, data_source, options, &block)
+      
+      options = options.dup
+      @chartx_id ||= 0
+      
+      height = options.delete(:height) || "600"
+      width = options.delete(:width) || "600"
+      elem_id = options.delete(:id) || "chart-#{@chartx_id += 1}"
+      
+      x_name = options.delete(:x_name) || "label"
+      y_name = options.delete(:y_name) || "value"
+      
+      stagger_labels = options.delete(:stagger_labels) || true
+      show_tooltips = options.delete(:show_tooltips) || false
+      show_values = options.delete(:show_values) || false
+      show_labels = options.delete(:show_labels) || true
+      color = options.delete(:color) || "category10"
+      show_controls = options.delete(:show_controls) || false
+      
+      show_dist_x = options.delete(:show_x_dist) || true
+      show_dist_y = options.delete(:show_y_dist) || true
+      
+      x_axis_format = options.delete(:x_axis_format) || ',f'
+      y_axis_format = options.delete(:y_axis_format) || ',.2f'
+      y2_axis_format = options.delete(:y2_axis_format) || '.2f'
+      
+      clip_edge = options.delete(:clip_edge) || true
+      
+      case chart_type
+        when "discrete_bar"
+          chart_str = "var chart = nv.models.discreteBarChart()
+            .x(function(d) { return d.#{x_name} })
+            .y(function(d) { return d.#{y_name} })
+            .staggerLabels(#{stagger_labels})
+            .tooltips(#{show_tooltips})
+            .showValues(#{show_values})
+            .width(#{width})
+            .height(#{height});"
+          
+        when "pie"      
+          data_source = [data_source] # bug of nvd3
+          chart_str = "var chart = nv.models.pieChart()
+            .x(function(d) { return d.#{x_name} })
+            .y(function(d) { return d.#{y_name} })
+            .values(function(d) { return d })  
+            .color(d3.scale.#{color}().range())
+            .width(#{width})
+            .height(#{height});"
+
+        when "multi_bar"    
+          chart_str = "var chart = nv.models.multiBarChart()
+            .width(#{width})
+            .height(#{height});
+            chart.xAxis.tickFormat(d3.format('#{x_axis_format}'));
+            chart.yAxis.tickFormat(d3.format('#{y_axis_format}'));"  
+             
+        when "line"
+          chart_str = "var chart = nv.models.lineChart()
+            .width(#{width})
+            .height(#{height});
+            chart.xAxis.tickFormat(d3.format('#{x_axis_format}'));
+            chart.yAxis.tickFormat(d3.format('#{y_axis_format}'));"    
+      
+        when "multi_bar_horizontal"      
+          chart_str = "var chart = nv.models.multiBarHorizontalChart()
+            .x(function(d) { return d.#{x_name} })
+            .y(function(d) { return d.#{y_name} })
+            .showValues(#{show_values})
+            .tooltips(#{show_tooltips})
+            .showControls(#{show_controls})
+            .width(#{width})
+            .height(#{height});
+            chart.yAxis.tickFormat(d3.format('#{x_axis_format}'));"
+      
+        when  "line_with_focus"       
+          chart_str = "var chart = nv.models.lineWithFocusChart()
+            .width(#{width})
+            .height(#{height});
+            chart.xAxis.tickFormat(d3.format('#{x_axis_format}'));
+            chart.yAxis.tickFormat(d3.format('#{y_axis_format}'));
+            chart.y2Axis.tickFormat(d3.format('#{y2_axis_format}'));"   
+            
+        when "scatter"       
+          chart_str = "chart = nv.models.scatterChart()
+            .showDistX(#{show_dist_x})
+            .showDistY(#{show_dist_y})
+            .useVoronoi(true)
+            .color(d3.scale.category10().range())
+            .width(#{width})
+            .height(#{height});
+            chart.xAxis.tickFormat(d3.format('#{x_axis_format}'));
+            chart.yAxis.tickFormat(d3.format('#{y_axis_format}'));"
+            
+        when "stacked_area"       
+          chart_str = "var chart = nv.models.stackedAreaChart()
+            .x(function(d) { return d.#{x_name} })
+            .y(function(d) { return d.#{y_name} })
+            .clipEdge(#{clip_edge})
+            .width(#{width})
+            .height(#{height});
+            chart.xAxis.tickFormat(d3.format('#{x_axis_format}'));
+            chart.yAxis.tickFormat(d3.format('#{y_axis_format}'));"
+      
+        when "bullet"
+          chart_str = "var chart = nv.models.bulletChart();"
+      end
+      
+      html = <<HTML
+      <div id="#{ERB::Util.html_escape(elem_id)}" style="height: #{ERB::Util.html_escape(height)}px;">
+      <svg></svg>
+      </div>
+HTML
+
+      js = <<JS
+      <script type="text/javascript">
+        nv.addGraph(function() {
+        #{chart_str}
+
+        d3.select("##{elem_id} svg")
+            .datum(#{data_source.to_json})
+            .transition().duration(500)
+            .call(chart);
+
+        return chart;
+      });
+      </script>
+JS
+
+      if options[:content_for]
+        content_for(options[:content_for]) { js.respond_to?(:html_safe) ? js.html_safe : js }
+      else
+        html += js
+      end
+
+      html.respond_to?(:html_safe) ? html.html_safe : html
+      
+    end
+    
+  end
+end

data/lib/chartx/version.rb

@@ -0,0 +1,3 @@
+module Chartx
+  VERSION = "0.0.1"
+end

data/lib/chartx.rb

@@ -0,0 +1,3 @@
+require "chartx/version"
+require "chartx/engine"
+require "chartx/helper"

data/vendor/assets/javascripts/chartx-core.js

@@ -0,0 +1,9 @@
+// This is a manifest file that'll be compiled into chartx-core.js, which will include all the files
+// listed below.
+// Please make sure you include this file before using Chartx
+//
+
+//= require ./nvd3/lib/d3.min
+//= require ./nvd3/nv.d3.min
+//= require ./nvd3/src/utils.js
+//= require set-env.js.erb

data/vendor/assets/javascripts/chartx-models.js

@@ -0,0 +1,2 @@
+// When you include this file, you will include all the models of Chartx
+//= require_tree ./nvd3/src/models

data/vendor/assets/javascripts/nvd3/.gitignore

@@ -0,0 +1,27 @@
+
+# Jekyll Files #
+################
+_site
+
+
+# Random Files #
+################
+*.swp
+*~
+*.log
+
+
+# Private Test Data #
+#####################
+*REALDATA*
+
+
+# OS generated files #
+######################
+.DS_Store*
+ehthumbs.db
+Icon?
+Thumbs.db
+#  nodejs packages   #
+######################
+node_modules

data/vendor/assets/javascripts/nvd3/.jshintrc

@@ -0,0 +1,3 @@
+{
+    "asi": true
+}

data/vendor/assets/javascripts/nvd3/LICENSE.md

@@ -0,0 +1,49 @@
+
+##nvd3.js License
+
+Copyright (c) 2011, 2012 [Novus Partners, Inc.][novus]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+[novus]: https://www.novus.com/
+
+
+
+##d3.js License
+
+Copyright (c) 2012, Michael Bostock
+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.
+
+* The name Michael Bostock may not be used to endorse or promote products
+  derived from this software without specific prior written permission.
+
+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 MICHAEL BOSTOCK 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/vendor/assets/javascripts/nvd3/README.md

@@ -0,0 +1 @@
+This is a branch for Chartx.