Session: Create & Modify Incremental Time Series

• Creating a new Incremental Time Series
  Incrementing entry values for an incremental time series that doesn't exist yet will create the new incremental time series with this entry.
• Creating an Incremental Time Series Entry
  Incrementing an entry value for an entry that doesn't exist yet will add the entry to this series at the specified timestamp.
• Modifying Entry Values
  Increment a value for an existing entry by a number of your choice.

There are four IncrementalTimeSeriesFor.Increment methods:

• Increment a time series entry's array of values at the provided timestamp.
  

  // Increment a time series entry's array of values at the provided timestamp
  void Increment(DateTime timestamp, IEnumerable<double> values);

• Increment a time series entry's array of values at the current time.
  

  // Increment a time series entry's array of values at the current time
  void Increment(IEnumerable<double> values);

• Increment an entry value at the provided timestamp.
  (If the entry exists and has more than one value, only the first value in its list will be incremented by the passed value.)
  

  // Increment an entry value at the provided timestamp
  void Increment(DateTime timestamp, double value);

• Increment an entry value at the current time.
  (If the entry exists and has more than one value, only the first value in its list will be incremented by the passed value.)
  

  // Increment an entry value at the current time
  void Increment(double value);

Parameters

Exceptions
If the document doesn't exist, a DocumentDoesNotExistException exception is thrown.

• An explicit document ID,
  -or-
  An entity tracked by the session, e.g. a document object returned from session.Query or from session.Load.
• The time series name.
  The name must begin with "INC:" (can be upper or lower case) to identify the time series as incremental.

var ts = session.IncrementalTimeSeriesFor("companies/webstore", "INC:Downloads");
ts.Increment(baseline.AddMinutes(1), new double[] { 10, -10, 0, 0 });
session.SaveChanges();

• If the time series doesn't exist, it will be created with this first entry.
• If the entry doesn't exist, it will be created with the provided values.
• If the entry exists, its values will be increased by the provided values.
  • a negative number will decrease the current value.