Skip to content

CLI reference

tsdive spc

Chart a window against baseline control limits.

The usage walkthrough has a section on it.

Usage

usage: tsdive spc [-h] --baseline BASELINE --window WINDOW
                  [--basis {TIME_WEIGHTED,EVENT_WEIGHTED}] [--stepped]
                  [--json] [--no-color]
                  parquet

Options

Argument Value Default Description
parquet required single-tag parquet archive to chart
--baseline BASELINE required ISO 8601 START/END in UTC the limits are computed from
--window WINDOW required ISO 8601 START/END in UTC to chart
--basis {TIME_WEIGHTED,EVENT_WEIGHTED} TIME_WEIGHTED calculation basis declared on the read
--stepped stepped interpolation between samples
--json print one JSON object and nothing else
--no-color plain text, no ANSI colour (NO_COLOR does the same)

Example

$ tsdive spc data/demo/fic101_demo.parquet \
    --baseline "2024-03-30T20:00:00Z/2024-03-31T01:00:00Z" \
    --window "2024-03-31T01:00:00Z/2024-03-31T06:00:00Z"
demo:FIC101.PV  37 rule hits in 300 samples

baseline  2024-03-30 20:00:00Z -> 2024-03-31 01:00:00Z   GOOD 261   censored no
window    2024-03-31 01:00:00Z -> 06:00:00Z
limits    center 62.32   sigma 0.5488   lcl 60.67   ucl 63.97
basis     individuals 3-sigma

BEYOND_3SIGMA  29
  2024-03-31 02:01:00Z -> 02:29:00Z   29 samples

RUN_9_SAMESIDE  6
  2024-03-31 01:08:00Z   9 consecutive points on one side of center 62.32
  2024-03-31 01:58:00Z   9 consecutive points on one side of center 62.32
  2024-03-31 02:09:00Z   9 consecutive points on one side of center 62.32
  2024-03-31 02:38:00Z   9 consecutive points on one side of center 62.32
  2024-03-31 04:36:00Z   9 consecutive points on one side of center 62.32
  (+1 more run)

TREND_6  2
  2024-03-31 01:25:00Z   6 consecutively increasing/decreasing points
  2024-03-31 05:56:00Z   6 consecutively increasing/decreasing points