com.landawn.abacus.util

Class ByteMatrix

java.lang.Object

com.landawn.abacus.util.AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

com.landawn.abacus.util.ByteMatrix

public final class ByteMatrix
extends AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Since:

0.8

Author:

Haiyang Li

Field Summary

Fields inherited from class com.landawn.abacus.util.AbstractMatrix

cols, count, rows

Constructor Summary

Constructors

Constructor and Description
ByteMatrix(byte[][] a)

Method Summary

Modifier and Type	Method and Description
ByteMatrix	add(ByteMatrix b)
Stream<Pair.IntPair>	adjacent4Points(int i, int j) Returns the four adjacencies with order: up, right, down, left.
Stream<Pair.IntPair>	adjacent8Points(int i, int j) Returns the eight adjacencies with order: left-up, up, right-up, right, right-down, down, left-down, left.
byte[][]	array()
Matrix<java.lang.Byte>	boxed()
byte[]	column(int columnIndex)
ByteMatrix	copy()
ByteMatrix	copy(int fromRowIndex, int toRowIndex)
ByteMatrix	copy(int fromRowIndex, int toRowIndex, int fromColumnIndex, int toColumnIndex)
static ByteMatrix	diagonal(byte[] leftUp2RighDownDiagonal, byte[] rightUp2LeftDownDiagonal)
static ByteMatrix	diagonalLU2RD(byte[] leftUp2RighDownDiagonal)
static ByteMatrix	diagonalRU2LD(byte[] rightUp2LeftDownDiagonal)
OptionalByte	downOf(int i, int j)
static ByteMatrix	empty()
boolean	equals(java.lang.Object obj)
void	fill(byte val)
void	fill(byte[][] b)
void	fill(int fromRowIndex, int fromColumnIndex, byte[][] b)
ByteList	flatten()
ByteMatrix	flipH()
ByteMatrix	flipV()
void	forEach(ByteConsumer action)
void	forEach(int fromRowIndex, int toRowIndex, int fromColumnIndex, int toColumnIndex, ByteConsumer action)
byte	get(int i, int j)
byte	get(Pair.IntPair point)
byte[]	getLU2RD()
byte[]	getRU2LD()
int	hashCode()
ByteMatrix	hstack(ByteMatrix b)
OptionalByte	leftOf(int i, int j)
ByteMatrix	map(ByteUnaryOperator func)
<T> Matrix<T>	mapToObj(java.lang.Class<T> cls, ByteFunction<? extends T> func)
ByteMatrix	multiply(ByteMatrix b)
static ByteMatrix	of(byte[]... a)
static ByteMatrix	random(int len)
static ByteMatrix	range(byte startInclusive, byte endExclusive)
static ByteMatrix	range(byte startInclusive, byte endExclusive, byte by)
static ByteMatrix	rangeClosed(byte startInclusive, byte endInclusive)
static ByteMatrix	rangeClosed(byte startInclusive, byte endInclusive, byte by)
static ByteMatrix	repeat(byte val, int len)
ByteMatrix	repelem(int rowRepeats, int colRepeats) Repeat elements rowRepeats times in row direction and colRepeats times in column direction.
void	replaceIf(BytePredicate predicate, byte newValue)
void	replaceIf(IntBiPredicate predicate, byte newValue) Replace elements by Predicate.test(i, j) based on points
ByteMatrix	repmat(int rowRepeats, int colRepeats) Repeat this matrix rowRepeats times in row direction and colRepeats times in column direction.
ByteMatrix	reshape(int newRows, int newCols)
void	reverseH()
void	reverseV()
OptionalByte	rightOf(int i, int j)
ByteMatrix	rotate180() Rotate this matrix clockwise 180
ByteMatrix	rotate270() Rotate this matrix clockwise 270
ByteMatrix	rotate90() Rotate this matrix clockwise 90
byte[]	row(int rowIndex)
void	set(int i, int j, byte val)
void	set(Pair.IntPair point, byte val)
void	setColumn(int columnIndex, byte[] column)
void	setLU2RD(byte[] diagonal)
void	setRow(int rowIndex, byte[] row)
void	setRU2LD(byte[] diagonal)
Stream<ByteStream>	streamC()
Stream<ByteStream>	streamC(int fromColumnIndex, int toColumnIndex)
ByteStream	streamH()
ByteStream	streamH(int rowIndex)
ByteStream	streamH(int fromRowIndex, int toRowIndex)
ByteStream	streamLU2RD()
Stream<ByteStream>	streamR()
Stream<ByteStream>	streamR(int fromRowIndex, int toRowIndex)
ByteStream	streamRU2LD()
ByteStream	streamV()
ByteStream	streamV(int columnIndex)
ByteStream	streamV(int fromColumnIndex, int toColumnIndex)
ByteMatrix	subtract(ByteMatrix b)
DoubleMatrix	toDoubleMatrix()
FloatMatrix	toFloatMatrix()
IntMatrix	toIntMatrix()
LongMatrix	toLongMatrix()
java.lang.String	toString()
ByteMatrix	transpose()
void	updateAll(ByteUnaryOperator func)
void	updateAll(IntBiFunction<java.lang.Byte> func) Update all elements based on points
void	updateColumn(int columnIndex, ByteUnaryOperator func)
void	updateLU2RD(ByteUnaryOperator func)
void	updateRow(int rowIndex, ByteUnaryOperator func)
void	updateRU2LD(ByteUnaryOperator func)
OptionalByte	upOf(int i, int j)
ByteMatrix	vstack(ByteMatrix b)
ByteMatrix	zipWith(ByteMatrix matrixB, ByteBiFunction<java.lang.Byte> zipFunction)
ByteMatrix	zipWith(ByteMatrix matrixB, ByteMatrix matrixC, ByteTriFunction<java.lang.Byte> zipFunction)

Methods inherited from class com.landawn.abacus.util.AbstractMatrix

isEmpty, isSameShape, pointsC, pointsC, pointsH, pointsH, pointsH, pointsLU2RD, pointsR, pointsR, pointsRU2LD, pointsV, pointsV, pointsV, println, reshape

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ByteMatrix

public ByteMatrix(byte[][] a)

Method Detail

empty

public static ByteMatrix empty()

of

@SafeVarargs
public static ByteMatrix of(byte[]... a)

random

public static ByteMatrix random(int len)

repeat

public static ByteMatrix repeat(byte val,
                                int len)

range

public static ByteMatrix range(byte startInclusive,
                               byte endExclusive)

range

public static ByteMatrix range(byte startInclusive,
                               byte endExclusive,
                               byte by)

rangeClosed

public static ByteMatrix rangeClosed(byte startInclusive,
                                     byte endInclusive)

rangeClosed

public static ByteMatrix rangeClosed(byte startInclusive,
                                     byte endInclusive,
                                     byte by)

diagonalLU2RD

public static ByteMatrix diagonalLU2RD(byte[] leftUp2RighDownDiagonal)

diagonalRU2LD

public static ByteMatrix diagonalRU2LD(byte[] rightUp2LeftDownDiagonal)

diagonal

public static ByteMatrix diagonal(byte[] leftUp2RighDownDiagonal,
                                  byte[] rightUp2LeftDownDiagonal)

array

public byte[][] array()

get

public byte get(int i,
                int j)

get

public byte get(Pair.IntPair point)

set

public void set(int i,
                int j,
                byte val)

set

public void set(Pair.IntPair point,
                byte val)

upOf

public OptionalByte upOf(int i,
                         int j)

downOf

public OptionalByte downOf(int i,
                           int j)

leftOf

public OptionalByte leftOf(int i,
                           int j)

rightOf

public OptionalByte rightOf(int i,
                            int j)

adjacent4Points

public Stream<Pair.IntPair> adjacent4Points(int i,
                                            int j)

Returns the four adjacencies with order: up, right, down, left. null is set if the adjacency doesn't exist.

Parameters:

i -

j -

Returns:

adjacent8Points

public Stream<Pair.IntPair> adjacent8Points(int i,
                                            int j)

Returns the eight adjacencies with order: left-up, up, right-up, right, right-down, down, left-down, left. null is set if the adjacency doesn't exist.

Parameters:

i -

j -

Returns:

row

public byte[] row(int rowIndex)

column

public byte[] column(int columnIndex)

setRow

public void setRow(int rowIndex,
                   byte[] row)

setColumn

public void setColumn(int columnIndex,
                      byte[] column)

updateRow

public void updateRow(int rowIndex,
                      ByteUnaryOperator func)

updateColumn

public void updateColumn(int columnIndex,
                         ByteUnaryOperator func)

getLU2RD

public byte[] getLU2RD()

setLU2RD

public void setLU2RD(byte[] diagonal)

updateLU2RD

public void updateLU2RD(ByteUnaryOperator func)

getRU2LD

public byte[] getRU2LD()

setRU2LD

public void setRU2LD(byte[] diagonal)

updateRU2LD

public void updateRU2LD(ByteUnaryOperator func)

updateAll

public void updateAll(ByteUnaryOperator func)

updateAll

public void updateAll(IntBiFunction<java.lang.Byte> func)

Update all elements based on points

Parameters:

func -

replaceIf

public void replaceIf(BytePredicate predicate,
                      byte newValue)

replaceIf

public void replaceIf(IntBiPredicate predicate,
                      byte newValue)

Replace elements by Predicate.test(i, j) based on points

Parameters:

predicate -

newValue -

map

public ByteMatrix map(ByteUnaryOperator func)

mapToObj

public <T> Matrix<T> mapToObj(java.lang.Class<T> cls,
                              ByteFunction<? extends T> func)

fill

public void fill(byte val)

fill

public void fill(byte[][] b)

fill

public void fill(int fromRowIndex,
                 int fromColumnIndex,
                 byte[][] b)

copy

public ByteMatrix copy()

Specified by:

copy in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a new Matrix

copy

public ByteMatrix copy(int fromRowIndex,
                       int toRowIndex)

Specified by:

copy in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a new Matrix

copy

public ByteMatrix copy(int fromRowIndex,
                       int toRowIndex,
                       int fromColumnIndex,
                       int toColumnIndex)

Specified by:

copy in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a new Matrix

reverseH

public void reverseH()

reverseV

public void reverseV()

flipH

public ByteMatrix flipH()

flipV

public ByteMatrix flipV()

rotate90

public ByteMatrix rotate90()

Description copied from class: AbstractMatrix

Rotate this matrix clockwise 90

Specified by:

rotate90 in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a new Matrix

rotate180

public ByteMatrix rotate180()

Description copied from class: AbstractMatrix

Rotate this matrix clockwise 180

Specified by:

rotate180 in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a new Matrix

rotate270

public ByteMatrix rotate270()

Description copied from class: AbstractMatrix

Rotate this matrix clockwise 270

Specified by:

rotate270 in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a new Matrix

transpose

public ByteMatrix transpose()

Specified by:

transpose in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

reshape

public ByteMatrix reshape(int newRows,
                          int newCols)

Specified by:

reshape in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

repelem

public ByteMatrix repelem(int rowRepeats,
                          int colRepeats)

Repeat elements rowRepeats times in row direction and colRepeats times in column direction.

Specified by:

repelem in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Parameters:

rowRepeats -

colRepeats -

Returns:

a new matrix

repmat

public ByteMatrix repmat(int rowRepeats,
                         int colRepeats)

Repeat this matrix rowRepeats times in row direction and colRepeats times in column direction.

Specified by:

repmat in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Parameters:

rowRepeats -

colRepeats -

Returns:

a new matrix

flatten

public ByteList flatten()

Specified by:

flatten in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

vstack

public ByteMatrix vstack(ByteMatrix b)

Parameters:

b -

Returns:

See Also:

IntMatrix.vstack(IntMatrix)

hstack

public ByteMatrix hstack(ByteMatrix b)

Parameters:

b -

Returns:

See Also:

IntMatrix.hstack(IntMatrix)

add

public ByteMatrix add(ByteMatrix b)

subtract

public ByteMatrix subtract(ByteMatrix b)

multiply

public ByteMatrix multiply(ByteMatrix b)

boxed

public Matrix<java.lang.Byte> boxed()

toIntMatrix

public IntMatrix toIntMatrix()

toLongMatrix

public LongMatrix toLongMatrix()

toFloatMatrix

public FloatMatrix toFloatMatrix()

toDoubleMatrix

public DoubleMatrix toDoubleMatrix()

zipWith

public ByteMatrix zipWith(ByteMatrix matrixB,
                          ByteBiFunction<java.lang.Byte> zipFunction)

zipWith

public ByteMatrix zipWith(ByteMatrix matrixB,
                          ByteMatrix matrixC,
                          ByteTriFunction<java.lang.Byte> zipFunction)

streamLU2RD

public ByteStream streamLU2RD()

Specified by:

streamLU2RD in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a stream composed by elements on the diagonal line from left up to right down.

streamRU2LD

public ByteStream streamRU2LD()

Specified by:

streamRU2LD in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a stream composed by elements on the diagonal line from right up to left down.

streamH

public ByteStream streamH()

Specified by:

streamH in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a stream based on the order of row.

streamH

public ByteStream streamH(int rowIndex)

Specified by:

streamH in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

streamH

public ByteStream streamH(int fromRowIndex,
                          int toRowIndex)

Specified by:

streamH in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Parameters:

fromRowIndex -

toRowIndex -

Returns:

a stream based on the order of row.

streamV

@Beta
public ByteStream streamV()

Specified by:

streamV in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a stream based on the order of column.

streamV

public ByteStream streamV(int columnIndex)

Specified by:

streamV in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

streamV

@Beta
public ByteStream streamV(int fromColumnIndex,
                                 int toColumnIndex)

Specified by:

streamV in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Parameters:

fromColumnIndex -

toColumnIndex -

Returns:

a stream based on the order of column.

streamR

public Stream<ByteStream> streamR()

Specified by:

streamR in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a row stream based on the order of row.

streamR

public Stream<ByteStream> streamR(int fromRowIndex,
                                  int toRowIndex)

Specified by:

streamR in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Parameters:

fromRowIndex -

toRowIndex -

Returns:

a row stream based on the order of row.

streamC

@Beta
public Stream<ByteStream> streamC()

Specified by:

streamC in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Returns:

a column stream based on the order of column.

streamC

@Beta
public Stream<ByteStream> streamC(int fromColumnIndex,
                                         int toColumnIndex)

Specified by:

streamC in class AbstractMatrix<byte[],ByteList,ByteStream,Stream<ByteStream>,ByteMatrix>

Parameters:

fromColumnIndex -

toColumnIndex -

Returns:

a column stream based on the order of column.

forEach

public void forEach(ByteConsumer action)

forEach

public void forEach(int fromRowIndex,
                    int toRowIndex,
                    int fromColumnIndex,
                    int toColumnIndex,
                    ByteConsumer action)

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object