Skip to content

Get Interpolated on Interval

Returns evenly spaced interpolated values of tags over a timeframe using a time window.

  • EIGEN.GETSTEP(datasource, tags, startT, endT, timeWindow = "1h", headers = false, showTag = true, tabular = false)
  • datasource (string): Historian name. If omitted, reads default from settings.
  • tags (string[][]): One or more tag names.
  • startT / endT (string): Time bounds (UTC). calculateTimeWindowParameters adjusts windows.
  • timeWindow (string): Duration string (e.g. 1h, 30m). Default: 1h.
  • headers, showTag, tabular: see Advanced Options.
  • string[][] — Array of rows with values at evenly spaced intervals defined by timeWindow.
    • Default format: Each row is [Tag, Timestamp, Value] for each step.
    • With headers=true: Header row ["Tag", "Timestamp", "Value"] precedes data.
    • Step count: Computed from total duration and timeWindow.
  • If timeWindow is invalid the function returns an error row.
  • =EIGEN.GETSTEP("Demo-influxdb", "DEMO_02TI301.PV", "01/01/2024 00:00:00", "01/01/2024 03:00:00", "30m") — values every 30 minutes for 3 hours for DEMO_02TI301.PV.

Sample output (30-minute steps over 3 hours):

TagTimestampValue
DEMO_02TI301.PV2024-01-01 00:00:0070.0
DEMO_02TI301.PV2024-01-01 00:30:0071.5
DEMO_02TI301.PV2024-01-01 01:00:0073.2
DEMO_02TI301.PV2024-01-01 01:30:0074.8
DEMO_02TI301.PV2024-01-01 02:00:0073.1
DEMO_02TI301.PV2024-01-01 02:30:0071.6

Have questions or issues? Reach out on our support system: https://eigen.freshdesk.com