simple-time-series v0.2.5

TimeSeries

For best practices and example checkout the tests

API

• Create timeseries data from one collection

    ts.mergeCollectionByTimestamp(collection,
    {
      start: '2017-01-01T00:00:00.000Z',
      end: '2017-01-01T00:10:00.000Z',
      interval: 1,
      timeIn: 'minutes',
      key: 'timestamp',
      dateFormat: 'iso'
    });

• Merge two collection by date key

    ts.mergeCollectionsByKey(collectionA, collectionB,{key: 'timestamp'});

Why?

• You have a collection with dates and you want to break it to equal intervals. for example your data look like this

    const collection = [
    {
      timestamp: '2017-01-01T00:01:00.000Z',
      sog: 10,
      cog: 10,
      wmg: 10
    },
    {
      timestamp: '2017-01-01T00:09:00.000Z',
      sog: 20,
      cog: 20,
      wmg: 20
    },
    {
      timestamp: '2017-01-01T00:11:00.000Z',
      sog: 30,
      cog: 30,
      wmg: 30
    },
    {
      timestamp: '2017-01-01T00:28:00.000Z',
      sog: 40,
      cog: 40,
      wmg: 40
    },
    {
      timestamp: '2017-01-01T00:39:00.000Z',
      sog: 50,
      cog: 50,
      wmg: 50
    },
    {
      timestamp: '2017-01-01T00:55:00.000Z',
      sog: 60,
      cog: 60,
      wmg: 60
    }
  ]

  But you need it to be move it to 10 minutes intervals

  [
     {
      timestamp: '2017-01-01T00:00:00.000Z',
      timestamp_original: '2017-01-01T00:01:00.000Z',
      sog: 10,
      cog: 10,
      wmg: 10
    },
    {
      timestamp: '2017-01-01T00:10:00.000Z',
      timestamp_original: '2017-01-01T00:09:00.000Z',
      sog: 20,
      cog: 20,
      wmg: 20
    },
    ...
  ]

• I'm saving the original timestamp as timestamp_original for debugging purposes.

  The logic

  • Use the closest time to the time interval
  • If the time absolute value is greater than the interval move to the next interval, this mean if the interval is 1 min and the closest time to 13:00 is 13:02:10 I will skip 13:00 and 13:01

  For more checkout the tests

  For feature request create a github issue.