simple_time_series 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6652cc5ac84fbe5b9a437ad9823a2b877f98eed5
-  data.tar.gz: 4e81af7f660737a23e230e575839ea2db4bfbc0a
+  metadata.gz: 96fc69681d3c929e6f16e8f162be2fc246128eed
+  data.tar.gz: 2737be6e56ae082830a0273e76b09663ac94d713
 SHA512:
-  metadata.gz: 44ba101165e85cd96a1b2868ccf1cbb2259158bfebed931a4ff1a31c23c55d559d77e698c18044e45684abc4dc1358f50ce212a0a78a14252b0ed159bd29844e
-  data.tar.gz: c194fe33b180a5baa8b7bc8b54a91178ec58ed1d1cc2b50e14019d9af28bba715971d5b62c563bb6e29c20e04cba1e8657b5dcc4451679cc2db4753bbc043b68
+  metadata.gz: 3b3d87226d74112ebf4c4a2650f57e9340a3a27e1a1de61347be8096606009e5b70610d74f17ec72f5fa072dd86901c6d5031c58a115e41507d659e4e19f4f03
+  data.tar.gz: 01753f203de51d3b6f321cd1c010a931f4764fd657986ecff98c5c4b05c487c1f5bc738f84234e8b2bba103301549347b3c35dae06254d5b98aa3b2d657c4b11

data/README.md

@@ -42,6 +42,13 @@ This is sufficient to package up your data into a SimpleTimeSeries object:
                                                   'miles' => miles,
                                                   'tasks_done' => tasks_done})
 
+If your input data is strings but should be converted into numeric, you can call #to_num on it and it will be converted to an array of integers (where possible) or floats:
+
+    donuts = ["6", "0", "2", "4.5", "1.5", "0", "9"]
+    new_data = SimpleTimeSeries.new(:time_vars => {'dates' => dates},
+                                    :data_vars => {'donuts' => donuts.to_num})
+    new_data.current('donuts') #returns [6, 0, 2, 4.5, 1.5, 0, 9]
+
 You can now easily access the value of any data variable for any value of one of your time variables via xxx_on methods created for each of your data_vars (here called 'pizzas_on,' 'miles_on' and 'tasks_done_on'):
 
     puts "Pizzas eaten on Tuesday: #{my_data.pizzas_on('Tuesday')}" # prints 1
@@ -247,7 +254,7 @@ You can extract subsets of your data into arrays of arrays with #data_array:
           [2, 3, 0, 14, 3, 11, 0],
           [0, 0, 1, 0, 0.5, 0, 2] ]
 
-You can tell it to prepend the variable name to each array:
+You can tell it to prepend each variable's name to its array:
 
       my_data.data_array('tasks_done', {:prepend_names => true})
         =>
@@ -308,6 +315,23 @@ You can tell it to prepend the variable name to each array:
           ['tasks_done', 3, 0, 14, 3, 11, 0],
           ['pizzas', 0, 1, 0, 0.5, 0, 2] ]
 
+You can also pass an array of custom names to prepend to each data_var array:
+
+    my_data.data_array('tasks_done', {:prepend_names => ['Tasks Completed']})
+      =>
+      [ ['Tasks Completed', 2, 3, 0, 14, 3, 11, 0] ]
+
+    my_data.data_array('miles', 'tasks_done', {:prepend_names => ['Miles Run', 'Tasks Completed']})
+      =>
+      [ ['Miles Run', 2.2, 3.1, 0.0, 4.3, 1.2, 12.2, 2.3],
+        ['Tasks Completed', 2, 3, 0, 14, 3, 11, 0] ]
+
+    my_data.data_array('dates', 'tasks_done', 'pizzas', {:prepend_names => ['YYYY-MM-DD', 'Tasks Completed', 'Pizzas Consumed']})
+      =>
+      [ ['YYYY-MM-DD', '2014-01-01', '2014-01-02', '2014-01-03', '2014-01-04', '2014-01-05', '2014-01-06', '2014-01-07'],
+        ['Tasks Completed', 2, 3, 0, 14, 3, 11, 0],
+        ['Pizzas Consumed', 0, 0, 1, 0, 0.5, 0, 2] ]
+
 Currently, SimpleTimeSeries assumes all variable arrays have equal lengths and represent the same sequence of observations. Though the gem says "time series," it should work with any kind of sequential data.
 
 ## Disclaimer

data/lib/core_ext/array.rb

@@ -0,0 +1,22 @@
+class Array
+
+  def to_i
+    map { |str| str.to_i }
+  end
+
+  def to_f
+    map { |str| str.to_f }
+  end
+
+  def to_num
+    begin
+      to_i
+    rescue
+      begin
+        to_f
+      rescue
+        raise "Unable to convert #{self} #to_num"
+      end
+    end
+  end
+end

data/lib/simple_time_series.rb

@@ -1,3 +1,4 @@
 require "simple_time_series/version"
+require "core_ext/array"
 require "simple_time_series/simple_time_series"
 

data/lib/simple_time_series/version.rb

@@ -1,3 +1,3 @@
 class SimpleTimeSeries
-  VERSION = "0.1.5"
+  VERSION = "0.1.6"
 end

data/spec/lib/simple_time_series_spec.rb

@@ -21,6 +21,36 @@ describe SimpleTimeSeries do
     @my_data.should be_a(SimpleTimeSeries)
   end
 
+  it "can convert (via #to_f) an input array of strings to an array of floats" do
+    @donuts = ["6", "0", "2", "4.5", "1.5", "0", "9"]
+    new_data = SimpleTimeSeries.new(:time_vars => {'dates' => @dates},
+                                    :data_vars => {'donuts' => @donuts.to_f})
+    new_data.current('donuts').should == [6, 0, 2, 4.5, 1.5, 0, 9]
+    new_data.current('donuts')[0].should_not == "6"
+  end
+
+  it "can convert (via #to_num) an input array of strings to an array of floats" do
+    @donuts = ["6", "0", "2", "4.5", "1.5", "0", "9"]
+    new_data = SimpleTimeSeries.new(:time_vars => {'dates' => @dates},
+                                    :data_vars => {'donuts' => @donuts.to_f})
+    new_data.current('donuts').should == [6, 0, 2, 4.5, 1.5, 0, 9]
+    new_data.current('donuts')[0].should_not == "6"
+  end
+
+  it "can convert (via #to_i) an input array of strings to an array of integers" do
+    @donuts = ["6", "0", "2", "4", "1", "0", "9"]
+    new_data = SimpleTimeSeries.new(:time_vars => {'dates' => @dates},
+                                    :data_vars => {'donuts' => @donuts.to_i})
+    new_data.current('donuts').should == [6, 0, 2, 4, 1, 0, 9]
+  end
+
+  it "can convert (via #to_num) an input array of strings to an array of integers" do
+    @donuts = ["6", "0", "2", "4", "1", "0", "9"]
+    new_data = SimpleTimeSeries.new(:time_vars => {'dates' => @dates},
+                                    :data_vars => {'donuts' => @donuts.to_num})
+    new_data.current('donuts').should == [6, 0, 2, 4, 1, 0, 9]
+  end
+
   it "sets #time_vars correctly" do
     @my_data.time_vars["dates"].should == @dates
     @my_data.time_vars["dows"].should == @dows

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simple_time_series
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - James Lavin
@@ -65,6 +65,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- lib/core_ext/array.rb
 - lib/simple_time_series.rb
 - lib/simple_time_series/simple_time_series.rb
 - lib/simple_time_series/version.rb