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<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.
int[][]	array()
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)
OptionalInt	downOf(int i, int j)
static IntMatrix	empty()
boolean	equals(java.lang.Object obj)
void	fill(int val)
void	fill(int[][] b)
void	fill(int fromRowIndex, int fromColumnIndex, int[][] b)
IntList	flatten()
IntMatrix	flipH()
IntMatrix	flipV()
void	forEach(IntConsumer action)
void	forEach(int fromRowIndex, int toRowIndex, int fromColumnIndex, int toColumnIndex, IntConsumer action)
static IntMatrix	from(byte[]... a)
static IntMatrix	from(char[]... a)
static IntMatrix	from(short[]... a)
int	get(int i, int j)
int	get(Pair.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.vstack(b); [[1, 2, 3, 7, 8, 9], [4, 5, 6, 10, 11, 23]]
OptionalInt	leftOf(int i, int j)
IntMatrix	map(IntUnaryOperator func)
<T> Matrix<T>	mapToObj(java.lang.Class<T> cls, IntFunction<? extends T> func)
IntMatrix	multiply(IntMatrix b)
static IntMatrix	of(int[]... a)
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.
void	replaceIf(IntBiPredicate predicate, int newValue) Replace elements by Predicate.test(i, j) based on points
void	replaceIf(IntPredicate 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()
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(Pair.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()
void	updateAll(IntBiFunction<java.lang.Integer> func) Update all elements based on points
void	updateAll(IntUnaryOperator func)
void	updateColumn(int columnIndex, IntUnaryOperator func)
void	updateLU2RD(IntUnaryOperator func)
void	updateRow(int rowIndex, IntUnaryOperator func)
void	updateRU2LD(IntUnaryOperator func)
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]]
IntMatrix	zipWith(IntMatrix matrixB, IntBiFunction<java.lang.Integer> zipFunction)
IntMatrix	zipWith(IntMatrix matrixB, IntMatrix matrixC, IntTriFunction<java.lang.Integer> 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

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)

array

public int[][] array()

get

public int get(int i,
               int j)

get

public int get(Pair.IntPair point)

set

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

set

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

upOf

public OptionalInt upOf(int i,
                        int j)

downOf

public OptionalInt downOf(int i,
                          int j)

leftOf

public OptionalInt leftOf(int i,
                          int j)

rightOf

public OptionalInt 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 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 void updateRow(int rowIndex,
                      IntUnaryOperator func)

updateColumn

public void updateColumn(int columnIndex,
                         IntUnaryOperator func)

getLU2RD

public int[] getLU2RD()

setLU2RD

public void setLU2RD(int[] diagonal)

updateLU2RD

public void updateLU2RD(IntUnaryOperator func)

getRU2LD

public int[] getRU2LD()

setRU2LD

public void setRU2LD(int[] diagonal)

updateRU2LD

public void updateRU2LD(IntUnaryOperator func)

updateAll

public void updateAll(IntUnaryOperator func)

updateAll

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

Update all elements based on points

Parameters:

func -

replaceIf

public void replaceIf(IntPredicate predicate,
                      int newValue)

replaceIf

public void replaceIf(IntBiPredicate predicate,
                      int newValue)

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

Parameters:

predicate -

newValue -

map

public IntMatrix map(IntUnaryOperator func)

mapToObj

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

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

reverseH

public void reverseH()

reverseV

public void reverseV()

flipH

public IntMatrix flipH()

flipV

public IntMatrix flipV()

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

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

flatten

public IntList flatten()

Specified by:

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

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.vstack(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 IntMatrix zipWith(IntMatrix matrixB,
                         IntBiFunction<java.lang.Integer> zipFunction)

zipWith

public IntMatrix zipWith(IntMatrix matrixB,
                         IntMatrix matrixC,
                         IntTriFunction<java.lang.Integer> zipFunction)

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 void forEach(IntConsumer action)

forEach

public void forEach(int fromRowIndex,
                    int toRowIndex,
                    int fromColumnIndex,
                    int toColumnIndex,
                    IntConsumer 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