represents a series of events given as time-value pairs {ti,vi}.


represents a series of events with values vi at times specified by tspec.

Details and Options

  • EventSeries represents a series of time-value pairs {ti,vi}.
  • The values vi can be scalars or arrays of any dimension, but must all be of equal dimensionality.
  • The following times tspec can be given:
  • Automaticuse uniformly spaced times starting at 0
    {tmin}use uniformly spaced times starting at tmin
    {tmin,tmax}use uniformly spaced times tmin to tmax
    {tmin,tmax,dt}use times tmin to tmax in steps of dt
    {{t1,t2,}}use explicit times {t1,t2,}
  • The ti can be numbers or any valid input to AbsoluteTime.
  • The values tmin, tmax, and dt can be given as numbers, dates, or Automatic.
  • Specifying es[t] gives the event value at time t.
  • EventSeries is a special case of TemporalData allowing only a single path and no interpolation.
  • EventSeries objects of equal dimensionality {es1,es2,} can be combined into a TemporalData object using TemporalData[{es1,es2,}].
  • Properties of an EventSeries object es can be obtained from es["property"].
  • A list of available properties can be obtained using es["Properties"].
  • Some properties of the event series include:
  • "Path"time-value pairs {{t1,v1},}
    "PathFunction"an interpolated path function
    "PathLength"the length of the path
    "Values"the values {v1,}
    "ValueDimensions"the dimensionality of the vi
    "Times"the times {t1,}
    "Dates"the times {t1,} as dates
    "DatePath"date-value pairs {{date1,v1},}
    "FirstTime"the first time t1
    "FirstDate"the first time t1 as date
    "LastTime"the last time
    "LastDate"the last time as date
    "FirstValue"the value v1 at the first time
    "LastValue"the value at the last time
  • If dates are given as input, es["Times"] returns them in AbsoluteTime.
  • Normal[es] is equivalent to es["Path"].
  • EventSeries takes the following options:
  • CalendarType"Gregorian"the calendar type to use
    HolidayCalendar{"UnitedStates","Default"}the holiday calendar to use
    MetaInformationNoneinclude additional meta-information
    MissingDataMethodNonemethod to use for missing values
    TemporalRegularityAutomaticwhether to assume the data is regular
    DateFunctionAutomatichow to convert dates to standard form


open all close all

Basic Examples  (1)

Attach temporal information to some events:

Click for copyable input
Click for copyable input

Visualize the path:

Click for copyable input

Scope  (30)

Options  (9)

Applications  (6)

Properties & Relations  (3)

Possible Issues  (1)

Neat Examples  (1)

Introduced in 2014
Updated in 2015