Interface: DatasetTimeAxis

Defined in: src/time/axis.ts:95

A dataset's declared time axis.

Examples

hourly buckets, two measures summarised differently
  { column: 'hour', unit: 'iso', interval: '1h',
    aggregate: { read_iops: 'avg', peak_iops: 'max' } }

raw samples every five minutes, epoch seconds
  { column: 'ts', unit: 'epoch-s', interval: '5m', aggregate: 'raw' }

Properties

aggregate?

readonly optional aggregate?: TimeAxisAggregate | "raw" | Readonly<Record<string, TimeAxisAggregate>>

Defined in: src/time/axis.ts:123

How each row summarises its interval. 'raw' — every row is a sample as collected, nothing was reduced. One aggregate — every measure column was reduced the same way. A record — measure column to its own aggregate ({ avg_iops: 'avg', peak_iops: 'max' }); a column not named there is not a declared measure. Any aggregate other than 'raw' requires interval, and interval requires aggregate: a summary of an interval nobody named, or an interval with no word for what happened in it, is half a declaration.

column

readonly column: string

Defined in: src/time/axis.ts:97

The column that holds time.

interval?

readonly optional interval?: string

Defined in: src/time/axis.ts:112

Width of the interval one row stands for: a positive whole number and one of s m h d w ('30s', '5m', '1h', '1d', '1w') — the time layer's one duration grammar, any number of digits. With aggregate: 'raw' it is the sampling cadence.

unit

readonly unit: TimeAxisUnit

Defined in: src/time/axis.ts:100

'iso' — ISO-8601 strings; 'epoch-s' / 'epoch-ms' — numbers since 1970-01-01T00:00:00Z in seconds / milliseconds.

zone?

readonly optional zone?: string

Defined in: src/time/axis.ts:107

IANA zone name ('Europe/London') the values are WALL-CLOCK in — never an abbreviation such as 'PST' or a bare offset. 'iso' only — an epoch is an instant and has no zone to declare. Absent: every ISO value must carry its own offset (Z or ±HH:MM); a value without one is NEVER read as UTC — normaliseInstants counts it (naive-values) or, by the reader's choice, refuses the column.