org.apache.sysml.runtime.instructions

Class InstructionUtils

java.lang.Object

org.apache.sysml.runtime.instructions.InstructionUtils

public class InstructionUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
InstructionUtils()

Method Summary

Modifier and Type	Method and Description
static int	checkNumFields(String[] parts, int expected)
static int	checkNumFields(String[] parts, int expected1, int expected2)
static int	checkNumFields(String str, int expected)
static int	checkNumFields(String str, int expected1, int expected2)
static org.apache.sysml.lops.PartialAggregate.CorrectionLocationType	deriveAggregateOperatorCorrectionLocation(String opcode)
static String	deriveAggregateOperatorOpcode(String opcode)
static org.apache.sysml.runtime.instructions.cp.CPInstruction.CPType	getCPType(String str)
static org.apache.sysml.lops.LopProperties.ExecType	getExecType(String str)
static GPUInstruction.GPUINSTRUCTION_TYPE	getGPUType(String str)
static String[]	getInstructionParts(String str) Given an instruction string, strip-off the execution type and return opcode and all input/output operands WITHOUT their data/value type.
static String[]	getInstructionPartsWithValueType(String str) Given an instruction string, this function strips-off the execution type (CP or MR) and returns the remaining parts, which include the opcode as well as the input and output operands.
static org.apache.sysml.runtime.matrix.operators.AggregateBinaryOperator	getMatMultOperator(int k)
static org.apache.sysml.runtime.instructions.mr.MRInstruction.MRType	getMRType(String str)
static String	getOpCode(String str)
static SPInstruction.SPType	getSPType(String str)
static boolean	isBuiltinFunction(String opcode)
static boolean	isDistQuaternaryOpcode(String opcode)
static boolean	isDistributedCacheUsed(String str) Evaluates if at least one instruction of the given instruction set used the distributed cache; this call can also be used for individual instructions.
static org.apache.sysml.runtime.matrix.operators.AggregateOperator	parseAggregateOperator(String opcode, String corrExists, String corrLoc)
static org.apache.sysml.runtime.matrix.operators.AggregateTernaryOperator	parseAggregateTernaryOperator(String opcode)
static org.apache.sysml.runtime.matrix.operators.AggregateTernaryOperator	parseAggregateTernaryOperator(String opcode, int numThreads)
static org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator	parseBasicAggregateUnaryOperator(String opcode)
static org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator	parseBasicAggregateUnaryOperator(String opcode, int numThreads)
static org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator	parseBasicCumulativeAggregateUnaryOperator(org.apache.sysml.runtime.matrix.operators.UnaryOperator uop)
static org.apache.sysml.runtime.matrix.operators.BinaryOperator	parseBinaryOperator(String opcode)
static org.apache.sysml.runtime.matrix.operators.Operator	parseBinaryOrBuiltinOperator(String opcode, org.apache.sysml.runtime.instructions.cp.CPOperand in1, org.apache.sysml.runtime.instructions.cp.CPOperand in2)
static org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator	parseCumulativeAggregateUnaryOperator(String opcode)
static org.apache.sysml.runtime.matrix.operators.BinaryOperator	parseExtendedBinaryOperator(String opcode)
static org.apache.sysml.runtime.matrix.operators.Operator	parseExtendedBinaryOrBuiltinOperator(String opcode, org.apache.sysml.runtime.instructions.cp.CPOperand in1, org.apache.sysml.runtime.instructions.cp.CPOperand in2)
static org.apache.sysml.runtime.matrix.operators.ScalarOperator	parseScalarBinaryOperator(String opcode, boolean arg1IsScalar) scalar-matrix operator
static org.apache.sysml.runtime.matrix.operators.ScalarOperator	parseScalarBinaryOperator(String opcode, boolean arg1IsScalar, double constant) scalar-matrix operator
static org.apache.sysml.runtime.matrix.operators.TernaryOperator	parseTernaryOperator(String opcode)
static org.apache.sysml.runtime.matrix.operators.UnaryOperator	parseUnaryOperator(String opcode)

Methods inherited from class java.lang.Object

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

Constructor Detail

InstructionUtils

public InstructionUtils()

Method Detail

checkNumFields

public static int checkNumFields(String str,
                                 int expected)

checkNumFields

public static int checkNumFields(String[] parts,
                                 int expected)

checkNumFields

public static int checkNumFields(String[] parts,
                                 int expected1,
                                 int expected2)

checkNumFields

public static int checkNumFields(String str,
                                 int expected1,
                                 int expected2)

getInstructionParts

public static String[] getInstructionParts(String str)

Given an instruction string, strip-off the execution type and return opcode and all input/output operands WITHOUT their data/value type. i.e., ret.length = parts.length-1 (-1 for execution type)

Parameters:

str - instruction string

Returns:

instruction parts as string array

getInstructionPartsWithValueType

public static String[] getInstructionPartsWithValueType(String str)

Given an instruction string, this function strips-off the execution type (CP or MR) and returns the remaining parts, which include the opcode as well as the input and output operands. Each returned part will have the datatype and valuetype associated with the operand. This function is invoked mainly for parsing CPInstructions.

Parameters:

str - instruction string

Returns:

instruction parts as string array

getExecType

public static org.apache.sysml.lops.LopProperties.ExecType getExecType(String str)

getOpCode

public static String getOpCode(String str)

getMRType

public static org.apache.sysml.runtime.instructions.mr.MRInstruction.MRType getMRType(String str)

getSPType

public static SPInstruction.SPType getSPType(String str)

getCPType

public static org.apache.sysml.runtime.instructions.cp.CPInstruction.CPType getCPType(String str)

getGPUType

public static GPUInstruction.GPUINSTRUCTION_TYPE getGPUType(String str)

isBuiltinFunction

public static boolean isBuiltinFunction(String opcode)

isDistributedCacheUsed

public static boolean isDistributedCacheUsed(String str)

Evaluates if at least one instruction of the given instruction set used the distributed cache; this call can also be used for individual instructions.

Parameters:

str - instruction set

Returns:

true if at least one instruction uses distributed cache

parseBasicAggregateUnaryOperator

public static org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator parseBasicAggregateUnaryOperator(String opcode)

parseBasicAggregateUnaryOperator

public static org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator parseBasicAggregateUnaryOperator(String opcode,
                                                                                                                int numThreads)

parseAggregateTernaryOperator

public static org.apache.sysml.runtime.matrix.operators.AggregateTernaryOperator parseAggregateTernaryOperator(String opcode)

parseAggregateTernaryOperator

public static org.apache.sysml.runtime.matrix.operators.AggregateTernaryOperator parseAggregateTernaryOperator(String opcode,
                                                                                                               int numThreads)

parseAggregateOperator

public static org.apache.sysml.runtime.matrix.operators.AggregateOperator parseAggregateOperator(String opcode,
                                                                                                 String corrExists,
                                                                                                 String corrLoc)

parseBasicCumulativeAggregateUnaryOperator

public static org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator parseBasicCumulativeAggregateUnaryOperator(org.apache.sysml.runtime.matrix.operators.UnaryOperator uop)

parseCumulativeAggregateUnaryOperator

public static org.apache.sysml.runtime.matrix.operators.AggregateUnaryOperator parseCumulativeAggregateUnaryOperator(String opcode)

parseUnaryOperator

public static org.apache.sysml.runtime.matrix.operators.UnaryOperator parseUnaryOperator(String opcode)

parseBinaryOrBuiltinOperator

public static org.apache.sysml.runtime.matrix.operators.Operator parseBinaryOrBuiltinOperator(String opcode,
                                                                                              org.apache.sysml.runtime.instructions.cp.CPOperand in1,
                                                                                              org.apache.sysml.runtime.instructions.cp.CPOperand in2)

parseExtendedBinaryOrBuiltinOperator

public static org.apache.sysml.runtime.matrix.operators.Operator parseExtendedBinaryOrBuiltinOperator(String opcode,
                                                                                                      org.apache.sysml.runtime.instructions.cp.CPOperand in1,
                                                                                                      org.apache.sysml.runtime.instructions.cp.CPOperand in2)

parseBinaryOperator

public static org.apache.sysml.runtime.matrix.operators.BinaryOperator parseBinaryOperator(String opcode)

parseTernaryOperator

public static org.apache.sysml.runtime.matrix.operators.TernaryOperator parseTernaryOperator(String opcode)

parseScalarBinaryOperator

public static org.apache.sysml.runtime.matrix.operators.ScalarOperator parseScalarBinaryOperator(String opcode,
                                                                                                 boolean arg1IsScalar)

scalar-matrix operator

Parameters:

opcode - the opcode

arg1IsScalar - ?

Returns:

scalar operator

parseScalarBinaryOperator

public static org.apache.sysml.runtime.matrix.operators.ScalarOperator parseScalarBinaryOperator(String opcode,
                                                                                                 boolean arg1IsScalar,
                                                                                                 double constant)

scalar-matrix operator

Parameters:

opcode - the opcode

arg1IsScalar - ?

constant - ?

Returns:

scalar operator

parseExtendedBinaryOperator

public static org.apache.sysml.runtime.matrix.operators.BinaryOperator parseExtendedBinaryOperator(String opcode)

deriveAggregateOperatorOpcode

public static String deriveAggregateOperatorOpcode(String opcode)

deriveAggregateOperatorCorrectionLocation

public static org.apache.sysml.lops.PartialAggregate.CorrectionLocationType deriveAggregateOperatorCorrectionLocation(String opcode)

isDistQuaternaryOpcode

public static boolean isDistQuaternaryOpcode(String opcode)

getMatMultOperator

public static org.apache.sysml.runtime.matrix.operators.AggregateBinaryOperator getMatMultOperator(int k)