Package io.deephaven.extensions.barrage.chunk

Interface BarrageCopyKernel

public interface BarrageCopyKernel

Typed kernel for copying individual cells from per-delta source chunks into a destination chunk, using a pre-computed encoded mapping array. Each mapping entry encodes (deltaIndex, add-or-mod flag, position) in a single long using the bit constants defined here.

Using a typed kernel avoids the virtual dispatch and System.arraycopy overhead of calling WritableChunk.copyFromChunk(src, offset, pos, 1) for each cell.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	BarrageCopyKernel.BarrageCopyKernelContext	Base context for a BarrageCopyKernel.

Field Summary

Fields

Modifier and Type	Field	Description
static final long	DELTA_INDEX_MASK
static final int	DELTA_INDEX_SHIFT
static final int	DELTA_MOD_FLAG_BIT
static final long	DELTA_POSITION_MASK

Method Summary

Modifier and Type	Method	Description
void	copyFromDeltaChunks(long[] mapping, WritableChunk<Values> dest, BarrageCopyKernel.BarrageCopyKernelContext context)	Copy cells from per-delta source chunk arrays into a destination chunk.
static BarrageCopyKernel	makeBarrageCopyKernel(ChunkType chunkType)
BarrageCopyKernel.BarrageCopyKernelContext	makeContext(WritableChunk<Values>[][] addChunks, WritableChunk<Values>[][] modChunks, int deltaChunkSize)	Create a context for this copy kernel that will contain add / mod delta chunks cast to the correct type.

Field Details

DELTA_POSITION_MASK

static final long DELTA_POSITION_MASK

See Also:

• Constant Field Values

DELTA_INDEX_SHIFT

static final int DELTA_INDEX_SHIFT

See Also:

• Constant Field Values

DELTA_INDEX_MASK

static final long DELTA_INDEX_MASK

See Also:

• Constant Field Values

DELTA_MOD_FLAG_BIT

static final int DELTA_MOD_FLAG_BIT

See Also:

• Constant Field Values

Method Details

makeBarrageCopyKernel

static BarrageCopyKernel makeBarrageCopyKernel(ChunkType chunkType)

makeContext

BarrageCopyKernel.BarrageCopyKernelContext makeContext(WritableChunk<Values>[][] addChunks,
 WritableChunk<Values>[][] modChunks,
 int deltaChunkSize)

Create a context for this copy kernel that will contain add / mod delta chunks cast to the correct type.

Parameters:

addChunks - the add delta chunks (per delta)

modChunks - the mod delta chunks (per delta)

Returns:

a context that can be passed to copyFromDeltaChunks(long[], WritableChunk, BarrageCopyKernelContext) to drive the copy from the add / mod delta chunks into the output chunk.

copyFromDeltaChunks

void copyFromDeltaChunks(long[] mapping,
 WritableChunk<Values> dest,
 BarrageCopyKernel.BarrageCopyKernelContext context)

Copy cells from per-delta source chunk arrays into a destination chunk.

Parameters:

mapping - encoded source references, one per output position

dest - the output chunk to fill (sized to mapping.length)

context - the context returned from makeContext(WritableChunk[][], WritableChunk[][], int) that contains the correctly typed add / mod delta chunks to drive the copy.