TimeArray

Define a tool (a class) to deal with time-related arrays: sums, multiplications, and so on.

Add this line to your application's Gemfile:

gem 'time_array'

And then execute:

$ bundle

Or install it yourself as:

$ gem install time_array

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:

[2.3].timed("2014", unit: :year)

In detail:

time_arr = [1,2,3.14,4,5].timed("2014")

Instance a structure like this:

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.

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.

time_arr = [1,2,3].timed("2014", zone: "Rome")
time_arr.size   # => 3

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:

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:

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]

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