com.landawn.abacus.util

Class IntMatrix

java.lang.Object

com.landawn.abacus.util.AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

com.landawn.abacus.util.IntMatrix

public final class IntMatrix
extends AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

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
IntMatrix(int[][] a)

Method Summary

Modifier and Type	Method and Description
IntMatrix	add(IntMatrix b)
Stream<IntPair>	adjacent4Points(int i, int j) Returns the four adjacencies with order: up, right, down, left.
Stream<IntPair>	adjacent8Points(int i, int j) Returns the eight adjacencies with order: left-up, up, right-up, right, right-down, down, left-down, left.
Matrix<java.lang.Integer>	boxed()
int[]	column(int columnIndex)
IntMatrix	copy()
IntMatrix	copy(int fromRowIndex, int toRowIndex)
IntMatrix	copy(int fromRowIndex, int toRowIndex, int fromColumnIndex, int toColumnIndex)
static IntMatrix	diagonal(int[] leftUp2RighDownDiagonal, int[] rightUp2LeftDownDiagonal)
static IntMatrix	diagonalLU2RD(int[] leftUp2RighDownDiagonal)
static IntMatrix	diagonalRU2LD(int[] rightUp2LeftDownDiagonal)
u.OptionalInt	downOf(int i, int j)
static IntMatrix	empty()
boolean	equals(java.lang.Object obj)
IntMatrix	extend(int newRows, int newCols)
IntMatrix	extend(int newRows, int newCols, int defaultValueForNewCell)
IntMatrix	extend(int toUp, int toDown, int toLeft, int toRight)
IntMatrix	extend(int toUp, int toDown, int toLeft, int toRight, int defaultValueForNewCell)
void	fill(int val)
void	fill(int[][] b)
void	fill(int fromRowIndex, int fromColumnIndex, int[][] b)
<E extends java.lang.Exception> void	flatOp(Try.Consumer<int[],E> op) flatten -> execute op -> set values back.
IntList	flatten()
IntMatrix	flipH()
IntMatrix	flipV()
<E extends java.lang.Exception> void	forEach(int fromRowIndex, int toRowIndex, int fromColumnIndex, int toColumnIndex, Try.IntConsumer<E> action)
<E extends java.lang.Exception> void	forEach(Try.IntConsumer<E> action)
static IntMatrix	from(byte[]... a)
static IntMatrix	from(char[]... a)
static IntMatrix	from(short[]... a)
int	get(int i, int j)
int	get(IntPair point)
int[]	getLU2RD()
int[]	getRU2LD()
int	hashCode()
IntMatrix	hstack(IntMatrix b) IntMatrix a = IntMatrix.of({{1, 2, 3}, {4, 5, 6}); IntMatrix b = IntMatrix.of({{7, 8, 9}, {10, 11, 12}); IntMatrix c = a.hstack(b); [[1, 2, 3, 7, 8, 9], [4, 5, 6, 10, 11, 23]]
u.OptionalInt	leftOf(int i, int j)
<E extends java.lang.Exception> IntMatrix	map(Try.IntUnaryOperator<E> func)
<T,E extends java.lang.Exception> Matrix<T>	mapToObj(java.lang.Class<T> cls, Try.IntFunction<? extends T,E> func)
IntMatrix	multiply(IntMatrix b)
static IntMatrix	of(int[]... a)
void	println()
static IntMatrix	random(int len)
static IntMatrix	range(int startInclusive, int endExclusive)
static IntMatrix	range(int startInclusive, int endExclusive, int by)
static IntMatrix	rangeClosed(int startInclusive, int endInclusive)
static IntMatrix	rangeClosed(int startInclusive, int endInclusive, int by)
static IntMatrix	repeat(int val, int len)
IntMatrix	repelem(int rowRepeats, int colRepeats) Repeat elements rowRepeats times in row direction and colRepeats times in column direction.
<E extends java.lang.Exception> void	replaceIf(Try.IntBiPredicate<E> predicate, int newValue) Replace elements by Predicate.test(i, j) based on points
<E extends java.lang.Exception> void	replaceIf(Try.IntPredicate<E> predicate, int newValue)
IntMatrix	repmat(int rowRepeats, int colRepeats) Repeat this matrix rowRepeats times in row direction and colRepeats times in column direction.
IntMatrix	reshape(int newRows, int newCols)
void	reverseH()
void	reverseV()
u.OptionalInt	rightOf(int i, int j)
IntMatrix	rotate180() Rotate this matrix clockwise 180
IntMatrix	rotate270() Rotate this matrix clockwise 270
IntMatrix	rotate90() Rotate this matrix clockwise 90
int[]	row(int rowIndex)
void	set(int i, int j, int val)
void	set(IntPair point, int val)
void	setColumn(int columnIndex, int[] column)
void	setLU2RD(int[] diagonal)
void	setRow(int rowIndex, int[] row)
void	setRU2LD(int[] diagonal)
Stream<IntStream>	streamC()
Stream<IntStream>	streamC(int fromColumnIndex, int toColumnIndex)
IntStream	streamH()
IntStream	streamH(int rowIndex)
IntStream	streamH(int fromRowIndex, int toRowIndex)
IntStream	streamLU2RD()
Stream<IntStream>	streamR()
Stream<IntStream>	streamR(int fromRowIndex, int toRowIndex)
IntStream	streamRU2LD()
IntStream	streamV()
IntStream	streamV(int columnIndex)
IntStream	streamV(int fromColumnIndex, int toColumnIndex)
IntMatrix	subtract(IntMatrix b)
DoubleMatrix	toDoubleMatrix()
FloatMatrix	toFloatMatrix()
LongMatrix	toLongMatrix()
java.lang.String	toString()
IntMatrix	transpose()
<E extends java.lang.Exception> void	updateAll(Try.IntBiFunction<java.lang.Integer,E> func) Update all elements based on points
<E extends java.lang.Exception> void	updateAll(Try.IntUnaryOperator<E> func)
<E extends java.lang.Exception> void	updateColumn(int columnIndex, Try.IntUnaryOperator<E> func)
<E extends java.lang.Exception> void	updateLU2RD(Try.IntUnaryOperator<E> func)
<E extends java.lang.Exception> void	updateRow(int rowIndex, Try.IntUnaryOperator<E> func)
<E extends java.lang.Exception> void	updateRU2LD(Try.IntUnaryOperator<E> func)
u.OptionalInt	upOf(int i, int j)
IntMatrix	vstack(IntMatrix b) IntMatrix a = IntMatrix.of({{1, 2, 3}, {4, 5, 6}); IntMatrix b = IntMatrix.of({{7, 8, 9}, {10, 11, 12}); IntMatrix c = a.vstack(b); [[1, 2, 3], [4, 5, 6], [7, 8, 9], [10, 11, 12]]
<E extends java.lang.Exception> IntMatrix	zipWith(IntMatrix matrixB, IntMatrix matrixC, Try.IntTriFunction<java.lang.Integer,E> zipFunction)
<E extends java.lang.Exception> IntMatrix	zipWith(IntMatrix matrixB, Try.IntBiFunction<java.lang.Integer,E> zipFunction)

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

array, forEach, isEmpty, isSameShape, pointsC, pointsC, pointsH, pointsH, pointsH, pointsLU2RD, pointsR, pointsR, pointsRU2LD, pointsV, pointsV, pointsV, reshape

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

IntMatrix

public IntMatrix(int[][] a)

Method Detail

empty

public static IntMatrix empty()

of

@SafeVarargs
public static IntMatrix of(int[]... a)

from

@SafeVarargs
public static IntMatrix from(char[]... a)

from

@SafeVarargs
public static IntMatrix from(byte[]... a)

from

@SafeVarargs
public static IntMatrix from(short[]... a)

random

public static IntMatrix random(int len)

repeat

public static IntMatrix repeat(int val,
                               int len)

range

public static IntMatrix range(int startInclusive,
                              int endExclusive)

range

public static IntMatrix range(int startInclusive,
                              int endExclusive,
                              int by)

rangeClosed

public static IntMatrix rangeClosed(int startInclusive,
                                    int endInclusive)

rangeClosed

public static IntMatrix rangeClosed(int startInclusive,
                                    int endInclusive,
                                    int by)

diagonalLU2RD

public static IntMatrix diagonalLU2RD(int[] leftUp2RighDownDiagonal)

diagonalRU2LD

public static IntMatrix diagonalRU2LD(int[] rightUp2LeftDownDiagonal)

diagonal

public static IntMatrix diagonal(int[] leftUp2RighDownDiagonal,
                                 int[] rightUp2LeftDownDiagonal)

get

public int get(int i,
               int j)

get

public int get(IntPair point)

set

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

set

public void set(IntPair point,
                int val)

upOf

public u.OptionalInt upOf(int i,
                          int j)

downOf

public u.OptionalInt downOf(int i,
                            int j)

leftOf

public u.OptionalInt leftOf(int i,
                            int j)

rightOf

public u.OptionalInt rightOf(int i,
                             int j)

adjacent4Points

public Stream<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<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 int[] row(int rowIndex)

column

public int[] column(int columnIndex)

setRow

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

setColumn

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

updateRow

public <E extends java.lang.Exception> void updateRow(int rowIndex,
                                                      Try.IntUnaryOperator<E> func)
                                               throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

updateColumn

public <E extends java.lang.Exception> void updateColumn(int columnIndex,
                                                         Try.IntUnaryOperator<E> func)
                                                  throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

getLU2RD

public int[] getLU2RD()

setLU2RD

public void setLU2RD(int[] diagonal)

updateLU2RD

public <E extends java.lang.Exception> void updateLU2RD(Try.IntUnaryOperator<E> func)
                                                 throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

getRU2LD

public int[] getRU2LD()

setRU2LD

public void setRU2LD(int[] diagonal)

updateRU2LD

public <E extends java.lang.Exception> void updateRU2LD(Try.IntUnaryOperator<E> func)
                                                 throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

updateAll

public <E extends java.lang.Exception> void updateAll(Try.IntUnaryOperator<E> func)
                                               throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

updateAll

public <E extends java.lang.Exception> void updateAll(Try.IntBiFunction<java.lang.Integer,E> func)
                                               throws E extends java.lang.Exception

Update all elements based on points

Parameters:

func -

Throws:

E extends java.lang.Exception

replaceIf

public <E extends java.lang.Exception> void replaceIf(Try.IntPredicate<E> predicate,
                                                      int newValue)
                                               throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

replaceIf

public <E extends java.lang.Exception> void replaceIf(Try.IntBiPredicate<E> predicate,
                                                      int newValue)
                                               throws E extends java.lang.Exception

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

Parameters:

predicate -

newValue -

Throws:

E extends java.lang.Exception

map

public <E extends java.lang.Exception> IntMatrix map(Try.IntUnaryOperator<E> func)
                                              throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

mapToObj

public <T,E extends java.lang.Exception> Matrix<T> mapToObj(java.lang.Class<T> cls,
                                                            Try.IntFunction<? extends T,E> func)
                                                     throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

fill

public void fill(int val)

fill

public void fill(int[][] b)

fill

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

copy

public IntMatrix copy()

Specified by:

copy in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a new Matrix

copy

public IntMatrix copy(int fromRowIndex,
                      int toRowIndex)

Specified by:

copy in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a new Matrix

copy

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

Specified by:

copy in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a new Matrix

extend

public IntMatrix extend(int newRows,
                        int newCols)

extend

public IntMatrix extend(int newRows,
                        int newCols,
                        int defaultValueForNewCell)

extend

public IntMatrix extend(int toUp,
                        int toDown,
                        int toLeft,
                        int toRight)

extend

public IntMatrix extend(int toUp,
                        int toDown,
                        int toLeft,
                        int toRight,
                        int defaultValueForNewCell)

reverseH

public void reverseH()

reverseV

public void reverseV()

flipH

public IntMatrix flipH()

Returns:

See Also:

https://www.mathworks.com/help/matlab/ref/flip.html#btz149s-1

flipV

public IntMatrix flipV()

Returns:

See Also:

https://www.mathworks.com/help/matlab/ref/flip.html#btz149s-1

rotate90

public IntMatrix rotate90()

Description copied from class: AbstractMatrix

Rotate this matrix clockwise 90

Specified by:

rotate90 in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a new Matrix

rotate180

public IntMatrix rotate180()

Description copied from class: AbstractMatrix

Rotate this matrix clockwise 180

Specified by:

rotate180 in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a new Matrix

rotate270

public IntMatrix rotate270()

Description copied from class: AbstractMatrix

Rotate this matrix clockwise 270

Specified by:

rotate270 in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a new Matrix

transpose

public IntMatrix transpose()

Specified by:

transpose in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

reshape

public IntMatrix reshape(int newRows,
                         int newCols)

Specified by:

reshape in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

repelem

public IntMatrix repelem(int rowRepeats,
                         int colRepeats)

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

Specified by:

repelem in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Parameters:

rowRepeats -

colRepeats -

Returns:

a new matrix

See Also:

https://www.mathworks.com/help/matlab/ref/repelem.html

repmat

public IntMatrix 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<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Parameters:

rowRepeats -

colRepeats -

Returns:

a new matrix

See Also:

https://www.mathworks.com/help/matlab/ref/repmat.html

flatten

public IntList flatten()

Specified by:

flatten in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

flatOp

public <E extends java.lang.Exception> void flatOp(Try.Consumer<int[],E> op)
                                            throws E extends java.lang.Exception

Description copied from class: AbstractMatrix

flatten -> execute op -> set values back.

 
 matrix.flatOp(a -> N.sort(a));
 
 

Specified by:

flatOp in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Throws:

E

E extends java.lang.Exception

vstack

public IntMatrix vstack(IntMatrix b)

 
 IntMatrix a = IntMatrix.of({{1, 2, 3}, {4, 5, 6});
 IntMatrix b = IntMatrix.of({{7, 8, 9}, {10, 11, 12});
 
 IntMatrix c = a.vstack(b);
 
 [[1, 2, 3],
  [4, 5, 6],
  [7, 8, 9],
  [10, 11, 12]]
 
 
 

Parameters:

b -

Returns:

hstack

public IntMatrix hstack(IntMatrix b)

 
 IntMatrix a = IntMatrix.of({{1, 2, 3}, {4, 5, 6});
 IntMatrix b = IntMatrix.of({{7, 8, 9}, {10, 11, 12});
 
 IntMatrix c = a.hstack(b);
 
 [[1, 2, 3, 7, 8, 9],
  [4, 5, 6, 10, 11, 23]]
 
 
 

Parameters:

b -

Returns:

add

public IntMatrix add(IntMatrix b)

subtract

public IntMatrix subtract(IntMatrix b)

multiply

public IntMatrix multiply(IntMatrix b)

boxed

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

toLongMatrix

public LongMatrix toLongMatrix()

toFloatMatrix

public FloatMatrix toFloatMatrix()

toDoubleMatrix

public DoubleMatrix toDoubleMatrix()

zipWith

public <E extends java.lang.Exception> IntMatrix zipWith(IntMatrix matrixB,
                                                         Try.IntBiFunction<java.lang.Integer,E> zipFunction)
                                                  throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

zipWith

public <E extends java.lang.Exception> IntMatrix zipWith(IntMatrix matrixB,
                                                         IntMatrix matrixC,
                                                         Try.IntTriFunction<java.lang.Integer,E> zipFunction)
                                                  throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

streamLU2RD

public IntStream streamLU2RD()

Specified by:

streamLU2RD in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

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

streamRU2LD

public IntStream streamRU2LD()

Specified by:

streamRU2LD in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

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

streamH

public IntStream streamH()

Specified by:

streamH in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a stream based on the order of row.

streamH

public IntStream streamH(int rowIndex)

Specified by:

streamH in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

streamH

public IntStream streamH(int fromRowIndex,
                         int toRowIndex)

Specified by:

streamH in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Parameters:

fromRowIndex -

toRowIndex -

Returns:

a stream based on the order of row.

streamV

@Beta
public IntStream streamV()

Specified by:

streamV in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a stream based on the order of column.

streamV

public IntStream streamV(int columnIndex)

Specified by:

streamV in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

streamV

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

Specified by:

streamV in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Parameters:

fromColumnIndex -

toColumnIndex -

Returns:

a stream based on the order of column.

streamR

public Stream<IntStream> streamR()

Specified by:

streamR in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a row stream based on the order of row.

streamR

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

Specified by:

streamR in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Parameters:

fromRowIndex -

toRowIndex -

Returns:

a row stream based on the order of row.

streamC

@Beta
public Stream<IntStream> streamC()

Specified by:

streamC in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Returns:

a column stream based on the order of column.

streamC

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

Specified by:

streamC in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

Parameters:

fromColumnIndex -

toColumnIndex -

Returns:

a column stream based on the order of column.

forEach

public <E extends java.lang.Exception> void forEach(Try.IntConsumer<E> action)
                                             throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

forEach

public <E extends java.lang.Exception> void forEach(int fromRowIndex,
                                                    int toRowIndex,
                                                    int fromColumnIndex,
                                                    int toColumnIndex,
                                                    Try.IntConsumer<E> action)
                                             throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

println

public void println()

Specified by:

println in class AbstractMatrix<int[],IntList,IntStream,Stream<IntStream>,IntMatrix>

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