scichart 2.0.2228 → 2.1.0-beta.40

package/Charting/ChartModifiers/DataPointSelectionModifier.js

@@ -410,7 +410,6 @@ var DataPointSelectionModifier = /** @class */ (function (_super) {
                     topYData = yCalc.getDataValue(_this.startPoint.y);
                 }
                 if (rs.dataSeries.type === IDataSeries_1.EDataSeriesType.HeatmapUniform) {
-                    var heatmapSeries = rs.dataSeries;
                     // TODO: Heatmap series
                 }
                 else {

package/Charting/Drawing/WebGlRenderContext2D.d.ts

@@ -39,6 +39,7 @@ export declare class WebGlRenderContext2D implements IRenderContext2D {
     private readonly layers;
     private readonly webAssemblyContext;
     private readonly effects;
+    private nativeContext;
     /**
      * Creates an instance of the WebGlRenderContext2D
      * @param webAssemblyContext The {@link TSciChart | SciChart WebAssembly Context} containing native methods and access to our WebGL2 Engine

package/Charting/Drawing/WebGlRenderContext2D.js

@@ -43,7 +43,10 @@ var WebGlRenderContext2D = /** @class */ (function () {
      * Get the native {@link SCRTRenderContext} for direct access to SciChart's WebAssembly Visual Xccelerator engine
      */
     WebGlRenderContext2D.prototype.getNativeContext = function () {
-        return this.webAssemblyContext.SCRTGetMainRenderContext2D();
+        if (!this.nativeContext) {
+            this.nativeContext = this.webAssemblyContext.SCRTGetMainRenderContext2D();
+        }
+        return this.nativeContext;
     };
     /**
      * Draw lines: grid lines, etc.

package/Charting/Model/BaseDataSeries.d.ts

@@ -1,13 +1,19 @@
 import { EventHandler } from "../../Core/EventHandler";
 import { NumberRange } from "../../Core/NumberRange";
-import { DoubleVector, TSciChart } from "../../types/TSciChart";
+import { ESearchMode } from "../../types/SearchMode";
+import { SCRTDoubleVector, TSciChart } from "../../types/TSciChart";
 import { SeriesAnimation } from "../Visuals/RenderableSeries/Animations/SeriesAnimation";
+import { IDataDistributionCalculator } from "./DataDistributionCalculator/IDataDistributionCalculator";
 import { EDataChangeType, EDataSeriesType, EDataSeriesValueType, IDataChangeArgs, IDataSeries } from "./IDataSeries";
 import { IMetadataGenerator, IPointMetadata } from "./IPointMetadata";
 /**
  * Options to pass to the {@link BaseDataSeries} constructor
  */
 export interface IBaseDataSeriesOptions {
+    /**
+     * A unique Id for the {@link IDataSeries}
+     */
+    id?: string;
     /**
      * The DataSeries name, used in legends, tooltips to identify the chart series
      */
@@ -19,6 +25,14 @@ export interface IBaseDataSeriesOptions {
      * algorithms for zooming, panning and ranging and ensure best performance.
      */
     dataIsSortedInX?: boolean;
+    /**
+     * When true, the Data is evenly spaced in X.
+     * @remarks
+     * The user must specify this flag (defaults to true) in order to choose the correct, and
+     * fastest algorithms for drawing, indexing and ranging. If you experience glitches or
+     * strange drawing, it may be because you have set data with uneven spacing in X but not set this flag.
+     */
+    dataEvenlySpacedInX?: boolean;
     /**
      * Gets or sets whether the Y data contains NaN values.
      */
@@ -49,6 +63,10 @@ export declare abstract class BaseDataSeries implements IDataSeries {
     abstract readonly type: EDataSeriesType;
     /** @inheritDoc */
     readonly dataChanged: EventHandler<IDataChangeArgs>;
+    /** @inheritDoc */
+    readonly id: string;
+    /** @inheritDoc */
+    readonly dataDistributionCalculator: IDataDistributionCalculator;
     minXSpacing: number;
     /**
      * If set, these will be included in the serialised definition, so that it can be used with sharedData
@@ -61,28 +79,30 @@ export declare abstract class BaseDataSeries implements IDataSeries {
     /**
      * X vector with initial animation values
      */
-    xInitialAnimationValues: DoubleVector;
+    xInitialAnimationValues: SCRTDoubleVector;
     /**
      * Y vector with initial animation values
      */
-    yInitialAnimationValues: DoubleVector;
+    yInitialAnimationValues: SCRTDoubleVector;
     /**
      * X vector with final animation values
      */
-    xFinalAnimationValues: DoubleVector;
+    xFinalAnimationValues: SCRTDoubleVector;
     /**
      * Y vector with final animation values
      */
-    yFinalAnimationValues: DoubleVector;
-    protected xValues: DoubleVector;
-    protected yValues: DoubleVector;
-    protected indexes: DoubleVector;
+    yFinalAnimationValues: SCRTDoubleVector;
+    protected xValues: SCRTDoubleVector;
+    protected yValues: SCRTDoubleVector;
+    protected indexes: SCRTDoubleVector;
     protected isDeleted: boolean;
     private dataSeriesNameProperty;
     private isSortedProperty;
     private containsNaNProperty;
+    private isEvenlySpacedProperty;
     private metadataProperty;
     private metadataGeneratorProperty;
+    private changeCountProperty;
     /**
      * Creates an instance of {@link BaseDataSeries}
      * @param webAssemblyContext the {@link TSciChart | SciChart WebAssembly Context} containing native methods
@@ -91,7 +111,7 @@ export declare abstract class BaseDataSeries implements IDataSeries {
      */
     protected constructor(webAssemblyContext: TSciChart, options?: IBaseDataSeriesOptions);
     /** @inheritDoc */
-    abstract clear(): void;
+    clear(): void;
     /** @inheritDoc */
     get containsNaN(): boolean;
     /** @inheritDoc */
@@ -101,6 +121,10 @@ export declare abstract class BaseDataSeries implements IDataSeries {
     /** @inheritDoc */
     set isSorted(isSorted: boolean);
     /** @inheritDoc */
+    get isEvenlySpaced(): boolean;
+    /** @inheritDoc */
+    set isEvenlySpaced(isSorted: boolean);
+    /** @inheritDoc */
     get dataSeriesName(): string;
     /** @inheritDoc */
     set dataSeriesName(dataSeriesName: string);
@@ -109,11 +133,11 @@ export declare abstract class BaseDataSeries implements IDataSeries {
     /** @inheritDoc */
     getIsDeleted(): boolean;
     /** @inheritDoc */
-    getNativeIndexes(): DoubleVector;
+    getNativeIndexes(): SCRTDoubleVector;
     /** @inheritDoc */
-    getNativeXValues(): DoubleVector;
+    getNativeXValues(): SCRTDoubleVector;
     /** @inheritDoc */
-    getNativeYValues(): DoubleVector;
+    getNativeYValues(): SCRTDoubleVector;
     /** @inheritDoc */
     delete(): void;
     /**
@@ -126,7 +150,8 @@ export declare abstract class BaseDataSeries implements IDataSeries {
     getXRange(dataSeriesValueType?: EDataSeriesValueType): NumberRange;
     /** @inheritDoc */
     getWindowedYRange(xRange: NumberRange, getPositiveRange: boolean, isXCategoryAxis?: boolean, dataSeriesValueType?: EDataSeriesValueType): NumberRange;
-    getIndicesRange(xRange: NumberRange): NumberRange;
+    /** @inheritDoc */
+    getIndicesRange(xRange: NumberRange, isCategoryData?: boolean, downSearchMode?: ESearchMode, upSearchMode?: ESearchMode): NumberRange;
     /** @inheritDoc */
     get hasValues(): boolean;
     /**
@@ -169,6 +194,8 @@ export declare abstract class BaseDataSeries implements IDataSeries {
     updateAnimationProperties(progress: number, animation: SeriesAnimation): void;
     /** @inheritDoc */
     toJSON(excludeData?: boolean): any;
+    /** @inheritDoc */
+    get changeCount(): number;
     protected validateIndex(index: number, message?: string): void;
     protected setMetadataAt(index: number, metadata: IPointMetadata): void;
     protected appendMetadata(metadata: IPointMetadata): void;
@@ -178,8 +205,8 @@ export declare abstract class BaseDataSeries implements IDataSeries {
     protected removeMetadataAt(index: number): void;
     protected removeMetadataRange(startIndex: number, count: number): void;
     protected setMetadata(value: IPointMetadata[]): void;
-    protected getXValues(dataSeriesValueType: EDataSeriesValueType): DoubleVector;
+    protected getXValues(dataSeriesValueType: EDataSeriesValueType): SCRTDoubleVector;
     private fillMetadataIfUndefined;
     private getYValues;
 }
-export declare const getWindowedYRange: (webAssemblyContext: TSciChart, xValues: DoubleVector, yValues: DoubleVector, xRange: NumberRange, getPositiveRange: boolean, isXCategoryAxis: boolean, isSorted: boolean) => NumberRange;
+export declare const getWindowedYRange: (webAssemblyContext: TSciChart, xValues: SCRTDoubleVector, yValues: SCRTDoubleVector, xRange: NumberRange, getPositiveRange: boolean, isXCategoryAxis: boolean, isSorted: boolean) => NumberRange;

package/Charting/Model/BaseDataSeries.js

@@ -26,9 +26,11 @@ var Deleter_1 = require("../../Core/Deleter");
 var EventHandler_1 = require("../../Core/EventHandler");
 var NumberRange_1 = require("../../Core/NumberRange");
 var BaseType_1 = require("../../types/BaseType");
-var fillDoubleVectorFromJsArray_1 = require("../../utils/ccall/fillDoubleVectorFromJsArray");
+var SearchMode_1 = require("../../types/SearchMode");
+var guid_1 = require("../../utils/guid");
 var isRealNumber_1 = require("../../utils/isRealNumber");
 var animationHelpers_1 = require("../Visuals/RenderableSeries/Animations/animationHelpers");
+var DataDistributionCalculator_1 = require("./DataDistributionCalculator/DataDistributionCalculator");
 var IDataSeries_1 = require("./IDataSeries");
 var IPointMetadata_1 = require("./IPointMetadata");
 /**
@@ -49,28 +51,34 @@ var BaseDataSeries = /** @class */ (function () {
      * @param options the {@link IBaseDataSeriesOptions} which can be passed to config the DataSeries at construct time
      */
     function BaseDataSeries(webAssemblyContext, options) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         /** @inheritDoc */
         this.dataChanged = new EventHandler_1.EventHandler();
+        /** @inheritDoc */
+        this.dataDistributionCalculator = new DataDistributionCalculator_1.DataDistributionCalculator();
         this.minXSpacing = 0;
-        this.isSortedProperty = true;
-        this.containsNaNProperty = true;
+        this.isSortedProperty = undefined;
+        this.containsNaNProperty = undefined;
+        this.isEvenlySpacedProperty = false;
         this.metadataGeneratorProperty = undefined;
+        this.changeCountProperty = 0;
         this.webAssemblyContext = webAssemblyContext;
-        this.xValues = new webAssemblyContext.DoubleVector();
-        this.yValues = new webAssemblyContext.DoubleVector();
-        this.indexes = new webAssemblyContext.DoubleVector();
-        this.xInitialAnimationValues = new webAssemblyContext.DoubleVector();
-        this.yInitialAnimationValues = new webAssemblyContext.DoubleVector();
-        this.xFinalAnimationValues = new webAssemblyContext.DoubleVector();
-        this.yFinalAnimationValues = new webAssemblyContext.DoubleVector();
-        this.dataSeriesNameProperty = (_a = options === null || options === void 0 ? void 0 : options.dataSeriesName) !== null && _a !== void 0 ? _a : this.dataSeriesNameProperty;
+        this.id = (_a = options === null || options === void 0 ? void 0 : options.id) !== null && _a !== void 0 ? _a : (0, guid_1.generateGuid)();
+        this.xValues = new webAssemblyContext.SCRTDoubleVector();
+        this.yValues = new webAssemblyContext.SCRTDoubleVector();
+        this.indexes = new webAssemblyContext.SCRTDoubleVector();
+        this.xInitialAnimationValues = new webAssemblyContext.SCRTDoubleVector();
+        this.yInitialAnimationValues = new webAssemblyContext.SCRTDoubleVector();
+        this.xFinalAnimationValues = new webAssemblyContext.SCRTDoubleVector();
+        this.yFinalAnimationValues = new webAssemblyContext.SCRTDoubleVector();
+        this.dataSeriesNameProperty = (_b = options === null || options === void 0 ? void 0 : options.dataSeriesName) !== null && _b !== void 0 ? _b : this.dataSeriesNameProperty;
         this.isSorted = (options === null || options === void 0 ? void 0 : options.dataIsSortedInX) !== undefined ? options === null || options === void 0 ? void 0 : options.dataIsSortedInX : this.isSortedProperty;
-        this.containsNaN = (_b = options === null || options === void 0 ? void 0 : options.containsNaN) !== null && _b !== void 0 ? _b : this.containsNaNProperty;
+        this.containsNaN = (_c = options === null || options === void 0 ? void 0 : options.containsNaN) !== null && _c !== void 0 ? _c : this.containsNaNProperty;
+        this.isEvenlySpaced = (_d = options === null || options === void 0 ? void 0 : options.dataEvenlySpacedInX) !== null && _d !== void 0 ? _d : this.isEvenlySpacedProperty;
         if (options === null || options === void 0 ? void 0 : options.metadata) {
             if ("type" in options.metadata) {
                 this.metadataGeneratorProperty = (0, classFactory_1.createType)(BaseType_1.EBaseType.MetadataGenerator, options.metadata.type, webAssemblyContext, options.metadata.data);
-                options.metadata = (_c = this.metadataGeneratorProperty) === null || _c === void 0 ? void 0 : _c.getMetadata();
+                options.metadata = (_e = this.metadataGeneratorProperty) === null || _e === void 0 ? void 0 : _e.getMetadata();
             }
             else if (!Array.isArray(options === null || options === void 0 ? void 0 : options.metadata)) {
                 this.metadataGeneratorProperty = new IPointMetadata_1.TemplateMetadataGenerator(options === null || options === void 0 ? void 0 : options.metadata);
@@ -78,6 +86,12 @@ var BaseDataSeries = /** @class */ (function () {
             }
         }
     }
+    /** @inheritDoc */
+    BaseDataSeries.prototype.clear = function () {
+        var _a;
+        (_a = this.indexes) === null || _a === void 0 ? void 0 : _a.clear();
+        this.dataDistributionCalculator.clear(this.isSorted, this.containsNaN);
+    };
     Object.defineProperty(BaseDataSeries.prototype, "containsNaN", {
         /** @inheritDoc */
         get: function () {
@@ -86,6 +100,9 @@ var BaseDataSeries = /** @class */ (function () {
         /** @inheritDoc */
         set: function (containsNaN) {
             this.containsNaNProperty = containsNaN;
+            if (containsNaN !== undefined) {
+                this.dataDistributionCalculator.setContainsNaN(containsNaN);
+            }
             this.notifyDataChanged(IDataSeries_1.EDataChangeType.Property, undefined, undefined, "containsNaN");
         },
         enumerable: false,
@@ -99,11 +116,27 @@ var BaseDataSeries = /** @class */ (function () {
         /** @inheritDoc */
         set: function (isSorted) {
             this.isSortedProperty = isSorted;
+            if (isSorted !== undefined) {
+                this.dataDistributionCalculator.setIsSortedAscending(isSorted);
+            }
             this.notifyDataChanged(IDataSeries_1.EDataChangeType.Property, undefined, undefined, "isSorted");
         },
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(BaseDataSeries.prototype, "isEvenlySpaced", {
+        /** @inheritDoc */
+        get: function () {
+            return this.isEvenlySpacedProperty;
+        },
+        /** @inheritDoc */
+        set: function (isSorted) {
+            this.isEvenlySpacedProperty = isSorted;
+            this.notifyDataChanged(IDataSeries_1.EDataChangeType.Property, undefined, undefined, "isEvenlySpaced");
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(BaseDataSeries.prototype, "dataSeriesName", {
         /** @inheritDoc */
         get: function () {
@@ -135,9 +168,7 @@ var BaseDataSeries = /** @class */ (function () {
         }
         var indexes = this.indexes;
         if (indexes.size() < this.count()) {
-            var newIndexesLength = this.count() - indexes.size();
-            var indexValues = Array.from(Array(newIndexesLength), function (_, i) { return i + indexes.size(); });
-            (0, fillDoubleVectorFromJsArray_1.fillDoubleVectorFromJsArray)(this.webAssemblyContext, this.indexes, indexValues);
+            this.webAssemblyContext.SCRTFillVectorSequential(this.indexes, this.count());
         }
         return this.indexes;
     };
@@ -165,6 +196,7 @@ var BaseDataSeries = /** @class */ (function () {
      * Call to notify subscribers of {@link dataChanged} that the data has changed and {@link SciChartSurface} needs redrawing
      */
     BaseDataSeries.prototype.notifyDataChanged = function (changeType, index, count, name) {
+        this.changeCountProperty++;
         this.dataChanged.raiseEvent({ changeType: changeType, index: index, count: count });
     };
     Object.defineProperty(BaseDataSeries.prototype, "xRange", {
@@ -187,14 +219,18 @@ var BaseDataSeries = /** @class */ (function () {
         else if (this.count() > 1) {
             var min = xValues.get(0);
             var max = xValues.get(this.count() - 1);
-            if (!this.isSorted) {
-                for (var i = 0; i < this.count(); i++) {
-                    if (xValues.get(i) < min) {
-                        min = xValues.get(i);
-                    }
-                    if (xValues.get(i) > max) {
-                        max = xValues.get(i);
+            if (!this.dataDistributionCalculator.isSortedAscending) {
+                var minMax = void 0;
+                try {
+                    minMax = this.webAssemblyContext.NumberUtil.MinMax(this.getNativeXValues());
+                    if (!(0, isRealNumber_1.isRealNumber)(minMax.minD) || !(0, isRealNumber_1.isRealNumber)(minMax.maxD)) {
+                        return new NumberRange_1.NumberRange(0, 0);
                     }
+                    min = minMax.minD;
+                    max = minMax.maxD;
+                }
+                finally {
+                    (0, Deleter_1.deleteSafe)(minMax);
                 }
             }
             if (min === max) {
@@ -207,7 +243,7 @@ var BaseDataSeries = /** @class */ (function () {
             }
             return new NumberRange_1.NumberRange(min, max);
         }
-        return new NumberRange_1.NumberRange();
+        return new NumberRange_1.NumberRange(0, 0);
     };
     /** @inheritDoc */
     BaseDataSeries.prototype.getWindowedYRange = function (xRange, getPositiveRange, isXCategoryAxis, dataSeriesValueType) {
@@ -215,11 +251,16 @@ var BaseDataSeries = /** @class */ (function () {
         if (dataSeriesValueType === void 0) { dataSeriesValueType = IDataSeries_1.EDataSeriesValueType.Default; }
         var xValues = this.getXValues(dataSeriesValueType);
         var yValues = this.getYValues(dataSeriesValueType);
-        return (0, exports.getWindowedYRange)(this.webAssemblyContext, xValues, yValues, xRange, getPositiveRange, isXCategoryAxis, this.isSorted);
+        return (0, exports.getWindowedYRange)(this.webAssemblyContext, xValues, yValues, xRange, getPositiveRange, isXCategoryAxis, this.dataDistributionCalculator.isSortedAscending);
     };
-    BaseDataSeries.prototype.getIndicesRange = function (xRange) {
+    /** @inheritDoc */
+    BaseDataSeries.prototype.getIndicesRange = function (xRange, isCategoryData, downSearchMode, upSearchMode) {
+        if (isCategoryData === void 0) { isCategoryData = false; }
+        if (downSearchMode === void 0) { downSearchMode = SearchMode_1.ESearchMode.RoundDown; }
+        if (upSearchMode === void 0) { upSearchMode = SearchMode_1.ESearchMode.RoundUp; }
         // TODO SearchMode downSearchMode = SearchMode.RoundDown, SearchMode upSearchMode = SearchMode.RoundUp
-        return getIndicesRange(this.webAssemblyContext, this.xValues, xRange, this.isSorted);
+        var vector = isCategoryData ? this.getNativeIndexes() : this.xValues;
+        return getIndicesRange(this.webAssemblyContext, vector, xRange, this.dataDistributionCalculator.isSortedAscending);
     };
     Object.defineProperty(BaseDataSeries.prototype, "hasValues", {
         /** @inheritDoc */
@@ -329,6 +370,14 @@ var BaseDataSeries = /** @class */ (function () {
             metadata: this.metadataGeneratorProperty ? this.metadataGeneratorProperty.toJSON() : this.metadataProperty }, this.dataIds);
         return options;
     };
+    Object.defineProperty(BaseDataSeries.prototype, "changeCount", {
+        /** @inheritDoc */
+        get: function () {
+            return this.changeCountProperty;
+        },
+        enumerable: false,
+        configurable: true
+    });
     BaseDataSeries.prototype.validateIndex = function (index, message) {
         if (Math.round(index) !== index) {
             throw Error("Index must be an integer");

package/Charting/Model/BaseHeatmapDataSeries.d.ts

@@ -1,14 +1,20 @@
 import { TSeriesDataDefinition } from "../../Builder/buildDataSeries";
 import { EventHandler } from "../../Core/EventHandler";
 import { NumberRange } from "../../Core/NumberRange";
-import { DoubleVector, FloatVector, TSciChart } from "../../types/TSciChart";
+import { ESearchMode } from "../../types/SearchMode";
+import { FloatVector, SCRTDoubleVector, TSciChart } from "../../types/TSciChart";
 import { IColorMapParams } from "../Visuals/RenderableSeries/HeatmapColorMap";
+import { IDataDistributionCalculator } from "./DataDistributionCalculator/IDataDistributionCalculator";
 import { EDataChangeType, EDataSeriesType, IDataChangeArgs, IDataSeries } from "./IDataSeries";
 import { IMetadataGenerator, IPointMetadata } from "./IPointMetadata";
 /**
- * Options to pass to the {@link BaseHeatmapSeries} constructor
+ * Options to pass to the {@link BaseHeatmapDataSeries} constructor
  */
 export interface IBaseHeatmapSeriesOptions {
+    /**
+     * A unique Id for the {@link IDataSeries}
+     */
+    id?: string;
     /**
      * The DataSeries name, used in legends, tooltips to identify the chart series
      */
@@ -45,14 +51,13 @@ export interface IHeatmapSeries extends IDataSeries {
  * See {@link UniformHeatmapRenderableSeries} to see the class for rendering a 2D JavaScript Heatmap Chart.
  */
 export declare abstract class BaseHeatmapDataSeries implements IHeatmapSeries {
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     abstract type: EDataSeriesType;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly dataChanged: EventHandler<IDataChangeArgs>;
+    /** @inheritDoc */
+    readonly id: string;
+    /** @inheritDoc */
     minXSpacing: number;
     /**
      * Gets the width of the 2-dimensional array of {@link getZValues | Z-Values} where array is ranked [width][height]
@@ -87,6 +92,7 @@ export declare abstract class BaseHeatmapDataSeries implements IHeatmapSeries {
     private lastZMin;
     private lastZMax;
     private metadataGeneratorProperty;
+    private changeCountProperty;
     /**
      * Creates an instance of {@link BaseHeatmapDataSeries}
      * @param webAssemblyContext the {@link TSciChart | SciChart WebAssembly Context} containing native methods
@@ -94,22 +100,20 @@ export declare abstract class BaseHeatmapDataSeries implements IHeatmapSeries {
      * @param options the {@link IBaseHeatmapSeriesOptions} which can be passed to configure the DataSeries at construct time
      */
     protected constructor(webAssemblyContext: TSciChart, options: IBaseHeatmapSeriesOptions);
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     get isSorted(): boolean;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     set isSorted(value: boolean);
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
+    get isEvenlySpaced(): boolean;
+    /** @inheritDoc */
+    set isEvenlySpaced(value: boolean);
+    /** @inheritDoc */
     get containsNaN(): boolean;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     set containsNaN(value: boolean);
+    /** @inheritDoc */
+    get dataDistributionCalculator(): IDataDistributionCalculator;
     /**
      * Returns true if the Heatmap DataSeries has data changes.
      * This flag is set to true when notifyDataChanged is called, and reset to false after
@@ -225,15 +229,15 @@ export declare abstract class BaseHeatmapDataSeries implements IHeatmapSeries {
     /**
      * @inheritDoc
      */
-    getNativeIndexes(): DoubleVector;
+    getNativeIndexes(): SCRTDoubleVector;
     /**
      * @inheritDoc
      */
-    getNativeXValues(): DoubleVector;
+    getNativeXValues(): SCRTDoubleVector;
     /**
      * @inheritDoc
      */
-    getNativeYValues(): DoubleVector;
+    getNativeYValues(): SCRTDoubleVector;
     /**
      * @inheritDoc
      */
@@ -278,6 +282,10 @@ export declare abstract class BaseHeatmapDataSeries implements IHeatmapSeries {
      * Gets the range in the Y-direction for this DataSeries
      */
     abstract getYRange(): NumberRange;
+    /** @inheritDoc */
+    getIndicesRange(visibleRange: NumberRange, isCategoryData: boolean, downSearchMode?: ESearchMode, upSearchMode?: ESearchMode): NumberRange;
+    /** @inheritDoc */
+    get changeCount(): number;
     /**
      * Computes the range in the Z-direction for this DataSeries
      * @remarks

package/Charting/Model/BaseHeatmapDataSeries.js

@@ -7,6 +7,7 @@ var EventHandler_1 = require("../../Core/EventHandler");
 var Guard_1 = require("../../Core/Guard");
 var NumberRange_1 = require("../../Core/NumberRange");
 var BaseType_1 = require("../../types/BaseType");
+var guid_1 = require("../../utils/guid");
 var isRealNumber_1 = require("../../utils/isRealNumber");
 var IDataSeries_1 = require("./IDataSeries");
 var IPointMetadata_1 = require("./IPointMetadata");
@@ -28,11 +29,10 @@ var BaseHeatmapDataSeries = /** @class */ (function () {
      * @param options the {@link IBaseHeatmapSeriesOptions} which can be passed to configure the DataSeries at construct time
      */
     function BaseHeatmapDataSeries(webAssemblyContext, options) {
-        var _a;
-        /**
-         * @inheritDoc
-         */
+        var _a, _b;
+        /** @inheritDoc */
         this.dataChanged = new EventHandler_1.EventHandler();
+        /** @inheritDoc */
         this.minXSpacing = 0;
         /**
          * Gets the width of the 2-dimensional array of {@link getZValues | Z-Values} where array is ranked [width][height]
@@ -50,12 +50,14 @@ var BaseHeatmapDataSeries = /** @class */ (function () {
         this.lastZMin = -1;
         this.lastZMax = -1;
         this.metadataGeneratorProperty = undefined;
+        this.changeCountProperty = 0;
         this.webAssemblyContext = webAssemblyContext;
+        this.id = (_a = options === null || options === void 0 ? void 0 : options.id) !== null && _a !== void 0 ? _a : (0, guid_1.generateGuid)();
         this.normalizedVector = new this.webAssemblyContext.FloatVector();
         if (options === null || options === void 0 ? void 0 : options.metadata) {
             if ("type" in options.metadata) {
                 this.metadataGeneratorProperty = (0, classFactory_1.createType)(BaseType_1.EBaseType.MetadataGenerator, options.metadata.type, webAssemblyContext, options.metadata.data);
-                options.metadata = (_a = this.metadataGeneratorProperty) === null || _a === void 0 ? void 0 : _a.getMetadata();
+                options.metadata = (_b = this.metadataGeneratorProperty) === null || _b === void 0 ? void 0 : _b.getMetadata();
             }
             else if (!Array.isArray(options === null || options === void 0 ? void 0 : options.metadata)) {
                 this.metadataGeneratorProperty = new IPointMetadata_1.TemplateMetadataGenerator(options === null || options === void 0 ? void 0 : options.metadata);
@@ -66,33 +68,45 @@ var BaseHeatmapDataSeries = /** @class */ (function () {
         this.setZValues(options === null || options === void 0 ? void 0 : options.zValues, options === null || options === void 0 ? void 0 : options.metadata);
     }
     Object.defineProperty(BaseHeatmapDataSeries.prototype, "isSorted", {
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         get: function () {
             return true;
         },
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         set: function (value) {
             throw new Error("setting isSorted on a heatmap series is not supported");
         },
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(BaseHeatmapDataSeries.prototype, "isEvenlySpaced", {
+        /** @inheritDoc */
+        get: function () {
+            return true;
+        },
+        /** @inheritDoc */
+        set: function (value) {
+            throw new Error("setting isEvenlySpaced on a heatmap series is not supported");
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(BaseHeatmapDataSeries.prototype, "containsNaN", {
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         get: function () {
             return false;
         },
-        /**
-         * @inheritDoc
-         */
+        /** @inheritDoc */
         set: function (value) {
-            throw new Error("setting containsNaN on a heatmap series is not supported");
+            throw new Error("setting containsNaN is not supported on BaseHeatmapDataSeries");
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(BaseHeatmapDataSeries.prototype, "dataDistributionCalculator", {
+        /** @inheritDoc */
+        get: function () {
+            throw new Error("dataDistributionCalculator is not supported on BaseHeatmapDataSeries");
         },
         enumerable: false,
         configurable: true
@@ -378,6 +392,7 @@ var BaseHeatmapDataSeries = /** @class */ (function () {
      * This will trigger a redraw on a parent SciChartSurface
      */
     BaseHeatmapDataSeries.prototype.notifyDataChanged = function (changeType, xIndex, yIndex, name) {
+        this.changeCountProperty++;
         this.hasDataChangesProperty = true;
         this.dataChanged.raiseEvent({ changeType: changeType, index: xIndex, yIndex: yIndex, name: name });
     };
@@ -472,6 +487,18 @@ var BaseHeatmapDataSeries = /** @class */ (function () {
         };
         return options;
     };
+    /** @inheritDoc */
+    BaseHeatmapDataSeries.prototype.getIndicesRange = function (visibleRange, isCategoryData, downSearchMode, upSearchMode) {
+        throw Error("getIndicesRange() method is not supported for BaseHeatmapDataSeries");
+    };
+    Object.defineProperty(BaseHeatmapDataSeries.prototype, "changeCount", {
+        /** @inheritDoc */
+        get: function () {
+            return this.changeCountProperty;
+        },
+        enumerable: false,
+        configurable: true
+    });
     /**
      * Computes the range in the Z-direction for this DataSeries
      * @remarks

package/Charting/Model/DataDistributionCalculator/DataDistributionCalculator.d.ts

@@ -0,0 +1,23 @@
+import { NumberArray } from "../../../types/NumberArray";
+import { SCRTDoubleVector } from "../../../types/TSciChart";
+import { IDataDistributionCalculator } from "./IDataDistributionCalculator";
+export declare class DataDistributionCalculator implements IDataDistributionCalculator {
+    private containsNanProperty;
+    private isSortedAscendingProperty;
+    /** @inheritDoc */
+    get containsNaN(): boolean;
+    /** @inheritDoc */
+    get isSortedAscending(): boolean;
+    /** @inheritDoc */
+    onAppend(isSorted: boolean, containsNaN: boolean, currentXValues: SCRTDoubleVector, newXValues: NumberArray, newYValues: NumberArray): void;
+    /** @inheritDoc */
+    onInsert(isSorted: boolean, containsNaN: boolean, currentXValues: SCRTDoubleVector, newXValues: NumberArray, newYValues: NumberArray, indexWhereInserted: number): void;
+    /** @inheritDoc */
+    onUpdate(isSorted: boolean, containsNaN: boolean, currentXValues: SCRTDoubleVector, newXValues: NumberArray, newYValues: NumberArray, indexWhereUpdated: number): void;
+    /** @inheritDoc */
+    clear(isSorted: boolean, containsNaN: boolean): void;
+    /** @inheritDoc */
+    setIsSortedAscending(value: boolean): void;
+    /** @inheritDoc */
+    setContainsNaN(value: boolean): void;
+}