Skip to content

Class: TwoDataLayer ​

Defined in: layers.ts:1707

Layer with two data values mapped to a 2D colormap.

Maps two scalar fields (X and Y) to colors using a 2D colormap texture. Useful for visualizing relationships between variables, such as:

  • Effect size (X) vs. statistical confidence (Y)
  • Activation magnitude (X) vs. significance (Y)
  • Any two correlated or independent scalar fields

Example ​

typescript
const layer = new TwoDataLayer(
  'effect-confidence',
  effectSizeData,    // X values
  confidenceData,    // Y values
  indices,
  'confidence',      // 2D colormap preset
  {
    rangeX: [-2, 2],
    rangeY: [0, 1],
    thresholdY: [0, 0.05]  // Hide low-confidence values
  }
);

Extends ​

Constructors ​

Constructor ​

ts
new TwoDataLayer(
   id, 
   dataX, 
   dataY, 
   indices, 
   colorMap, 
   config?
): TwoDataLayer;

Defined in: layers.ts:1721

Parameters ​

id ​

string

dataX ​

Float32Array<ArrayBufferLike> | number[]

dataY ​

Float32Array<ArrayBufferLike> | number[]

indices ​

number[] | Uint32Array<ArrayBufferLike> | null

colorMap ​

| ColorMap2DPreset | ColorMap2D

config? ​

TwoDataLayerConfig = {}

Returns ​

TwoDataLayer

Overrides ​

Layer.constructor

Properties ​

id ​

ts
id: string;

Defined in: layers.ts:294

Inherited from ​

Layer.id


visible ​

ts
visible: boolean;

Defined in: layers.ts:295

Inherited from ​

Layer.visible


opacity ​

ts
opacity: number;

Defined in: layers.ts:296

Inherited from ​

Layer.opacity


blendMode ​

ts
blendMode: BlendMode;

Defined in: layers.ts:297

Inherited from ​

Layer.blendMode


needsUpdate ​

ts
needsUpdate: boolean;

Defined in: layers.ts:298

Inherited from ​

Layer.needsUpdate


_onChangeCallback ​

ts
_onChangeCallback: ((changes) => void) | null;

Defined in: layers.ts:300

Callback set by the parent surface to propagate observable layer changes.

Inherited from ​

Layer._onChangeCallback


is2DLayer ​

ts
readonly is2DLayer: boolean = true;

Defined in: layers.ts:1719

Flag to identify this as a 2D data layer for GPU compositor

Accessors ​

order ​

Get Signature ​

ts
get order(): number;

Defined in: layers.ts:343

Numeric initialization hint used when this layer first enters a stack. Runtime ordering is owned exclusively by LayerStack.

Deprecated ​

Use LayerStack.setLayerOrder() or LayerStack.moveLayer() after the layer has been added. Runtime writes are ignored.

Returns ​

number

Set Signature ​

ts
set order(order): void;

Defined in: layers.ts:347

Parameters ​
order ​

number

Returns ​

void

Inherited from ​

ParcelConnectivityLayer.order

Methods ​

getOrderConstraints() ​

ts
getOrderConstraints(): LayerOrderConstraints;

Defined in: layers.ts:361

Returns ​

LayerOrderConstraints

Inherited from ​

Layer.getOrderConstraints


getPresentation() ​

ts
getPresentation(): LayerPresentation;

Defined in: layers.ts:365

Returns ​

LayerPresentation

Inherited from ​

Layer.getPresentation


setPresentation() ​

ts
setPresentation(presentation): void;

Defined in: layers.ts:369

Parameters ​

presentation ​

Partial<LayerPresentation>

Returns ​

void

Inherited from ​

Layer.setPresentation


getDataSummary() ​

ts
getDataSummary(_options?): LayerDataSummary | null;

Defined in: layers.ts:377

Scalar layers override this without exposing their underlying arrays.

Parameters ​

_options? ​

LayerDataSummaryOptions = {}

Returns ​

LayerDataSummary | null

Inherited from ​

Layer.getDataSummary


setVisible() ​

ts
setVisible(visible): void;

Defined in: layers.ts:432

Parameters ​

visible ​

boolean

Returns ​

void

Inherited from ​

Layer.setVisible


setOpacity() ​

ts
setOpacity(opacity): void;

Defined in: layers.ts:439

Parameters ​

opacity ​

number

Returns ​

void

Inherited from ​

Layer.setOpacity


setBlendMode() ​

ts
setBlendMode(mode): void;

Defined in: layers.ts:447

Parameters ​

mode ​

BlendMode

Returns ​

void

Inherited from ​

Layer.setBlendMode


fromConfig() ​

ts
static fromConfig(config): Layer;

Defined in: layers.ts:501

Backward-compatible throwing factory. The package entry point installs the same explicit registry exposed by createLayerFromConfig.

Parameters ​

config ​

unknown

Returns ​

Layer

Inherited from ​

Layer.fromConfig


setData() ​

ts
setData(
   dataX, 
   dataY, 
   indices?
): void;

Defined in: layers.ts:1740

Parameters ​

dataX ​

Float32Array<ArrayBufferLike> | number[]

dataY ​

Float32Array<ArrayBufferLike> | number[]

indices? ​

number[] | Uint32Array<ArrayBufferLike> | null

Returns ​

void


getDataX() ​

ts
getDataX(): Float32Array<ArrayBufferLike> | null;

Defined in: layers.ts:1774

Returns ​

Float32Array<ArrayBufferLike> | null


getDataY() ​

ts
getDataY(): Float32Array<ArrayBufferLike> | null;

Defined in: layers.ts:1778

Returns ​

Float32Array<ArrayBufferLike> | null


setColorMap() ​

ts
setColorMap(colorMap): void;

Defined in: layers.ts:1782

Parameters ​

colorMap ​

| ColorMap2DPreset | ColorMap2D

Returns ​

void


getColorMap() ​

ts
getColorMap(): ColorMap2D | null;

Defined in: layers.ts:1811

Returns ​

ColorMap2D | null


setRangeX() ​

ts
setRangeX(range): void;

Defined in: layers.ts:1815

Parameters ​

range ​

[number, number]

Returns ​

void


setRangeY() ​

ts
setRangeY(range): void;

Defined in: layers.ts:1824

Parameters ​

range ​

[number, number]

Returns ​

void


setThresholdX() ​

ts
setThresholdX(threshold): void;

Defined in: layers.ts:1833

Parameters ​

threshold ​

[number, number]

Returns ​

void


setThresholdY() ​

ts
setThresholdY(threshold): void;

Defined in: layers.ts:1842

Parameters ​

threshold ​

[number, number]

Returns ​

void


getRangeX() ​

ts
getRangeX(): [number, number];

Defined in: layers.ts:1851

Returns ​

[number, number]


getRangeY() ​

ts
getRangeY(): [number, number];

Defined in: layers.ts:1852

Returns ​

[number, number]


getThresholdX() ​

ts
getThresholdX(): [number, number];

Defined in: layers.ts:1853

Returns ​

[number, number]


getThresholdY() ​

ts
getThresholdY(): [number, number];

Defined in: layers.ts:1854

Returns ​

[number, number]


getColorMapName() ​

ts
getColorMapName(): string;

Defined in: layers.ts:1855

Returns ​

string


getRGBAData() ​

ts
getRGBAData(vertexCount): Float32Array;

Defined in: layers.ts:1857

Get straight RGBA values for this layer.

Alpha here is intrinsic data/colormap coverage only. Layer.opacity is applied exactly once by the CPU or GPU compositor.

Parameters ​

vertexCount ​

number

Returns ​

Float32Array

Overrides ​

Layer.getRGBAData


update() ​

ts
update(updates): void;

Defined in: layers.ts:1907

Update layer data Must be implemented by subclasses

Parameters ​

updates ​

TwoDataLayerUpdateData

Returns ​

void

Overrides ​

Layer.update


toStateJSON() ​

ts
toStateJSON(): Record<string, unknown>;

Defined in: layers.ts:1962

Serialize common layer state for state persistence. Override in subclasses.

Returns ​

Record<string, unknown>

Overrides ​

Layer.toStateJSON


dispose() ​

ts
dispose(): void;

Defined in: layers.ts:1974

Returns ​

void

Overrides ​

Layer.dispose

Released under the MIT License.