stream-charts 1.0.1 → 1.1.0

package/dist/src/app/charts/series/datumSeries.test.js

@@ -0,0 +1,50 @@
+import { emptySeries, seriesFrom } from "./baseSeries";
+describe('should be able to create an empty series', () => {
+    test('an empty series should be empty', () => {
+        expect(emptySeries('test1').isEmpty());
+    });
+    test('an empty series should not have a last element', () => {
+        expect(emptySeries('test1').last().failed);
+    });
+    test('an empty series should have 0 length', () => {
+        expect(emptySeries('test1').length()).toBe(0);
+    });
+    test('an empty series should not have any data', () => {
+        expect(emptySeries('test1').data.length).toBe(0);
+    });
+    test('an empty series should have the specified name', () => {
+        expect(emptySeries('test1').name).toBe('test1');
+    });
+});
+describe('should be able to create a series from data', () => {
+    const data = [
+        { time: 1, value: 10 },
+        { time: 2, value: 20 },
+        { time: 3, value: 30 },
+        { time: 4, value: 40 },
+        { time: 5, value: 50 },
+        { time: 6, value: 60 },
+        { time: 7, value: 70 },
+        { time: 8, value: 80 },
+        { time: 9, value: 90 },
+        { time: 10, value: 100 },
+    ];
+    const series = seriesFrom('test2', data);
+    test('series should not be empty', () => {
+        expect(!series.isEmpty());
+    });
+    test('series name should be test2', () => {
+        expect(series.name).toEqual('test2');
+    });
+    test('series should have 10 points', () => {
+        expect(series.length()).toBe(10);
+    });
+    test('last value in series should be (10, 100)', () => {
+        const lastElement = series.last().getOrElse({ time: NaN, value: NaN });
+        expect(lastElement).toEqual({ time: 10, value: 100 });
+    });
+    test('series data should equal original data', () => {
+        expect(series.data).toEqual(data);
+    });
+});
+//# sourceMappingURL=datumSeries.test.js.map

package/dist/src/app/charts/series/datumSeries.test.js.map

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

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

@@ -0,0 +1,42 @@
+import { BaseSeries } from "./baseSeries";
+/**
+ * An immutable datum object that holds the iterate `(f[n](x), f[n+1](x))` with an
+ * informational time
+ */
+export interface IterateDatum {
+    readonly time: number;
+    readonly iterateN: number;
+    readonly iterateN_1: number;
+}
+/**
+ * Creates an empty iterate datum
+ */
+export declare const emptyIterateDatum: IterateDatum;
+/**
+ * Creates an iterate datum
+ * @param time The informational time
+ * @param iterateN The n-th iterate (i.e. `f[n](x)`)
+ * @param iterateN_1 The (n+1)-th iterate (i.e. `f[n+1](x)`)
+ * @return An iterate datum
+ */
+export declare const iterateDatumOf: (time: number, iterateN: number, iterateN_1: number) => IterateDatum;
+/**
+ * Returns whether the iterate datum is considered empty. An iterate datum is considered
+ * empty when the time, `f[n](x)`, `f[n+1](x)` values are all `NaN`
+ * @param datum The iterate datum to test
+ * @return `true` if the iterate datum is empty; `false` otherwise
+ */
+export declare const nonEmptyIterateDatum: (datum: IterateDatum) => boolean;
+/**
+ * A series of iterate (i.e. `(f[n](x), f[n+1](x))` pairs)
+ */
+export type IterateSeries = BaseSeries<IterateDatum>;
+/**
+ * Creates a series from the name and the optional array of (x, y) pairs (tuples)
+ * @param name The name of the series
+ * @param data The optional array of (x, y) pairs (tuples)
+ * @return A `Series` for object that can be used by the `PoincarePlot`
+ * @see seriesFrom
+ * @see emptySeries
+ */
+export declare const iterateSeriesFromTuples: (name: string, data?: Array<[number, number, number]>) => IterateSeries;

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

@@ -0,0 +1,34 @@
+import { seriesFrom } from "./baseSeries";
+/**
+ * Creates an empty iterate datum
+ */
+export const emptyIterateDatum = { time: NaN, iterateN: NaN, iterateN_1: NaN };
+/**
+ * Creates an iterate datum
+ * @param time The informational time
+ * @param iterateN The n-th iterate (i.e. `f[n](x)`)
+ * @param iterateN_1 The (n+1)-th iterate (i.e. `f[n+1](x)`)
+ * @return An iterate datum
+ */
+export const iterateDatumOf = (time, iterateN, iterateN_1) => ({
+    time,
+    iterateN,
+    iterateN_1
+});
+/**
+ * Returns whether the iterate datum is considered empty. An iterate datum is considered
+ * empty when the time, `f[n](x)`, `f[n+1](x)` values are all `NaN`
+ * @param datum The iterate datum to test
+ * @return `true` if the iterate datum is empty; `false` otherwise
+ */
+export const nonEmptyIterateDatum = (datum) => !isNaN(datum.time) && !isNaN(datum.iterateN) && !isNaN(datum.iterateN_1);
+/**
+ * Creates a series from the name and the optional array of (x, y) pairs (tuples)
+ * @param name The name of the series
+ * @param data The optional array of (x, y) pairs (tuples)
+ * @return A `Series` for object that can be used by the `PoincarePlot`
+ * @see seriesFrom
+ * @see emptySeries
+ */
+export const iterateSeriesFromTuples = (name, data = []) => seriesFrom(name, data.map(([t, fn, fn_1]) => iterateDatumOf(t, fn, fn_1)));
+//# sourceMappingURL=iterateSeries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iterateSeries.js","sourceRoot":"","sources":["../../../../../src/app/charts/series/iterateSeries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,UAAU,EAAC,MAAM,cAAc,CAAC;AAYpD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAiB,EAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAC,CAAA;AAE1F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAE,UAAkB,EAAgB,EAAE,CAAC,CAAC;IACjG,IAAI;IACJ,QAAQ;IACR,UAAU;CACb,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAmB,EAAW,EAAE,CACjE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;AAO5E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAE,OAAwC,EAAE,EAAiB,EAAE,CAC/G,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,54 @@
+import { BaseSeries } from "./baseSeries";
+import { OrdinalChartData, OrdinalStats } from "../observables/ordinals";
+/**
+ * An immutable datum object for series with a category and value.
+ * This could be a series of (ordinal, value) where the category runs
+ * along the x-axis. Or, it could be a series of (value, ordinal) where
+ * the categories run along the y-axis.
+ */
+export interface OrdinalDatum {
+    readonly time: number;
+    readonly ordinal: string;
+    readonly value: number;
+}
+/**
+ * Creates an empty ordinal datum
+ */
+export declare const emptyOrdinalDatum: OrdinalDatum;
+export declare const copyOrdinalDatum: (datum: OrdinalDatum) => OrdinalDatum;
+/**
+ * Creates an iterate datum
+ * @param time The datum time, which is mostly informational
+ * @param ordinal The category name or identifier
+ * @param value The value
+ * @return An iterate datum
+ */
+export declare const ordinalDatumOf: (time: number, ordinal: string, value: number) => OrdinalDatum;
+/**
+ * Returns whether the ordinal datum is empty. An ordinal datum is considered empty
+ * when the time is NaN, the ordinal is blank (empty or only whitespace), and the value
+ * is NaN.
+ * @param datum The iterate datum to test
+ * @return `true` if the iterate datum is empty; `false` otherwise
+ */
+export declare const nonEmptyOrdinalDatum: (datum: OrdinalDatum) => boolean;
+/**
+ * A series of ordinal datum
+ */
+export type OrdinalSeries = BaseSeries<OrdinalDatum>;
+/**
+ * Creates a series from the name and the optional array of (time, ordinal, value) tuples
+ * @param name The name of the series
+ * @param data The optional array of (time, ordinal, value) tuples
+ * @return An {@link OrdinalSeries} for charts where one axis is the category, and the other a value
+ * @see seriesFrom
+ * @see emptySeries
+ */
+export declare function ordinateSeriesFromTuples(name: string, data?: Array<[time: number, ordinal: string, value: number]>): OrdinalSeries;
+/**
+ * Creates an empty chart data object with all the values set to 0
+ * @param seriesList The list of series names (identifiers) to update
+ * @return An empty chart data object
+ */
+export declare function initialOrdinalChartData(seriesList: Array<OrdinalSeries>): OrdinalChartData;
+export declare function calculateOrdinalStats(seriesList: Array<OrdinalSeries>): OrdinalStats;

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

@@ -0,0 +1,98 @@
+import { seriesFrom } from "./baseSeries";
+import { initialMaxTimeDatum, initialMaxValueDatum, initialMinTimeDatum, initialMinValueDatum } from "../observables/ordinals";
+/**
+ * Creates an empty ordinal datum
+ */
+export const emptyOrdinalDatum = {
+    time: NaN,
+    ordinal: "",
+    value: NaN,
+};
+export const copyOrdinalDatum = (datum) => ({
+    time: datum.time,
+    ordinal: datum.ordinal,
+    value: datum.value,
+});
+/**
+ * Creates an iterate datum
+ * @param time The datum time, which is mostly informational
+ * @param ordinal The category name or identifier
+ * @param value The value
+ * @return An iterate datum
+ */
+export const ordinalDatumOf = (time, ordinal, value) => ({
+    time,
+    ordinal,
+    value,
+});
+/**
+ * Returns whether the ordinal datum is empty. An ordinal datum is considered empty
+ * when the time is NaN, the ordinal is blank (empty or only whitespace), and the value
+ * is NaN.
+ * @param datum The iterate datum to test
+ * @return `true` if the iterate datum is empty; `false` otherwise
+ */
+export const nonEmptyOrdinalDatum = (datum) => !isNaN(datum.time) && datum.ordinal.replace(/\s/g, "").length > 0 && !isNaN(datum.value);
+/**
+ * Creates a series from the name and the optional array of (time, ordinal, value) tuples
+ * @param name The name of the series
+ * @param data The optional array of (time, ordinal, value) tuples
+ * @return An {@link OrdinalSeries} for charts where one axis is the category, and the other a value
+ * @see seriesFrom
+ * @see emptySeries
+ */
+export function ordinateSeriesFromTuples(name, data = []) {
+    return seriesFrom(name, data.map(([t, ordinal, value]) => ordinalDatumOf(t, ordinal, value)));
+}
+/**
+ * Creates an empty chart data object with all the values set to 0
+ * @param seriesList The list of series names (identifiers) to update
+ * @return An empty chart data object
+ */
+export function initialOrdinalChartData(seriesList) {
+    return {
+        seriesNames: new Set(seriesList.map(series => series.name)),
+        stats: calculateOrdinalStats(seriesList),
+        newPoints: new Map(seriesList.map(series => [
+            series.name,
+            series.data.map(datum => ({
+                time: datum.time,
+                ordinal: datum.ordinal,
+                value: datum.value,
+            }))
+        ]))
+    };
+}
+export function calculateOrdinalStats(seriesList) {
+    const ordinalValueStats = new Map(seriesList.map((series) => {
+        const seriesMin = series.data.reduce((min, datum) => datum.value < min.value ? datum : min, initialMinValueDatum());
+        const seriesMax = series.data.reduce((max, datum) => datum.value > max.value ? datum : max, initialMaxValueDatum());
+        const seriesSum = series.data.reduce((sum, datum) => sum + datum.value, 0);
+        const seriesSumSquared = series.data.reduce((sumSquared, datum) => sumSquared + datum.value * datum.value, 0);
+        const seriesMean = series.data.length > 0 ? seriesSum / series.data.length : NaN;
+        return [series.name, {
+                max: seriesMax,
+                min: seriesMin,
+                count: series.data.length,
+                sum: seriesSum,
+                sumSquared: seriesSumSquared,
+                mean: seriesMean,
+            }];
+    }));
+    const minValueDatum = Array.from(ordinalValueStats.values()).reduce((min, value) => value.min.value < min.value ? value.min : min, initialMinValueDatum());
+    const maxValueDatum = Array.from(ordinalValueStats.values()).reduce((max, value) => value.max.value > max.value ? value.max : max, initialMaxValueDatum());
+    const minTimeDatum = seriesList.reduce((globalMin, series) => {
+        const seriesMin = series.data.reduce((min, datum) => datum.value < min.value ? datum : min, globalMin);
+        return seriesMin.value < globalMin.value ? seriesMin : globalMin;
+    }, initialMinTimeDatum());
+    const maxTimeDatum = seriesList.reduce((globalMax, series) => {
+        const seriesMax = series.data.reduce((max, datum) => datum.value > max.value ? datum : max, globalMax);
+        return seriesMax.value > globalMax.value ? seriesMax : globalMax;
+    }, initialMaxTimeDatum());
+    return {
+        maxDatum: { time: maxTimeDatum, value: maxValueDatum },
+        minDatum: { time: minTimeDatum, value: minValueDatum },
+        valueStatsForSeries: ordinalValueStats
+    };
+}
+//# sourceMappingURL=ordinalSeries.js.map

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

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

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

@@ -0,0 +1,30 @@
+import { BaseSeries } from "./baseSeries";
+/**
+ * An immutable datum object that holds the spike (time, value) representing a neuron spike
+ */
+export interface Datum {
+    readonly time: number;
+    readonly value: number;
+}
+/**
+ * Creates a datum from a (time, value) pair
+ * @param time The time
+ * @param value The value
+ * @return A {@link Datum} instance with the specified (time, value)
+ */
+export declare const datumOf: (time: number, value: number) => Datum;
+export declare const emptyDatum: () => Datum;
+export type TimeSeries = BaseSeries<Datum>;
+/**
+ * Creates a series from the name and the optional array of (x, y) pairs (tuples)
+ * @param name The name of the series
+ * @param data The optional array of (x, y) pairs (tuples)
+ * @return A `Series` for object that can be used by the `RasterChart`
+ * @see seriesFrom
+ * @see emptySeries
+ */
+export declare const timeSeriesFromTuples: (name: string, data?: Array<[number, number]>) => TimeSeries;
+export interface PixelDatum extends Datum {
+    x: number;
+    y: number;
+}

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

@@ -0,0 +1,19 @@
+import { seriesFrom } from "./baseSeries";
+/**
+ * Creates a datum from a (time, value) pair
+ * @param time The time
+ * @param value The value
+ * @return A {@link Datum} instance with the specified (time, value)
+ */
+export const datumOf = (time, value) => ({ time, value });
+export const emptyDatum = () => ({ time: NaN, value: NaN });
+/**
+ * Creates a series from the name and the optional array of (x, y) pairs (tuples)
+ * @param name The name of the series
+ * @param data The optional array of (x, y) pairs (tuples)
+ * @return A `Series` for object that can be used by the `RasterChart`
+ * @see seriesFrom
+ * @see emptySeries
+ */
+export const timeSeriesFromTuples = (name, data = []) => seriesFrom(name, data.map(([t, y]) => datumOf(t, y)));
+//# sourceMappingURL=timeSeries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeSeries.js","sourceRoot":"","sources":["../../../../../src/app/charts/series/timeSeries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,UAAU,EAAC,MAAM,cAAc,CAAC;AAUpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,KAAa,EAAS,EAAE,CAAC,CAAC,EAAC,IAAI,EAAE,KAAK,EAAC,CAAC,CAAA;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAG,GAAU,EAAE,CAAC,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAC,CAAC,CAAA;AAKhE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,OAAgC,EAAE,EAAc,EAAE,CACjG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/src/app/charts/{chartData.d.ts → series/timeSeriesChartData.d.ts}

@@ -1,8 +1,9 @@
-import { Datum, Series } from "./datumSeries";
+import { Datum, TimeSeries } from "./timeSeries";
+import { ChartData } from "../observables/ChartData";
 /**
- * The spike-chart data produced by the rxjs observable that is pushed to the `RasterChart`
+ * The spike-chart data produced by the rxjs observable that is pushed to a streaming chart
  */
-export interface ChartData {
+export interface TimeSeriesChartData extends ChartData {
     /**
      * The max (latest) time for the data in the newPoints map
      */
@@ -16,17 +17,21 @@ export interface ChartData {
      * data points for that time-series (`map(series_name -> array(datum))`)
      */
     newPoints: Map<string, Array<Datum>>;
+    /**
+     * The current time (for example, when used with cadence)
+     */
     currentTime?: number;
 }
 /**
  * Creates an empty chart data object with all the values set to 0
  * @param {Array<string>} series The list of series names (identifiers) to update
- * @return {ChartData} An empty chart data object
+ * @return {TimeSeriesChartData} An empty chart data object
  */
-export declare function emptyChartData(series: Array<string>): ChartData;
+export declare function emptyTimeSeriesChartData(series: Array<string>): TimeSeriesChartData;
 /**
  * Creates an empty chart data object with all the values set to 0
  * @param seriesList The list of series names (identifiers) to update
+ * @param [currentTime=0] The current time
  * @return An empty chart data object
  */
-export declare function initialChartData(seriesList: Array<Series>): ChartData;
+export declare function initialTimeSeriesChartData(seriesList: Array<TimeSeries>, currentTime?: number): TimeSeriesChartData;

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

@@ -0,0 +1,32 @@
+import { defaultChartData } from "../observables/ChartData";
+/**
+ * Creates an empty chart data object with all the values set to 0
+ * @param {Array<string>} series The list of series names (identifiers) to update
+ * @return {TimeSeriesChartData} An empty chart data object
+ */
+export function emptyTimeSeriesChartData(series) {
+    return Object.assign(Object.assign({}, defaultChartData()), { maxTime: 0, maxTimes: new Map(series.map(name => [name, 0])), newPoints: new Map(series.map(name => [name, [{ time: 0, value: 0 }]])) });
+}
+/**
+ * Creates an empty chart data object with all the values set to 0
+ * @param seriesList The list of series names (identifiers) to update
+ * @param [currentTime=0] The current time
+ * @return An empty chart data object
+ */
+export function initialTimeSeriesChartData(seriesList, currentTime = 0) {
+    const maxTime = seriesList.reduce((tMax, series) => Math.max(tMax, series.last().map(datum => datum.time).getOrElse(-Infinity)), -Infinity);
+    return {
+        seriesNames: new Set(seriesList.map(series => series.name)),
+        maxTime,
+        maxTimes: new Map(seriesList.map(series => [series.name, series.last().map(datum => datum.time).getOrElse(0)])),
+        newPoints: new Map(seriesList.map(series => [
+            series.name,
+            [{
+                    time: series.last().map(datum => datum.time).getOrElse(0),
+                    value: series.last().map(datum => datum.value).getOrElse(0)
+                }]
+        ])),
+        currentTime: currentTime
+    };
+}
+//# sourceMappingURL=timeSeriesChartData.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeSeriesChartData.js","sourceRoot":"","sources":["../../../../../src/app/charts/series/timeSeriesChartData.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AA4BrE;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAqB;IAC1D,uCACO,gBAAgB,EAAE,KACrB,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAChD,SAAS,EAAE,IAAI,GAAG,CAAuB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC,IAC9F;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAA6B,EAAE,cAAsB,CAAC;IAC7F,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAC7B,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,EAC7F,CAAC,QAAQ,CACZ,CAAA;IACD,OAAO;QACH,WAAW,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3D,OAAO;QACP,QAAQ,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/G,SAAS,EAAE,IAAI,GAAG,CAAuB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI;YACX,CAAC;oBACG,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;oBACzD,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;iBAC9D,CAAC;SACL,CAAC,CAAC;QACH,WAAW,EAAE,WAAW;KAC3B,CAAA;AACL,CAAC"}

package/dist/src/app/charts/styling/barPlotStyle.d.ts

@@ -0,0 +1,41 @@
+import { SeriesStyle } from "../axes/axes";
+import { SvgFillStyle, SvgStrokeStyle } from "./svgStyle";
+export interface BarSeriesStyle extends SeriesStyle {
+    /**
+     * The bar style for the lifetime min/max range bar. The style is for the width, fill,
+     * and stroke.
+     */
+    minMaxBar: BarStyle;
+    /**
+     * The bar style for the windowed min/max range bar. The style is for the width, fill,
+     * and stroke.
+     */
+    windowedMinMaxBar: BarStyle;
+    /**
+     * The line style for the current value.
+     */
+    valueLine: LineStyle;
+    /**
+     * The line style for the mean value.
+     */
+    meanValueLine: LineStyle;
+    /**
+     * The line style for the windowed-mean value.
+     */
+    windowedMeanValueLine: LineStyle;
+}
+export interface BarStyle {
+    widthFraction: number;
+    fill: SvgFillStyle;
+    stroke: SvgStrokeStyle;
+}
+export interface LineStyle {
+    regular: SvgStrokeStyle;
+    highlight: SvgStrokeStyle;
+}
+export declare function defaultMinMaxBarStyle(color?: string): BarStyle;
+export declare function defaultWindowedMinMaxBarStyle(color?: string): BarStyle;
+export declare function defaultValueLineStyle(color?: string): LineStyle;
+export declare function defaultMeanValueLineStyle(color?: string): LineStyle;
+export declare function defaultWindowedMeanValueLineStyle(color?: string): LineStyle;
+export declare function defaultBarSeriesStyle(color?: string): BarSeriesStyle;

package/dist/src/app/charts/styling/barPlotStyle.js

@@ -0,0 +1,84 @@
+import * as d3 from "d3";
+export function defaultMinMaxBarStyle(color = "#008aad") {
+    return {
+        widthFraction: 0.65,
+        fill: {
+            color,
+            opacity: 0.4
+        },
+        stroke: {
+            width: 1,
+            opacity: 0.6,
+            color,
+        }
+    };
+}
+export function defaultWindowedMinMaxBarStyle(color = "#008aad") {
+    var _a, _b, _c, _d;
+    return {
+        widthFraction: 0.25,
+        fill: {
+            color: (_b = (_a = d3.color(color)) === null || _a === void 0 ? void 0 : _a.darker(0.3).toString()) !== null && _b !== void 0 ? _b : color,
+            opacity: 0.6
+        },
+        stroke: {
+            width: 0,
+            opacity: 0,
+            color: (_d = (_c = d3.color(color)) === null || _c === void 0 ? void 0 : _c.darker(0.3).toString()) !== null && _d !== void 0 ? _d : color,
+        }
+    };
+}
+export function defaultValueLineStyle(color = "#008aad") {
+    return {
+        regular: {
+            color,
+            opacity: 0.6,
+            width: 3
+        },
+        highlight: {
+            color,
+            opacity: 1,
+            width: 5
+        }
+    };
+}
+export function defaultMeanValueLineStyle(color = "#008aad") {
+    return {
+        regular: {
+            color,
+            opacity: 0.6,
+            width: 1
+        },
+        highlight: {
+            color,
+            opacity: 1,
+            width: 3
+        }
+    };
+}
+export function defaultWindowedMeanValueLineStyle(color = "#008aad") {
+    return {
+        regular: {
+            color: 'red',
+            opacity: 0.6,
+            width: 1
+        },
+        highlight: {
+            color: 'red',
+            opacity: 1,
+            width: 3
+        }
+    };
+}
+export function defaultBarSeriesStyle(color = "#008aad") {
+    return {
+        color,
+        highlightColor: color,
+        minMaxBar: defaultMinMaxBarStyle(color),
+        windowedMinMaxBar: defaultWindowedMinMaxBarStyle(color),
+        valueLine: defaultValueLineStyle(color),
+        meanValueLine: defaultMeanValueLineStyle(color),
+        windowedMeanValueLine: defaultWindowedMeanValueLineStyle(color),
+    };
+}
+//# sourceMappingURL=barPlotStyle.js.map

package/dist/src/app/charts/styling/barPlotStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"barPlotStyle.js","sourceRoot":"","sources":["../../../../../src/app/charts/styling/barPlotStyle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAsCzB,MAAM,UAAU,qBAAqB,CAAC,QAAgB,SAAS;IAC3D,OAAO;QACH,aAAa,EAAE,IAAI;QACnB,IAAI,EAAE;YACF,KAAK;YACL,OAAO,EAAE,GAAG;SACf;QACD,MAAM,EAAE;YACJ,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,GAAG;YACZ,KAAK;SACR;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAgB,SAAS;;IACnE,OAAO;QACH,aAAa,EAAE,IAAI;QACnB,IAAI,EAAE;YACF,KAAK,EAAE,MAAA,MAAA,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,0CAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,mCAAI,KAAK;YACvD,OAAO,EAAE,GAAG;SACf;QACD,MAAM,EAAE;YACJ,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,MAAA,MAAA,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,0CAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,mCAAI,KAAK;SAC1D;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,SAAS;IAC3D,OAAO;QACH,OAAO,EAAE;YACL,KAAK;YACL,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACP,KAAK;YACL,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAgB,SAAS;IAC/D,OAAO;QACH,OAAO,EAAE;YACL,KAAK;YACL,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACP,KAAK;YACL,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,QAAgB,SAAS;IACvE,OAAO;QACH,OAAO,EAAE;YACL,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACP,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,SAAS;IAC3D,OAAO;QACH,KAAK;QACL,cAAc,EAAE,KAAK;QACrB,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC;QACvC,iBAAiB,EAAE,6BAA6B,CAAC,KAAK,CAAC;QACvD,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC;QACvC,aAAa,EAAE,yBAAyB,CAAC,KAAK,CAAC;QAC/C,qBAAqB,EAAE,iCAAiC,CAAC,KAAK,CAAC;KAClE,CAAA;AACL,CAAC"}

package/dist/src/app/charts/{margins.d.ts → styling/margins.d.ts}

@@ -9,12 +9,12 @@ export interface Margin {
 }
 export declare function noMargins(): Margin;
 export interface Dimensions {
-    width: number;
-    height: number;
+    readonly width: number;
+    readonly height: number;
 }
 /**
  * Given the dimensions of the plot (width, height) based on the container's width and height,
- * and the plots margins. Calculates the dimensions of the actual plot by subtracting the margins.
+ * and the plot's margins. Calculates the dimensions of the actual plot by subtracting the margins.
  * @param containerWidth The overall width of the container (plot and margins)
  * @param containerHeight The overall height of the container (plot and margins)
  * @param plotMargins The margins around the plot (top, bottom, left, right)
@@ -22,7 +22,7 @@ export interface Dimensions {
  * from the overall dimensions
  * @see containerDimensionsFrom
  */
-export declare const plotDimensionsFrom: (containerWidth: number, containerHeight: number, plotMargins: Margin) => Dimensions;
+export declare function plotDimensionsFrom(containerWidth: number, containerHeight: number, plotMargins: Margin): Dimensions;
 /**
  * Calculates the container's dimensions from the plot dimensions and the plot margin. The container
  * dimensions are the plot dimensions plus the margins.
@@ -31,4 +31,6 @@ export declare const plotDimensionsFrom: (containerWidth: number, containerHeigh
  * @return The container dimensions.
  * @see plotDimensionsFrom
  */
-export declare const containerDimensionsFrom: (plotDimensions: Dimensions, plotMargin: Margin) => Dimensions;
+export declare function containerDimensionsFrom(plotDimensions: Dimensions, plotMargin: Margin): Dimensions;
+export declare function dimensionsEqual(dimension1: Dimensions, dimension2: Dimensions): boolean;
+export declare function dimensionsNotEqual(dimension1: Dimensions, dimension2: Dimensions): boolean;

package/dist/src/app/charts/{margins.js → styling/margins.js}

@@ -3,7 +3,7 @@ export function noMargins() {
 }
 /**
  * Given the dimensions of the plot (width, height) based on the container's width and height,
- * and the plots margins. Calculates the dimensions of the actual plot by subtracting the margins.
+ * and the plot's margins. Calculates the dimensions of the actual plot by subtracting the margins.
  * @param containerWidth The overall width of the container (plot and margins)
  * @param containerHeight The overall height of the container (plot and margins)
  * @param plotMargins The margins around the plot (top, bottom, left, right)
@@ -11,10 +11,12 @@ export function noMargins() {
  * from the overall dimensions
  * @see containerDimensionsFrom
  */
-export var plotDimensionsFrom = function (containerWidth, containerHeight, plotMargins) { return ({
-    width: containerWidth - plotMargins.left - plotMargins.right,
-    height: containerHeight - plotMargins.top - plotMargins.bottom
-}); };
+export function plotDimensionsFrom(containerWidth, containerHeight, plotMargins) {
+    return {
+        width: containerWidth - plotMargins.left - plotMargins.right,
+        height: containerHeight - plotMargins.top - plotMargins.bottom
+    };
+}
 /**
  * Calculates the container's dimensions from the plot dimensions and the plot margin. The container
  * dimensions are the plot dimensions plus the margins.
@@ -23,8 +25,16 @@ export var plotDimensionsFrom = function (containerWidth, containerHeight, plotM
  * @return The container dimensions.
  * @see plotDimensionsFrom
  */
-export var containerDimensionsFrom = function (plotDimensions, plotMargin) { return ({
-    width: plotDimensions.width + plotMargin.left + plotMargin.right,
-    height: plotDimensions.height + plotMargin.top + plotMargin.bottom
-}); };
+export function containerDimensionsFrom(plotDimensions, plotMargin) {
+    return {
+        width: plotDimensions.width + plotMargin.left + plotMargin.right,
+        height: plotDimensions.height + plotMargin.top + plotMargin.bottom
+    };
+}
+export function dimensionsEqual(dimension1, dimension2) {
+    return dimension1.height === dimension2.height && dimension1.width === dimension2.width;
+}
+export function dimensionsNotEqual(dimension1, dimension2) {
+    return !dimensionsEqual(dimension1, dimension2);
+}
 //# sourceMappingURL=margins.js.map

package/dist/src/app/charts/styling/margins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"margins.js","sourceRoot":"","sources":["../../../../../src/app/charts/styling/margins.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,SAAS;IACrB,OAAO,EAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAC,CAAA;AACjD,CAAC;AAOD;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,cAAsB,EAAE,eAAuB,EAAE,WAAmB;IACnG,OAAO;QACH,KAAK,EAAE,cAAc,GAAG,WAAW,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK;QAC5D,MAAM,EAAE,eAAe,GAAG,WAAW,CAAC,GAAG,GAAG,WAAW,CAAC,MAAM;KACjE,CAAA;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,cAA0B,EAAE,UAAkB;IAClF,OAAO;QACH,KAAK,EAAE,cAAc,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK;QAChE,MAAM,EAAE,cAAc,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,MAAM;KACrE,CAAA;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAsB,EAAE,UAAsB;IAC1E,OAAO,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK,CAAA;AAC3F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAsB,EAAE,UAAsB;IAC7E,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AACnD,CAAC"}