stream-charts 1.0.0 → 1.1.0

package/dist/src/app/charts/plots/ScatterPlot.js

@@ -0,0 +1,379 @@
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import { useChart } from "../hooks/useChart";
+import * as d3 from "d3";
+import { setClipPathG } from "./plot";
+import { axesForSeriesGen, continuousAxisIntervals, continuousAxisRanges, continuousAxisZoomHandler, defaultLineStyle, panHandler } from "../axes/axes";
+import { noop } from "../utils";
+import { subscriptionTimeSeriesFor, subscriptionTimeSeriesWithCadenceFor, TimeWindowBehavior } from "../subscriptions/subscriptions";
+import { useDataObservable } from "../hooks/useDataObservable";
+import { usePlotDimensions } from "../hooks/usePlotDimensions";
+import { useInitialData } from "../hooks/useInitialData";
+import { Optional } from "result-fn";
+import { ContinuousAxisRange } from "../axes/ContinuousAxisRange";
+/**
+ * Renders a streaming scatter plot for the series in the initial data and those sourced by the
+ * observable specified as a property in the {@link Chart}. This component uses the {@link useChart}
+ * hook, and therefore must be a child of the {@link Chart} in order to be plugged in to the
+ * chart ecosystem (axes, tracker, tooltip).
+ *
+ * @param props The properties associated with the scatter plot
+ * @constructor
+ * @example
+ <ScatterPlot
+ interpolation={interpolation}
+ axisAssignments={new Map([
+ ['test2', assignAxes("x-axis-2", "y-axis-2")],
+ ])}
+ dropDataAfter={10000}
+ panEnabled={true}
+ zoomEnabled={true}
+ zoomKeyModifiersRequired={true}
+ />
+ */
+export function ScatterPlot(props) {
+    const { chartId, container, mainG, axes, color, seriesStyles, seriesFilter, mouse } = useChart();
+    const { initialData } = useInitialData();
+    const { xAxesState, yAxesState, setAxisIntervalFor, updateAxisRanges = noop, onUpdateAxesInterval, axesRanges, } = axes;
+    const { mouseOverHandlerFor, mouseLeaveHandlerFor } = mouse;
+    const { plotDimensions, margin } = usePlotDimensions();
+    const { seriesObservable, windowingTime = 100, shouldSubscribe, onSubscribe = noop, onUpdateData, } = useDataObservable();
+    const { axisAssignments = new Map(), interpolation = d3.curveLinear, dropDataAfter = Infinity, panEnabled = false, zoomEnabled = false, zoomKeyModifiersRequired = true, withCadenceOf, timeWindowBehavior = TimeWindowBehavior.SCROLL, } = props;
+    const initialTimes = useMemo(() => {
+        return new Map(Array.from(axesRanges().entries())
+            .map(([axisId, range]) => ([axisId, range.original.start])));
+    }, [axesRanges]);
+    // why do "dataRef" and "seriesRef" both hold on to the same underlying data? for performance.
+    //
+    // the "dataRef" and "seriesRef" both point to the same underlying data, a collection
+    // of series. The series in "dataRef" are bound to the DOM elements through d3. The "seriesRef" series
+    // are the ones that are updated as new data is streamed in.
+    //
+    // the "dataRef" object holds on to a copy of the initial data (which is an array of
+    // time-series, e.i. an array of BaseSeries<OrdinalDatum> objects). The slice just creates a copy of
+    // the array, but the references to the BaseSeries objects are the same and still point to the same
+    // data as the "initialData" array.
+    //
+    // the "seriesRef" object is a reference to a map (series_name -> BaseSeries<OrdinalDatum>) which is
+    // used to update the data in the series. When new data enters, it is appended to one or more series.
+    //
+    // the series in the "dataRef" object are the ones bound to the DOM elements in d3, and so as these
+    // are updated, d3 will update the DOM elements (the elements in this plot).
+    const dataRef = useRef(initialData.slice());
+    const seriesRef = useRef(new Map(initialData.map(series => [series.name, series])));
+    // map(axis_id -> current_time) -- maps the axis ID to the current time for that axis
+    const currentTimeRef = useRef(new Map());
+    const subscriptionRef = useRef(undefined);
+    const isSubscriptionClosed = () => subscriptionRef.current === undefined || subscriptionRef.current.closed;
+    const allowTooltip = useRef(isSubscriptionClosed());
+    useEffect(() => {
+        currentTimeRef.current = new Map(Array.from(xAxesState.axes.keys()).map(id => [id, 0]));
+    }, [xAxesState]);
+    // calculates the distinct series IDs that cover all the series in the plot
+    const axesForSeries = useMemo(() => axesForSeriesGen(initialData, axisAssignments, xAxesState), [initialData, axisAssignments, xAxesState]);
+    // updates the timing using the onUpdateTime and updatePlot references. This and the references
+    // defined above allow the axes' times to be updated properly by avoid stale reference to these
+    // functions.
+    const updateTimingAndPlot = useCallback((ranges) => {
+        if (mainG !== null) {
+            onUpdateTimeRef.current(ranges);
+            updatePlotRef.current(ranges, mainG);
+            if (onUpdateAxesInterval) {
+                setTimeout(() => {
+                    const times = new Map();
+                    ranges.forEach((range, name) => times.set(name, range.current));
+                    onUpdateAxesInterval(times);
+                }, 0);
+            }
+        }
+    }, [mainG, onUpdateAxesInterval]);
+    // todo find better way
+    // when the initial data changes, then reset the plot. note that the initial data doesn't change
+    // during the normal course of updates from the observable, only when the plot is restarted.
+    useEffect(() => {
+        dataRef.current = initialData.slice();
+        seriesRef.current = new Map(initialData.map(series => [series.name, series]));
+        currentTimeRef.current = new Map(Array.from(xAxesState.axes.keys()).map(id => [id, 0]));
+        updateTimingAndPlot(new Map(Array.from(continuousAxisRanges(xAxesState.axes).entries())
+            .map(([id, range]) => {
+            // grab the current range, then calculate the minimum time from the initial data, and
+            // set that as the start, and then add the range to it for the end time
+            const [start, end] = range.original.asTuple();
+            const minTime = initialData
+                .filter(srs => { var _a; return ((_a = axisAssignments.get(srs.name)) === null || _a === void 0 ? void 0 : _a.xAxis) === id; })
+                .reduce((tMin, series) => Math.min(tMin, !series.isEmpty() ? series.data[0].time : tMin), Infinity);
+            const startTime = minTime === Infinity ? 0 : minTime;
+            return [id, ContinuousAxisRange.from(startTime, startTime + end - start)];
+        })));
+    }, 
+    // ** not happy about this **
+    // only want this effect to run when the initial data is changed, which mean all the
+    // other dependencies are recalculated anyway.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [initialData]);
+    /**
+     * Adjusts the time-range and updates the plot when the plot is dragged to the left or right
+     * @param deltaX The amount that the plot is dragged
+     * @param plotDimensions The dimensions of the plot
+     * @param ranges A map holding the axis ID and its associated time range
+     */
+    const onPan = useCallback((x, plotDimensions, ranges) => panHandler(axesForSeries, margin, setAxisIntervalFor, xAxesState)(x, plotDimensions, ranges), [axesForSeries, margin, setAxisIntervalFor, xAxesState]);
+    /**
+     * Called when the user uses the scroll wheel (or scroll gesture) to zoom in or out. Zooms in/out
+     * at the location of the mouse when the scroll wheel or gesture was applied.
+     * @param transform The d3 zoom transformation information
+     * @param x The x-position of the mouse when the scroll wheel or gesture is used
+     * @param plotDimensions The dimensions of the plot
+     * @param series An array of series names
+     * @param ranges A map holding the axis ID and its associated time-range
+     */
+    const onZoom = useCallback((transform, x, plotDimensions, ranges) => continuousAxisZoomHandler(axesForSeries, margin, setAxisIntervalFor, xAxesState)(transform, x, plotDimensions, ranges), [axesForSeries, margin, setAxisIntervalFor, xAxesState]);
+    const updatePlot = useCallback(
+    /**
+     * Updates the plot data for the specified time-range, which may have changed due to zoom or pan
+     * @param timeRanges The current time range
+     * @param mainGElem The main <g> element selection for that holds the plot
+     */
+    (timeRanges, mainGElem) => {
+        if (container) {
+            // select the svg element bind the data to them
+            const svg = d3.select(container);
+            // create a map associating series-names to their time-series.
+            //
+            // performance-related confusion: wondering where the dataRef is updated? well it isn't
+            // directly. The dataRef holds on to an array of references to the Series. And so does the
+            // seriesRef, though is uses a map(series_name -> series). The seriesRef is use to append
+            // data to the underlying Series, and the dataRef is used so that we can just use
+            // dataRef.current and don't have to do Array.from(seriesRef.current.values()) which
+            // creates a temporary array
+            const boundedSeries = new Map(dataRef.current.map(series => [
+                series.name,
+                series.data
+            ]));
+            // set up panning
+            if (panEnabled) {
+                const drag = d3.drag()
+                    .on("start", () => {
+                    d3.select(container).style("cursor", "move");
+                    // during panning, we need to disable viewing the tooltip to prevent
+                    // tooltips from rendering but not getting removed
+                    allowTooltip.current = false;
+                })
+                    .on("drag", (event) => {
+                    onPan(event.dx, plotDimensions, 
+                    // Array.from(boundedSeries.keys()),
+                    timeRanges);
+                    updatePlotRef.current(timeRanges, mainGElem);
+                })
+                    .on("end", () => {
+                    d3.select(container).style("cursor", "auto");
+                    // during panning, we disabled viewing the tooltip to prevent
+                    // tooltips from rendering but not getting removed, now that panning
+                    // is over, allow tooltips to render again
+                    allowTooltip.current = isSubscriptionClosed();
+                });
+                svg.call(drag);
+            }
+            // set up for zooming
+            if (zoomEnabled) {
+                const zoom = d3.zoom()
+                    .filter(event => !zoomKeyModifiersRequired || event.shiftKey || event.ctrlKey)
+                    .scaleExtent([0, 10])
+                    .translateExtent([[margin.left, margin.top], [plotDimensions.width, plotDimensions.height]])
+                    .on("zoom", event => {
+                    onZoom(event.transform, event.sourceEvent.offsetX - margin.left, plotDimensions, timeRanges);
+                    updatePlotRef.current(timeRanges, mainGElem);
+                });
+                svg.call(zoom);
+            }
+            // define the clip-path so that the series lines don't go beyond the plot area
+            const clipPathId = setClipPathG(chartId, mainGElem, plotDimensions);
+            boundedSeries.forEach((data, name) => {
+                // grab the x and y axes assigned to the series, and if either or both
+                // axes aren't found, then give up and return
+                const [xAxisLinear, yAxisLinear] = axesFor(name, axisAssignments, axisId => xAxesState.axisFor(axisId).getOrUndefined(), axisId => yAxesState.axisFor(axisId).getOrUndefined());
+                if (xAxisLinear === undefined || yAxisLinear === undefined)
+                    return;
+                // grab the style for the series
+                const { color, lineWidth } = seriesStyles.get(name) || Object.assign(Object.assign({}, defaultLineStyle()), { highlightColor: defaultLineStyle().color });
+                // only show the data for which the filter matches
+                const plotData = (name.match(seriesFilter)) ? data : [];
+                // create the time-series paths
+                mainGElem
+                    .selectAll(`#${name}-${chartId}-scatter`)
+                    .data([[], plotData], () => `${name}`)
+                    .join(enter => enter
+                    .append("path")
+                    .attr("class", 'time-series-lines')
+                    .attr("id", `${name}-${chartId}-scatter`)
+                    .attr("d", d3.line()
+                    .x((d) => xAxisLinear.scale(d.time) || 0)
+                    .y((d) => yAxisLinear.scale(d.value) || 0)
+                    .curve(interpolation))
+                    .attr("fill", "none")
+                    .attr("stroke", color)
+                    .attr("stroke-width", lineWidth)
+                    .attr('transform', `translate(${margin.left}, ${margin.top})`)
+                    .attr("clip-path", `url(#${clipPathId})`)
+                    .on("mouseover", (event, datumArray) => 
+                // recall that this handler is passed down via the "useChart" hook
+                handleMouseOverSeries(container, xAxisLinear, name, datumArray, event, margin, seriesStyles, allowTooltip.current, mouseOverHandlerFor(`tooltip-${chartId}`)))
+                    .on("mouseleave", event => handleMouseLeaveSeries(name, event.currentTarget, seriesStyles, mouseLeaveHandlerFor(`tooltip-${chartId}`))), update => update, exit => exit.remove());
+            });
+        }
+    }, [
+        container, panEnabled, zoomEnabled, chartId, plotDimensions, margin, onPan,
+        zoomKeyModifiersRequired, onZoom, axisAssignments,
+        xAxesState, yAxesState,
+        seriesStyles, seriesFilter, interpolation,
+        mouseOverHandlerFor, mouseLeaveHandlerFor
+    ]);
+    // need to keep the function references for use by the subscription, which forms a closure
+    // on them. without the references, the closures become stale, and resizing during streaming
+    // doesn't work properly
+    const updatePlotRef = useRef(noop);
+    useEffect(() => {
+        updatePlotRef.current = updatePlot;
+    }, [updatePlot]);
+    const onUpdateTimeRef = useRef(updateAxisRanges);
+    useEffect(() => {
+        onUpdateTimeRef.current = updateAxisRanges;
+    }, [updateAxisRanges]);
+    // memoized function for subscribing to the chart-data observable
+    const subscribe = useCallback(() => {
+        if (seriesObservable === undefined || mainG === null)
+            return undefined;
+        if (withCadenceOf !== undefined) {
+            return subscriptionTimeSeriesWithCadenceFor(seriesObservable, onSubscribe, windowingTime, axisAssignments, xAxesState, onUpdateData, dropDataAfter, updateTimingAndPlot, 
+            // as new data flows into the subscription, the subscription
+            // updates this map directly (for performance)
+            seriesRef.current, (axisId, end) => currentTimeRef.current.set(axisId, end), withCadenceOf);
+        }
+        return subscriptionTimeSeriesFor(seriesObservable, onSubscribe, windowingTime, axisAssignments, xAxesState, onUpdateData, dropDataAfter, updateTimingAndPlot, 
+        // as new data flows into the subscription, the subscription
+        // updates this map directly (for performance)
+        seriesRef.current, (axisId, end) => currentTimeRef.current.set(axisId, end), timeWindowBehavior, initialTimes);
+    }, [
+        axisAssignments, dropDataAfter, mainG,
+        onSubscribe, onUpdateData,
+        seriesObservable, updateTimingAndPlot, windowingTime, xAxesState,
+        withCadenceOf,
+        initialTimes, timeWindowBehavior
+    ]);
+    const timeRangesRef = useRef(new Map());
+    useEffect(() => {
+        if (container && mainG) {
+            // so this gets a bit complicated. the time-ranges need to be updated whenever the time-ranges
+            // change. for example, as data is streamed in, the times change, and then we need to update the
+            // time-range. however, we want to keep the time-ranges to reflect their original scale so that
+            // we can zoom properly (so the updates can't fuck with the scale). At the same time, when the
+            // interpolation changes, then the update plot changes, and the time-ranges must maintain their
+            // original scale as well.
+            if (timeRangesRef.current.size === 0) {
+                // when no time-ranges have yet been created, then create them and hold on to a mutable
+                // reference to them
+                timeRangesRef.current = continuousAxisRanges(xAxesState.axes);
+            }
+            else {
+                // when the time-ranges already exist, then we want to update the time-ranges for each
+                // existing time-range in a way that maintains the original scale.
+                const intervals = continuousAxisIntervals(xAxesState.axes);
+                timeRangesRef.current
+                    .forEach((range, id, rangesMap) => {
+                    const [start, end] = Optional.ofNullable(intervals.get(id))
+                        .map(interval => interval.asTuple())
+                        .getOrThrow(() => new Error(`Unable to retrieve interval for axis; axis_id: ${id}`));
+                    // .getOrElse([NaN, NaN])
+                    if (!isNaN(start) && !isNaN(end)) {
+                        // update the reference map with the new (start, end) portion of the range,
+                        // while keeping the original scale intact
+                        rangesMap.set(id, range.update(start, end));
+                    }
+                });
+            }
+            updatePlot(timeRangesRef.current, mainG);
+        }
+    }, [chartId, color, container, mainG, plotDimensions, updatePlot, xAxesState]);
+    // subscribe/unsubscribe to the observable chart data. when the `shouldSubscribe`
+    // is changed to `true` and we haven't subscribed yet, then subscribe. when the
+    // `shouldSubscribe` is `false` and we had subscribed, then unsubscribe. otherwise,
+    // do nothing.
+    useEffect(() => {
+        var _a;
+        if (shouldSubscribe && subscriptionRef.current === undefined) {
+            subscriptionRef.current = subscribe();
+            allowTooltip.current = false;
+        }
+        else if (!shouldSubscribe && subscriptionRef.current !== undefined) {
+            (_a = subscriptionRef.current) === null || _a === void 0 ? void 0 : _a.unsubscribe();
+            subscriptionRef.current = undefined;
+            allowTooltip.current = true;
+        }
+    }, [shouldSubscribe, subscribe]);
+    return null;
+}
+/**
+ * Attempts to locate the x- and y-axes for the specified series. If no axis is found for the
+ * series name, then uses the default returned by the useChart() hook
+ * @param seriesName Name of the series for which to retrieve the axis
+ * @param axisAssignments A map holding the series name and the associated x- and y-axes assigned
+ * to that series. Note that the series in the axis-assignment map is merely a subset of the set
+ * of series names.
+ * @param xAxisFor The function that accepts an axis ID and returns the corresponding x-axis
+ * @param yAxisFor The function that accepts an axis ID and returns the corresponding y-axis
+ */
+function axesFor(seriesName, axisAssignments, xAxisFor, yAxisFor) {
+    const axes = axisAssignments.get(seriesName);
+    const xAxis = xAxisFor((axes === null || axes === void 0 ? void 0 : axes.xAxis) || "");
+    const xAxisLinear = xAxis;
+    const yAxis = yAxisFor((axes === null || axes === void 0 ? void 0 : axes.yAxis) || "");
+    const yAxisLinear = yAxis;
+    if (xAxis && !xAxisLinear) {
+        throw Error("Scatter plot requires that x-axis be of type LinearAxis");
+    }
+    if (yAxis && !yAxisLinear) {
+        throw Error("Scatter plot requires that y-axis be of type LinearAxis");
+    }
+    return [xAxisLinear, yAxisLinear];
+}
+/**
+ * Renders a tooltip showing the neuron, spike time, and the spike strength when the mouse hovers over a spike.
+ * @param container The chart container
+ * @param xAxis The x-axis
+ * @param seriesName The name of the series (i.e. the neuron ID)
+ * @param series The time series
+ * @param event The mouse-over series event
+ * @param margin The plot margin
+ * @param seriesStyles The series style information (needed for (un)highlighting)
+ * @param allowTooltip When set to `false` won't show tooltip, even if it is visible (used by pan)
+ * @param mouseOverHandlerFor The handler for the mouse over (registered by the <Tooltip/>)
+ */
+function handleMouseOverSeries(container, xAxis, seriesName, series, event, margin, seriesStyles, allowTooltip, mouseOverHandlerFor) {
+    // grab the time needed for the tooltip ID
+    const [x, y] = d3.pointer(event, container);
+    const time = Math.round(xAxis.scale.invert(x - margin.left));
+    const { highlightColor, highlightWidth } = seriesStyles.get(seriesName) || defaultLineStyle();
+    // Use d3 to select element, change color and size
+    d3.select(event.currentTarget)
+        .attr('stroke', highlightColor)
+        .attr('stroke-width', highlightWidth);
+    if (mouseOverHandlerFor && allowTooltip) {
+        mouseOverHandlerFor(seriesName, time, { series, metadata: {} }, [x, y]);
+    }
+}
+/**
+ * Unselects the time series and calls the mouse-leave-series handler registered for this series.
+ * @param seriesName The name of the series (i.e. the neuron ID)
+ * @param segment The SVG line element representing the spike, over which the mouse is hovering.
+ * @param seriesStyles The styles for the series (for (un)highlighting)
+ * @param mouseLeaverHandlerFor Registered handler for the series when the mouse leaves
+ */
+function handleMouseLeaveSeries(seriesName, segment, seriesStyles, mouseLeaverHandlerFor) {
+    const { color, lineWidth } = seriesStyles.get(seriesName) || defaultLineStyle();
+    d3.select(segment)
+        .attr('stroke', color)
+        .attr('stroke-width', lineWidth);
+    if (mouseLeaverHandlerFor) {
+        mouseLeaverHandlerFor(seriesName);
+    }
+}
+//# sourceMappingURL=ScatterPlot.js.map

package/dist/src/app/charts/plots/ScatterPlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScatterPlot.js","sourceRoot":"","sources":["../../../../../src/app/charts/plots/ScatterPlot.tsx"],"names":[],"mappings":"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"}

package/dist/src/app/charts/{plot.d.ts → plots/plot.d.ts}

@@ -1,7 +1,6 @@
-import { Dimensions, Margin } from "./margins";
-import { GSelection, SvgSelection } from "./d3types";
-export declare type Range = [min: number, max: number];
-export declare type TimeSeries = Array<[number, number]>;
+import { Dimensions } from "../styling/margins";
+import { GSelection } from "../d3types";
+export type Series<D> = Array<D>;
 /**
  * Creates the main SVG for holding the plot.
  * @param chartId A unique value identifying the chart.
@@ -13,18 +12,17 @@ export declare function createPlotContainer(chartId: number, container: SVGSVGEl
 /**
  * Adds a clip area for the chart to the specified SVG element. The clip-area is given
  * an `id` of `clip-series-<chart_id>`, which because the chart ID should be unique, makes
- * this unique as well
- * @param chartId The ID of the chart to which the clip area is to be added
- * @param svg The SVG element to which the clip area is to be added
- * @param plotDimensions The dimensions of the plot
- * @param margin The margins around the plot
- * @return The ID of the clip-path
+ * this unique as well.
+ * @param chartId The ID of the chart to which the clip area is to be added.
+ * @param plotGroup The SVG group element to which the clip area is to be added.
+ * @param plotDimensions The dimensions of the plot.
+ * @return The ID of the clip-path.
  */
-export declare function setClipPath(chartId: number, svg: SvgSelection, plotDimensions: Dimensions, margin: Margin): string;
+export declare function setClipPathG(chartId: number, plotGroup: GSelection, plotDimensions: Dimensions): string;
 /**
- * Represents the assignment of an x-axis and y-axis to a series. This is used
- * by the plots (see, for example, {@link ScatterPlot} and {@link RasterPlot})
- * to manage the assignment of axes to series
+ * Represents the assignment of an x-axis and y-axis to a series. Plots (see, for example,
+ * {@link ScatterPlot} and {@link RasterPlot}) use this interface to manage the assignment
+ * of axes to series
  */
 export interface AxesAssignment {
     xAxis: string;

package/dist/src/app/charts/{plot.js → plots/plot.js}

@@ -7,35 +7,37 @@ import * as d3 from "d3";
  * @param color The SVG `color` attribute used for the axis
  */
 export function createPlotContainer(chartId, container, plotDimensions, color) {
-    var width = plotDimensions.width, height = plotDimensions.height;
+    const { width, height } = plotDimensions;
     return d3.select(container)
-        .attr('width', width)
-        .attr('height', height)
+        .attr('width', Math.max(0, width))
+        .attr('height', Math.max(0, height))
         .attr('color', color)
         .append('g')
-        .attr('id', "main-container-" + chartId);
+        .attr('id', `main-container-${chartId}`);
 }
 /**
  * Adds a clip area for the chart to the specified SVG element. The clip-area is given
  * an `id` of `clip-series-<chart_id>`, which because the chart ID should be unique, makes
- * this unique as well
- * @param chartId The ID of the chart to which the clip area is to be added
- * @param svg The SVG element to which the clip area is to be added
- * @param plotDimensions The dimensions of the plot
- * @param margin The margins around the plot
- * @return The ID of the clip-path
+ * this unique as well.
+ * @param chartId The ID of the chart to which the clip area is to be added.
+ * @param plotGroup The SVG group element to which the clip area is to be added.
+ * @param plotDimensions The dimensions of the plot.
+ * @return The ID of the clip-path.
  */
-export function setClipPath(chartId, svg, plotDimensions, margin) {
-    var clipPathId = "chart-clip-path-" + chartId;
+export function setClipPathG(chartId, plotGroup, plotDimensions) {
+    const clipPathId = `chart-clip-path-${chartId}`;
     // remove the old clipping region and add a new one with the updated plot dimensions
-    svg.select('defs').remove();
-    svg
+    plotGroup.select(`#${clipPathId}-defs`).remove();
+    plotGroup
         .append('defs')
+        .attr('id', `${clipPathId}-defs`)
         .append("clipPath")
         .attr("id", clipPathId)
         .append("rect")
-        .attr("width", plotDimensions.width)
-        .attr("height", Math.max(margin.bottom, plotDimensions.height - margin.bottom));
+        .attr("x", 0)
+        .attr("y", 0)
+        .attr("width", Math.max(0, plotDimensions.width))
+        .attr("height", Math.max(0, plotDimensions.height));
     return clipPathId;
 }
 /**
@@ -44,5 +46,5 @@ export function setClipPath(chartId, svg, plotDimensions, margin) {
  * @param yAxis The ID of the y-axis
  * @return An {@link AxesAssignment}
  */
-export var assignAxes = function (xAxis, yAxis) { return ({ xAxis: xAxis, yAxis: yAxis }); };
+export const assignAxes = (xAxis, yAxis) => ({ xAxis, yAxis });
 //# sourceMappingURL=plot.js.map

package/dist/src/app/charts/plots/plot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot.js","sourceRoot":"","sources":["../../../../../src/app/charts/plots/plot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAKzB;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAC/B,OAAe,EACf,SAAwB,EACxB,cAA0B,EAC1B,KAAa;IAEb,MAAM,EAAC,KAAK,EAAE,MAAM,EAAC,GAAG,cAAc,CAAA;IACtC,OAAO,EAAE,CAAC,MAAM,CAAqB,SAAS,CAAC;SAC1C,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;SACjC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;SACnC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;SACpB,MAAM,CAAc,GAAG,CAAC;SACxB,IAAI,CAAC,IAAI,EAAE,kBAAkB,OAAO,EAAE,CAAC,CAAA;AAChD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,SAAqB,EAAE,cAA0B;IAC3F,MAAM,UAAU,GAAG,mBAAmB,OAAO,EAAE,CAAA;IAE/C,oFAAoF;IACpF,SAAS,CAAC,MAAM,CAAC,IAAI,UAAU,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;IACjD,SAAS;SACJ,MAAM,CAAC,MAAM,CAAC;SACV,IAAI,CAAC,IAAI,EAAE,GAAG,UAAU,OAAO,CAAC;SACpC,MAAM,CAAC,UAAU,CAAC;SACd,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;SAC1B,MAAM,CAAC,MAAM,CAAC;SACV,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;SACZ,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;SACZ,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;SAChD,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;IAE3D,OAAO,UAAU,CAAA;AACrB,CAAC;AAYD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,KAAa,EAAkB,EAAE,CAAC,CAAC,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC,CAAA"}

package/dist/src/app/charts/series/baseSeries.d.ts

@@ -0,0 +1,38 @@
+import { Result } from "result-fn";
+/**
+ * A spike series holding an array of spike (time, value) datum, the name and supplemental information
+ * needed by the `RasterChart`
+ */
+export interface BaseSeries<D> {
+    readonly name: string;
+    data: Array<D>;
+    readonly last: () => Result<D, string>;
+    readonly length: () => number;
+    readonly isEmpty: () => boolean;
+}
+/**
+ * Creates a series from the name and the optional array of `Datum`.
+ * @param name The name of the series (i.e. neuron)
+ * @param data The array of datum, which could be `(t, f(t))`, or `(f[n](x), f[n+1](x))`
+ * @return A {@link BaseSeries} for object that can be used by in {@link Chart}s
+ * @see seriesFromTuples
+ * @see emptySeries
+ */
+export declare function seriesFrom<D>(name: string, data?: Array<D>): BaseSeries<D>;
+/**
+ * Returns an empty series with the specified name
+ * @param name The name of the series
+ * @return The empty series
+ * @see seriesFrom
+ * @see seriesFromTuples
+ */
+export declare const emptySeries: <D>(name: string) => BaseSeries<D>;
+/**
+ * Creates an array of empty series, one for each specified name
+ * @param names The names for each of the empty series
+ * @return An array of empty series with the specified names
+ * @see emptySeries
+ * @see seriesFrom
+ * @see seriesFromTuples
+ */
+export declare const emptySeriesFor: <D>(names: Array<string>) => Array<BaseSeries<D>>;

package/dist/src/app/charts/series/baseSeries.js

@@ -0,0 +1,36 @@
+import { failureResult, successResult } from "result-fn";
+/**
+ * Creates a series from the name and the optional array of `Datum`.
+ * @param name The name of the series (i.e. neuron)
+ * @param data The array of datum, which could be `(t, f(t))`, or `(f[n](x), f[n+1](x))`
+ * @return A {@link BaseSeries} for object that can be used by in {@link Chart}s
+ * @see seriesFromTuples
+ * @see emptySeries
+ */
+export function seriesFrom(name, data = []) {
+    return {
+        name: name,
+        data: data,
+        last: () => data ? (data.length > 0 ? successResult(data[data.length - 1]) : failureResult("Data is empty")) : failureResult("Data is not defined"),
+        length: () => data ? data.length : 0,
+        isEmpty: () => data ? data.length === 0 : true
+    };
+}
+/**
+ * Returns an empty series with the specified name
+ * @param name The name of the series
+ * @return The empty series
+ * @see seriesFrom
+ * @see seriesFromTuples
+ */
+export const emptySeries = (name) => seriesFrom(name);
+/**
+ * Creates an array of empty series, one for each specified name
+ * @param names The names for each of the empty series
+ * @return An array of empty series with the specified names
+ * @see emptySeries
+ * @see seriesFrom
+ * @see seriesFromTuples
+ */
+export const emptySeriesFor = (names) => names.map(name => seriesFrom(name));
+//# sourceMappingURL=baseSeries.js.map

package/dist/src/app/charts/series/baseSeries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseSeries.js","sourceRoot":"","sources":["../../../../../src/app/charts/series/baseSeries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAU,aAAa,EAAC,MAAM,WAAW,CAAC;AAc/D;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAI,IAAY,EAAE,OAAiB,EAAE;IAC3D,OAAO;QACH,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAY,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAY,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAY,qBAAqB,CAAC;QACpL,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;KACjD,CAAA;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAI,IAAY,EAAiB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,KAAoB,EAAwB,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA"}

package/dist/src/app/charts/series/datumSeries.test.d.ts

@@ -0,0 +1 @@
+export {};