Options
All
  • Public
  • Public/Protected
  • All
Menu

Class UniformHeatmapDataSeries

Go to JavaScript Charting Documentation
Go to JavaScript Chart Examples
Go to SciChart.js on Github

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

  • new UniformHeatmapDataSeries(webAssemblyContext: TSciChart, xStart: number, xStep: number, yStart: number, yStep: number, zValues?: number[][]): UniformHeatmapDataSeries

  • Creates an instance of UniformHeatmapDataSeries

    Parameters

    • webAssemblyContext: TSciChart

      the {@link TSciChart | SciChart WebAssembly Context} containing native methods and access to our underlying WebGL2 rendering engine

    • xStart: number

      defines the Start point on the XAxis where this heatmap will be drawn

    • xStep: number

      defines Step on the XAxis for each cell in the heatmap

    • yStart: number

      defines the Start point on the YAxis where this heatmap will be drawn

    • yStep: number

      defines Step on the YAxis for each cell in the heatmap

    • Optional zValues: number[][]

      the 2-Dimensional array of cells which can be passed to populate the BaseHeatmapDataSeries at construct time. The numeric values in these cells will be used to render the heatmap according to the Color Map provided

    Returns UniformHeatmapDataSeries

Properties

arrayHeight

arrayHeight: number = 0

Gets the height of the 2-dimensional array of Z-Values where array is ranked [width][height]

arrayWidth

arrayWidth: number = 0

Gets the width of the 2-dimensional array of Z-Values where array is ranked [width][height]

Readonly dataChanged

dataChanged: EventHandler<void> = new EventHandler<void>()

An EventHandler which is raised when the data changes.

remarks

To subscribe to dataChanged, use the following code:

const dataSeries = new XyDataSeries(wasmContext);
const callback = () => {
   // Data has changed
};
dataSeries.dataChanged.subscribe(callback);

To unsubscribe from dataChanged, use the following code:

const dataSeries = new XyDataSeries(wasmContext);
dataSeries.dataChanged.unsubscribe(callback);

Protected hasDataChangesProperty

hasDataChangesProperty: boolean = false

When true, the BaseHeatmapDataSeries has data changes and requires redrawing

minXSpacing

minXSpacing: number = 0

Protected normalizedVector

normalizedVector: FloatVector

A normalized {@link FloatVector} is a native / WebAssembly vector (array) of Float32 values with normalized values ready for drawing in SciChart's WebGL2 Rendering Engine

Protected size

size: number

Gets the size of the heatmap where size = arrayWidth * arrayHeight

Readonly type

type: EDataSeriesType = EDataSeriesType.HeatmapUniform

Gets the EDataSeriesType type of the DataSeries

Protected webAssemblyContext

webAssemblyContext: TSciChart

The {@link TSciChart | SciChart WebAssembly Context} containing native methods and access to our underlying WebGL2 rendering engine

Readonly xStart

xStart: number

xStart defines the Start point on the XAxis where this heatmap will be drawn

Readonly xStep

xStep: number

xStep defines Step on the XAxis for each cell in the heatmap

Readonly yStart

yStart: number

yStart defines the Start point on the YAxis where this heatmap will be drawn

Readonly yStep

yStep: number

yStep defines Step on the YAxis for each cell in the heatmap

Accessors

containsNaN

  • get containsNaN(): boolean
  • set containsNaN(value: boolean): void

  • Gets or sets whether the Y data contains NaN values. Set containsNaN = false for the performance optimization when the series has no NaNs

    inheritdoc

    Returns boolean

  • Gets or sets whether the Y data contains NaN values. Set containsNaN = false for the performance optimization when the series has no NaNs

    inheritdoc

    Parameters

    • value: boolean

    Returns void

dataSeriesName

  • get dataSeriesName(): string
  • set dataSeriesName(dataSeriesName: string): void

  • Gets the DataSeries name. This is used in legend controls and tooltips to identify the series

    inheritdoc

    Returns string

  • Gets the DataSeries name. This is used in legend controls and tooltips to identify the series

    inheritdoc

    Parameters

    • dataSeriesName: string

    Returns void

hasDataChanges

  • get hasDataChanges(): boolean

  • Returns true if the Heatmap DataSeries has data changes. This flag is set to true when notifyDataChanged is called, and reset to false after

    Returns boolean

hasNaNs

  • get hasNaNs(): boolean
  • set hasNaNs(value: boolean): void

  • Gets/sets whether this Heatmap has NaN value, to display them as transparent tiles

    Returns boolean

  • Gets/sets whether this Heatmap has NaN value, to display them as transparent tiles

    Parameters

    • value: boolean

    Returns void

hasValues

  • get hasValues(): boolean

  • Gets whether this Heatmap has values to display

    Returns boolean

isSorted

  • get isSorted(): boolean
  • set isSorted(value: boolean): void

  • Gets or sets whether the X-values are sorted or not. See remarks at IDataSeries.isSorted for further information

    inheritdoc

    Returns boolean

  • Gets or sets whether the X-values are sorted or not. See remarks at IDataSeries.isSorted for further information

    inheritdoc

    Parameters

    • value: boolean

    Returns void

xMax

  • get xMax(): number

  • Gets the maximum X-value for this heatmap, which controls where it is displayed on a cartesian chart

    Returns number

xMin

  • get xMin(): number

  • Gets the minimum X-value for this heatmap, which controls where it is displayed on a cartesian chart

    Returns number

xRange

  • Gets the XRange for this heatmap, which controls where it is displayed on a cartesian chart

    Returns NumberRange

yMax

  • get yMax(): number

  • Gets the maximum Y-value for this heatmap, which controls where it is displayed on a cartesian chart

    Returns number

yMin

  • get yMin(): number

  • Gets the minimum Y-value for this heatmap, which controls where it is displayed on a cartesian chart

    Returns number

yRange

  • Gets the YRange for this heatmap, which controls where it is displayed on a cartesian chart

    Returns NumberRange

zMax

  • get zMax(): number

  • Computes the maximum Z-value for this heatmap

    remarks

    Be aware for performance reasons, every call to zMax will result in a recalculation

    Returns number

zMin

  • get zMin(): number

  • Computes the minimum Z-value for this heatmap

    remarks

    Be aware for performance reasons, every call to zMin will result in a recalculation

    Returns number

zRange

  • Computes the ZRange for this heatmap, which controls where it is displayed on a cartesian chart

    remarks

    Be aware for performance reasons, every call to zRange will result in a recalculation

    Returns NumberRange

Methods

count

  • count(): number

delete

  • delete(): void

  • Deletes native (WebAssembly) memory used by this type, after which it cannot be used.

    remarks

    Call .delete() before finishing with the object to ensure that WebAssmembly memory leaks do not occur.

    All elements within SciChart's High Performance Realtime JavaScript Charts which implement IDeletable must be deleted manually to free native (WebAssembly) memory

    Returns void

getIsDeleted

  • getIsDeleted(): boolean

getNativeIndexes

  • getNativeIndexes(): DoubleVector

getNativeXValues

  • getNativeXValues(): DoubleVector

getNativeYValues

  • getNativeYValues(): DoubleVector

getNormalizedVector

getWindowedYRange

Protected getXRange

getXValue

  • getXValue(xIndex: number): number

  • Gets the X-value at the specified index. This will be computed from constructor parameters xStep and xStart

    Parameters

    • xIndex: number

    Returns number

Protected getYRange

getYValue

  • getYValue(yIndex: number): number

  • Gets the Y-value at the specified index. This will be computed from constructor parameters yStep and yxStart

    Parameters

    • yIndex: number

    Returns number

Protected getZRange

  • Computes the range in the Z-direction for this DataSeries

    remarks

    Be aware for performance reasons, every call to getZRange will result in a recalculation

    Returns NumberRange

getZValue

  • getZValue(yIndex: number, xIndex: number): number

  • Gets the ZValue at the specific Y,X index where Y must be within 0-arrayHeight and X must be within 0-arrayWidth

    Parameters

    • yIndex: number

      the y-index from 0 to arrayHeight

    • xIndex: number

      the x-index from 0 to arrayWidth

    Returns number

getZValues

  • getZValues(): number[][]

  • Gets a readonly collection of Z-values which can be read in the format zValues[y][x] Note that changes or manipulation of the 2D array will not update the Heatmap. Set it back via setZValues() to see changes to the chart

    Returns number[][]

notifyDataChanged

  • notifyDataChanged(): void

recreateNormalizedVector

  • recreateNormalizedVector(zMin: number, zMax: number): void

  • Recreates the normalized vector (internally used for drawing heatmap) according to zMin and zMax values

    Parameters

    • zMin: number
    • zMax: number

    Returns void

setZValue

  • setZValue(yIndex: number, xIndex: number, zValue: number): void

  • Sets the ZValue at the specific Y,X index where Y must be within 0-arrayHeight and X must be within 0-arrayWidth

    Parameters

    • yIndex: number

      the y-index from 0 to arrayHeight

    • xIndex: number

      the x-index from 0 to arrayWidth

    • zValue: number

      the new Z-value

    Returns void

setZValues

  • setZValues(zValues: number[][]): void

  • Sets a 2D array of zValues. Input is in the format zValues[y][x] where Y is 0 to height and X is 0 to Width

    Parameters

    • zValues: number[][]

    Returns void

Generated using TypeDoc