time_array 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: aa5896db51acd0cd4c78503ea4ed9c0c1b396090
+  data.tar.gz: a4978dc1c86f1f1828e03433d2587fa69c54570b
+SHA512:
+  metadata.gz: 0385f2d1d7cac766a234350ab93a058561250689f0c77f7eeb0e1d5cdf8718f8311f7dd06c9322cb7a269e953d75351edba8e001ec1c629b3fb0cd526c29901c
+  data.tar.gz: ef291bcbacd519537534ac1c29fe2eb983ac624d288854633233024f232ee95ee4665998bf48a2eff749aff32a977dbd9f8d591ca16639c523adbf5a0188e0ed

data/.coveralls.yml

@@ -0,0 +1,2 @@
+service_name: travis-ci
+repo_token: TZmnh0d75NP1pE97mc0aiDevTRaIp3ImW

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+cache: bundler
+
+rvm:
+  - jruby
+  - 1.9.3
+  - 2.0.0
+
+notifications:
+  email:
+    recipients:
+      - iwan.buetti@gmail.com
+    on_failure: change
+    on_success: never

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,14 @@
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rsspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separetly)
+#  * 'just' rspec: 'rspec'
+guard :rspec, cmd: 'bundle exec rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Iwan Buetti
+
+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,102 @@
+# TimeArray
+
+[![Build Status](https://travis-ci.org/iwan/time_array.png)](https://travis-ci.org/iwan/time_array)
+[![Coverage Status](https://img.shields.io/coveralls/iwan/time_array.svg)](https://coveralls.io/r/iwan/time_array)
+[![Code Climate](https://codeclimate.com/github/iwan/time_array/badges/gpa.svg)](https://codeclimate.com/github/iwan/time_array)
+Define a tool (a class) to deal with time-related arrays: sums, multiplications, and so on.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'time_array'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install time_array
+
+## Usage
+
+```ruby
+include TimeArray
+
+time_arr = TimeArray::TimeArray.new("2014", [2.3], unit: :year)
+```
+Generate a time-related array: 8760 elements of '2.3' values, one for each hour in the year 2014.
+
+You can do the same starting from a standard Array:
+```ruby
+[2.3].timed("2014", unit: :year)
+```
+
+
+
+In detail:
+```ruby
+time_arr = [1,2,3.14,4,5].timed("2014")
+```
+Instance a structure like this:
+
+| Time with zone            | Value |
+|---------------------------|------:|
+| 2014-01-01 00:00:00 +0100 |     1 |
+| 2014-01-01 01:00:00 +0100 |     2 |
+| 2014-01-01 02:00:00 +0100 |  3.14 |
+| 2014-01-01 03:00:00 +0100 |     4 |
+| 2014-03-01 04:00:00 +0100 |     5 |
+
+
+
+By default the unit of data you pass is hourly, but you can specify different units: day, month or year. The internal representation of data is always hourly. So your daily data is converted to hourly data.
+
+```ruby
+time_arr = [1,2,3].timed("2014", unit: :day)
+time_arr.size   # => 24*3
+```
+
+The other option you can specify is the time zone (by default is 'Rome'), TimeArray use ActiveSupport::TimeWithZone to store the time data.
+
+```ruby
+time_arr = [1,2,3].timed("2014", zone: "Rome")
+time_arr.size   # => 3
+```
+
+### Operations
+
+```ruby
+a = [12].timed("2014", unit: :year)
+b = [4].timed("2014", unit: :year)
+a+b   # => will be an array of [16,16,16,...], size of 8760
+a-b   # => will be an array of [8,8,8,...], size of 8760
+a*b   # => will be an array of [48,48,48,...], size of 8760
+a/b   # => will be an array of [3,3,3,...], size of 8760
+```
+If you sum two arrays that are not aligned (in term of time), the result of the operation will be applied to the intersection of the two arrays:
+
+```ruby
+a = [12].timed("2014", unit: :day)  # size of 24
+b = [4, 3].timed("2014", unit: :day)  # size of 48
+a.aligned_with? b   # => false
+a+b   # => will be an array of [16,16,16,...], size of 24
+```
+The same goes for time_arrays defined in two different time zones:
+
+```ruby
+a = [1,2,3,4,5].timed("2014", zone: "Rome")
+b = [1,2,3].timed("2014", zone: "London")
+a.aligned_with? b   # => false
+a+b   # => [3,5,7]
+```
+
+
+## Contributing
+
+1. Fork it ( https://github.com/iwan/time_array/fork )
+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 a new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require 'rspec/core/rake_task'
+require 'bundler/gem_tasks'
+
+# Default directory to look in is `/spec`
+# Run with `bundle exec rake spec`
+RSpec::Core::RakeTask.new(:spec) do |task|
+  task.rspec_opts = ['--color', '--format', 'progress']
+end
+
+task :default => :spec

data/lib/time_array/array_ext.rb

@@ -0,0 +1,21 @@
+require 'active_support/core_ext/time/zones'
+
+module TimeArray
+  module ArrayExt
+    module ClassMethods
+      
+    end
+    
+    module InstanceMethods
+      def timed(start_time, options={})
+        TimeArray.new(start_time, self, options)
+      end
+    end
+    
+    def self.included(receiver)
+      receiver.extend         ClassMethods
+      receiver.send :include, InstanceMethods
+    end
+  end
+end
+

data/lib/time_array/exceptions.rb

@@ -0,0 +1,9 @@
+module TimeArray
+  class NilStartTimeError < RuntimeError
+    
+  end
+
+  class NilVectorError < RuntimeError
+    
+  end
+end

data/lib/time_array/group_hash.rb

@@ -0,0 +1,31 @@
+module TimeArray
+  class GroupHash < Hash
+    def sum(options={})
+      if options[:values]
+        case options[:values]
+        when :positive, :non_negative
+          each_pair{|k,v| self[k]=v.sum_positive}
+        when :negative, :non_positive
+          each_pair{|k,v| self[k]=v.sum_negative}
+        when :zero
+          each_pair{|k,v| self[k]=0.0}
+        when :all, :non_zero
+          each_pair{|k,v| self[k]=v.sum_all}
+        else
+          raise ArgumentError, "Option not recognized"
+        end
+      else
+        each_pair{|k,v| self[k]=v.sum_all}
+      end
+    end
+
+    def count(options={})
+      if options[:values]
+        raise ArgumentError, "Option not recognized" if !%w(positive negative non_positive non_negative non_zero zero all).include?(options[:values].to_s)
+        each_pair{|k,v| self[k]=v.send("count_"+options[:values])}
+      else
+        each_pair{|k,v| self[k]=v.count_all}
+      end
+    end
+  end
+end

data/lib/time_array/hour_array.rb

@@ -0,0 +1,9 @@
+module TimeArray
+  class HourArray
+    def initialize
+      
+    end
+    
+    
+  end
+end

data/lib/time_array/time_array.rb

@@ -0,0 +1,305 @@
+require 'active_support/core_ext/time/zones'
+require 'active_support/core_ext/time/calculations'
+require 'active_support/core_ext/numeric/time'
+require 'active_support/core_ext/hash'
+
+
+module TimeArray
+  class TimeArray
+    attr_reader :start_time, :v, :unit
+
+    def initialize(start_time, values=Vector.new, options={})
+      manage_options(options)
+      set_start_time start_time
+      set_values     values      
+    end
+
+
+    def zone
+      Time.zone.name
+    end
+
+    def time_zone
+      Time.zone
+    end
+
+    def clone
+      TimeArray.new(@start_time, (@v.clone rescue Vector.new), zone: Time.zone.name)
+    end
+
+    # Set all vector values to a new value
+    def all_to(new_value)
+      @v = Vector.new(@v.size, new_value)
+      # @v.map!{|e| e=new_value}
+      self
+    end
+
+    def size
+      @v.size
+    end
+
+
+    # get the sum of the values
+    def sum(options = {})
+      if options[:values]
+        opt = options[:values].to_sym
+        case opt
+        when :positive, :non_negative
+          @v.sum_positive
+        when :negative, :non_positive
+          @v.sum_negative
+        when :zero
+          0.0
+        when :all, :non_zero
+          @v.sum_all
+        else
+          raise ArgumentError, "Option '#{opt}' not recognized"
+        end
+      else
+        @v.sum_all
+      end
+    end
+
+    # alias :+ :sum
+
+    # Count the values
+    def count(options = {})
+      if options[:values]
+        raise ArgumentError, "Option not recognized" if !%w(positive negative non_positive non_negative non_zero zero all).include?(options[:values].to_s)
+        @v.send("count_"+options[:values].to_s)
+      else
+        @v.count_all
+      end
+    end
+
+
+    # Get the average of values
+    def avg(options = {})
+      c = count(options)
+      return nil if c.zero? # if the array is empty will be returned nil
+      sum(options) / c
+    end
+
+    # Get the minimum value
+    def min
+      @v.compact.min
+    rescue
+      nil
+    end
+
+    # Get the maximum value
+    def max
+      @v.compact.max
+    rescue
+      nil
+    end
+
+    # Round every values of the array
+    def round!(ndigit=3)
+      @v.collect!{|e| e.nil? ? nil : e.round(ndigit)}
+      self
+    end
+
+    # def xy_array(options={}) # for the moment has been left out
+
+
+
+    def empty?
+      @v.nil? || @v.empty?
+    end
+
+    # Return the time assiociated with the last value
+    def end_time
+      return nil if empty?
+      @start_time + (@v.size-1).hours
+    end
+
+    def clear_data
+      raise NilStartTimeError if @start_time.nil?
+      @v = Vector.new
+      self
+    end
+
+    def aligned_with?(other_array)
+      self.start_time==other_array.start_time && @v.size==other_array.size
+    end
+
+    def align_with(other_array)
+      # @start_time    = other_array.start_time if @start_time.nil? # ====
+      return self if empty?
+      return clear_data if other_array.empty?
+        
+      
+      new_start_time = [start_time, other_array.start_time].max
+      new_end_time   = [end_time,   other_array.end_time].min
+
+      if end_time.nil? || other_array.end_time.nil? || new_start_time>new_end_time
+        clear_data
+      else
+        @v = @v[((new_start_time-start_time)/3600).to_i, 1+((new_end_time-new_start_time)/3600).to_i]
+      end
+      @start_time = new_start_time
+      self      
+    end
+
+
+    def print_values
+      start_time = @start_time - 1.hour
+      @v.collect{|v| "#{(start_time+=1.hour).strftime('%Y-%m-%d %H:%M %a')}\t#{v}" }.join("\n")
+    end
+
+    def to_s
+      "Start time: #{@start_time}\nData (size: #{@v.size}):\n#{print_values}"
+    end
+
+    # mah!
+    def until_the_end_of_the_year(fill_value=0.0)
+      t = Time.zone.parse("#{@start_time.year+1}-01-01")
+      hh = (t-@start_time)/( 60 * 60) # final size
+      @v += Vector.new(hh-@v.size, fill_value) if hh>@v.size
+      self
+    end
+
+    def +(vec)
+      oper(vec, :+)
+    end
+
+    def -(vec)
+      oper(vec, :-)
+    end
+
+    def *(vec)
+      oper(vec, :*)
+    end
+
+    def /(vec)
+      oper(vec, :/)
+    end
+
+    def value(index)
+      @v[index]
+    end
+
+    def first_values(number)
+      @v[0,number]
+    end
+
+    def set_value(index, new_value)
+      @v[index]=new_value if index>=0 && index<@v.size
+    end
+
+    def group_by(interval)
+      raise ArgumentError, "interval not valid. Valid intervals are :hour, :day, :wday, :month" unless Units.valid?(interval)
+      t = start_time
+      h = GroupHash.new{|h,k| h[k]=[]}
+      @v.each do |v|
+        h[t.send(interval)]<<v
+        t+=1.hour
+      end
+      h
+    end
+
+    # ===========================================================
+
+    private
+
+
+    def oper(other_array, op)
+      return self if other_array.nil?
+      raise NilVectorError if @v.nil? || (other_array.is_a?(TimeArray) && other_array.v.nil?)
+
+      c = self.clone
+      if other_array.is_a? Numeric
+        default_value = other_array
+      else
+        c.align_with(other_array)
+      end
+      
+      # c.data(Array.new(other_array.size){[:+, :-].include?(op) ? 0.0 : 1.0}) if @v.nil?
+      c.size.times do |i|
+        c.set_value(i, c.value(i).to_f.send(op, (default_value || other_array.value(i) || 0.0)))
+      end
+      c
+    end
+
+    def set_values(data)
+      # the values are always stored as hour values
+      @v = @unit==:hour ? Vector.new(data) : expand(data)
+    end
+
+
+    def expand(data)
+      vector = Vector.new
+      raise NilStartTimeError if @start_time.nil?
+      start_time = @start_time.clone
+
+      prev_value = start_time.send(@unit)
+      data.each do |v|
+        while start_time.send(@unit)==prev_value
+          vector << v
+          start_time+=1.hour
+        end
+        prev_value = start_time.send(@unit)
+      end
+      vector
+    end
+
+    def set_start_time(start_time)
+      st = read_start_time(start_time)
+      @start_time = floor_start_time(st, @unit)
+    end
+
+
+
+    # start_time must be a Time (or similar) or a String
+    # valid start_time "yyyy", "yyyy-m", "yyyy-mm", "yyyy-mm-dd", "yyyy-mm-dd yy"
+    def read_start_time(start_time)
+      if start_time.is_a?(String)
+        start_time.gsub!("/", "-")
+        start_time = "20#{r[0]}-01-01" if r = start_time.match(/^\d{2}$/) # "yy"
+        start_time = "#{r[0]}-01-01"   if r = start_time.match(/^\d{4}$/) # "yyyy"
+        start_time = "#{r[0]}-01"      if r = start_time.match(/^\d{4}-\d{1,2}$/) # "yyyy-m" or "yyyy-mm"
+        start_time = Time.zone.parse(start_time)
+        raise ArgumentError, "Start time not valid" if start_time.nil?
+      end
+      start_time
+    end
+
+
+
+
+
+    def floor_start_time(t, unit=:hour)
+      return nil if t.nil?
+      case @unit
+      # when :'15minutes'
+      #   t = t - t.sec - (60 * (t.min % 15)) # floor to hour
+      when :hour
+        t = Time.zone.parse("#{t.year}-#{t.month}-#{t.day} #{t.hour}:00:00")
+        # t = t - t.sec - (60 * (t.min % 60)) # floor to hour
+      when :day
+        t = Time.zone.parse("#{t.year}-#{t.month}-#{t.day}")
+      when :month
+        t = Time.zone.parse("#{t.year}-#{t.month}-01")
+      when :year
+        t = Time.zone.parse("#{t.year}-01-01")
+      end
+      t
+    end
+
+
+
+    def manage_options(options)
+      options = options.symbolize_keys.assert_valid_keys(:unit, :zone)
+
+      # unit
+      options = {unit: :hour}.merge(options)
+      @unit = options[:unit].to_sym
+      Units.validate(@unit)
+
+      # zone
+      Time.zone = options[:zone] || "Rome"
+    end
+  end
+end
+

data/lib/time_array/units.rb

@@ -0,0 +1,13 @@
+module TimeArray
+  module Units
+    LIST = [:hour, :day, :month, :year]
+
+    def self.valid?(u)
+      LIST.include?(u.to_sym)
+    end
+    
+    def self.validate(u)
+      raise ArgumentError, "Time unit is not valid" if !self.valid?(u) 
+    end
+  end
+end

data/lib/time_array/vector.rb

@@ -0,0 +1,51 @@
+module TimeArray
+  class Vector < Array
+    def clone
+      Vector.new(self)
+    end
+
+    def sum_all
+      inject(0.0){|total, n| total + (n||0.0) }
+    end
+
+    def sum_positive
+      inject(0.0){|total, n| total + (n>0.0 ? n : 0.0) }
+    end
+
+    def sum_negative
+      inject(0.0){|total, n| total + (n<0.0 ? n : 0.0) }
+    end
+
+    def count_positive
+      count{|e| e>0.0}
+    end
+
+    def count_non_positive
+      count{|e| e<=0.0}
+    end
+
+    def count_non_negative
+      count{|e| e>=0.0}
+    end
+
+    def count_negative
+      count{|e| e<0.0}
+    end
+
+    def count_non_zero
+      count{|e| e!=0.0}
+    end
+
+    def count_zero
+      count{|e| e==0.0}
+    end
+
+    def count_all
+      size
+    end
+
+    def +(o)
+      Vector.new(super(o)) # recast
+    end
+  end
+end

data/lib/time_array/version.rb

@@ -0,0 +1,3 @@
+module TimeArray
+  VERSION = "0.5.0"
+end

data/lib/time_array.rb

@@ -0,0 +1,16 @@
+%w(
+  version
+  vector
+  exceptions
+  time_array
+  hour_array
+  array_ext
+  units
+  group_hash
+).each { |file| require File.join(File.dirname(__FILE__), 'time_array', file) }
+
+
+class Array
+  include TimeArray::ArrayExt
+end
+

data/spec/array_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+RSpec.describe 'array' do
+  subject(:a1) { [1,2,3].timed("2014") }
+
+  it 'init hour array' do
+    expect(a1).to be_an_instance_of(TimeArray::TimeArray)
+  end
+end

data/spec/hour_array_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+RSpec.describe 'hour array' do
+  # subject(:a1) { HourArray.new }
+
+  # it 'init hour array' do
+  #   expect(a1).to be_an_instance_of(HourArray)
+  # end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require 'coveralls'
+Coveralls.wear!
+
+require 'pry'
+require 'time_array'

data/spec/time_array_operations_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+RSpec.describe 'operations' do
+  subject(:a1) { TimeArray::TimeArray.new("2013", [2.1], unit: :year) }
+  subject(:a2) { TimeArray::TimeArray.new("2013", [3.7], unit: :year) }
+
+  it 'sum time arrays' do
+    b = a1+a2
+    expect(b.size).to eq(8760)
+    expect(b.sum).to be_within(0.001).of(8760*(2.1+3.7))
+
+    c = a1+2
+    expect(c.size).to eq(8760)
+    expect(c.sum).to be_within(0.001).of(8760*(2.1+2))
+  end
+
+  it 'subtract time arrays' do
+    b = a1-a2
+    expect(b.size).to eq(8760)
+    expect(b.sum).to be_within(0.001).of(8760*(2.1-3.7))
+
+    c = a1-2
+    expect(c.size).to eq(8760)
+    expect(c.sum).to be_within(0.001).of(8760*(2.1-2))
+  end
+
+  it 'multiply time arrays' do
+    b = a1*a2
+    expect(b.size).to eq(8760)
+    expect(b.sum).to be_within(0.001).of(8760*(2.1*3.7))
+
+    c = a1*2
+    expect(c.size).to eq(8760)
+    expect(c.sum).to be_within(0.001).of(8760*(2.1*2))
+  end
+
+  it 'divide time arrays' do
+    b = a1/a2
+    expect(b.size).to eq(8760)
+    expect(b.sum).to be_within(0.001).of(8760*(2.1/3.7))
+
+    c = a1/2
+    expect(c.size).to eq(8760)
+    expect(c.sum).to be_within(0.001).of(8760*(2.1/2))
+  end
+
+  it 'divide time arrays by zero' do
+    a3 = TimeArray::TimeArray.new("2013", [1,0,1,1,1,1,1,1,1,1,1,1], unit: :month)
+    c = a1/a3
+    expect(c.size).to eq(8760)
+    expect(c.sum).to eq(Float::INFINITY)
+  end
+end

data/spec/time_array_spec.rb

@@ -0,0 +1,212 @@
+require 'spec_helper'
+
+RSpec.describe 'time array' do
+  subject(:a1) { TimeArray::TimeArray.new("2013", [1,2,3], zone: "Rome", unit: :hour) }
+  values = [1,2,3]
+  subject(:v1) { [0,1,2,-3,0,2,-1] }
+  subject(:time_arr) { TimeArray::TimeArray.new("2013", v1) }
+
+
+  it 'init' do
+    expect(a1).to be_an_instance_of(TimeArray::TimeArray)
+    expect(a1.v).to be_an_instance_of(TimeArray::Vector)
+
+    expect(TimeArray::TimeArray.new("2013", [1], unit: :year).v.size).to eq(8760)
+    expect(TimeArray::TimeArray.new("2012", [1], unit: :year).v.size).to eq(8760+24) # lead year
+    expect(TimeArray::TimeArray.new("2013", [1], unit: :month).v.size).to eq(31*24)
+    expect(TimeArray::TimeArray.new("2013", [1], unit: :day).v.size).to eq(24)
+    expect(TimeArray::TimeArray.new("2013", [1], unit: :hour).v.size).to eq(1)
+
+    expect(TimeArray::TimeArray.new("2013-04-16", [1], unit: :year).v.size).to eq(8760)
+    expect(TimeArray::TimeArray.new("2013-04-16", [1], unit: :month).v.size).to eq(30*24)
+    expect(TimeArray::TimeArray.new("2013-04-16", [1], unit: :day).v.size).to eq(24)
+    expect(TimeArray::TimeArray.new("2013-04-16", [1], unit: :hour).v.size).to eq(1)
+  end
+
+  it 'unit option on initialize' do
+    expect(TimeArray::TimeArray.new("2013", [1,2,3], unit: :hour).unit).to eq(:hour)
+    expect(TimeArray::TimeArray.new("2013", [1,2,3], zone: "Rome", unit: :hour).unit).to eq(:hour)
+    expect(TimeArray::TimeArray.new("2013", [1,2,3], unit: 'hour').unit).to eq(:hour)
+    expect(TimeArray::TimeArray.new("2013").unit).to eq(:hour)
+
+    expect(TimeArray::TimeArray.new("2013", [1,2,3], unit: 'month').unit).to eq(:month)
+    expect(TimeArray::TimeArray.new("2013", [1,2,3], unit: 'year').unit).to eq(:year)
+    expect(TimeArray::TimeArray.new("2013", [1,2,3], unit: 'day').unit).to eq(:day)
+
+    expect{ TimeArray::TimeArray.new("2013", [1,2,3], unit: 'foo').unit}.to raise_error(ArgumentError)
+  end
+
+  it 'zone opt on initialize' do
+    expect(a1.zone).to eq("Rome")
+    expect(TimeArray::TimeArray.new("2013", [1,2,3]).zone).to eq("Rome")
+    expect(TimeArray::TimeArray.new("2013", [1,2,3], zone: "London").zone).to eq("London")
+    expect(a1.time_zone).to be_an_instance_of(ActiveSupport::TimeZone)
+  end
+
+  it 'start_time on initialize' do
+    expect(TimeArray::TimeArray.new("2013", [1,2,3], zone: "Rome").start_time.to_s).to eq("2013-01-01 00:00:00 +0100")
+    expect(TimeArray::TimeArray.new("2013-03", [1,2,3], zone: "Rome").start_time.to_s).to eq("2013-03-01 00:00:00 +0100")
+    expect(TimeArray::TimeArray.new("2013-03-04", [1,2,3], zone: "Rome").start_time.to_s).to eq("2013-03-04 00:00:00 +0100")
+    expect(TimeArray::TimeArray.new("2013-03-04 13", [1,2,3], zone: "Rome").start_time.to_s).to eq("2013-03-04 13:00:00 +0100")
+    expect{TimeArray::TimeArray.new("foobar", [1,2,3], zone: "Rome").start_time.to_s}.to raise_error(ArgumentError)
+  end
+
+  it 'clone' do
+    orig = TimeArray::TimeArray.new("2013", [1,2,3], zone: "Rome")
+    cloned = orig.clone
+    expect(orig.start_time).to equal(orig.start_time)
+    expect(cloned.start_time).not_to equal(orig.start_time)
+    expect(cloned.v).not_to equal(orig.v)
+    # expect(cloned.time_zone).not_to equal(orig.time_zone) # why?
+    
+  end
+
+  it 'set all values to' do
+    x = 3.4
+    expect(a1.all_to(x).v).to eq(Array.new(a1.size, x))
+  end
+
+  it 'get values size' do
+    expect(a1.size).to eq(3)
+    expect(TimeArray::TimeArray.new("2013").size).to eq(0)
+  end
+
+  it 'sum of values' do
+    expect(time_arr.sum).to eq(1)
+    expect(time_arr.sum).to eq(1.0)
+    expect(time_arr.sum(values: :all)).to eq(1)
+    expect(time_arr.sum(values: 'all')).to eq(1)
+    expect(time_arr.sum(values: :non_zero)).to eq(1)
+
+    expect(time_arr.sum(values: :positive)).to eq(5)
+    expect(time_arr.sum(values: :non_positive)).to eq(-4)
+    expect(time_arr.sum(values: :negative)).to eq(-4)
+    expect(time_arr.sum(values: :non_negative)).to eq(5)
+    expect(time_arr.sum(values: :zero)).to eq(0)
+    expect{time_arr.sum(values: :invalid_argument)}.to raise_error(ArgumentError)
+  end
+
+  it 'count of values' do
+    expect(time_arr.count).to eq(7)
+    expect(time_arr.count).to eq(7.0)
+    expect(time_arr.count(values: :all)).to eq(7)
+    expect(time_arr.count(values: 'all')).to eq(7)
+
+    expect(time_arr.count(values: :positive)).to eq(3)
+    expect(time_arr.count(values: :non_positive)).to eq(4)
+    expect(time_arr.count(values: :negative)).to eq(2)
+    expect(time_arr.count(values: :non_negative)).to eq(5)
+    expect(time_arr.count(values: :zero)).to eq(2)
+    expect(time_arr.count(values: :non_zero)).to eq(5)
+    expect{time_arr.count(values: :invalid_argument)}.to raise_error(ArgumentError)
+  end
+
+  it 'average of values' do
+    expect(time_arr.avg).to eq(1.0/7)
+    expect(time_arr.avg(values: :positive)).to eq(5.0/3)
+    expect(time_arr.avg(values: :non_positive)).to eq(-1.0)
+    expect(time_arr.avg(values: :negative)).to eq(-2.0)
+    expect(time_arr.avg(values: :non_negative)).to eq(1.0)
+    expect(time_arr.avg(values: :zero)).to eq(0.0)
+    expect{time_arr.avg(values: :invalid_argument)}.to raise_error(ArgumentError)
+
+    expect(TimeArray::TimeArray.new("2013", [0,1,2,3,0,2,1]).avg(values: :negative)).to be_nil
+  end
+
+  it 'minimum and maximum values' do
+    expect(time_arr.min).to eq(-3)
+    expect(time_arr.max).to eq(2)
+    expect(TimeArray::TimeArray.new("2013", []).max).to be_nil
+    expect(TimeArray::TimeArray.new("2013", []).min).to be_nil
+  end
+
+  it 'round values' do
+    expect(TimeArray::TimeArray.new("2013", [0.0, 1.23456, nil]).round!(2).v).to eq([0.0, 1.23, nil])
+    expect(TimeArray::TimeArray.new("2013", [0.0, 1.23456, nil]).round!(2).v).to be_an_instance_of(TimeArray::Vector)
+  end
+
+  it 'empty' do
+    expect(time_arr.empty?).to eq(false)
+    expect(TimeArray::TimeArray.new("2013", []).empty?).to eq(true)
+  end
+
+  it 'end time' do
+    st = time_arr.start_time
+    expect(time_arr.end_time).to eq(st+(v1.size-1).hours)
+  end
+
+  it 'clear data' do
+    expect(time_arr.clear_data.empty?).to eq(true)
+  end
+
+  it 'aligned with' do
+    a2 = TimeArray::TimeArray.new("2013", [1,2,3], zone: "Rome")
+    expect(a2.aligned_with?(TimeArray::TimeArray.new("2013", [0,3,0], zone: "Rome"))).to eq(true)
+    expect(a2.aligned_with?(TimeArray::TimeArray.new("2013", [0,3], zone: "Rome"))).to eq(false)
+    expect(a2.aligned_with?(TimeArray::TimeArray.new("2013", [0,3,4], zone: "London"))).to eq(false)
+    expect(a2.aligned_with?(TimeArray::TimeArray.new("2012", [0,3,4], zone: "Rome"))).to eq(false)
+  end
+
+  it 'align with' do
+    # case 1. Different data size
+    a2 = TimeArray::TimeArray.new("2013", [1,2,3], zone: "Rome")
+    a3 = TimeArray::TimeArray.new("2013", [4,5], zone: "Rome")
+    expect(a2.align_with(a3).v).to eq([1,2])
+    a3 = TimeArray::TimeArray.new("2013", [], zone: "Rome")
+    expect(a2.align_with(a3).v).to eq([])
+
+    # case 2. Different zone
+    a2 = TimeArray::TimeArray.new("2013", [1,2,3], zone: "Rome")
+    a3 = TimeArray::TimeArray.new("2013", [4,5,6], zone: "London")
+    expect(a2.align_with(a3).v).to eq([2,3])
+    a2 = TimeArray::TimeArray.new("2013", [1,2,3], zone: "Rome")
+    expect(a3.align_with(a2).v).to eq([4,5])
+
+    a2 = TimeArray::TimeArray.new("2013", [1,2,3], zone: "Rome", unit: :day)
+    a3 = TimeArray::TimeArray.new("2013", [4,5,6], zone: "London", unit: :day)
+    expect(a2.align_with(a3).size).to eq(24*3-1)
+
+    # case 2. Different start time (and zone and size)
+    a2 = TimeArray::TimeArray.new("2013-03-04 13", [1,2,3,4,5], zone: "Rome")
+    a3 = TimeArray::TimeArray.new("2013-03-04 14", [4,5], zone: "London")
+    expect(a2.align_with(a3).v).to eq([3,4])
+  end
+
+  it 'print values' do
+    a2 = TimeArray::TimeArray.new("2013-03-04 13", [1,2,3], zone: "Rome")
+    aa = a2.print_values.split("\n")
+    expect(aa.first.split("\t")).to eq(["2013-03-04 13:00 Mon", "1"])
+  end
+
+  it 'fill until the end of the year' do
+    a2 = TimeArray::TimeArray.new("2013-02", [10,20,30])
+    value = 1
+    a2.until_the_end_of_the_year(value)
+    size = 8760 - 31*24
+    sum = size*value -3 + 10+20+30
+    expect(a2.size).to eq(size)
+    expect(a2.sum).to eq(sum)
+  end
+
+  it 'get value at' do
+    expect(a1.value(0)).to eq(1)
+    expect(a1.value(1)).to eq(2)
+    expect(a1.value(2)).to eq(3)
+    expect(a1.value(20)).to be_nil # out of range!
+  end
+
+
+  it 'set value at' do
+    a1.set_value(0, 100)
+    a1.set_value(2, 234)
+    expect(a1.v).to eq([100,2,234])
+    a1.set_value(20, 3) # out of range!
+    expect(a1.v).to eq([100,2,234])
+  end
+
+  it 'get first x values' do
+    arr = Array.new(100){|i| rand(1000)}
+    a = TimeArray::TimeArray.new("2013", arr, zone: "Rome", unit: :hour)
+    expect(a.first_values(23)).to eq(arr[0...23])
+  end
+end

data/spec/units_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+RSpec.describe 'units' do
+  include TimeArray::Units
+
+
+  it 'check if unit is valid' do
+    expect(TimeArray::Units.valid?(:hour)).to be true
+    expect(TimeArray::Units.valid?("hour")).to be true
+    expect(TimeArray::Units.valid?(:day)).to be true
+    expect(TimeArray::Units.valid?("day")).to be true
+    expect(TimeArray::Units.valid?(:month)).to be true
+    expect(TimeArray::Units.valid?("month")).to be true
+    expect(TimeArray::Units.valid?(:year)).to be true
+    expect(TimeArray::Units.valid?("year")).to be true
+
+    expect(TimeArray::Units.valid?(:years)).to be false
+    expect(TimeArray::Units.valid?("years")).to be false
+  end
+end

data/spec/vector_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+
+RSpec.describe 'vector' do
+  subject(:v1) { TimeArray::Vector.new([0,1,2,-3,0,2,-1]) }
+
+  it 'sum all elements' do
+    expect(v1.sum_all).to eq(1)
+  end
+
+  it 'sum positive elements' do
+    expect(v1.sum_positive).to eq(5)
+  end
+
+  it 'sum negative elements' do
+    expect(v1.sum_negative).to eq(-4)
+  end
+
+
+  it 'count pos elements' do
+    expect(v1.count_positive).to eq(3)
+  end
+
+  it 'count non pos elements' do
+    expect(v1.count_non_positive).to eq(4)
+  end
+
+  it 'count neg elements' do
+    expect(v1.count_negative).to eq(2)
+  end
+
+  it 'count non neg elements' do
+    expect(v1.count_non_negative).to eq(5)
+  end
+
+  it 'count zero elements' do
+    expect(v1.count_zero).to eq(2)
+  end
+
+  it 'count non zero elements' do
+    expect(v1.count_non_zero).to eq(5)
+  end
+
+  it 'count zero elements' do
+    expect(v1.count_all).to eq(7)
+  end
+
+  it 'clone' do
+    expect(v1.clone).not_to equal(v1)
+    expect(v1.clone).to eq(v1)
+  end
+
+  it 'sum vectors' do
+    v2 = TimeArray::Vector.new([0,1,2,-3,0,2,-1])
+    expect(v1+v2).to be_an_instance_of(TimeArray::Vector)
+  end
+end

data/time_array.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'time_array/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "time_array"
+  spec.version       = TimeArray::VERSION
+  spec.authors       = ["Iwan Buetti"]
+  spec.email         = ["iwan.buetti@gmail.com"]
+  spec.summary       = %q{Some tools to deal with time based arrays}
+  # spec.description   = %q{TODO: Write a longer description. Optional.}
+  spec.homepage      = "https://github.com/iwan/time_array"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rspec-nc"
+  spec.add_development_dependency "guard"
+  spec.add_development_dependency "guard-rspec"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "pry-remote"
+  spec.add_development_dependency "pry-nav"
+
+  spec.add_development_dependency "coveralls"
+
+  spec.add_dependency("activesupport")
+
+end

data/usage/usage_01.rb

@@ -0,0 +1,20 @@
+require_relative '../lib/time_array'
+
+
+arr = TimeArray::TimeArray.new("2016-03", [1,2,3])
+puts arr.start_time.to_s
+puts arr.start_time.class
+puts arr.start_time.inspect
+
+# puts Time.zone.parse("2014")
+# puts Time.zone.parse("2020-01-02")
+
+a = [2,3,4].timed("2012", unit: :day)
+puts a.size
+puts a.v.inspect
+
+
+puts [1,2,3].timed("2014", unit: :day).size
+
+puts arr.group_by(:day)
+puts arr.group_by(:hour)

metadata

@@ -0,0 +1,232 @@
+--- !ruby/object:Gem::Specification
+name: time_array
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Iwan Buetti
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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'
+- !ruby/object:Gem::Dependency
+  name: rspec-nc
+  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'
+- !ruby/object:Gem::Dependency
+  name: guard
+  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'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry-remote
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry-nav
+  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'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  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'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- iwan.buetti@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/time_array.rb
+- lib/time_array/array_ext.rb
+- lib/time_array/exceptions.rb
+- lib/time_array/group_hash.rb
+- lib/time_array/hour_array.rb
+- lib/time_array/time_array.rb
+- lib/time_array/units.rb
+- lib/time_array/vector.rb
+- lib/time_array/version.rb
+- spec/array_spec.rb
+- spec/hour_array_spec.rb
+- spec/spec_helper.rb
+- spec/time_array_operations_spec.rb
+- spec/time_array_spec.rb
+- spec/units_spec.rb
+- spec/vector_spec.rb
+- time_array.gemspec
+- usage/usage_01.rb
+homepage: https://github.com/iwan/time_array
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Some tools to deal with time based arrays
+test_files:
+- spec/array_spec.rb
+- spec/hour_array_spec.rb
+- spec/spec_helper.rb
+- spec/time_array_operations_spec.rb
+- spec/time_array_spec.rb
+- spec/units_spec.rb
+- spec/vector_spec.rb
+has_rdoc: