Class ColGroupRLE
- java.lang.Object
-
- org.apache.sysds.runtime.compress.colgroup.AColGroup
-
- org.apache.sysds.runtime.compress.colgroup.AColGroupCompressed
-
- org.apache.sysds.runtime.compress.colgroup.ADictBasedColGroup
-
- org.apache.sysds.runtime.compress.colgroup.AColGroupValue
-
- org.apache.sysds.runtime.compress.colgroup.APreAgg
-
- org.apache.sysds.runtime.compress.colgroup.AColGroupOffset
-
- org.apache.sysds.runtime.compress.colgroup.ColGroupRLE
-
- All Implemented Interfaces:
Serializable
public class ColGroupRLE extends AColGroupOffset
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.sysds.runtime.compress.colgroup.AColGroup
AColGroup.CompressionType
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description AColGroupappend(AColGroup g)Append the other column group to this column group.AColGroupappendNInternal(AColGroup[] g)AColGroupbinaryRowOpLeft(BinaryOperator op, double[] v, boolean isRowSafe)Perform a binary row operation.AColGroupbinaryRowOpRight(BinaryOperator op, double[] v, boolean isRowSafe)Perform a binary row operation.boolean[]computeZeroIndicatorVector()booleancontainsValue(double pattern)Detect if the column group contains a specific value.static char[]genRLEBitmap(int[] offsets, int len)Encodes the bitmap as a series of run lengths and offsets.org.apache.sysds.runtime.compress.colgroup.AColGroup.ColGroupTypegetColGroupType()ICLASchemegetCompressionScheme()Get the compression scheme for this column group to enable compression of other data.AColGroup.CompressionTypegetCompType()Obtain the compression type.doublegetCost(ComputationCostEstimator e, int nRows)Get the computation cost associated with this column group.int[]getCounts(int[] counts)doublegetIdx(int r, int colIdx)Get the value at a colGroup specific row/column index position.voidleftMultByMatrixNoPreAgg(MatrixBlock matrix, MatrixBlock result, int rl, int ru, int cl, int cu)Left multiply with this column group.voidpreAggregateDense(MatrixBlock m, double[] preAgg, int rl, int ru, int cl, int cu)Pre aggregate a dense matrix block into a pre aggregate target (first step of left matrix multiplication)voidpreAggregateSparse(SparseBlock sb, double[] preAgg, int rl, int ru)static ColGroupRLEread(DataInput in, int nRows)AColGroupscalarOperation(ScalarOperator op)Perform the specified scalar operation directly on the compressed column group, without decompressing individual cells if possible.AColGroupsliceRows(int rl, int ru)Slice range of rows out of the column group and return a new column group only containing the row segment.StringtoString()AColGroupunaryOperation(UnaryOperator op)Perform unary operation on the column group and return a new column group-
Methods inherited from class org.apache.sysds.runtime.compress.colgroup.AColGroupOffset
containZerosTuples, estimateInMemorySize, getExactSizeOnDisk, readData, readPointers, write
-
Methods inherited from class org.apache.sysds.runtime.compress.colgroup.APreAgg
getPreAggregateSize, leftMultByAColGroup, mmWithDictionary, preAggregate, preAggregateThatIndexStructure, tsmmAColGroup
-
Methods inherited from class org.apache.sysds.runtime.compress.colgroup.AColGroupValue
centralMoment, computeColSums, getCounts, getNumberNonZeros, getNumValues, replace, rexpandCols
-
Methods inherited from class org.apache.sysds.runtime.compress.colgroup.ADictBasedColGroup
decompressToDenseBlock, decompressToSparseBlock, getDictionary, rightMultByMatrix
-
Methods inherited from class org.apache.sysds.runtime.compress.colgroup.AColGroupCompressed
getMax, getMin, getSum, isEmpty, preAggRows, tsmm, unaryAggregateOperations, unaryAggregateOperations
-
Methods inherited from class org.apache.sysds.runtime.compress.colgroup.AColGroup
appendN, colSum, decompressToDenseBlock, decompressToSparseBlock, get, getColIndices, getNumCols, rightMultByMatrix, shiftColIndices, sliceColumn, sliceColumns
-
-
-
-
Method Detail
-
getCompType
public AColGroup.CompressionType getCompType()
Description copied from class:AColGroupObtain the compression type.- Specified by:
getCompTypein classAColGroup- Returns:
- How the elements of the column group are compressed.
-
getColGroupType
public org.apache.sysds.runtime.compress.colgroup.AColGroup.ColGroupType getColGroupType()
-
getCounts
public int[] getCounts(int[] counts)
-
scalarOperation
public AColGroup scalarOperation(ScalarOperator op)
Description copied from class:AColGroupPerform the specified scalar operation directly on the compressed column group, without decompressing individual cells if possible.- Specified by:
scalarOperationin classAColGroup- Parameters:
op- operation to perform- Returns:
- version of this column group with the operation applied
-
unaryOperation
public AColGroup unaryOperation(UnaryOperator op)
Description copied from class:AColGroupPerform unary operation on the column group and return a new column group- Specified by:
unaryOperationin classAColGroup- Parameters:
op- The operation to perform- Returns:
- The new column group
-
binaryRowOpLeft
public AColGroup binaryRowOpLeft(BinaryOperator op, double[] v, boolean isRowSafe)
Description copied from class:AColGroupPerform a binary row operation.- Specified by:
binaryRowOpLeftin classAColGroup- Parameters:
op- The operation to executev- The vector of values to apply, should be same length as dictionary length.isRowSafe- True if the binary op is applied to an entire zero row and all results are zero- Returns:
- A updated column group with the new values.
-
binaryRowOpRight
public AColGroup binaryRowOpRight(BinaryOperator op, double[] v, boolean isRowSafe)
Description copied from class:AColGroupPerform a binary row operation.- Specified by:
binaryRowOpRightin classAColGroup- Parameters:
op- The operation to executev- The vector of values to apply, should be same length as dictionary length.isRowSafe- True if the binary op is applied to an entire zero row and all results are zero- Returns:
- A updated column group with the new values.
-
computeZeroIndicatorVector
public boolean[] computeZeroIndicatorVector()
-
getIdx
public double getIdx(int r, int colIdx)Description copied from class:AColGroupGet the value at a colGroup specific row/column index position.
-
leftMultByMatrixNoPreAgg
public void leftMultByMatrixNoPreAgg(MatrixBlock matrix, MatrixBlock result, int rl, int ru, int cl, int cu)
Description copied from class:AColGroupLeft multiply with this column group.- Specified by:
leftMultByMatrixNoPreAggin classAColGroup- Parameters:
matrix- The matrix to multiply with on the leftresult- The result to output the values into, always dense for the purpose of the column groups parallelizingrl- The row to begin the multiplication from on the lhs matrixru- The row to end the multiplication at on the lhs matrixcl- The column to begin the multiplication from on the lhs matrixcu- The column to end the multiplication at on the lhs matrix
-
containsValue
public boolean containsValue(double pattern)
Description copied from class:AColGroupDetect if the column group contains a specific value.- Specified by:
containsValuein classAColGroup- Parameters:
pattern- The value to look for.- Returns:
- boolean saying true if the value is contained.
-
preAggregateDense
public void preAggregateDense(MatrixBlock m, double[] preAgg, int rl, int ru, int cl, int cu)
Description copied from class:APreAggPre aggregate a dense matrix block into a pre aggregate target (first step of left matrix multiplication)- Specified by:
preAggregateDensein classAPreAgg- Parameters:
m- The matrix to preAggregatepreAgg- The preAggregate targetrl- Row lower on the left side matrixru- Row upper on the left side matrixcl- Column lower on the left side matrix (or row lower in the column group)cu- Column upper on the left side matrix (or row upper in the column group)
-
preAggregateSparse
public void preAggregateSparse(SparseBlock sb, double[] preAgg, int rl, int ru)
- Specified by:
preAggregateSparsein classAPreAgg
-
getCost
public double getCost(ComputationCostEstimator e, int nRows)
Description copied from class:AColGroupGet the computation cost associated with this column group.
-
read
public static ColGroupRLE read(DataInput in, int nRows) throws IOException
- Throws:
IOException
-
sliceRows
public AColGroup sliceRows(int rl, int ru)
Description copied from class:AColGroupSlice range of rows out of the column group and return a new column group only containing the row segment. Note that this slice should maintain pointers back to the original dictionaries and only modify index structures.
-
append
public AColGroup append(AColGroup g)
Description copied from class:AColGroupAppend the other column group to this column group. This method tries to combine them to return a new column group containing both. In some cases it is possible in reasonable time, in others it is not. The result is first this column group followed by the other column group in higher row values. If it is not possible or very inefficient null is returned.
-
getCompressionScheme
public ICLAScheme getCompressionScheme()
Description copied from class:AColGroupGet the compression scheme for this column group to enable compression of other data.- Specified by:
getCompressionSchemein classAColGroup- Returns:
- The compression scheme of this column group
-
toString
public String toString()
- Overrides:
toStringin classAColGroupValue
-
genRLEBitmap
public static char[] genRLEBitmap(int[] offsets, int len)Encodes the bitmap as a series of run lengths and offsets. Note that this method should not be called if the len is 0.- Parameters:
offsets- uncompressed offset listlen- logical length of the given offset list- Returns:
- compressed version of said bitmap
-
-