rails-data-explorer 0.2.3 → 1.0.0

data/spec/rails_data_explorer/data_type_spec.rb

@@ -0,0 +1,7 @@
+require_relative '../helper_no_rails'
+
+class RailsDataExplorer
+  describe DataType do
+
+  end
+end

data/spec/{rails-data-explorer → rails_data_explorer}/exploration_spec.rb

@@ -22,19 +22,19 @@ class RailsDataExplorer
 
       [
         [
-          ['Univariate Integer data', [nil, 1, 2, 3]],
+          ['Univariate Integer data', [1, 2, 3]],
           { has_charts: ['histogram-quantitative', 'descriptive-statistics-table'] }
         ],
         [
-          ['Univariate Decimal data', [nil, 1.0, 2.0, 3.0]],
+          ['Univariate Decimal data', [1.0, 2.0, 3.0]],
           { has_charts: ['histogram-quantitative', 'descriptive-statistics-table'] }
         ],
         [
-          ['Univariate Temporal data', [nil, Time.now]],
+          ['Univariate Temporal data', [DateTime.new(2015,2,7)]],
           { has_charts: ['histogram-temporal', 'descriptive-statistics-table'] }
         ],
         [
-          ['Univariate Categorical data', [nil, 'a', 'b', 'c']],
+          ['Univariate Categorical data', ['a', 'b', 'c']],
           { has_charts: ['histogram-categorical', 'pie-chart', 'descriptive-statistics-table'] }
         ],
       ].each { |(args, xpect_options)|
@@ -42,7 +42,7 @@ class RailsDataExplorer
 
         it "renders #{ title } correctly" do
           check_render_expectations(
-            Exploration.new(*args).render,
+            Exploration.new(*args, true).render,
             xpect_options
           )
         end

data/spec/rails_data_explorer/utils/color_scale_spec.rb

@@ -0,0 +1,13 @@
+require_relative '../../helper_no_rails'
+
+class RailsDataExplorer
+  module Utils
+    describe ColorScale do
+
+      it 'computes a color from an input value' do
+        ColorScale.new.compute(0).must_equal '#000000'
+      end
+
+    end
+  end
+end

data/spec/rails_data_explorer/utils/value_formatter_spec.rb

@@ -0,0 +1,33 @@
+require_relative '../../helper_no_rails'
+
+class RailsDataExplorer
+  module Utils
+    describe ValueFormatter do
+
+      describe 'initialize from options' do
+
+        let(:value_formatter) {
+          ValueFormatter.new(
+            d3_format: 'd3f',
+            ruby_formatter: 'rf',
+            significant_figures: 2
+          )
+        }
+
+        it 'has d3_format' do
+          value_formatter.d3_format.must_equal 'd3f'
+        end
+
+        it 'has ruby_formatter' do
+          value_formatter.ruby_formatter.must_equal 'rf'
+        end
+
+        it 'has significant_figures' do
+          value_formatter.significant_figures.must_equal 2
+        end
+
+      end
+
+    end
+  end
+end

data/vendor/assets/stylesheets/sources/rde-default-style.css

@@ -15,6 +15,10 @@ h2.rde-exploration-title {
   font-size: 24px;
 }
 
+.rde-chart {
+  overflow-x: scroll;
+}
+
 h3.rde-chart-title {
   display: none;
   font-size: 16px;
@@ -63,7 +67,7 @@ td.rde_toc-available_not_rendered {
 }
 
 td.rde_toc-currently_rendered {
-  background-color: #cfc;
+  background-color: #dff0d8;
 }
 
 td.rde_toc-not_available {

metadata

@@ -1,71 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: rails-data-explorer
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 1.0.0
 platform: ruby
 authors:
 - Jo Hund
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-04 00:00:00.000000000 Z
+date: 2015-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: color
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.7.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.7.1
 - !ruby/object:Gem::Dependency
   name: descriptive-statistics
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.1.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.1.2
 - !ruby/object:Gem::Dependency
   name: distribution
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.7.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.7.1
 - !ruby/object:Gem::Dependency
   name: interpolate
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: actionview
   requirement: !ruby/object:Gem::Requirement
@@ -136,20 +136,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: yui-compressor
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 description: rails-data-explorer is a Rails Engine plugin that makes it easy to explore
   the data in your app using charts and statistics.
 email: jhund@clearcove.ca
@@ -169,55 +155,67 @@ files:
 - doc/rails-data-explorer-screenshot.png
 - lib/rails-data-explorer-no-rails.rb
 - lib/rails-data-explorer.rb
-- lib/rails-data-explorer/action_view_extension.rb
-- lib/rails-data-explorer/active_record_extension.rb
-- lib/rails-data-explorer/chart.rb
-- lib/rails-data-explorer/chart/box_plot.rb
-- lib/rails-data-explorer/chart/box_plot_group.rb
-- lib/rails-data-explorer/chart/contingency_table.rb
-- lib/rails-data-explorer/chart/descriptive_statistics_table.rb
-- lib/rails-data-explorer/chart/descriptive_statistics_table_group.rb
-- lib/rails-data-explorer/chart/histogram_categorical.rb
-- lib/rails-data-explorer/chart/histogram_quantitative.rb
-- lib/rails-data-explorer/chart/histogram_temporal.rb
-- lib/rails-data-explorer/chart/multi_dimensional_charts.rb
-- lib/rails-data-explorer/chart/parallel_coordinates.rb
-- lib/rails-data-explorer/chart/parallel_set.rb
-- lib/rails-data-explorer/chart/pie_chart.rb
-- lib/rails-data-explorer/chart/scatterplot.rb
-- lib/rails-data-explorer/chart/scatterplot_matrix.rb
-- lib/rails-data-explorer/chart/stacked_bar_chart_categorical_percent.rb
-- lib/rails-data-explorer/constants.rb
-- lib/rails-data-explorer/data_series.rb
-- lib/rails-data-explorer/data_set.rb
-- lib/rails-data-explorer/data_type.rb
-- lib/rails-data-explorer/data_type/categorical.rb
-- lib/rails-data-explorer/data_type/geo.rb
-- lib/rails-data-explorer/data_type/quantitative.rb
-- lib/rails-data-explorer/data_type/quantitative/decimal.rb
-- lib/rails-data-explorer/data_type/quantitative/integer.rb
-- lib/rails-data-explorer/data_type/quantitative/temporal.rb
-- lib/rails-data-explorer/engine.rb
-- lib/rails-data-explorer/exploration.rb
-- lib/rails-data-explorer/statistics/pearsons_chi_squared_independence_test.rb
-- lib/rails-data-explorer/statistics/rng_category.rb
-- lib/rails-data-explorer/statistics/rng_gaussian.rb
-- lib/rails-data-explorer/statistics/rng_power_law.rb
-- lib/rails-data-explorer/utils/color_scale.rb
-- lib/rails-data-explorer/utils/data_binner.rb
-- lib/rails-data-explorer/utils/data_encoder.rb
-- lib/rails-data-explorer/utils/data_quantizer.rb
-- lib/rails-data-explorer/utils/rde_table.rb
-- lib/rails-data-explorer/utils/value_formatter.rb
 - lib/rails_data_explorer.rb
+- lib/rails_data_explorer/action_view_extension.rb
+- lib/rails_data_explorer/active_record_extension.rb
+- lib/rails_data_explorer/chart.rb
+- lib/rails_data_explorer/chart/anova.rb
+- lib/rails_data_explorer/chart/box_plot.rb
+- lib/rails_data_explorer/chart/box_plot_group.rb
+- lib/rails_data_explorer/chart/contingency_table.rb
+- lib/rails_data_explorer/chart/descriptive_statistics_table.rb
+- lib/rails_data_explorer/chart/descriptive_statistics_table_group.rb
+- lib/rails_data_explorer/chart/histogram_categorical.rb
+- lib/rails_data_explorer/chart/histogram_quantitative.rb
+- lib/rails_data_explorer/chart/histogram_temporal.rb
+- lib/rails_data_explorer/chart/multi_dimensional_charts.rb
+- lib/rails_data_explorer/chart/parallel_coordinates.rb
+- lib/rails_data_explorer/chart/parallel_set.rb
+- lib/rails_data_explorer/chart/pie_chart.rb
+- lib/rails_data_explorer/chart/scatterplot.rb
+- lib/rails_data_explorer/chart/scatterplot_matrix.rb
+- lib/rails_data_explorer/chart/stacked_bar_chart_categorical.rb
+- lib/rails_data_explorer/chart/stacked_bar_chart_categorical_percent.rb
+- lib/rails_data_explorer/chart/stacked_histogram_temporal.rb
+- lib/rails_data_explorer/data_series.rb
+- lib/rails_data_explorer/data_set.rb
+- lib/rails_data_explorer/data_type.rb
+- lib/rails_data_explorer/data_type/categorical.rb
+- lib/rails_data_explorer/data_type/geo.rb
+- lib/rails_data_explorer/data_type/quantitative.rb
+- lib/rails_data_explorer/data_type/quantitative/decimal.rb
+- lib/rails_data_explorer/data_type/quantitative/integer.rb
+- lib/rails_data_explorer/data_type/quantitative/temporal.rb
+- lib/rails_data_explorer/engine.rb
+- lib/rails_data_explorer/exploration.rb
+- lib/rails_data_explorer/statistics/pearsons_chi_squared_independence_test.rb
+- lib/rails_data_explorer/statistics/rng_category.rb
+- lib/rails_data_explorer/statistics/rng_gaussian.rb
+- lib/rails_data_explorer/statistics/rng_power_law.rb
+- lib/rails_data_explorer/utils/color_scale.rb
+- lib/rails_data_explorer/utils/data_binner.rb
+- lib/rails_data_explorer/utils/data_encoder.rb
+- lib/rails_data_explorer/utils/data_quantizer.rb
+- lib/rails_data_explorer/utils/rde_table.rb
+- lib/rails_data_explorer/utils/value_formatter.rb
 - rails-data-explorer.gemspec
 - spec/helper.rb
 - spec/helper_no_rails.rb
-- spec/rails-data-explorer/data_series_spec.rb
-- spec/rails-data-explorer/data_type/categorical_spec.rb
-- spec/rails-data-explorer/exploration_spec.rb
-- spec/rails-data-explorer/utils/data_binner_spec.rb
-- spec/rails-data-explorer/utils/data_quantizer_spec.rb
+- spec/rails_data_explorer/chart_spec.rb
+- spec/rails_data_explorer/data_series_spec.rb
+- spec/rails_data_explorer/data_set_spec.rb
+- spec/rails_data_explorer/data_type/categorical_spec.rb
+- spec/rails_data_explorer/data_type/quantitative/decimal_spec.rb
+- spec/rails_data_explorer/data_type/quantitative/integer_spec.rb
+- spec/rails_data_explorer/data_type/quantitative/temporal_spec.rb
+- spec/rails_data_explorer/data_type/quantitative_spec.rb
+- spec/rails_data_explorer/data_type_spec.rb
+- spec/rails_data_explorer/exploration_spec.rb
+- spec/rails_data_explorer/statistics/pearsons_chi_squared_independence_test_spec.rb
+- spec/rails_data_explorer/utils/color_scale_spec.rb
+- spec/rails_data_explorer/utils/data_binner_spec.rb
+- spec/rails_data_explorer/utils/data_quantizer_spec.rb
+- spec/rails_data_explorer/utils/value_formatter_spec.rb
 - vendor/assets/javascripts/packaged/rails-data-explorer.min.js
 - vendor/assets/javascripts/rails-data-explorer.js
 - vendor/assets/javascripts/sources/d3.boxplot.js
@@ -262,8 +260,19 @@ summary: A Rails engine plugin for exploring data in your app with charts and st
 test_files:
 - spec/helper.rb
 - spec/helper_no_rails.rb
-- spec/rails-data-explorer/data_series_spec.rb
-- spec/rails-data-explorer/data_type/categorical_spec.rb
-- spec/rails-data-explorer/exploration_spec.rb
-- spec/rails-data-explorer/utils/data_binner_spec.rb
-- spec/rails-data-explorer/utils/data_quantizer_spec.rb
+- spec/rails_data_explorer/chart_spec.rb
+- spec/rails_data_explorer/data_series_spec.rb
+- spec/rails_data_explorer/data_set_spec.rb
+- spec/rails_data_explorer/data_type/categorical_spec.rb
+- spec/rails_data_explorer/data_type/quantitative/decimal_spec.rb
+- spec/rails_data_explorer/data_type/quantitative/integer_spec.rb
+- spec/rails_data_explorer/data_type/quantitative/temporal_spec.rb
+- spec/rails_data_explorer/data_type/quantitative_spec.rb
+- spec/rails_data_explorer/data_type_spec.rb
+- spec/rails_data_explorer/exploration_spec.rb
+- spec/rails_data_explorer/statistics/pearsons_chi_squared_independence_test_spec.rb
+- spec/rails_data_explorer/utils/color_scale_spec.rb
+- spec/rails_data_explorer/utils/data_binner_spec.rb
+- spec/rails_data_explorer/utils/data_quantizer_spec.rb
+- spec/rails_data_explorer/utils/value_formatter_spec.rb
+has_rdoc: 

data/lib/rails-data-explorer/active_record_extension.rb

@@ -1,14 +0,0 @@
-#
-# Adds rails-data-explorer methods to ActiveRecord::Base and sub classes.
-#
-class RailsDataExplorer
-  module ActiveRecordExtension
-
-    module ClassMethods
-
-    protected
-
-    end
-
-  end
-end

data/lib/rails-data-explorer/constants.rb

@@ -1,5 +0,0 @@
-class RailsDataExplorer
-
-  GREATER_ZERO = 1.0 / 1_000_000 # The smallest value to use if we have to avoid zero (div by zero)
-
-end

data/lib/rails-data-explorer/data_series.rb

@@ -1,156 +0,0 @@
-class RailsDataExplorer
-  class DataSeries
-
-    # TODO: Add concept of significant figures for rounding values when displaying them
-    # http://en.wikipedia.org/wiki/Significant_figures
-
-    attr_reader :data_type, :name, :values, :chart_roles
-    delegate :available_chart_types, to: :data_type, prefix: false
-    delegate :available_chart_roles, to: :data_type, prefix: false
-
-    # Any data series with a dynamic range greater than this is considered
-    # having a large dynamic range
-    # We consider dynamic range the ratio between the largest and the smallest value.
-    def self.large_dynamic_range_threshold
-      10000.0
-    end
-
-    # Any data series with more than this uniq vals is considered having many
-    # uniq values.
-    def self.many_uniq_vals_threshold
-      30
-    end
-
-    # options: :chart_roles, :data_type (all optional)
-    def initialize(_name, _values, options={})
-      options = { chart_roles: [], data_type: nil }.merge(options)
-      @name = _name
-      @values = _values
-      @data_type = init_data_type(options[:data_type])
-      @chart_roles = init_chart_roles(options[:chart_roles]) # after data_type!
-    end
-
-    # Returns descriptive_statistics as a flat Array
-    def descriptive_statistics
-      @data_type.descriptive_statistics(values)
-    end
-
-    # Returns descriptive_statistics as a renderable table structure
-    def descriptive_statistics_table
-      @data_type.descriptive_statistics_table(values)
-    end
-
-    def number_of_values
-      values.length
-    end
-
-    def values_summary
-      if values.length < 3 || values.inspect.length < 80
-        values.inspect
-      else
-        "[#{ values.first } ... #{ values.last }]"
-      end
-    end
-
-    def inspect(indent=1, recursive=1000)
-      r = %(#<#{ self.class.to_s }\n)
-      r << [
-        "@name=#{ name.inspect }",
-        "@data_type=#{ data_type.inspect }",
-        "@chart_roles=#{ chart_roles.inspect }",
-        "@values=<count: #{ values.count }, items: #{ values_summary }>",
-      ].map { |e| "#{ '  ' * indent }#{ e }\n"}.join
-      if recursive > 0
-        # nothing to recurse
-      end
-      r << %(#{ '  ' * (indent-1) }>\n)
-    end
-
-    def axis_tick_format
-      data_type.axis_tick_format(values)
-    end
-
-    # @param[Symbol] d3_or_vega :d3 or :vega
-    def axis_scale(d3_or_vega)
-      data_type.axis_scale(self, d3_or_vega)
-    end
-
-    def uniq_vals
-      @uniq_vals ||= values.uniq
-    end
-
-    def uniq_vals_count
-      @uniq_vals_count ||= uniq_vals.length
-    end
-
-    def min_val
-      @min_val ||= values.compact.min
-    end
-
-    def max_val
-      @max_val ||= values.compact.max
-    end
-
-    # Used to decide whether we can render certain chart types
-    def has_many_uniq_vals?
-      uniq_vals_count > self.class.many_uniq_vals_threshold
-    end
-
-    def dynamic_range
-      # TODO: avoid division by zero
-      max_val / [min_val, max_val].min.to_f
-    end
-
-    def has_large_dynamic_range?
-      dynamic_range > self.class.large_dynamic_range_threshold
-    end
-
-    def label_sorter(label_val_key, value_sorter)
-      data_type.label_sorter(label_val_key, self, value_sorter)
-    end
-
-  private
-
-    # @param[Array<Symbol>] chart_role_overrides, :x, :y, :color
-    # @return[Hash] keys are chart_classes, and values are arrays with roles
-    def init_chart_roles(chart_role_overrides)
-      r = if chart_role_overrides.any?
-        available_chart_types.inject(Hash.new([])) { |m,chart_type|
-          subset = chart_type[:chart_roles] & chart_role_overrides
-          next m if subset.empty?
-          m[chart_type[:chart_class]] += subset
-          m[chart_type[:chart_class]].uniq!
-          m
-        }
-      else
-        available_chart_types.inject(Hash.new([])) { |m,chart_type|
-          m[chart_type[:chart_class]] += chart_type[:chart_roles]
-          m[chart_type[:chart_class]].uniq!
-          m
-        }
-      end
-      r.freeze
-    end
-
-    def init_data_type(data_type_override)
-      if data_type_override.nil?
-        first_value = values.detect { |e| !e.nil? }
-        case first_value
-        when Integer, Bignum, Fixnum
-          DataType::Quantitative::Integer.new
-        when Float
-          DataType::Quantitative::Decimal.new
-        when String
-          DataType::Categorical.new
-        when Time, DateTime, ActiveSupport::TimeWithZone
-          DataType::Quantitative::Temporal.new
-        else
-          raise(ArgumentError.new("Can't infer data type for value: #{ values.first.class.inspect }"))
-        end
-      else
-        data_type_override
-      end
-    end
-
-  end
-end