Package org.djunits.vecmat.def

Class AbsTable<A extends AbsQuantity<A,Q,?>,Q extends Quantity<Q>,MA extends AbsTable<A,Q,MA,MQ,MAT>,MQ extends Table<Q,MQ,?,?,?>,MAT extends AbsTable<A,Q,MAT,?,MA>>

java.lang.Object

org.djunits.vecmat.def.AbsVectorMatrix<A,Q,MA,MQ,MAT>

org.djunits.vecmat.def.AbsTable<A,Q,MA,MQ,MAT>

Type Parameters:

A - the absolute quantity type

Q - the quantity type

MA - the absolute table type

MQ - the relative table type

MAT - the type of the transposed version of the absolute table

All Implemented Interfaces:

Serializable, Value<MA,Q>

Direct Known Subclasses:

AbsMatrix, AbsQuantityTable

public abstract class AbsTable<A extends AbsQuantity<A,Q,?>,Q extends Quantity<Q>,MA extends AbsTable<A,Q,MA,MQ,MAT>,MQ extends Table<Q,MQ,?,?,?>,MAT extends AbsTable<A,Q,MAT,?,MA>>
extends AbsVectorMatrix<A,Q,MA,MQ,MAT>

AbsTable contains a number of standard operations on 2-dimensional tables that contain absolute quantities.

Copyright (c) 2025-2026 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See for project information https://djunits.org. The DJUNITS project is distributed under a three-clause BSD-style license.

Author:

Alexander Verbraeck

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
AbsTable(MQ matrix, Reference<?,A,Q> reference)	Create a new matrix of absolute values with a reference point.

Method Summary

Modifier and Type	Method	Description
A	get(int row, int col)	Return the quantity at position (row, col), where both row and col are 0-based values.
A[]	getColumnScalars(int col)	Retrieve a column (0-based) from the matrix as an array of scalars.
double[]	getColumnSi(int col)	Return an array with SI-values for the given column (0-based) from the vector or matrix.
abstract AbsVector<A,Q,?,?,?>	getColumnVector(int col)	Return a quantity column (0-based) from the vector or matrix.
A[]	getRowScalars(int row)	Retrieve a row (0-based) from the matrix as an array of scalars.
double[]	getRowSi(int row)	Return an array with SI-values for the given row (0-based) from the vector or matrix.
abstract AbsVector<A,Q,?,?,?>	getRowVector(int row)	Return a quantity row (0-based) from the vector or matrix.
A[]	getScalarArray()	Return the vector or matrix as a row-major array of scalars.
A[][]	getScalarGrid()	Return the vector or matrix as a 2D array of scalars.
double[]	getSiArray()	Return the vector or matrix as a row-major array of double SI values.
double[][]	getSiGrid()	Return the vector or matrix as a 2D array of double SI values.
A	mget(int mRow, int mCol)	Return the quantity at position (row, col), where both row and col are 1-based values.
A[]	mgetColumnScalars(int mCol)	Retrieve a column (1-based) from the matrix as an array of scalars.
double[]	mgetColumnSi(int mCol)	Return an array with SI-values for the given column (1-based) from the vector or matrix.
abstract AbsVector<A,Q,?,?,?>	mgetColumnVector(int mCol)	Return a quantity column (1-based) from the vector or matrix.
A[]	mgetRowScalars(int mRow)	Retrieve a row (1-based) from the matrix as an array of scalars.
double[]	mgetRowSi(int mRow)	Return an array with SI-values for the given row (1-based) from the vector or matrix.
abstract AbsVector<A,Q,?,?,?>	mgetRowVector(int mRow)	Return a quantity row (1-based) from the vector or matrix.
double	msi(int mRow, int mCol)	Return the si-value at position (row, col), where both row and col are 1-based values.
double	si(int row, int col)	Return the si-value at position (row, col), where both row and col are 0-based values.

Methods inherited from class org.djunits.vecmat.def.AbsVectorMatrix

add, add, asAbsMatrix1x1, asAbsMatrix2x2, asAbsMatrix3x3, asAbsMatrixNxM, asAbsMatrixNxN, asAbsQuantityTable, asAbsVector1, asAbsVector2Col, asAbsVector2Row, asAbsVector3Col, asAbsVector3Row, asAbsVectorNCol, asAbsVectorNRow, checkCol, checkRow, cols, equals, getDisplayUnit, getReference, getRelativeVecMat, hashCode, instantiate, instantiateSi, isRelative, max, mcheckCol, mcheckRow, median, min, rows, setDisplayUnit, subtract, subtract, subtract, subtract, toString, transpose

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.djunits.value.Value

format, format, isAbsolute, setDisplayUnit

Constructor Details

AbsTable

public AbsTable(MQ matrix,
 Reference<?,A,Q> reference)

Create a new matrix of absolute values with a reference point.

Parameters:

matrix - the underlying relative matrix with SI values relative to the reference point

reference - the reference point for the absolute values

Method Details

si

public double si(int row,
 int col)
          throws IndexOutOfBoundsException

Return the si-value at position (row, col), where both row and col are 0-based values.

Parameters:

row - the row (0-based)

col - the column (0-based)

Returns:

the si-value at position (row, col)

Throws:

IndexOutOfBoundsException - when row or col < 0 or larger than number of rows/columns - 1.

msi

public double msi(int mRow,
 int mCol)
           throws IndexOutOfBoundsException

Return the si-value at position (row, col), where both row and col are 1-based values.

Parameters:

mRow - the row (1-based)

mCol - the column (1-based)

Returns:

the si-value at position (row, col)

Throws:

IndexOutOfBoundsException - when row or col < 1 or larger than number of rows/columns.

get

public A get(int row,
 int col)
      throws IndexOutOfBoundsException

Return the quantity at position (row, col), where both row and col are 0-based values.

Parameters:

row - the row (0-based)

col - the column (0-based)

Returns:

the quantity at position (row, col)

Throws:

IndexOutOfBoundsException - when row or col < 0 or larger than number of rows/columns - 1.

mget

public A mget(int mRow,
 int mCol)
       throws IndexOutOfBoundsException

Return the quantity at position (row, col), where both row and col are 1-based values.

Parameters:

mRow - the row (1-based)

mCol - the column (1-based)

Returns:

the quantity at position (row, col)

Throws:

IndexOutOfBoundsException - when row or col < 1 or larger than number of rows/columns.

getScalarGrid

public A[][] getScalarGrid()

Return the vector or matrix as a 2D array of scalars.

Returns:

a new A[rows()][cols()] array; entry [i][j] contains get(i, j).

getSiGrid

public double[][] getSiGrid()

Return the vector or matrix as a 2D array of double SI values.

Returns:

a new double[rows()][cols()] array; entry [i][j] contains si(i, j).

getScalarArray

public A[] getScalarArray()

Return the vector or matrix as a row-major array of scalars.

Returns:

a new A[rows() * cols()] array.

getSiArray

public double[] getSiArray()

Return the vector or matrix as a row-major array of double SI values.

Returns:

a new double[rows() * cols()] array.

getRowVector

public abstract AbsVector<A,Q,?,?,?> getRowVector(int row)

Return a quantity row (0-based) from the vector or matrix. Note that the specific vector to return can be tightened by the implementing class.

Parameters:

row - the row number to retrieve (0-based)

Returns:

a row vector with the data at the given row

mgetRowVector

public abstract AbsVector<A,Q,?,?,?> mgetRowVector(int mRow)

Return a quantity row (1-based) from the vector or matrix. Note that the specific vector to return can be tightened by the implementing class.

Parameters:

mRow - the row number to retrieve (1-based)

Returns:

a row vector with the data at the given row

getColumnVector

public abstract AbsVector<A,Q,?,?,?> getColumnVector(int col)

Return a quantity column (0-based) from the vector or matrix. Note that the specific vector to return can be tightened by the implementing class.

Parameters:

col - the column number to retrieve (0-based)

Returns:

a column vector with the data at the given column

mgetColumnVector

public abstract AbsVector<A,Q,?,?,?> mgetColumnVector(int mCol)

Return a quantity column (1-based) from the vector or matrix. Note that the specific vector to return can be tightened by the implementing class.

Parameters:

mCol - the column number to retrieve (1-based)

Returns:

a column vector with the data at the given column

getRowSi

public double[] getRowSi(int row)

Return an array with SI-values for the given row (0-based) from the vector or matrix.

Parameters:

row - the row number to retrieve (0-based)

Returns:

an array with SI-values with the data at the given row

mgetRowSi

public double[] mgetRowSi(int mRow)

Return an array with SI-values for the given row (1-based) from the vector or matrix.

Parameters:

mRow - the row number to retrieve (1-based)

Returns:

an array with SI-values with the data at the given row

getColumnSi

public double[] getColumnSi(int col)

Return an array with SI-values for the given column (0-based) from the vector or matrix.

Parameters:

col - the column number to retrieve (0-based)

Returns:

an array with SI-values with the data at the given column

mgetColumnSi

public double[] mgetColumnSi(int mCol)

Return an array with SI-values for the given column (1-based) from the vector or matrix.

Parameters:

mCol - the column number to retrieve (1-based)

Returns:

an array with SI-values with the data at the given column

getRowScalars

public A[] getRowScalars(int row)
                  throws IndexOutOfBoundsException

Retrieve a row (0-based) from the matrix as an array of scalars.

Parameters:

row - row of the values to retrieve (0-based)

Returns:

the row as a Scalar array

Throws:

IndexOutOfBoundsException - in case row is out of bounds

mgetRowScalars

public A[] mgetRowScalars(int mRow)
                   throws IndexOutOfBoundsException

Retrieve a row (1-based) from the matrix as an array of scalars.

Parameters:

mRow - row of the values to retrieve (1-based)

Returns:

the row as a Scalar array

Throws:

IndexOutOfBoundsException - in case row is out of bounds

getColumnScalars

public A[] getColumnScalars(int col)
                     throws IndexOutOfBoundsException

Retrieve a column (0-based) from the matrix as an array of scalars.

Parameters:

col - column of the values to retrieve (0-based)

Returns:

the column as a Scalar array

Throws:

IndexOutOfBoundsException - in case column is out of bounds

mgetColumnScalars

public A[] mgetColumnScalars(int mCol)
                      throws IndexOutOfBoundsException

Retrieve a column (1-based) from the matrix as an array of scalars.

Parameters:

mCol - column of the values to retrieve (1-based)

Returns:

the column as a Scalar array

Throws:

IndexOutOfBoundsException - in case column is out of bounds