org.apache.sysml.runtime.compress

Class ColGroupRLE

java.lang.Object

org.apache.sysml.runtime.compress.ColGroup

org.apache.sysml.runtime.compress.ColGroupBitmap

org.apache.sysml.runtime.compress.ColGroupRLE

All Implemented Interfaces:

Serializable

public class ColGroupRLE
extends ColGroupBitmap

A group of columns compressed with a single run-length encoded bitmap.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.sysml.runtime.compress.ColGroup

ColGroup.CompressionType

Field Summary

Fields inherited from class org.apache.sysml.runtime.compress.ColGroupBitmap

_data, _ptr, _skiplist, _values, _zeros, CREATE_SKIPLIST, LOW_LEVEL_OPT, READ_CACHE_BLKSZ, WRITE_CACHE_BLKSZ

Fields inherited from class org.apache.sysml.runtime.compress.ColGroup

_colIndexes, _numRows

Constructor Summary

Constructors

Constructor and Description
ColGroupRLE()
ColGroupRLE(int[] colIndices, int numRows, boolean zeros, double[] values, char[] bitmaps, int[] bitmapOffs)
ColGroupRLE(int[] colIndices, int numRows, UncompressedBitmap ubm) Main constructor.

Method Summary

Modifier and Type	Method and Description
boolean[]	computeZeroIndicatorVector()
protected void	countNonZerosPerRow(int[] rnnz, int rl, int ru) Count the number of non-zeros per row
void	decompressToBlock(MatrixBlock target, int colpos) Decompress to block.
void	decompressToBlock(MatrixBlock target, int[] colixTargets) Decompress the contents of this column group into uncompressed packed columns
void	decompressToBlock(MatrixBlock target, int rl, int ru) Decompress the contents of this column group into the specified full matrix block.
Iterator<Integer>	getDecodeIterator(int k)
void	leftMultByRowVector(MatrixBlock vector, MatrixBlock result) Multiply the slice of the matrix that this column group represents by a row vector on the left (the original column vector is assumed to be transposed already i.e.
void	rightMultByVector(MatrixBlock vector, MatrixBlock result, int rl, int ru) Multiply the slice of the matrix that this column group represents by a vector on the right.
ColGroup	scalarOperation(org.apache.sysml.runtime.matrix.operators.ScalarOperator op) Perform the specified scalar operation directly on the compressed column group, without decompressing individual cells if possible.
void	unaryAggregateOperations(org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator op, MatrixBlock result)
void	unaryAggregateOperations(org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator op, MatrixBlock result, int rl, int ru)

Methods inherited from class org.apache.sysml.runtime.compress.ColGroupBitmap

applyScalarOp, applyScalarOp, computeColMxx, computeMxx, computeOffsets, createCompressedBitmaps, estimateInMemorySize, get, getBitmapOffsets, getBitmaps, getExactSizeOnDisk, getNumValues, getValues, hasZeros, len, mxxValues, preaggValues, readFields, sumValues, sumValues, write

Methods inherited from class org.apache.sysml.runtime.compress.ColGroup

getColIndex, getColIndices, getCompType, getNumCols, getNumRows, shiftColIndices

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ColGroupRLE

public ColGroupRLE()

ColGroupRLE

public ColGroupRLE(int[] colIndices,
                   int numRows,
                   UncompressedBitmap ubm)

Main constructor. Constructs and stores the necessary bitmaps.

Parameters:

colIndices - indices (within the block) of the columns included in this column

numRows - total number of rows in the parent block

ubm - Uncompressed bitmap representation of the block

ColGroupRLE

public ColGroupRLE(int[] colIndices,
                   int numRows,
                   boolean zeros,
                   double[] values,
                   char[] bitmaps,
                   int[] bitmapOffs)

Method Detail

getDecodeIterator

public Iterator<Integer> getDecodeIterator(int k)

Specified by:

getDecodeIterator in class ColGroupBitmap

Parameters:

k - index of a specific compressed bitmap (stored in subclass, index same as ColGroupBitmap.getValues())

Returns:

an object for iterating over the row offsets in this bitmap. Only valid until the next call to this method. May be reused across calls.

decompressToBlock

public void decompressToBlock(MatrixBlock target,
                              int rl,
                              int ru)

Description copied from class: ColGroup

Decompress the contents of this column group into the specified full matrix block.

Overrides:

decompressToBlock in class ColGroupBitmap

Parameters:

target - a matrix block where the columns covered by this column group have not yet been filled in.

rl - row lower

ru - row upper

decompressToBlock

public void decompressToBlock(MatrixBlock target,
                              int[] colixTargets)

Description copied from class: ColGroup

Decompress the contents of this column group into uncompressed packed columns

Overrides:

decompressToBlock in class ColGroupBitmap

Parameters:

target - a dense matrix block. The block must have enough space to hold the contents of this column group.

colixTargets - array that maps column indices in the original matrix block to columns of target.

decompressToBlock

public void decompressToBlock(MatrixBlock target,
                              int colpos)

Description copied from class: ColGroup

Decompress to block.

Overrides:

decompressToBlock in class ColGroupBitmap

Parameters:

target - dense output vector

colpos - column to decompress, error if larger or equal numCols

rightMultByVector

public void rightMultByVector(MatrixBlock vector,
                              MatrixBlock result,
                              int rl,
                              int ru)
                       throws DMLRuntimeException

Description copied from class: ColGroup

Multiply the slice of the matrix that this column group represents by a vector on the right.

Specified by:

rightMultByVector in class ColGroup

Parameters:

vector - vector to multiply by (tall vector)

result - accumulator for holding the result

rl - row lower

ru - row upper

Throws:

DMLRuntimeException - if the internal SystemML code that performs the multiplication experiences an error

leftMultByRowVector

public void leftMultByRowVector(MatrixBlock vector,
                                MatrixBlock result)
                         throws DMLRuntimeException

Description copied from class: ColGroup

Multiply the slice of the matrix that this column group represents by a row vector on the left (the original column vector is assumed to be transposed already i.e. its size now is 1xn).

Specified by:

leftMultByRowVector in class ColGroup

Parameters:

vector - row vector

result - matrix block result

Throws:

DMLRuntimeException - if DMLRuntimeException occurs

scalarOperation

public ColGroup scalarOperation(org.apache.sysml.runtime.matrix.operators.ScalarOperator op)
                         throws DMLRuntimeException

Description copied from class: ColGroup

Perform the specified scalar operation directly on the compressed column group, without decompressing individual cells if possible.

Specified by:

scalarOperation in class ColGroup

Parameters:

op - operation to perform

Returns:

version of this column group with the operation applied

Throws:

DMLRuntimeException - if DMLRuntimeException occurs

unaryAggregateOperations

public void unaryAggregateOperations(org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator op,
                                     MatrixBlock result)
                              throws DMLRuntimeException

Specified by:

unaryAggregateOperations in class ColGroup

Throws:

DMLRuntimeException

unaryAggregateOperations

public void unaryAggregateOperations(org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator op,
                                     MatrixBlock result,
                                     int rl,
                                     int ru)
                              throws DMLRuntimeException

Specified by:

unaryAggregateOperations in class ColGroupBitmap

Throws:

DMLRuntimeException

computeZeroIndicatorVector

public boolean[] computeZeroIndicatorVector()
                                     throws DMLRuntimeException

Throws:

DMLRuntimeException

countNonZerosPerRow

protected void countNonZerosPerRow(int[] rnnz,
                                   int rl,
                                   int ru)

Description copied from class: ColGroup

Count the number of non-zeros per row

Specified by:

countNonZerosPerRow in class ColGroup

Parameters:

rnnz - non-zeros per row

rl - row lower bound, inclusive

ru - row upper bound, exclusive