stream-charts 1.0.1 → 1.1.1

package/README.md

@@ -4,76 +4,116 @@
 [Change History](changes.md) •
 [Example Project](https://github.com/robphilipp/stream-charts-examples)
 
-`stream-charts` are [react](https://reactjs.org)-based time-series charts for viewing high frequency data, streamed in real-time using [rxjs](https://rxjs-dev.firebaseapp.com). Generally, update periods of 25 ms aren't a problem for about a hundred or so time-series. To achieve this type of performance, the charts are implemented using [d3](https://d3js.org) SVG elements, wrapped in react functional components, and keep chart updates outside the react render cycle.
+## [&#10514;](#top) <span id="intro">intro</span>
+`stream-charts` is a [react](https://reactjs.org)-based library for building real-time time-series charts for viewing high frequency data. Ingesting and plotting new data for about 100 time-series every 25 ms isn't generally a problem. 
 
-### quick overview
+The following plot types are currently available:
 
-With `stream-charts` you can display initial (or static) data as well as live data from an `Observable`.
+1. **Scatter Plot**: for plotting time-series data.
+2. **Raster Plot**: for plotting event-timing data.
+3. **Bar Plot**: for plotting time-series as bars that show the current value and its minimum, maximum, and mean values for all times and time-windows.
+4. **Poincare Plot**: for plotting function iterates (`f[n](t)` vs `f[n-m](t)`).
 
-`Charts` are composable using react components. So you can add different axis types, multiple axes, trackers, tooltips, and plots.
+> Try it on codesandbox [stream-charts](https://codesandbox.io/p/sandbox/n7c8jm)
 
-All aspects of the `Charts` style are exposed allowing you to use your favorite frameworks theme provider, or none at all.
-
-`Charts` provide zooming and panning can be enabled or disabled. And zooming is set to use a modifier key by default so that it doesn't interfere with normal scrolling.
+`Charts` are composable using react components. So you can add different axis types, multiple axes, trackers, tooltips, and plots. `stream-charts` provides the following react components from which to build your own charts:
+1. The [Chart](#chart-usage) serves as the container, holding the other components as children, and providing the data to the plot.
+2. The [ContinuousAxis](#continuous-axes-usage) and [OrdinalAxis](#ordinal-axes-usage) components define the x- and y-axes, and provide the scales for the axes. Charts are required to have at least one x-axis and one y-axis.
+3. The optional [Tracker](#tracker-usage) component shows the value associated with the current mouse location of the axes to which it is assigned.
+4. The optional [Tooltip](#tooltip-usage) component shows the `TooltipContent` for the datum under the mouse cursor. Each plot type has a default tooltip content component ([ScatterPlotTooltipContent](#scatterplot-tooltip-usage), [RasterPlotTooltipContent](#rasterplot-tooltip-usage), [BarPlotTooltipContent](#barplot-tooltip-usage), [PoincarePlotTooltipContent](#poincareplot-tooltip-usage)).
+5. The `Plot` component displays the data. Currently, there are four plot components: [ScatterPlot](#scatter-plot-usage), [RasterPlot](#raster-plot-usage), [BarPlot](#bar-plot-usage), and [PoincarePlot](#poincare-plot-usage).
 
-When using lower update frequencies, such as < 250 ms, and data updates are sparse, you can set an update cadence so that the plot's time smoothly scrolls, rather than updating only when new data arrives.
+### [&#10514;](#content) <span id="axes">capabilities</span>
+Charts can have multiple x-axes and y-axes, and these axes can have different scales. Time series can be assigned to an axis or use the default one. Currently, there are continuous and ordinal (category) axes. Continuous axes are available with all the scales supported by [d3](https://d3js.org) (for example, linear scales, logarithmic scales, and power scales).
 
-`Charts` can have a data TTL (time-to-live) to drop older data to allow long-running streams of data. With the data-update callback you can capture that data and store it in local storage, memory, or a location of your choice.
+Each plot type comes with a default tooltip and tooltip content. However, you can customize the tooltip and tooltip content to suit your needs.
 
+The charts are designed to be responsive to changes in size, for example, to support window resizing.
 
-### project status
-Although still under development, there are two charts available:
+With `stream-charts` you can display initial (static) data as well as live data from an [Observable](https://rxjs-dev.firebaseapp.com/api/index/class/Observable).
 
-1. a neuron raster chart, and a
-2. scatter chart.
-
-Over time, I'll add additional chart types. In the meantime, I welcome any contributions to create new chart types (bar, gauges, etc).
-
-## [&#10514;](#top) <span id="content">content</span>
+All aspects of the `Charts` style are exposed allowing you to use your favorite frameworks theme provider, or none at all.
 
-**[quick start](#quick-start)**<br>
-&nbsp;&nbsp;&nbsp;&nbsp;[example raster chart code](#example-raster-chart-code)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;[example scatter chart code](#example-scatter-chart-code)
+`Charts` provide zooming and panning that can be enabled or disabled. And zooming is set to use a modifier key by default so that it doesn't interfere with normal scrolling.
 
-**[intro](#intro)**<br>
-&nbsp;&nbsp;&nbsp;&nbsp;[terminology](#terminology)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;[data ttl, time-windows, performance](#data-ttl)<br>
+### [&#10514;](#top) <span id="content">rendering performance</span>
+Charts can easily ingest and plot new data for about 100 time-series every 25 ms. 
 
-**[chart](#chart)**<br>
-&nbsp;&nbsp;&nbsp;&nbsp;[&lt;Chart/&gt;](#chart-usage)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[dimensions](#chart-usage-dimensions)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[styling](#chart-usage-styling)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[initial data](#chart-usage-initial-data)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[streaming data](#chart-usage-streaming-data)<br>
+When using lower update frequencies, such as < 250 ms, and data updates are sparse, you can set an update cadence so that the plot's time smoothly scrolls, rather than updating only when new data arrives.
 
-**[axes](#axes)**<br>
-&nbsp;&nbsp;&nbsp;&nbsp;[&lt;ContinousAxis/&gt;](#continuous-axes-usage)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[base properties](#continuous-axes-usage-base)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[styling](#continuous-axes-usage-styling)<br>
+`Charts` can have a data TTL (time-to-live) to drop older data to allow long-running streams of data. With the data-update callback you can capture that data and store it in local storage, memory, or a location of your choice.
 
-&nbsp;&nbsp;&nbsp;&nbsp;[&lt;CategoryAxis/&gt;](#category-axes-usage)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[base properties](#category-axes-usage-base)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[styling](#category-axes-usage-styling)<br>
+To achieve this type of performance, the charts:
+1. accept an [rxjs](https://rxjs-dev.firebaseapp.com) [Observable](https://rxjs-dev.firebaseapp.com/api/index/class/Observable) as the source of the time-series data, and
+2. are implemented using [d3](https://d3js.org) SVG elements wrapped in [react](https://reactjs.org) functional components, and
+3. keep chart updates outside [react](https://reactjs.org)'s render cycle.
 
-**[plots](#plots)**<br>
-&nbsp;&nbsp;&nbsp;&nbsp;[&lt;ScatterPlot/&gt;](#scatter-plot-usage)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[base properties](#scatter-plot-usage-base)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[view-modifying interactions](#scatter-plot-usage-view)<br>
 
-&nbsp;&nbsp;&nbsp;&nbsp;[&lt;RasterPlot/&gt;](#raster-plot-usage)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[base properties](#raster-plot-usage-base)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[view-modifying interactions](#raster-plot-usage-view)<br>
+### [&#10514;](#top) <span id="content">project status</span>
+The following plots are currently available:
 
-**[utilities](#utilities)**<br>
-&nbsp;&nbsp;&nbsp;&nbsp;[&lt;Tracker/&gt;](#tracker-usage)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[base properties](#tracker-usage-base)<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[styling](#tracker-usage-styling)<br>
+1. **Scatter Plot**: for plotting time-series data.
+2. **Raster Plot**: for plotting event-timing data.
+3. **Bar Plot**: for plotting windowed stats (min, max, mean).
+4. **Poincare Plot**: for plotting iterates (n vs n-1).
 
-&nbsp;&nbsp;&nbsp;&nbsp;[&lt;Tooltip/&gt;](#tooltip-usage)<br>
+Over time, I'll add additional chart types. In the meantime, I welcome any contributions to create new chart types (gauges, etc).
 
-&nbsp;&nbsp;&nbsp;&nbsp;[&lt;ScatterPlotTooltipContent/&gt;](#scatterplot-tooltip-usage)<br>
+## [&#10514;](#top) <span id="content">content</span>
 
-&nbsp;&nbsp;&nbsp;&nbsp;[&lt;RasterPlotTooltipContent/&gt;](#rasterplot-tooltip-usage)<br>
+**[quick start](#quick-start)**
+- [example raster chart code](#example-raster-chart-code)
+- [example scatter chart code](#example-scatter-chart-code)
+- [example bar chart code](#example-bar-chart-code)
+- [example poincare chart code](#example-poincare-chart-code)
+
+**[intro](#intro)**
+- [terminology](#terminology)
+- [data ttl, time-windows, performance](#data-ttl)
+
+**[chart](#chart)**
+- [&lt;Chart/&gt;](#chart-usage)
+  - [dimensions](#chart-usage-dimensions)
+  - [styling](#chart-usage-styling)
+  - [initial data](#chart-usage-initial-data)
+  - [streaming data](#chart-usage-streaming-data)
+
+**[axes](#axes)**
+- [&lt;ContinuousAxis/&gt;](#continuous-axes-usage)
+  - [base properties](#continuous-axes-usage-base)
+  - [styling](#continuous-axes-usage-styling)
+
+- [&lt;OrdinalAxis/&gt;](#ordinal-axes-usage)
+  - [base properties](#ordinal-axes-usage-base)
+  - [styling](#ordinal-axes-usage-styling)
+
+**[plots](#plots)**
+- [&lt;ScatterPlot/&gt;](#scatter-plot-usage)
+  - [base properties](#scatter-plot-usage-base)
+  - [view-modifying interactions](#scatter-plot-usage-view)
+
+- [&lt;RasterPlot/&gt;](#raster-plot-usage)
+  - [base properties](#raster-plot-usage-base)
+  - [view-modifying interactions](#raster-plot-usage-view)
+
+- [&lt;BarPlot/&gt;](#bar-plot-usage)
+  - [base properties](#bar-plot-usage-base)
+  - [view-modifying interactions](#bar-plot-usage-view)
+
+- [&lt;PoincarePlot/&gt;](#poincare-plot-usage)
+  - [base properties](#poincare-plot-usage-base)
+  - [view-modifying interactions](#poincare-plot-usage-view)
+
+**[utilities](#utilities)**
+- [&lt;Tracker/&gt;](#tracker-usage)
+  - [base properties](#tracker-usage-base)
+  - [styling](#tracker-usage-styling)
+- [&lt;Tooltip/&gt;](#tooltip-usage)
+- [&lt;RasterPlotTooltipContent/&gt;](#rasterplot-tooltip-usage)
+- [&lt;ScatterPlotTooltipContent/&gt;](#scatterplot-tooltip-usage)
+- [&lt;BarPlotTooltipContent/&gt;](#barplot-tooltip-usage)
+- [&lt;PoincarePlotTooltipContent/&gt;](#poincareplot-tooltip-usage)
+- [hooks](#hooks)
 
 
 ## [&#10514;](#content) <span id="quick-start">quick start</span>
@@ -83,66 +123,99 @@ npm install stream-charts
 ```
 
 ### [&#10514;](#content) <span id="example-raster-chart-code">example raster chart</span>
-For the neuron raster chart (see [example](https://github.com/robphilipp/stream-charts-examples/blob/master/src/app/examples/StreamingRasterChart.tsx))
+An example raster chart (see [example](https://github.com/robphilipp/stream-charts-examples/blob/master/src/app/examples/StreamingRasterChart.tsx))
 
-![raster-chart](https://github.com/robphilipp/stream-charts/blob/master/images/raster-magnifier.png?raw=true)
+![raster-chart](https://github.com/robphilipp/stream-charts/blob/develop/images/raster-chart-tooltip.png?raw=true)
 
 
 ```typescript jsx
-import {RasterChart} from "stream-charts";
-// .
-// .
-// .
 <Chart
+    chartId={chartId.current}
     width={useGridCellWidth()}
     height={useGridCellHeight()}
-    margin={{...defaultMargin, top: 60, right: 60}}
+    margin={{...defaultMargin, top: 40, right: 75, left: 70, bottom: 40}}
+    // svgStyle={{'background-color': 'pink'}}
     color={theme.color}
     backgroundColor={theme.backgroundColor}
     seriesStyles={new Map([
-        ['test1', {...defaultLineStyle, color: 'orange', lineWidth: 1, highlightColor: 'orange'}],
-        ['test2', {...defaultLineStyle, 
-            color: theme.name === 'light' ? 'blue' : 'gray', 
-            lineWidth: 3, 
-            highlightColor: theme.name === 'light' ? 'blue' : 'gray', 
-            highlightWidth: 5}
-        ],
+        ['neuron1', {
+            ...defaultLineStyle(),
+            color: 'orange',
+            lineWidth: 2,
+            highlightColor: 'orange'
+        }],
+        ['neuron2', {
+            ...defaultLineStyle(),
+            color: 'orange',
+            lineWidth: 2,
+            highlightColor: 'orange'
+        }],
+        ['neuron3', {
+            ...defaultLineStyle(),
+            color: 'orange',
+            lineWidth: 2,
+            highlightColor: 'orange'
+        }],
+        ['neuron4', {
+            ...defaultLineStyle(),
+            color: 'orange',
+            lineWidth: 2,
+            highlightColor: 'orange'
+        }],
+        ['neuron5', {
+            ...defaultLineStyle(),
+            color: 'orange',
+            lineWidth: 2,
+            highlightColor: 'orange'
+        }],
+        ['neuron6', {
+            ...defaultLineStyle(),
+            color: theme.name === 'light' ? 'blue' : 'gray',
+            lineWidth: 3,
+            highlightColor: theme.name === 'light' ? 'blue' : 'gray',
+            highlightWidth: 5
+        }],
+        // ['test3', {...defaultLineStyle, color: 'dodgerblue', lineWidth: 1, highlightColor: 'dodgerblue', highlightWidth: 3}],
     ])}
     initialData={initialDataRef.current}
     seriesFilter={filter}
     seriesObservable={observableRef.current}
     shouldSubscribe={running}
-    windowingTime={35}
+    onUpdateAxesBounds={handleChartTimeUpdate}
+    windowingTime={25}
+    // onSubscribe={subscription => console.log("subscribed raster")}
 >
     <ContinuousAxis
         axisId="x-axis-1"
         location={AxisLocation.Bottom}
         domain={[0, 5000]}
-        label="x-axis"
+        label="t (ms)"
         // font={{color: theme.color}}
     />
     <ContinuousAxis
         axisId="x-axis-2"
         location={AxisLocation.Top}
-        domain={[0, 10000]}
-        label="x-axis"
+        domain={[0, 5000]}
+        label="t (ms)"
         // font={{color: theme.color}}
     />
-    <CategoryAxis
+    <OrdinalAxis
         axisId="y-axis-1"
         location={AxisLocation.Left}
         categories={initialDataRef.current.map(series => series.name)}
-        label="y-axis"
+        label="neuron"
+        axisTickStyle={{rotation: 25}}
     />
-    <CategoryAxis
+    <OrdinalAxis
         axisId="y-axis-2"
         location={AxisLocation.Right}
         categories={initialDataRef.current.map(series => series.name)}
-        label="y-axis"
+        label="neuron"
     />
     <Tracker
         visible={visibility.tracker}
-        labelLocation={TrackerLabelLocation.WithMouse}
+        labelLocation={TrackerLabelLocation.ByAxis}
+        labelFormatter={x => `${d3.format(",.0f")(x)} ms`}
         style={{color: theme.color}}
         font={{color: theme.color}}
         // onTrackerUpdate={update => console.dir(update)}
@@ -164,14 +237,20 @@ import {RasterChart} from "stream-charts";
     <RasterPlot
         axisAssignments={new Map([
             // ['test', assignAxes("x-axis-1", "y-axis-1")],
-            ['test1', assignAxes("x-axis-2", "y-axis-2")],
+            ['neuron1', assignAxes("x-axis-2", "y-axis-2")],
+            ['neuron2', assignAxes("x-axis-2", "y-axis-2")],
+            ['neuron3', assignAxes("x-axis-2", "y-axis-2")],
+            ['neuron4', assignAxes("x-axis-2", "y-axis-2")],
+            ['neuron5', assignAxes("x-axis-2", "y-axis-2")],
+            ['neuron6', assignAxes("x-axis-2", "y-axis-2")],
             // ['test3', assignAxes("x-axis-1", "y-axis-1")],
         ])}
-        dropDataAfter={10000}
+        spikeMargin={1}
+        dropDataAfter={5000}
         panEnabled={true}
         zoomEnabled={true}
         zoomKeyModifiersRequired={true}
-        withCadenceOf={30}
+        withCadenceOf={50}
     />
 </Chart>
 ```
@@ -180,39 +259,51 @@ import {RasterChart} from "stream-charts";
 
 An example scatter chart  (see [example](https://github.com/robphilipp/stream-charts-examples/blob/master/src/app/examples/StreamingScatterChart.tsx))
 
-![scatter-chart-tooltip](https://github.com/robphilipp/stream-charts/blob/master/images/scatter-tooltip.png?raw=true)
+![scatter-chart-tooltip](https://github.com/robphilipp/stream-charts/blob/develop/images/scatter-chart-with-tooltip.png?raw=true)
 
 
 ```typescript jsx
-import {ScatterChart} from "stream-charts";
-// .
-// .
-// .
 <Chart
+    chartId={chartId.current}
     width={useGridCellWidth()}
     height={useGridCellHeight()}
-    margin={{...defaultMargin, top: 60, right: 60}}
+    margin={{...defaultMargin, top: 40, bottom: 40, right: 60}}
+    // svgStyle={{'background-color': 'pink'}}
     color={theme.color}
     backgroundColor={theme.backgroundColor}
     seriesStyles={new Map([
-        ['test1', {...defaultLineStyle, color: 'orange', lineWidth: 1, highlightColor: 'orange'}],
-        ['test2', {...defaultLineStyle, 
-            color: theme.name === 'light' ? 'blue' : 'gray', 
-            lineWidth: 3, 
-            highlightColor: theme.name === 'light' ? 'blue' : 'gray', 
-            highlightWidth: 5}
-        ],
+        ['test1', {
+            ...defaultLineStyle(),
+            color: 'orange',
+            lineWidth: 1,
+            highlightColor: 'orange'
+        }],
+        ['test2', {
+            ...defaultLineStyle(),
+            color: theme.name === 'light' ? 'blue' : 'gray',
+            lineWidth: 3,
+            highlightColor: theme.name === 'light' ? 'blue' : 'gray',
+            highlightWidth: 5
+        }],
+        ['test3', {
+            ...defaultLineStyle(),
+            color: theme.name === 'light' ? 'dodgerblue' : 'gray',
+            lineWidth: 3,
+            highlightColor: theme.name === 'light' ? 'dodgerblue' : 'gray',
+            highlightWidth: 5
+        }],
     ])}
     initialData={initialDataRef.current}
     seriesFilter={filter}
     seriesObservable={observableRef.current}
     shouldSubscribe={running}
+    onUpdateAxesBounds={handleChartTimeUpdate}
     windowingTime={25}
 >
     <ContinuousAxis
         axisId="x-axis-1"
         location={AxisLocation.Bottom}
-        domain={[10, 5000]}
+        domain={[10, 10000]}
         label="x-axis"
     />
     <ContinuousAxis
@@ -224,7 +315,7 @@ import {ScatterChart} from "stream-charts";
     <ContinuousAxis
         axisId="x-axis-2"
         location={AxisLocation.Top}
-        domain={[100, 2500]}
+        domain={[100, 5000]}
         label="x-axis (2)"
     />
     <ContinuousAxis
@@ -236,7 +327,8 @@ import {ScatterChart} from "stream-charts";
     />
     <Tracker
         visible={visibility.tracker}
-        labelLocation={TrackerLabelLocation.WithMouse}
+        labelLocation={TrackerLabelLocation.ByAxis}
+        labelFormatter={x => `${d3.format(",.0f")(x)} ms`}
         style={{color: theme.color}}
         font={{color: theme.color}}
         // onTrackerUpdate={update => console.dir(update)}
@@ -254,49 +346,297 @@ import {ScatterChart} from "stream-charts";
             xLabel="t (ms)"
             yLabel="count"
             yValueFormatter={value => formatNumber(value, " ,.0f")}
-            yChangeFormatter={value => formatNumber(value, " ,.0f")}
+            yChangeFormatter={(y1, y2) => formatNumber(y2 - y1, " ,.0f")}
         />
     </Tooltip>
     <ScatterPlot
         interpolation={interpolation}
         axisAssignments={new Map([
+            // ['test1', assignAxes("x-axis-1", "y-axis-1")],
             ['test2', assignAxes("x-axis-2", "y-axis-2")],
+            ['test3', assignAxes("x-axis-2", "y-axis-1")],
         ])}
-        dropDataAfter={10000}
+        dropDataAfter={20000}
         panEnabled={true}
         zoomEnabled={true}
         zoomKeyModifiersRequired={true}
-        withCadenceOf={30}
+        // withCadenceOf={30}
+        // timeWindowBehavior={TimeWindowBehavior.SQUEEZE}
     />
 </Chart>
+
 ```
 
-## [&#10514;](#content) <span id="intro">intro</span>
+### [&#10514;](#content) <span id="example-bar-chart-code">example bar chart</span>
 
-`stream-charts` aim to provide high-performance charts for displaying large amounts of data in real-time. The examples (above) show a scatter plot and raster plot whose data was updated about every 25 ms. These plots show 30 time-series of data each. 
+Example bar chart showing windowed statistics (see [example](https://github.com/robphilipp/stream-charts-examples/blob/develop/src/app/examples/StreamingBarChart.tsx)).
 
-> There are obviously limits to the amount of data, and the performance of the plots. For example, the raster chart plots thousands of lines in the chart. When displaying more data in the raster plot, update performance will suffer. Therefore, you must tune your plots somewhat when you are working in the limits of their performance. 
+![bar-chart-tooltip](https://github.com/robphilipp/stream-charts/blob/develop/images/bar-chart-with-tooltip.png?raw=true)
+
+```typescript jsx
+
+<Chart<OrdinalChartData, OrdinalDatum, BarSeriesStyle, WindowedOrdinalStats>
+    chartId={chartId.current}
+    width={useGridCellWidth()}
+    height={useGridCellHeight()}
+    margin={{...defaultMargin, top: 60, bottom: 80, right: 75, left: 70}}
+    // svgStyle={{'background-color': 'pink'}}
+    color={theme.color}
+    backgroundColor={theme.backgroundColor}
+    seriesStyles={new Map<string, BarSeriesStyle>([
+        ['neuron1', {
+            ...defaultBarSeriesStyle('orange'),
+            lineWidth: 2,
+            minMaxBar: {
+                ...defaultBarSeriesStyle('orange').minMaxBar,
+                stroke: {
+                    ...defaultBarSeriesStyle('orange').minMaxBar.stroke,
+                    width: 0
+                }
+            }
+        } as BarSeriesStyle],
+        ['neuron14', {
+            ...defaultBarSeriesStyle(theme.name === 'light' ? 'blue' : 'gray'),
+            lineWidth: 3,
+            highlightWidth: 5,
+            minMaxBar: {
+                ...defaultBarSeriesStyle(theme.name === 'light' ? 'blue' : 'gray').minMaxBar,
+                widthFraction: 1
+            }
+
+        } as BarSeriesStyle],
+        ['neuron31', {
+            ...defaultBarSeriesStyle('green'),
+            lineWidth: 2,
+        } as BarSeriesStyle],
+    ])}
+    initialData={initialDataRef.current}
+    seriesObservable={observableRef.current}
+    seriesFilter={filter}
+    shouldSubscribe={running}
+    onUpdateChartTime={handleChartTimeUpdate}
+    onUpdateAxesBounds={handleChartRangeUpdate}
+    windowingTime={25}
 >
-> The scatter chart can handle a larger number of series at 25 ms update frequency.
+    <OrdinalAxis
+        axisId="x-axis-1"
+        location={AxisLocation.Bottom}
+        categories={initialDataRef.current.map(series => series.name)}
+        label="neuron"
+        axisTickStyle={{rotation: 90}}
+    />
+    <OrdinalAxis
+        axisId="x-axis-2"
+        location={AxisLocation.Top}
+        categories={initialDataRef.current.map(series => series.name)}
+        label="neuron"
+        axisTickStyle={{rotation: 40}}
+    />
+    <ContinuousAxis
+        axisId="y-axis-1"
+        location={AxisLocation.Left}
+        domain={[-1.1, 1.1]}
+        label="ρ (mV)"
+    />
+    <ContinuousAxis
+        axisId="y-axis-2"
+        location={AxisLocation.Right}
+        domain={[-1.1, 1.1]}
+        label="ρ (mV)"
+    />
+    <Tracker
+        visible={visibility.tracker}
+        trackerAxis={AxisLocation.Left}
+        labelLocation={TrackerLabelLocation.ByAxis}
+        labelFormatter={x => `${d3.format(".2f")(x)} mV`}
+        style={{color: theme.color}}
+        font={{color: theme.color}}
+        // onTrackerUpdate={update => console.dir(update)}
+    />
+    <Tooltip
+        visible={visibility.tooltip}
+        style={{
+            fontColor: theme.color,
+            backgroundColor: theme.backgroundColor,
+            borderColor: theme.color,
+            backgroundOpacity: 0.9,
+        }}
+    >
+        <BarPlotTooltipContent ordinalUnits="mV"/>
+    </Tooltip>
+    <BarPlot
+        barMargin={1}
+        dropDataAfter={5000}
+        panEnabled={true}
+        zoomEnabled={true}
+        zoomKeyModifiersRequired={true}
+        // withCadenceOf={50}
+
+        // to have the upper axis zoom when the series zoom, we must have at
+        // least one series assigned to this axis.
+        axisAssignments={new Map([
+            ['neuron1', assignAxes("x-axis-2", "y-axis-2")],
+        ])}
+
+        showMinMaxBars={showMinMax}
+        showValueLines={showValue}
+        showMeanValueLines={showMean}
+        showWindowedMinMaxBars={showWinMinMax}
+        showWindowedMeanValueLines={showWinMean}
+    />
+</Chart>
+```
+
+### [&#10514;](#content) <span id="example-poincare-chart-code">example poincare chart</span>
+
+Example Poincare (iterates) chart (see [example](https://github.com/robphilipp/stream-charts-examples/blob/develop/src/app/examples/StreamingPoincareChart.tsx)).
+
+![poincare-chart-with-tooltip](https://github.com/robphilipp/stream-charts/blob/develop/images/poincare-chart-with-tooltip.png?raw=true)
+
+```typescript jsx
+<Chart
+    chartId={chartId.current}
+    width={useGridCellWidth()}
+    height={useGridCellHeight()}
+    margin={{...defaultMargin, top: 40, bottom: 30, right: 60}}
+    // svgStyle={{'background-color': 'pink'}}
+    color={theme.color}
+    backgroundColor={theme.backgroundColor}
+    seriesStyles={new Map([
+        ['test1', {
+            ...defaultLineStyle(),
+            color: 'orange',
+            lineWidth: 1,
+            highlightColor: 'orange'
+        }],
+        ['test2', {
+            ...defaultLineStyle(),
+            color: theme.name === 'light' ? 'blue' : 'gray',
+            lineWidth: 1,
+            highlightColor: theme.name === 'light' ? 'blue' : 'gray',
+            highlightWidth: 5
+        }],
+        ['test3', {
+            ...defaultLineStyle(),
+            color: theme.name === 'light' ? 'red' : 'gray',
+            lineWidth: 1,
+            highlightColor: theme.name === 'light' ? 'dodgerblue' : 'gray',
+            highlightWidth: 5
+        }],
+    ])}
+    initialData={initialDataRef.current}
+    // seriesFilter={filter}
+    seriesObservable={observableRef.current}
+    shouldSubscribe={running}
+    onUpdateChartTime={handleChartTimeUpdate}
+    windowingTime={25}
+>
+    <ContinuousAxis
+        axisId="x-axis-1"
+        location={AxisLocation.Bottom}
+        domain={axesRange}
+        label="f[n](x)"
+        updateAxisBasedOnDomainValues={false}
+    />
+    <ContinuousAxis
+        axisId="y-axis-1"
+        location={AxisLocation.Left}
+        domain={axesRange}
+        label={`f[n+${lagN}](x)`}
+        updateAxisBasedOnDomainValues={false}
+    />
+    <ContinuousAxis
+        axisId="x-axis-2"
+        location={AxisLocation.Top}
+        domain={axesRange}
+        label="f[n](x)"
+        updateAxisBasedOnDomainValues={false}
+    />
+    <ContinuousAxis
+        axisId="y-axis-2"
+        location={AxisLocation.Right}
+        domain={axesRange}
+        label={`f[n+${lagN}](x)`}
+        updateAxisBasedOnDomainValues={false}
+    />
+    <Tracker
+        key="tracker-x-axis"
+        visible={visibility.tracker}
+        // labelLocation={TrackerLabelLocation.Nowhere}
+        labelLocation={TrackerLabelLocation.ByAxis}
+        trackerAxis={AxisLocation.Bottom}
+        labelFormatter={x => `${d3.format(",.3f")(x)}`}
+        style={{color: theme.color}}
+        font={{color: theme.color}}
+        // onTrackerUpdate={update => console.dir("bottom", update)}
+    />
+    <Tracker
+        key="tracker-y-axis"
+        visible={visibility.tracker}
+        // labelLocation={TrackerLabelLocation.Nowhere}
+        labelLocation={TrackerLabelLocation.ByAxis}
+        trackerAxis={AxisLocation.Left}
+        labelFormatter={x => `${d3.format(",.3f")(x)}`}
+        style={{color: theme.color}}
+        font={{color: theme.color}}
+        // onTrackerUpdate={update => console.dir("left", update)}
+    />
+    <Tooltip
+        visible={visibility.tooltip}
+        style={{
+            fontColor: theme.color,
+            backgroundColor: theme.backgroundColor,
+            borderColor: theme.color,
+            backgroundOpacity: 0.9,
+        }}
+    >
+        <PoincarePlotTooltipContent
+            xLabel="t (ms)"
+            yLabel="f(x)"
+            yValueFormatter={value => formatNumber(value, " ,.4f")}
+            style={{
+                ...defaultTooltipStyle,
+                fontColor: 'black',
+                // fontColor: theme.color,
+                fontWeight: 650
+            }}
+        />
+    </Tooltip>
+    <PoincarePlot
+        interpolation={interpolation}
+        dropDataAfter={dropAfterMs}
+        panEnabled={true}
+        zoomEnabled={true}
+        zoomKeyModifiersRequired={true}
+        // withCadenceOf={30}
+    />
+</Chart>
+```
+
+## [&#10514;](#content) <span id="intro">intro</span>
+
+`stream-charts` aim to provide high-performance charts for displaying large amounts of data in real-time. The examples (above) show various plot types whose data can be updated about every 25 ms.
+
+There are obviously limits to the amount of data, and the performance of the plots. For example, the raster chart plots thousands of lines in the chart. When displaying more data in the raster plot, update performance will suffer. Therefore, you must tune your plots somewhat when you are working in the limits of their performance.
 
 ### [&#10514;](#content) <span id="terminology">terminology</span>
 
-A &lt;Chart/&gt; holds a `plot`, the `axes`, and optionally, a &lt;Tracker/&gt;, and a &lt;Tooltip/&gt;. A &lt;Chart/&gt; is generic, and holds a specific type of `plot`, for example, a &lt;RasterPlot/&gt; or a &lt;ScatterPlot/&gt;. The `plot` holds the data, and optionally provides pan and zoom. The `axes` provide the scale of the data. For example, the scale could be a continuous numeric logarithmic scale, or a category scale. The `axes` are also generic. Though, a `plot` can restrict the type of `axes` allowed. For example, a &lt;RasterPlot/&gt; requires that the y-axes are category axes. &lt;Trackers/&gt; are generic. &lt;Tooltipes/&gt; are also generic, though the tooltip content is a child, specific to a plot type, that it knows how to interpret and present the data.
+A &lt;Chart/&gt; holds a `plot`, the `axes`, and optionally, a &lt;Tracker/&gt;, and a &lt;Tooltip/&gt;. A &lt;Chart/&gt; is generic, and holds a specific type of `plot`, for example, a &lt;RasterPlot/&gt;, &lt;ScatterPlot/&gt;, &lt;BarPlot/&gt;, or &lt;PoincarePlot/&gt;. The `plot` holds the data, and optionally provides pan and zoom. The `axes` provide the scale of the data. For example, the scale could be a continuous numeric logarithmic scale, or an ordinal scale. The `axes` are also generic. Though, a `plot` can restrict the type of `axes` allowed. For example, a &lt;RasterPlot/&gt; requires that the y-axes are ordinal axes. &lt;Trackers/&gt; are generic. &lt;Tooltips/&gt; are also generic, though the tooltip content is a child, specific to a plot type, that it knows how to interpret and present the data.
 
-> **&lt;Chart/&gt;** [&#8628;](#chart)<br>
-> Generic container which holds the `Axes`, `Plot`, `Tracker`, `Tooltip`.
+**&lt;Chart/&gt;** [&#8628;](#chart)<br>
+Generic container which holds the `Axes`, `Plot`, `Tracker`, `Tooltip`.
 
-> **Axes** [&#8628;](#axes)<br>
-> Defines the scale of the data. `stream-charts` current has two axis types: [&lt;ContinousAxis/&gt;](#continuous-axes-usage) and [&lt;CategoryAxis/&gt;](#category-axes-usage). The &lt;ContinousAxis can be used as an x-axis or y-axis. However, the &lt;CategoryAxis/&gt; can only be used as a y-axes because these are all time-series charts and the x-axis currently only represents time (this will change in the future with additional plot types). 
+**Axes** [&#8628;](#axes)<br>
+Defines the scale of the data. `stream-charts` current has two axis types: [&lt;ContinuousAxis/&gt;](#continuous-axes-usage) and [&lt;OrdinalAxis/&gt;](#ordinal-axes-usage). The &lt;ContinuousAxis/&gt; can be used as an x-axis or y-axis. However, the &lt;OrdinalAxis/&gt; can only be used as a y-axes because these are all time-series charts and the x-axis currently only represents time.
 
-> **Plot** [&#8628;](#plots)<br>
-> The plot is a container for the data that uses the `axes` for scale, domain, and range information. Plots provide panning and zooming of the x-axis (time), interacting with the `axes` to update the time-range. The plot is the visual representation of the data. Currently, two type of plots are available: [&lt;RasterPlot/&gt;](#raster-plot-usage), and [&lt;ScatterPlot/&gt;](#scatter-plot-usage).
+**Plot** [&#8628;](#plots)<br>
+The plot is a container for the data that uses the `axes` for scale, domain, and range information. Plots provide panning and zooming of the x-axis (time), interacting with the `axes` to update the time-range. The plot is the visual representation of the data. Currently, four types of plots are available: [&lt;RasterPlot/&gt;](#raster-plot-usage), [&lt;ScatterPlot/&gt;](#scatter-plot-usage), [&lt;BarPlot/&gt;](#bar-plot-usage), and [&lt;PoincarePlot/&gt;](#poincare-plot-usage).
 
-> **&lt;Tracker/&gt;** [&#8628;](#tracker-usage)<br>
-> The tracker displays the current plot time of the mouse. When multiple x-axes are used in the chart, then the tracker displays both times (i.e. from the upper and lower x-axis).
+**&lt;Tracker/&gt;** [&#8628;](#tracker-usage)<br>
+The tracker displays the current plot time of the mouse. When multiple x-axes are used in the chart, then the tracker displays both times (i.e. from the upper and lower x-axis).
 
-> **&lt;Tooltip/&gt;** [&#8628;](#tooltip-usage)<br>
-> The tooltip is a generic component for rendering information about the data when the user mouses over a series or datum. The `<Tooltip/>` expects a child component that understands the data and renders the information show in the tooltip. For example, when using a [&lt;RasterPlot/&gt;](#raster-plot-usage), the [&lt;RasterPlotTooltipContent/&gt;](#rasterplot-tooltip-usage) renders the data for the raster plot tooltip. And when using a [&lt;ScatterPlot/&gt;](#scatter-plot-usage), the [&lt;ScatterPlotTooltipContent/&gt;](#scatterplot-tooltip-usage) renders the data for the scatter plot tooltip. The tooltip content can be extended.
+**&lt;Tooltip/&gt;** [&#8628;](#tooltip-usage)<br>
+The tooltip is a generic component for rendering information about the data when the user mouses over a series or datum. The `<Tooltip/>` expects a child component that understands the data and renders the information show in the tooltip. For example, when using a [&lt;RasterPlot/&gt;](#raster-plot-usage), the [&lt;RasterPlotTooltipContent/&gt;](#rasterplot-tooltip-usage) renders the data for the raster plot tooltip. And when using a [&lt;ScatterPlot/&gt;](#scatter-plot-usage), the [&lt;ScatterPlotTooltipContent/&gt;](#scatterplot-tooltip-usage) renders the data for the scatter plot tooltip. The tooltip content can be extended.
 
 ### [&#10514;](#content) <span id="data-ttl">data ttl, time-windows, performance</span>
 
@@ -327,93 +667,92 @@ The `Chart`s properties fall into four categories:
 4. streamed data and how to manage the stream of data
 
 #### [&#10514;](#content) <span id="chart-usage-dimensions">&lt;Chart/&gt; dimensions</span>
-> **width (pixels)**<br>
-> The width (in pixels) of the container that holds the chart. The actual plot will be smaller based on the margins.
+**width (pixels)**<br>
+The width (in pixels) of the container that holds the chart. The actual plot will be smaller based on the margins.
 
-> **height (pixels)**<br>
-> The height (in pixels) of the container that holds the chart. The actual plot will be smaller based on the margins.
+**height (pixels)**<br>
+The height (in pixels) of the container that holds the chart. The actual plot will be smaller based on the margins.
 
 #### [&#10514;](#content) <span id="chart-usage-styling">&lt;Chart/&gt; styling</span>
-> **margin ([Margin](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/margins.ts), optional)**<br>
-> The margin (in pixels) around plot. For example, if the container has a (h, w) = (300, 600) and a margin of 10 pixels for the top, left, right, bottom, then the actual plot will have a (h, w) = (290, 590), leaving only 10 pixels around the plot for axis titles, ticks, and axis labels. 
-> 
-> The Margin has the following shape 
+**margin ([Margin](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/margins.ts), optional)**<br>
+The margin (in pixels) around plot. For example, if the container has a (h, w) = (300, 600) and a margin of 10 pixels for the top, left, right, bottom, then the actual plot will have a (h, w) = (290, 590), leaving only 10 pixels around the plot for axis titles, ticks, and axis labels. 
+
+The Margin has the following shape 
 >```typescript
 >interface Margin {
->   top: number
->   bottom: number
->   left: number
->   right: number
+  top: number
+  bottom: number
+  left: number
+  right: number
 >}
 >```
 
 
-> **color (string, optional)**<br>
-> The color of the axis lines and text, which can be overridden specifically by the axes styles.
+**color (string, optional)**<br>
+The color of the axis lines and text, which can be overridden specifically by the axes styles.
+
+**backgroundColor (string, optional)**<br>
+The color of the chart background (the whole chart, not just the plot).
 
-> **backgroundColor (string, optional)**<br>
-> The color of the chart background (the whole chart, not just the plot).
+**svgStyle ([SvgStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/svgStyle.ts), optional)**<br>
+The style attributes for the main SVG element, in case you want to change those. Generally, this is not needed.
 
-> **svgStyle ([SvgStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/svgStyle.ts), optional)**<br>
-> The style attributes for the main SVG element, in case you want to change those. Generally, this is not needed.
-> 
-> The SvgStyle has the following shape 
+The SvgStyle has the following shape 
 >```typescript
 >interface SvgStyle {
->   height?: string | number 
->   width?: string | number 
->   outline?: string
->   // any valid SVG CSS attribute
->   [propName: string]: any
+  height?: string | number 
+  width?: string | number 
+  outline?: string
+  // any valid SVG CSS attribute
+  [propName: string]: any
 >}
 >```
 
-> **seriesStyles (Map&lt;string, [SeriesLineStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) &gt;, optional)**<br>
-> A map holding the data series name with an associated SeriesLineStyle. Any series listed in this map will use the associated styles for that series. Any series not in the map will use the default series styles.
-> 
-> The SeriesLineStyle has the following shape
-> ```typescript
-> interface SeriesLineStyle {
->    color: string
->    lineWidth: number
->    // the color of the series when the user mouses over the series
->    highlightColor: string
->    // the line width of the series when the user mouses over the series 
->    highlightWidth: number
->    // the line margin used for raster charts
->    margin?: number
-> }
+**seriesStyles (Map&lt;string, [SeriesLineStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) &gt;, optional)**<br>
+A map holding the data series name with an associated SeriesLineStyle. Any series listed in this map will use the associated styles for that series. Any series not in the map will use the default series styles.
+
+The SeriesLineStyle has the following shape
+```typescript
+interface SeriesLineStyle {
+   color: string
+   lineWidth: number
+   // the color of the series when the user mouses over the series
+   highlightColor: string
+   // the line width of the series when the user mouses over the series 
+   highlightWidth: number
+   // the line margin used for raster charts
+   margin?: number
+}
 >```
 
 #### [&#10514;](#content) <span id="chart-usage-initial-data">&lt;Chart/&gt; initial data</span>
 
 Holds the initial (static data). This data is displayed in the chart even before subscribing to the chart-data observable. The initial data can be used to generate static charts.
 
-> **initialData (Array<[Series](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/datumSeries.ts) >)**<br>
-> An array holding the initial data series to be plotted before subscribing to the chart-data observable.  
+**initialData (Array<[Series](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/datumSeries.ts) >)**<br>
+An array holding the initial data series to be plotted before subscribing to the chart-data observable.  
 >
-> The Series has the following shape
-> ```typescript
-> interface Series {
->    // the series name
->    readonly name: string;
->    // the array of time-value pairs
->    data: Array<Datum>;
->    // ... accessor functions
->    . 
->    . 
->    . 
-> }
->
->```
-> And the [Datum](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/datumSeries.ts) is an immutable object that has the following shape 
-> ```typescript
-> interface Datum {
->    readonly time: number;
->    readonly value: number;
-> }
+The Series has the following shape
+```typescript
+interface Series {
+   // the series name
+   readonly name: string
+   // the array of time-value pairs
+   data: Array<Datum>
+   // ... accessor functions
+   // . 
+   // . 
+   // . 
+}
+```
+And the [Datum](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/datumSeries.ts) is an immutable object that has the following shape 
+```typescript
+interface Datum {
+   readonly time: number;
+   readonly value: number;
+}
 >```
-> There are a number of helper functions for creating `Series` and `Datum`.
+There are a number of helper functions for creating `Series` and `Datum`.
 >> `seriesFrom(name: string, data: Array<Datum> = []): Series`<br>
 >> `seriesFromTuples(name: string, data: Array<[number, number]> = []): Series`<br>
 >> `emptySeries(name: string): Series`<br>
@@ -423,42 +762,42 @@ Holds the initial (static data). This data is displayed in the chart even before
 
 A set of properties, functions, and callbacks to control and observe the streaming of live data into the chart.
 
-> **seriesObservable (Observable<[ChartData](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/chartData.ts) >)**<br>
-> An observable of (source for) chart-data. The `shouldSubscribe` property controls whether the chart subscribes to the observable, or unsubscribes. This is the source of live data to the chart. An example of an observable is shown below.
-> ```typescript
-> function randomSpikeDataObservable(
->     series: Array<Series>,
->     updatePeriod: number = UPDATE_PERIOD_MS,
->     spikeProbability: number = 0.1
-> ): Observable<ChartData> {
->   const seriesNames = series.map(series => series.name)
->   const initialData = initialChartData(series)
->   return interval(updatePeriod).pipe(
->     // convert the number sequence to a time
->     map(sequence => (sequence + 1) * updatePeriod),
->     // create a random spike for each series
->     map((time) => randomSpikeData(time, seriesNames, initialData.maxTimes, updatePeriod, spikeProbability))
->   )
-> }
-> ```
-
-> **shouldSubscribe (boolean, optional, default = false)**<br>
-> Optional property, that when set from `false` to `true`, causes the &lt;Chart/&gt; to subscribe to the chart-data observable. When set to `false` after a subscription, causes the &lt;Chart/&gt; to unsubscribe from the chart-data observable. 
-
-> **windowingTime (number, milliseconds, optional, default = 100 ms)**<br>
-> Optional property that defines a time-window during which incoming events are buffered, and then handed to plot, causing the plot to update. The `windowingTime` defines the maximum plot update rate, though not the maximum data update rate. The larger the windowing time, the fewer updates per unit time, and the more choppy the updates. Large amounts of data with high update rates can cause rendering delays. The windowing time provides a lever to manage the plot update rates to get the smoothest plot updates that keep up with real-time.
-
-> **shouldSubscribe (number, optional, default = false)**<br>
-> Optional property that default to `false`. When changed to `true`, from `false`, signals the &lt;Chart/&gt; to subscribe to the `seriesObservable`, streaming in the `ChartData` and updating the &lt;Chart/&gt; in real-time.
-
-> **onSubscribe (callback function, (subscription: Subscription) => void, optional, default = noop**<br>
-> Optional callback function that is called when the &lt;Chart/&gt; subscribes to the `ChartData` observable.
-
-> **onUpdateData (callback function, (seriesName: string, data: Array<Datum>)) => void, optional, default = noop)**<br>
-> Optional callback function that is called when the data updates. This callback can be used if you would like to respond to data updates. For example, use this callback if you would like to have the plot drop data after 10 seconds, but would like to store that data in an in-browser database. Though, a more efficient way to store the data would be to subscribe to the series-observable separately, and then use that observer to stream the data to the storage.
-
-> **onUpdateTime (callback function, (times: Map<string, [start: number, end: number]>) => void, optional, default = noop)**<br>
-> Optional callback this is called whenever the time-ranges change. Use this to track the current time of the plot.
+**seriesObservable (Observable<[ChartData](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/chartData.ts) >)**<br>
+An observable of (source for) chart-data. The `shouldSubscribe` property controls whether the chart subscribes to the observable, or unsubscribes. This is the source of live data to the chart. An example of an observable is shown below.
+```typescript
+function randomSpikeDataObservable(
+    series: Array<Series>,
+    updatePeriod: number = UPDATE_PERIOD_MS,
+    spikeProbability: number = 0.1
+): Observable<ChartData> {
+  const seriesNames = series.map(series => series.name)
+  const initialData = initialChartData(series)
+  return interval(updatePeriod).pipe(
+    // convert the number sequence to a time
+    map(sequence => (sequence + 1) * updatePeriod),
+    // create a random spike for each series
+    map((time) => randomSpikeData(time, seriesNames, initialData.maxTimes, updatePeriod, spikeProbability))
+  )
+}
+```
+
+**shouldSubscribe (boolean, optional, default = false)**<br>
+Optional property, that when set from `false` to `true`, causes the &lt;Chart/&gt; to subscribe to the chart-data observable. When set to `false` after a subscription, causes the &lt;Chart/&gt; to unsubscribe from the chart-data observable. 
+
+**windowingTime (number, milliseconds, optional, default = 100 ms)**<br>
+Optional property that defines a time-window during which incoming events are buffered, and then handed to plot, causing the plot to update. The `windowingTime` defines the maximum plot update rate, though not the maximum data update rate. The larger the windowing time, the fewer updates per unit time, and the more choppy the updates. Large amounts of data with high update rates can cause rendering delays. The windowing time provides a lever to manage the plot update rates to get the smoothest plot updates that keep up with real-time.
+
+**shouldSubscribe (number, optional, default = false)**<br>
+Optional property that default to `false`. When changed to `true`, from `false`, signals the &lt;Chart/&gt; to subscribe to the `seriesObservable`, streaming in the `ChartData` and updating the &lt;Chart/&gt; in real-time.
+
+**onSubscribe (callback function, (subscription: Subscription) => void, optional, default = noop**<br>
+Optional callback function that is called when the &lt;Chart/&gt; subscribes to the `ChartData` observable.
+
+**onUpdateData (callback function, (seriesName: string, data: Array<Datum>)) => void, optional, default = noop)**<br>
+Optional callback function that is called when the data updates. This callback can be used if you would like to respond to data updates. For example, use this callback if you would like to have the plot drop data after 10 seconds, but would like to store that data in an in-browser database. Though, a more efficient way to store the data would be to subscribe to the series-observable separately, and then use that observer to stream the data to the storage.
+
+**onUpdateTime (callback function, (times: Map<string, [start: number, end: number]>) => void, optional, default = noop)**<br>
+Optional callback this is called whenever the time-ranges change. Use this to track the current time of the plot.
 
 ## [&#10514;](#content) <span id="axes">axes</span>
 
@@ -472,67 +811,67 @@ When creating a &lt;ContinuousAxis/&gt;, you must specify its location using the
 
 The base properties defining the axis.
 
-> **axisId (string)**<br>
-> The unique ID of the axis. The axis can then be referred to by this ID. For example, when assigning axes to series, the assignment is made by associating the axis ID to the series name.
+**axisId (string)**<br>
+The unique ID of the axis. The axis can then be referred to by this ID. For example, when assigning axes to series, the assignment is made by associating the axis ID to the series name.
 
-> **location ([AxisLocation](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) )**<br>
-> The location of the axis. As defined by the `AxisLocation` in the the [axes.ts](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) file, x-axes can be placed on the `bottom` or the `top`, and y-axes can be placed on the `left` or the `right`. 
+**location ([AxisLocation](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) )**<br>
+The location of the axis. As defined by the `AxisLocation` in the the [axes.ts](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) file, x-axes can be placed on the `bottom` or the `top`, and y-axes can be placed on the `left` or the `right`. 
 
-> **scale (ScaleContinuousNumeric<number, number>, optional, default = d3.scaleLinear)**<br>
-> The optional scale (factory) of the continuous axis. The scale of the axis is like the axis ruler and determines how the points are placed on the screen. For example, a linear scale is like an evenly spaced ruler, and the mapping between screen location and data value are linear. As another example, the log scale has a logarithmic mapping between the screen location and the data. The scale can be a linear scale (default scale, d3.scaleLinear), a logarithmic scale (d3.scaleLog), a power scale (d3.scalePower), or any other d3 continouos numeric scale that works. Not that if a chart, for example, has two x-axes, that the x-axes are **not** required to have the same scale.
+**scale (ScaleContinuousNumeric<number, number>, optional, default = d3.scaleLinear)**<br>
+The optional scale (factory) of the continuous axis. The scale of the axis is like the axis ruler and determines how the points are placed on the screen. For example, a linear scale is like an evenly spaced ruler, and the mapping between screen location and data value are linear. As another example, the log scale has a logarithmic mapping between the screen location and the data. The scale can be a linear scale (default scale, d3.scaleLinear), a logarithmic scale (d3.scaleLog), a power scale (d3.scalePower), or any other d3 continouos numeric scale that works. Not that if a chart, for example, has two x-axes, that the x-axes are **not** required to have the same scale.
 
-> **domain ([min: number, max: number])**<br>
-> The domain of the axis (in d3 terminology) is effectively the minimum value of the axis and the maximum value of the axis when the initial data is displayed. The domain defines the time-window of the displayed data. For example, if the `domain` for an x-axis is specified as `[1000, 6000]`, then the axis starts at `1000` and ends at `6000`, and the time-window is `5000`. Once data starts to stream past the axis end, the plot starts to scroll, maintaining the calculated time-window (in out example, 5000). Of course, a zooming event will change the domain, and also the time-window.
+**domain ([min: number, max: number])**<br>
+The domain of the axis (in d3 terminology) is effectively the minimum value of the axis and the maximum value of the axis when the initial data is displayed. The domain defines the time-window of the displayed data. For example, if the `domain` for an x-axis is specified as `[1000, 6000]`, then the axis starts at `1000` and ends at `6000`, and the time-window is `5000`. Once data starts to stream past the axis end, the plot starts to scroll, maintaining the calculated time-window (in out example, 5000). Of course, a zooming event will change the domain, and also the time-window.
 
-> **label (string)**<br>
-> The axis label.
+**label (string)**<br>
+The axis label.
 
 #### [&#10514;](#content) <span id="continuous-axes-usage-styling">&lt;ContinuousAxis/&gt; styling</span>
 
 A set of properties to update the style of the axes.
 
-> **font (Partial<[AxesLabelFont](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) >)**<br>
-> An optional CSS properties specifying the font for the axis and tick labels.
+**font (Partial<[AxesLabelFont](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) >)**<br>
+An optional CSS properties specifying the font for the axis and tick labels.
 
 
-### [&#10514;](#content) <span id="category-axes-usage">&lt;CategoryAxis/&gt;</span>
+### [&#10514;](#content) <span id="ordinal-axes-usage">&lt;OrdinalAxis/&gt;</span>
 
-The &lt;CategoryAxis/&gt; must be a child of the &lt;Chart/&gt;. Each &lt;Chart/&gt can one or two category axes for the y-axes. Unlike the [&lt;ContinousAxis/&gt;](#continuous-axes-usage), the &lt;CategoryAxis/&gt; can only be used as a y-axis because for stream charts (at this point) the x-axes represent time. In the same way as with the [&lt;ContinousAxis/&gt;](#continuous-axes-usage), when using multiple multiple y-axes you must assign the series to the axes in one of the `Plot` components. Any series that are not explicitly assigned an axis will be assigned to the default y-axis, which is the left-hand side axis in the &lt;Chart/&gt.
+The &lt;OrdinalAxis/&gt; must be a child of the &lt;Chart/&gt;. Each &lt;Chart/&gt; can have one or two ordinal axes for the y-axes. Unlike the [&lt;ContinuousAxis/&gt;](#continuous-axes-usage), the &lt;OrdinalAxis/&gt; can only be used as a y-axis because for stream charts (at this point) the x-axes represent time. In the same way as with the [&lt;ContinuousAxis/&gt;](#continuous-axes-usage), when using multiple multiple y-axes you must assign the series to the axes in one of the `Plot` components. Any series that are not explicitly assigned an axis will be assigned to the default y-axis, which is the left-hand side axis in the &lt;Chart/&gt;.
 
-When creating a &lt;CategoryAxis/&gt;, you must specify its location using the `AxisLocation` enum defined in the [axes.ts](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) file. Each axis must have a unique axis ID. The &lt;CategoryAxis/&gt; uses a band scale (d3.scaleLinear).
+When creating an &lt;OrdinalAxis/&gt;, you must specify its location using the `AxisLocation` enum defined in the [axes.ts](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) file. Each axis must have a unique axis ID. The &lt;OrdinalAxis/&gt; uses a band scale (d3.scaleBand).
 
-#### [&#10514;](#content) <span id="category-axes-usage-base">&lt;CategoryAxis/&gt; base properties</span>
+#### [&#10514;](#content) <span id="ordinal-axes-usage-base">&lt;OrdinalAxis/&gt; base properties</span>
 
 The base properties defining the axis.
 
-> **axisId (string)**<br>
-> The unique ID of the axis. The axis can then be referred to by this ID. For example, when assigning axes to series, the assignment is made by associating the axis ID to the series name.
+**axisId (string)**<br>
+The unique ID of the axis. The axis can then be referred to by this ID. For example, when assigning axes to series, the assignment is made by associating the axis ID to the series name.
 
-> **location ([AxisLocation](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) )**<br>
-> The location of the axis. As defined by the `AxisLocation` in the the [axes.ts](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) file, x-axes can be placed on the `bottom` or the `top`, and y-axes can be placed on the `left` or the `right`.
+**location ([AxisLocation](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) )**<br>
+The location of the axis. As defined by the `AxisLocation` in the the [axes.ts](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) file, x-axes can be placed on the `bottom` or the `top`, and y-axes can be placed on the `left` or the `right`.
 
-> **categories (Array<string>)**<br>
-> The required `categories` property holds the names of the categories, in the order that they will be displayed on the axis. The first element in the array will be on shown at the top of the axis. The second element will be on lower, and the last element will be at the bottom of the axis.
+**categories (Array<string>)**<br>
+The required `categories` property holds the names of the categories, in the order that they will be displayed on the axis. The first element in the array will be shown at the top of the axis. The second element will be lower, and the last element will be at the bottom of the axis.
 
-> **domain ([min: number, max: number])**<br>
-> The domain of the axis (in d3 terminology) is effectively the minimum value of the displayed axis and the maximum value of the displayed axis when the initial data is displayed. The domain defines the time-window of the displayed data. For example, if the `domain` for an x-axis is specified as `[1000, 6000]`, then the axis starts at `1000` and ends at `6000`, and the time-window is `5000`. Once data starts to stream past the axis end, the plot starts to scroll, maintaining the calculated time-window (in out example, 5000). Of course, a zooming event will change the domain, and also the time-window.
+**domain ([min: number, max: number])**<br>
+The domain of the axis (in d3 terminology) is effectively the minimum value of the displayed axis and the maximum value of the displayed axis when the initial data is displayed. The domain defines the time-window of the displayed data. For example, if the `domain` for an x-axis is specified as `[1000, 6000]`, then the axis starts at `1000` and ends at `6000`, and the time-window is `5000`. Once data starts to stream past the axis end, the plot starts to scroll, maintaining the calculated time-window (in our example, 5000). Of course, a zooming event will change the domain, and also the time-window.
 
-> **label (string)**<br>
-> The axis label.
+**label (string)**<br>
+The axis label.
 
-#### [&#10514;](#content) <span id="category-axes-usage-styling">&lt;CategoryAxis/&gt; styling</span>
+#### [&#10514;](#content) <span id="ordinal-axes-usage-styling">&lt;OrdinalAxis/&gt; styling</span>
 
 A set of properties to update the style of the axes.
 
-> **font (Partial<[AxesLabelFont](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) >, optional)**<br>
-> An optional CSS properties specifying the font for the axis and tick labels.
+**font (Partial<[AxesLabelFont](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/axes.ts) >, optional)**<br>
+An optional CSS properties specifying the font for the axis and tick labels.
 
 
 ## [&#10514;](#content) <span id="plots">plots</span>
 
 ### [&#10514;](#content) <span id="scatter-plot-usage">&lt;ScatterPlot/&gt;</span>
 
-In `stream-charts`, the `plot` is the data visualization component. To work, a plot must be a child of the &lt;Chart/&gt; component so that it is plugged into the `stream-charts` ecosystem. The plot determines how to render the data. But it relies on the axes to determine scaling information so that it can map data to screen locations. And therefore, a plot must have sibling axes ([&lt;ContinousAxis/&gt;](#continuous-axes-usage), [&lt;CategoryAxis/&gt;](#category-axes-usage)) components for the x-axis and the y-axis. Because the plot is responsible for data visualization, it is also where the data series are assigned to axes. The assignment of axes to series is optional, and any series not explicitly assigned to an axis will be assigned to the default axes. The default x-axis is the bottom axis, and the default y-axis is the axis on the left-hand side of the plot. 
+In `stream-charts`, the `plot` is the data visualization component. To work, a plot must be a child of the &lt;Chart/&gt; component so that it is plugged into the `stream-charts` ecosystem. The plot determines how to render the data. But it relies on the axes to determine scaling information so that it can map data to screen locations. And therefore, a plot must have sibling axes ([&lt;ContinousAxis/&gt;](#continuous-axes-usage), [&lt;OrdinalAxis/&gt;](#ordinal-axes-usage)) components for the x-axis and the y-axis. Because the plot is responsible for data visualization, it is also where the data series are assigned to axes. The assignment of axes to series is optional, and any series not explicitly assigned to an axis will be assigned to the default axes. The default x-axis is the bottom axis, and the default y-axis is the axis on the left-hand side of the plot. 
 
 The plot determines what view-modifying user interactions are available. Specifically, panning the data to the left and right in time, and zooming in time.
 
@@ -540,66 +879,115 @@ The &lt;ScatterPlot/&gt; specifically is used to plot time-series data, where th
 
 #### [&#10514;](#content) <span id="scatter-plot-usage-base">&lt;ScatterPlot/&gt; base properties</span>
 
-> **axisAssignments (Map<string, [AxesAssignment](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/plot.ts) >, optional, default = Map())**<br>
-> An optional property that assigns data series to (x, y)-axes. Any series not assigned to an axis will use the default axis. The default x-axis is the bottom axis, and the default y-axis is the axis on the left-hand side of the plot. The `Map` associates the series name with an [AxesAssignment](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/plot.ts), which is a simple object (`{xAxis: string, yAxis: string}`) that holds the axis ID for the x-axis and for the y-axis assigned to the series.
+**axisAssignments (Map<string, [AxesAssignment](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/plot.ts) >, optional, default = Map())**<br>
+An optional property that assigns data series to (x, y)-axes. Any series not assigned to an axis will use the default axis. The default x-axis is the bottom axis, and the default y-axis is the axis on the left-hand side of the plot. The `Map` associates the series name with an [AxesAssignment](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/plot.ts), which is a simple object (`{xAxis: string, yAxis: string}`) that holds the axis ID for the x-axis and for the y-axis assigned to the series.
 
-> **interpolation (d3.CurveFactory, optional, default = d3.curveLinear)**<br>
-> An optional property that defines how the data series line will be interpolated between individual data points. You can use any valid [d3.CurveFactory](https://github.com/d3/d3-shape#curves) for the interpolation. Changing the interpolation once the data is already display, will cause a re-render of the data with the new interpolation.
+**interpolation (d3.CurveFactory, optional, default = d3.curveLinear)**<br>
+An optional property that defines how the data series line will be interpolated between individual data points. You can use any valid [d3.CurveFactory](https://github.com/d3/d3-shape#curves) for the interpolation. Changing the interpolation once the data is already display, will cause a re-render of the data with the new interpolation.
 
-> <span id="scatter-plot-drop">**dropDataAfter (number, milliseconds, opitional, default = Infinity)**</span><br>
-> Optional property that sets when to drop data (effectively a TTL). This only drops data while streaming. Don't worry, your data won't disappear after the streaming has stopped. By default, none of the data is dropped. However, when large amounts of data are being streamed and plotted over long periods of time, memory and performance may become an issue. Setting this value allows a scrolling chart to run forever without running into resource issues.
+<span id="scatter-plot-drop">**dropDataAfter (number, milliseconds, opitional, default = Infinity)**</span><br>
+Optional property that sets when to drop data (effectively a TTL). This only drops data while streaming. Don't worry, your data won't disappear after the streaming has stopped. By default, none of the data is dropped. However, when large amounts of data are being streamed and plotted over long periods of time, memory and performance may become an issue. Setting this value allows a scrolling chart to run forever without running into resource issues.
 
 #### [&#10514;](#content) <span id="scatter-plot-usage-view">&lt;ScatterPlot/&gt; view-modifying interactions</span>
 
 View-modifying interactions are those that change the way the data is displayed. For example, zooming in time, panning in time.
 
-> **panEnabled (boolean, optional, default = false)**<br>
-> Optional property that defaults to `false`. When set to `true` then enables "panning" which allows the user to drag the plot to the left and right.
+**panEnabled (boolean, optional, default = false)**<br>
+Optional property that defaults to `false`. When set to `true` then enables "panning" which allows the user to drag the plot to the left and right.
 
-> **zoomEnabled (boolean, optional, default = false)**<br>
-> Optional property that defaults for `false`. When set to `true` then enables "zooming" which allows the user to increase or decrease the displayed time range. By default, scrolling will cause the zoom effect. See the `zoomKeyModifiersRequired` property which requires the `shift` key to be pressed in order for the zoom action to apply.
+**zoomEnabled (boolean, optional, default = false)**<br>
+Optional property that defaults for `false`. When set to `true` then enables "zooming" which allows the user to increase or decrease the displayed time range. By default, scrolling will cause the zoom effect. See the `zoomKeyModifiersRequired` property which requires the `shift` key to be pressed in order for the zoom action to apply.
 
-> **zoomKeyModifiersRequired (boolean, optional, default = false)**<br>
-> An optional property that defaults to `false`. When set to `true`, and the `zoomEnabled` property is also set to `true`, then requires that the `shift` key be pressed when scrolling in order to activate the zoom. This is nice when a user can scroll through your page containing the plot, so that zooming doesn't interfere with scrolling. 
+**zoomKeyModifiersRequired (boolean, optional, default = false)**<br>
+An optional property that defaults to `false`. When set to `true`, and the `zoomEnabled` property is also set to `true`, then requires that the `shift` key be pressed when scrolling in order to activate the zoom. This is nice when a user can scroll through your page containing the plot, so that zooming doesn't interfere with scrolling. 
 
-> **withCadenceOf (number, optional, default = undefinded)**<br>
-> An optional property that defaults to `undefined`. When set, uses a cadence with the specified refresh period (in milliseconds). For plots with slow data updates (> 100 ms) using a cadence of 10 to 25 ms smooths out the updates so the time scrolling doesn't appear choppy. When updates are around 25 ms or less, then setting the cadence period too small will result in poor update performance. Generally at high update speeds, the cadence is unnecessary. Finally, using cadence, sets the max time to the current time. See also the related &lt;Chart/&gt's `windowingTime` property.
+**withCadenceOf (number, optional, default = undefinded)**<br>
+An optional property that defaults to `undefined`. When set, uses a cadence with the specified refresh period (in milliseconds). For plots with slow data updates (> 100 ms) using a cadence of 10 to 25 ms smooths out the updates so the time scrolling doesn't appear choppy. When updates are around 25 ms or less, then setting the cadence period too small will result in poor update performance. Generally at high update speeds, the cadence is unnecessary. Finally, using cadence, sets the max time to the current time. See also the related &lt;Chart/&gt's `windowingTime` property.
 
 
 ### [&#10514;](#content) <span id="raster-plot-usage">&lt;RasterPlot/&gt;</span>
 
-In `stream-charts`, the `plot` is the data visualization component. To work, a plot must be a child of the &lt;Chart/&gt; component so that it is plugged into the `stream-charts` ecosystem. The plot determines how to render the data. But it relies on the axes to determine scaling information so that it can map data to screen locations. And therefore, a plot must have sibling axes ([&lt;ContinousAxis/&gt;](#continuous-axes-usage), [&lt;CategoryAxis/&gt;](#category-axes-usage)) components for the x-axis and the y-axis. Because the plot is responsible for data visualization, it is also where the data series are assigned to axes. The assignment of axes to series is optional, and any series not explicitly assigned to an axis will be assigned to the default axes. The default x-axis is the bottom axis, and the default y-axis is the axis on the left-hand side of the plot.
+In `stream-charts`, the `plot` is the data visualization component. To work, a plot must be a child of the &lt;Chart/&gt; component so that it is plugged into the `stream-charts` ecosystem. The plot determines how to render the data. But it relies on the axes to determine scaling information so that it can map data to screen locations. And therefore, a plot must have sibling axes ([&lt;ContinousAxis/&gt;](#continuous-axes-usage), [&lt;OrdinalAxis/&gt;](#ordinal-axes-usage)) components for the x-axis and the y-axis. Because the plot is responsible for data visualization, it is also where the data series are assigned to axes. The assignment of axes to series is optional, and any series not explicitly assigned to an axis will be assigned to the default axes. The default x-axis is the bottom axis, and the default y-axis is the axis on the left-hand side of the plot.
 
 The plot determines what view-modifying user interactions are available. Specifically, panning the data to the left and right in time, and zooming in time.
 
-The &lt;RasterPlot/&gt; specifically is used to plot event-timing data, where the x-values are time, and the y-values are a category to which the event belongs. The x-axis is required to be a [&lt;ContinousAxis/&gt;](#continuous-axes-usage), and the y-axis is required to the a [&lt;CategoryAxis/&gt;](#category-axes-usage). 
+The &lt;RasterPlot/&gt; specifically is used to plot event-timing data, where the x-values are time, and the y-values are a category to which the event belongs. The x-axis is required to be a [&lt;ContinuousAxis/&gt;](#continuous-axes-usage), and the y-axis is required to be an [&lt;OrdinalAxis/&gt;](#ordinal-axes-usage).
 
 #### [&#10514;](#content) <span id="raster-plot-usage-base">&lt;RasterPlot/&gt; base properties</span>
 
-> **axisAssignments (Map<string, [AxesAssignment](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/plot.ts) >, optional, default = Map())**<br>
-> An optional property that assigns data series to (x, y)-axes. Any series not assigned to an axis will use the default axis. The default x-axis is the bottom axis, and the default y-axis is the axis on the left-hand side of the plot. The `Map` associates the series name with an [AxesAssignment](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/plot.ts), which is a simple object (`{xAxis: string, yAxis: string}`) that holds the axis ID for the x-axis and for the y-axis assigned to the series.
+**axisAssignments (Map<string, [AxesAssignment](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/plot.ts) >, optional, default = Map())**<br>
+An optional property that assigns data series to (x, y)-axes. Any series not assigned to an axis will use the default axis. The default x-axis is the bottom axis, and the default y-axis is the axis on the left-hand side of the plot. The `Map` associates the series name with an [AxesAssignment](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/plot.ts), which is a simple object (`{xAxis: string, yAxis: string}`) that holds the axis ID for the x-axis and for the y-axis assigned to the series.
 
-> <span id="raster-plot-drop">**dropDataAfter (number, milliseconds, opitional, default = Infinity)**</span><br>
-> Optional property that sets when to drop data (effectively a TTL). This only drops data while streaming. Don't worry, your data won't disappear after the streaming has stopped. By default, none of the data is dropped. However, when large amounts of data are being streamed and plotted over long periods of time, memory and performance may become an issue. Setting this value allows a scrolling chart to run forever without running into resource issues.
+<span id="raster-plot-drop">**dropDataAfter (number, milliseconds, opitional, default = Infinity)**</span><br>
+Optional property that sets when to drop data (effectively a TTL). This only drops data while streaming. Don't worry, your data won't disappear after the streaming has stopped. By default, none of the data is dropped. However, when large amounts of data are being streamed and plotted over long periods of time, memory and performance may become an issue. Setting this value allows a scrolling chart to run forever without running into resource issues.
 
-> **spikeMargin (number, pixels, default = 2)**<br>
-> Optional property that adds a margin to the top and bottom of the raster (event) lines to give vertical spacing to the events in the plot. Margins on individual series can also be set through the [Chart.seriesStyles](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/hooks/useChart.tsx) property.
+**spikeMargin (number, pixels, default = 2)**<br>
+Optional property that adds a margin to the top and bottom of the raster (event) lines to give vertical spacing to the events in the plot. Margins on individual series can also be set through the [Chart.seriesStyles](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/hooks/useChart.tsx) property.
 
 #### [&#10514;](#content) <span id="raster-plot-usage-view">&lt;RasterPlot/&gt; view-modifying interactions</span>
 
 View-modifying interactions are those that change the way the data is displayed. For example, zooming in time, panning in time.
 
-> **panEnabled (boolean, optional, default = false)**<br>
-> Optional property that defaults to `false`. When set to `true` then enables "panning" which allows the user to drag the plot to the left and right.
+**panEnabled (boolean, optional, default = false)**<br>
+Optional property that defaults to `false`. When set to `true` then enables "panning" which allows the user to drag the plot to the left and right.
+
+**zoomEnabled (boolean, optional, default = false)**<br>
+Optional property that defaults for `false`. When set to `true` then enables "zooming" which allows the user to increase or decrease the displayed time range. By default, scrolling will cause the zoom effect. See the `zoomKeyModifiersRequired` property which requires the `shift` key to be pressed in order for the zoom action to apply.
+
+**zoomKeyModifiersRequired (boolean, optional, default = false)**<br>
+An optional property that defaults to `false`. When set to `true`, and the `zoomEnabled` property is also set to `true`, then requires that the `shift` key be pressed when scrolling in order to activate the zoom. This is nice when a user can scroll through your page containing the plot, so that zooming doesn't interfere with scrolling.
+
+**withCadenceOf (number, optional, default = undefinded)**<br>
+An optional property that defaults to `undefined`. When set, uses a cadence with the specified refresh period (in milliseconds). For plots with slow data updates (> 100 ms) using a cadence of 10 to 25 ms smooths out the updates so the time scrolling doesn't appear choppy. When updates are around 25 ms or less, then setting the cadence period too small will result in poor update performance. Generally at high update speeds, the cadence is unnecessary. Finally, using cadence, sets the max time to the current time. See also the related &lt;Chart/&gt's `windowingTime` property.
+
+### [&#10514;](#content) <span id="bar-plot-usage">&lt;BarPlot/&gt;</span>
+
+The &lt;BarPlot/&gt; is used to plot windowed statistics for a data series. It can display the current value, the mean value, and the min/max range for the windowed data.
+
+#### [&#10514;](#content) <span id="bar-plot-usage-base">&lt;BarPlot/&gt; base properties</span>
+
+**axisAssignments (Map<string, [AxesAssignment](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/plot.ts) >, optional, default = Map())**<br>
+An optional property that assigns data series to (x, y)-axes. Any series not assigned to an axis will use the default axis. The default x-axis is the bottom axis, and the default y-axis is the axis on the left-hand side of the plot.
+
+**showMinMaxBars (boolean, optional, default = false)**<br>
+When `true`, displays bars representing the minimum and maximum values in the data.
+
+**showWindowedMinMaxBars (boolean, optional, default = false)**<br>
+When `true`, displays bars representing the windowed minimum and maximum values.
+
+**showValueLines (boolean, optional, default = false)**<br>
+When `true`, displays lines representing the current values of the data series.
+
+**showMeanValueLines (boolean, optional, default = false)**<br>
+When `true`, displays lines representing the mean values of the data series.
+
+**showWindowedMeanValueLines (boolean, optional, default = false)**<br>
+When `true`, displays lines representing the windowed mean values.
+
+**barMargin (number, pixels, optional, default = 2)**<br>
+Optional property that adds a margin to the top and bottom of the bars.
+
+#### [&#10514;](#content) <span id="bar-plot-usage-view">&lt;BarPlot/&gt; view-modifying interactions</span>
+
+**panEnabled**, **zoomEnabled**, **zoomKeyModifiersRequired**, **withCadenceOf**<br>
+These properties behave the same as in [&lt;ScatterPlot/&gt;](#scatter-plot-usage-view).
+
+### [&#10514;](#content) <span id="poincare-plot-usage">&lt;PoincarePlot/&gt;</span>
+
+The &lt;PoincarePlot/&gt; (also known as an iterates plot) is used to plot the current value of a series against its previous value (n vs n-1). This is useful for identifying patterns or oscillations in the data.
 
-> **zoomEnabled (boolean, optional, default = false)**<br>
-> Optional property that defaults for `false`. When set to `true` then enables "zooming" which allows the user to increase or decrease the displayed time range. By default, scrolling will cause the zoom effect. See the `zoomKeyModifiersRequired` property which requires the `shift` key to be pressed in order for the zoom action to apply.
+#### [&#10514;](#content) <span id="poincare-plot-usage-base">&lt;PoincarePlot/&gt; base properties</span>
 
-> **zoomKeyModifiersRequired (boolean, optional, default = false)**<br>
-> An optional property that defaults to `false`. When set to `true`, and the `zoomEnabled` property is also set to `true`, then requires that the `shift` key be pressed when scrolling in order to activate the zoom. This is nice when a user can scroll through your page containing the plot, so that zooming doesn't interfere with scrolling.
+**interpolation (d3.CurveFactory, optional, default = undefined)**<br>
+An optional property that defines how the line between iterates will be interpolated. Use `NoCurveFactory` to disable the line.
 
-> **withCadenceOf (number, optional, default = undefinded)**<br>
-> An optional property that defaults to `undefined`. When set, uses a cadence with the specified refresh period (in milliseconds). For plots with slow data updates (> 100 ms) using a cadence of 10 to 25 ms smooths out the updates so the time scrolling doesn't appear choppy. When updates are around 25 ms or less, then setting the cadence period too small will result in poor update performance. Generally at high update speeds, the cadence is unnecessary. Finally, using cadence, sets the max time to the current time. See also the related &lt;Chart/&gt's `windowingTime` property.
+**showPoints (boolean, optional, default = false)**<br>
+When `true`, displays individual data points on the plot.
+
+#### [&#10514;](#content) <span id="poincare-plot-usage-view">&lt;PoincarePlot/&gt; view-modifying interactions</span>
+
+**panEnabled**, **zoomEnabled**, **zoomKeyModifiersRequired**, **withCadenceOf**<br>
+These properties behave the same as in [&lt;ScatterPlot/&gt;](#scatter-plot-usage-view).
 
 ## [&#10514;](#content) <span id="utilities">utilities</span>
 
@@ -609,23 +997,23 @@ The tracker, when enabled, follows the mouse when it is in the plot area, render
 
 #### [&#10514;](#content) <span id="tracker-usage-base">&lt;Tracker/&gt; base properties</span>
 
-> **visible (boolean)**<br>
-> When set to `true` the tracker is visible when the mouse is in the plot area. When set to `false` the tracker is not shown.
+**visible (boolean)**<br>
+When set to `true` the tracker is visible when the mouse is in the plot area. When set to `false` the tracker is not shown.
 
-> **labelLocation ([TrackerLabelLocation](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/Tracker.tsx), optional, default = TrackerLabelLocation.WithMouse)**<br>
-> Optional property specifies the location of the label. The `TrackerLabelLocation` is an enumeration with three values `Nowhere`, `WithMouse`, and `ByAxes`. By default, the label location is with the mouse (i.e. `WithMouse`). The `Nowhere` location can be used to hide the label, in cases where you would like to use your own. The `WithMouse` value has the label follow the mouse in the vertical direction along the tracker line. And the `ByAxes` displays the labels next to their respective axes, with the tracker line.
+**labelLocation ([TrackerLabelLocation](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/Tracker.tsx), optional, default = TrackerLabelLocation.WithMouse)**<br>
+Optional property specifies the location of the label. The `TrackerLabelLocation` is an enumeration with three values `Nowhere`, `WithMouse`, and `ByAxes`. By default, the label location is with the mouse (i.e. `WithMouse`). The `Nowhere` location can be used to hide the label, in cases where you would like to use your own. The `WithMouse` value has the label follow the mouse in the vertical direction along the tracker line. And the `ByAxes` displays the labels next to their respective axes, with the tracker line.
 
-> **onTrackerUpdate ((update: TrackerAxisUpdate) => void, optional, default = noop)**<br>
-> Optional callback function that accepts the update from the tracker. Use this to display the tracker and data information outside of the &lt;Chart/&gt. The `TrackerAxisUpdate` is a `Map<string, TrackerAxisInfo>`, the `TrackerAxisInfo` has the shape `{x: number, axisLocation: AxisLocation}`, and the `AxisLocation` is an same enumeration used for placing the axes on the chart (i.e. `AxisLocation.Bottom`, `AxisLocation.Top`).
+**onTrackerUpdate ((update: TrackerAxisUpdate) => void, optional, default = noop)**<br>
+Optional callback function that accepts the update from the tracker. Use this to display the tracker and data information outside of the &lt;Chart/&gt. The `TrackerAxisUpdate` is a `Map<string, TrackerAxisInfo>`, the `TrackerAxisInfo` has the shape `{x: number, axisLocation: AxisLocation}`, and the `AxisLocation` is an same enumeration used for placing the axes on the chart (i.e. `AxisLocation.Bottom`, `AxisLocation.Top`).
 
 
 #### [&#10514;](#content) <span id="tracker-usage-styling">&lt;Tracker/&gt; styling</span>
 
-> **style ([TrackerStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/trackerUtils.ts), optional, default = {visible: false, color: '#d2933f', lineWidth: 1})**<br>
-> Optional property defining the style for the tracker line. Has a shape of `{visible: boolean, color: string, lineWidth: number}`.
+**style ([TrackerStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/trackerUtils.ts), optional, default = {visible: false, color: '#d2933f', lineWidth: 1})**<br>
+Optional property defining the style for the tracker line. Has a shape of `{visible: boolean, color: string, lineWidth: number}`.
 
-> **font ([TrackerLabelFont](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/trackerUtils.ts), optional, default = {size: 12, color: '#d2933f', weight: 300, family: 'sans-serif'})**<br>
-> Optional property defining the font for the tracker label. Has a shape of `{size: number, color: string, family: string, weight: number}`.
+**font ([TrackerLabelFont](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/trackerUtils.ts), optional, default = {size: 12, color: '#d2933f', weight: 300, family: 'sans-serif'})**<br>
+Optional property defining the font for the tracker label. Has a shape of `{size: number, color: string, family: string, weight: number}`.
 
 
 ### [&#10514;](#content) <span id="tooltip-usage">&lt;Tooltip/&gt;</span>
@@ -634,32 +1022,32 @@ A tooltip renders information about the data over which the mouse is hovering. T
 
 The properties for the lt;Tooltip/&gt; are simple and limited. The tooltip content components have more options.
 
-> **visible (boolean)**<br>
-> When set to `true` the the tooltip is shown when the mouse hovers over a data series or point.
-
-> **style ([TooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts), optional, default = [defaultTooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts) )**<br>
-> Optional property defining the style of the tooltip. The following style elements are available
-> 1. **visible**<br>Visibility of the tooltip when the mouse hovers over a data series or point
-> ---
-> 2. **fontSize**<br>The size of the font displayed in the tooltip
-> 3. **fontColor**<br>The color of the text displayed in the tooltip
-> 4. **fontFamily**<br>The font weight for the text displayed in the tooltip
-> 5. **fontWeight**<br>The font weight for the text displayed in the tooltip
-> ---
-> 6. **backgroundColor**<br>The background color of the tooltip
-> 7. **backgroundOpacity**<br>The opacity of the background (i.e. how transparent it is)
-> ---
-> 8. **borderColor**<br>The color of the border surrounding the tooltip content
-> 9. **borderWidth**<br>The width of the border surrounding the tooltip content
-> 10. **borderRadius**<br>The radius of the border surrounding the tooltip content
-> ---
-> 11. **paddingLeft**<br>The padding to the left of the tooltip content
-> 12. **paddingRight**<br>The padding to the right of the tooltip content
-> 13. **paddingTop**<br>The padding to the top of the tooltip content
-> 14. **paddingBottom**<br>The padding to the bottom of the tooltip content
-
-> **children (&lt;ScatterPlotTooltipContent/&gt; and &lt;RasterPlotTooltipContent/&gt;)**<br>
-> The tooltip content.
+**visible (boolean)**<br>
+When set to `true` the the tooltip is shown when the mouse hovers over a data series or point.
+
+**style ([TooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts), optional, default = [defaultTooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts) )**<br>
+Optional property defining the style of the tooltip. The following style elements are available
+1. **visible**<br>Visibility of the tooltip when the mouse hovers over a data series or point
+---
+2. **fontSize**<br>The size of the font displayed in the tooltip
+3. **fontColor**<br>The color of the text displayed in the tooltip
+4. **fontFamily**<br>The font weight for the text displayed in the tooltip
+5. **fontWeight**<br>The font weight for the text displayed in the tooltip
+---
+6. **backgroundColor**<br>The background color of the tooltip
+7. **backgroundOpacity**<br>The opacity of the background (i.e. how transparent it is)
+---
+8. **borderColor**<br>The color of the border surrounding the tooltip content
+9. **borderWidth**<br>The width of the border surrounding the tooltip content
+10. **borderRadius**<br>The radius of the border surrounding the tooltip content
+---
+11. **paddingLeft**<br>The padding to the left of the tooltip content
+12. **paddingRight**<br>The padding to the right of the tooltip content
+13. **paddingTop**<br>The padding to the top of the tooltip content
+14. **paddingBottom**<br>The padding to the bottom of the tooltip content
+
+**children (&lt;ScatterPlotTooltipContent/&gt; and &lt;RasterPlotTooltipContent/&gt;)**<br>
+The tooltip content.
 
 
 ### [&#10514;](#content) <span id="scatterplot-tooltip-usage">&lt;ScatterPlotTooltipContent/&gt;</span>
@@ -676,61 +1064,88 @@ series name
 
 ---
 
-> **xLabel (string)**<br>
-> Required property that gives a name to the x-values. This is the label for the x-values in the tooltip.
+**xLabel (string)**<br>
+Required property that gives a name to the x-values. This is the label for the x-values in the tooltip.
 
-> **yLabel (string)**<br>
-> Required property that gives a name to the y-values. This is the label for the y-values in the tooltip.
+**yLabel (string)**<br>
+Required property that gives a name to the y-values. This is the label for the y-values in the tooltip.
 
-> **beforeHeader (string, optional, default = 'before')**<br>
-> Optional property that gives a name to the data point that is immediately before the mouse location.
+**beforeHeader (string, optional, default = 'before')**<br>
+Optional property that gives a name to the data point that is immediately before the mouse location.
 
-> **afterHeader (string, optional, default = 'after')**<br>
-> Optional property that gives a name to the data point that is immediately after the mouse location.
+**afterHeader (string, optional, default = 'after')**<br>
+Optional property that gives a name to the data point that is immediately after the mouse location.
 
-> **deltaHeader (string, optional, default = '∆')**<br>
-> Optional property that gives a name to the difference between the datum immediately before and after the mouse location.
+**deltaHeader (string, optional, default = '∆')**<br>
+Optional property that gives a name to the difference between the datum immediately before and after the mouse location.
 
-> **xValueFormatter ((value: number) => string, optional, default =** [**formatTime**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
-> Optional function that formats the x-value immediately before and after the mouse location. The default function formats that x-values as natural numbers representing milliseconds.
+**xValueFormatter ((value: number) => string, optional, default =** [**formatTime**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
+Optional function that formats the x-value immediately before and after the mouse location. The default function formats that x-values as natural numbers representing milliseconds.
 
-> **yValueFormatter ((value: number) => string, optional, default =** [**formatValue**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
-> Optional function that formats the x-value immediately before and after the mouse location. The default function formats the y-values as floating point with 3 values to the right of the decimal point.
+**yValueFormatter ((value: number) => string, optional, default =** [**formatValue**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
+Optional function that formats the x-value immediately before and after the mouse location. The default function formats the y-values as floating point with 3 values to the right of the decimal point.
 
-> **xChangeFormatter ((value1: number, value2: number) => string, optional, default =** [**formatTimeChange**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
-> Optional function that formats the change in the x-value of the points immediately before and after the mouse location. The default function formats the value as a natural number. 
+**xChangeFormatter ((value1: number, value2: number) => string, optional, default =** [**formatTimeChange**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
+Optional function that formats the change in the x-value of the points immediately before and after the mouse location. The default function formats the value as a natural number. 
 
-> **yChangeFormatter ((value1: number, value2: number) => string, optional, default =** [**formatValueChange**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
-> Optional function that formats the change in the y-value of the points immediately before and after the mouse location. The default function formats the value as floating point with 3 values to the right of the decimal point.
+**yChangeFormatter ((value1: number, value2: number) => string, optional, default =** [**formatValueChange**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
+Optional function that formats the change in the y-value of the points immediately before and after the mouse location. The default function formats the value as floating point with 3 values to the right of the decimal point.
 
-> **style ([TooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts), optional, default = [defaultTooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts) )**<br>
-> Optional styles for the tooltip content. The styles are the same as those for the &lt;Tooltip/&gt;.
+**style ([TooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts), optional, default = [defaultTooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts) )**<br>
+Optional styles for the tooltip content. The styles are the same as those for the &lt;Tooltip/&gt;.
 
 
 ### [&#10514;](#content) <span id="rasterplot-tooltip-usage">&lt;RasterTooltipContent/&gt;</span>
-The &lt;RasterPlotTooltipContent/&gt; shows the series name, the time and value of the point over which the mouse is hovering. There are only three properties.
+The &lt;RasterPlotTooltipContent/&gt; shows the series name, the time, and value of the point over which the mouse is hovering. There are only three properties.
 
-> **xFormatter ((value: number) => string, optional, default =** [**formatTime**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
-> Optional function that formats the x-value immediately before and after the mouse location. The default function formats that x-values as natural numbers representing milliseconds.
+**xFormatter ((value: number) => string, optional, default =** [**formatTime**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
+Optional function that formats the x-value immediately before and after the mouse location. The default function formats that x-values as natural numbers representing milliseconds.
 
-> **yFormatter ((value: number) => string, optional, default =** [**formatValue**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
-> Optional function that formats the x-value immediately before and after the mouse location. The default function formats the y-values as floating point with 3 values to the right of the decimal point.
+**yFormatter ((value: number) => string, optional, default =** [**formatValue**](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/utils.ts) <br>
+Optional function that formats the x-value immediately before and after the mouse location. The default function formats the y-values as floating point with 3 values to the right of the decimal point.
 
-> **style ([TooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts), optional, default = [defaultTooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts) )**<br>
-> Optional styles for the tooltip content. The styles are the same as those for the &lt;Tooltip/&gt;.
+**style ([TooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts), optional, default = [defaultTooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts) )**<br>
+Optional styles for the tooltip content. The styles are the same as those for the &lt;Tooltip/&gt;.
 
-## building
+### [&#10514;](#content) <span id="barplot-tooltip-usage">&lt;BarPlotTooltipContent/&gt;</span>
 
-Building
-```shell
-npm install
-npm run build
-```
+The &lt;BarPlotTooltipContent/&gt; displays the series name and current statistics in a table format.
 
-Packaging
-```shell
-npm pack
-```
+**ordinalUnits (string, optional)**<br>
+Optional units to display alongside the values.
+
+**style ([TooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts), optional)**<br>
+Optional styles for the tooltip content.
+
+### [&#10514;](#content) <span id="poincareplot-tooltip-usage">&lt;PoincarePlotTooltipContent/&gt;</span>
+
+The &lt;PoincarePlotTooltipContent/&gt; displays the series name and the current, previous, and next iterates in a table format.
+
+**xLabel (string)**<br>
+Required label for the x-axis values.
+
+**yLabel (string)**<br>
+Required label for the y-axis values.
+
+**nMinusLagHeader**, **nHeader**, **nPlusLagHeader** (string, optional)<br>
+Optional headers for the previous, current, and next iterates.
+
+**xValueFormatter**, **yValueFormatter**, **xChangeFormatter**, **yChangeFormatter** (optional)<br>
+Optional formatters for values and their changes.
+
+**style ([TooltipStyle](https://github.com/robphilipp/stream-charts/blob/master/src/app/charts/tooltipUtils.ts), optional)**<br>
+Optional styles for the tooltip content.
+
+## [&#10514;](#content) <span id="hooks">hooks</span>
+
+For advanced usage, `stream-charts` provides several hooks to interact with the chart's internal state.
+
+- **useChart()**: Access the chart's context, including dimensions, scales, and registration functions for tooltips and trackers.
+- **useAxes()**: Access the state of the x and y axes.
+- **usePlotDimensions()**: Access the dimensions of the plot area and margins.
+- **useDataObservable()**: Access the data stream observable.
+
+## [&#10514;](#content) <span id="building">building</span>
 
 Testing
 ```shell