Package org.apache.sysds.hops.estim

Class EstimatorRowWise

java.lang.Object

org.apache.sysds.hops.estim.SparsityEstimator

org.apache.sysds.hops.estim.EstimatorRowWise

public class EstimatorRowWise
extends SparsityEstimator

This estimator implements an approach based on row-wise sparsity estimation, introduced in Lin, Chunxu, Wensheng Luo, Yixiang Fang, Chenhao Ma, Xilin Liu and Yuchi Ma: On Efficient Large Sparse Matrix Chain Multiplication. Proceedings of the ACM on Management of Data 2 (2024): 1 - 27.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.sysds.hops.estim.SparsityEstimator

SparsityEstimator.OpCode

Field Summary

Fields inherited from class org.apache.sysds.hops.estim.SparsityEstimator

MIN_PAR_THRESHOLD, MULTI_THREADED_BUILD, MULTI_THREADED_ESTIM

Constructor Summary

Constructors

Constructor	Description
EstimatorRowWise()

Method Summary

Modifier and Type	Method	Description
static DataCharacteristics	deriveOutputCharacteristics(MMNode node, double spOut)
DataCharacteristics	estim(MMNode root)	Estimates the output sparsity of a DAG of matrix multiplications for the given operator graph of a single root node.
double	estim(MatrixBlock m1, SparsityEstimator.OpCode op)	Estimates the output sparsity for a given unary operation.
double	estim(MatrixBlock m1, MatrixBlock m2)	Estimates the output sparsity for a single matrix multiplication.
double	estim(MatrixBlock m1, MatrixBlock m2, SparsityEstimator.OpCode op)	Estimates the output sparsity for a given binary operation.

Methods inherited from class java.lang.Object

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

Constructor Details

EstimatorRowWise

public EstimatorRowWise()

Method Details

estim

public DataCharacteristics estim(MMNode root)

Description copied from class: SparsityEstimator

Estimates the output sparsity of a DAG of matrix multiplications for the given operator graph of a single root node.

Specified by:

estim in class SparsityEstimator

Parameters:

root - DAG root node

Returns:

output data characteristics

estim

public double estim(MatrixBlock m1,
 MatrixBlock m2)

Description copied from class: SparsityEstimator

Estimates the output sparsity for a single matrix multiplication.

Specified by:

estim in class SparsityEstimator

Parameters:

m1 - left-hand-side operand

m2 - right-hand-side operand

Returns:

sparsity

estim

public double estim(MatrixBlock m1,
 MatrixBlock m2,
 SparsityEstimator.OpCode op)

Description copied from class: SparsityEstimator

Estimates the output sparsity for a given binary operation.

Specified by:

estim in class SparsityEstimator

Parameters:

m1 - left-hand-side operand

m2 - right-hand-side operand

op - operator code

Returns:

sparsity

estim

public double estim(MatrixBlock m1,
 SparsityEstimator.OpCode op)

Description copied from class: SparsityEstimator

Estimates the output sparsity for a given unary operation.

Specified by:

estim in class SparsityEstimator

Parameters:

m1 - left-hand-side operand

op - operator code

Returns:

sparsity

deriveOutputCharacteristics

public static DataCharacteristics deriveOutputCharacteristics(MMNode node,
 double spOut)