Charts
Chart types
The 29 chart types, what each is for and how to add one.
Kymoscope draws 29 kinds of chart from the same datasets. Every chart in these pages is drawn live by the engine from the data of its example, so what you copy is what you see.
Add a chart
A chart is a kind plus settings. Settings name columns of the datasets in the worksheet; the chart draws every selected dataset, and shows an empty state until its columns are set.
import { createEngine } from '@kymoscope/sdk'
const engine = createEngine({ licenseKey })
await engine.datasets.addText(await file.text(), file.name)
const chart = engine.charts.add('histogram', {
title: 'Shaft diameter',
settings: { histColumn: 'diameter', histNormal: true },
})
engine.charts.mount(chart, document.getElementById('chart')!)
// Later: change any setting; the kind stays.
engine.charts.update(chart, { histBins: 40 })Settings you leave out take their defaults (listed under each chart). In the app, the same settings are in the chart's settings dialog. See Worksheets and charts for layout and windows, and Mounting and styling charts for colours and themes.
Which chart to use
| Chart | Use it for |
|---|---|
| Multi-band | The main time-series chart. |
| Area Chart | Filled areas of several columns over an X column, stacked to show how parts add up to a total (energy sources, load per line, queue by state). |
| Spectrum | The FFT of one signal. |
| Spectrogram | A short-time FFT. |
| Control Chart | Statistical process control. |
| Gauges | Dials and bars for the current value of a few channels. |
| Camera | Video of a camera next to its data. |
| X-Y scatter | One column against another, to see how they relate. |
| Bubble Chart | A scatter where each point is a bubble sized (and optionally coloured) by more columns. |
| X-Y-Z mesh | Three columns in 3-D. |
| Heatmap | A value as colour over a grid. |
| Polar | A value against an angle. |
| Parallel Coords | Many columns at once. |
| Radar | A profile across several measures, one polygon per group. |
| Histogram | How the values of one column are distributed. |
| Box Plot | The distribution of a value per group as boxes (quartiles, median, whiskers, outliers). |
| Violin | Like a box plot, with the full shape of each distribution (kernel density). |
| CDF / ECDF | The empirical cumulative distribution. |
| Q-Q Plot | The quantiles of a column against a normal distribution (or against another column). |
| Bar Chart | Values per category as bars, grouped or stacked. |
| Treemap | A hierarchy as nested rectangles sized by value. |
| Sankey | Flows between stages as bands whose width is the amount. |
| Flame Graph | A hierarchy as stacked bars whose width is the value. |
| Gantt Chart | Intervals on a time axis, one bar per row. |
| Confusion Matrix | Actual against predicted classes of a classifier. |
| ROC Curve | How well a score separates two classes at every threshold. |
| Calibration Curve | Whether predicted probabilities mean what they say. |
| Loss Curves | Training curves on two Y axes. |
| Embedding | A 2-D embedding (t-SNE, UMAP, PCA output) coloured by class or by value. |
By family
- Signals and time series: Multi-band, Area Chart, Spectrum, Spectrogram, Control Chart, Gauges, Camera.
- Relationships: X-Y scatter, Bubble Chart, X-Y-Z mesh, Heatmap, Polar, Parallel Coords, Radar.
- Distributions: Histogram, Box Plot, Violin, CDF / ECDF, Q-Q Plot.
- Categories, hierarchies and flows: Bar Chart, Treemap, Sankey, Flame Graph, Gantt Chart.
- Machine learning: Confusion Matrix, ROC Curve, Calibration Curve, Loss Curves, Embedding.
What every chart shares
- Reference lines. Most kinds take an alarm line (
histAlarm,bcAlarm, …):{ value, style, width, color }, ornullfor none. A line linked to an alert rule follows the rule's threshold (see Alerts). - Annotations. Text, arrows, boxes and strokes drawn on any chart, saved with it (see Worksheets and charts).
- Cursor and zoom. Charts of a worksheet share its X range and cursor; multi-band charts set the cursor on hover.
- Theme. Every chart follows dark or light mode; mount options set its colours.
- Text columns. Category, name and class columns can hold text when the data comes from CSV (
datasets.addTextor an imported file);addColumnstakes numbers only. A units row under the header is optional; when the reader guesses the rows wrong, setparseConfigwithdatasets.configure. - Several datasets. Selected datasets draw together, each in its own colour, so runs compare in the same chart.