tsdive compare¶

Report what changed between two periods of one unit.

The usage walkthrough has a section on it.

Usage¶

usage: tsdive compare [-h] --before BEFORE --after AFTER [--top TOP]
                      [--rate-s RATE_S] [--json] [--no-color]
                      parquet [parquet ...]

Options¶

Argument	Value	Default	Description
`parquet ...`		required	every single-tag archive of one unit
`--before`	`BEFORE`	required	ISO 8601 START/END in UTC for the earlier period
`--after`	`AFTER`	required	ISO 8601 START/END in UTC for the later period
`--top`	`TOP`	`10`	rows each table prints before it counts the rest
`--rate-s`	`RATE_S`		grid rate in seconds; omitted, the rate every archive declares
`--json`			print one JSON object and nothing else
`--no-color`			plain text, no ANSI colour (NO_COLOR does the same)

Example¶

$ tsdive compare \
    data/demo/fic101_demo.parquet data/demo/tic101_demo.parquet \
    --before "2024-03-30T20:00:00Z/2024-03-30T23:00:00Z" \
    --after "2024-03-31T04:00:00Z/2024-03-31T06:00:00Z"
demo  2 tags   refused 0   pairs 1 of 1 clearing

before    2024-03-30 20:00:00Z -> 23:00:00Z   (3 h)
after     2024-03-31 04:00:00Z -> 06:00:00Z   (2 h)
grid      rate 60 s (declared)   coverage 1.000 -> 1.000

Tags that changed
  tag        quality   sigma  spread  flagged  changed at
  TIC101.PV  ok         +0.8    x6.0      62%  2024-03-31 04:18:00Z
  FIC101.PV  ok         +0.4    x0.5       0%  2024-03-31 04:00:00Z

Pairs that decoupled  (Pearson on first differences, 95% block bootstrap)
  pair                   before   after   delta  interval
  FIC101.PV ~ TIC101.PV    0.69    0.17   -0.53  [-0.76, -0.26]

Joint structure  (PCA fitted on before, 2 of 2 tags aligned)
  components 1 of 2   explained 0.9767 -> 0.5129 on after
  rows 121   T2 breaches 70   SPE breaches 108
  SPE contributors   TIC101.PV 50%   FIC101.PV 50%