Package org.djunits.vecmat.storage

Class DenseDoubleDataSi

java.lang.Object
org.djunits.vecmat.storage.DenseDoubleDataSi
All Implemented Interfaces:
DataGridSi<DenseDoubleDataSi>
public class DenseDoubleDataSi extends Object implements DataGridSi<DenseDoubleDataSi>
DenseDoubleData implements a dense data grid for N x M matrices or N x 1 or 1 x M vectors with double values. DenseDoubleData always stores a safe copy of the data when using the of() or ofSi() methods.

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

  • Constructor Summary

    Constructors
    Constructor
    Description
    DenseDoubleDataSi(double[] dataSi, int rows, int cols)
    Instantiate a data object with one array in row-major format.

  • Method Summary

    Modifier and Type
    Method
    Description
    int
    cols()
    Return the number of columns in the grid.
    DenseDoubleDataSi
    copy()
    Return a deep copy of the DataGrid object.
    boolean
    equals(Object obj)
     
    double
    get(int row, int col)
    Return element (row, col) from the grid as a double value, independent of the fact whether it is stored as a double.
    double[]
    getSiArray()
    Return a safe copy of the data in row-major format.
    int
    hashCode()
     
    DenseDoubleDataSi
    instantiateNew(double[] newData)
    Instantiate a new version of the DataGrid object with the given data and the same number of rows and columns.
    DenseDoubleDataSi
    instantiateNew(double[] newData, int newRows, int newCols)
    Instantiate a new version of the DataGrid object with the given data and the given number of rows and columns.
    boolean
    isDense()
    Return whether the data is dense.
    boolean
    isDouble()
    Return whether the data is double precision.
    int
    nonZeroCount()
    Compute and return the number of non-zero cells in this indexed value.
    static <Q extends Quantity<Q>>
    DenseDoubleDataSi
    of(double[][] gridInUnit, Unit<?,Q> unit)
    Instantiate a data object based on a row x column double[][] array in a given unit.
    static <Q extends Quantity<Q>>
    DenseDoubleDataSi
    of(double[] dataInUnit, int rows, int cols, Unit<?,Q> unit)
    Instantiate a data object based on a row-major double[] array in a given unit.
    static <A extends AbsQuantity<A, Q, ?>, Q extends Quantity<Q>>
    DenseDoubleDataSi
    of(A[][] absGrid)
    Instantiate a data object with a A[rows][cols].
    static <A extends AbsQuantity<A, Q, ?>, Q extends Quantity<Q>>
    DenseDoubleDataSi
    of(A[] absData, int rows, int cols)
    Instantiate a data object based on a row-major A[] array.
    static <A extends AbsQuantity<A, Q, ?>, Q extends Quantity<Q>>
    DenseDoubleDataSi
    of(List<A> absData, int rows, int cols)
    Instantiate a data object based on a row-major list of absolute quantities.
    static <Q extends Quantity<Q>>
    DenseDoubleDataSi
    of(Q[][] grid)
    Instantiate a data object with a Q[rows][cols].
    static <Q extends Quantity<Q>>
    DenseDoubleDataSi
    of(Q[] data, int rows, int cols)
    Instantiate a data object based on a row-major Q[] array.
    static DenseDoubleDataSi
    ofSi(double[][] gridSi)
    Instantiate a data object with a double[rows][cols].
    static DenseDoubleDataSi
    ofSi(double[] dataSi, int rows, int cols)
    Instantiate a data object with one array in row-major format.
    int
    rows()
    Return the number of rows in the grid.
    double[]
    unsafeSiArray()
    Return the data in row-major format.

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface org.djunits.vecmat.storage.DataGridSi

    equals, getColArray, getRowArray, isFloat, isSparse, nnz

  • Constructor Details

    • DenseDoubleDataSi

      public DenseDoubleDataSi(double[] dataSi, int rows, int cols)
      Instantiate a data object with one array in row-major format. NO safe copy of the data is stored. The constructor is very useful to store data after a calculation that already made a new safe copy.
      Parameters:
      dataSi - the data with SI-values in row-major format
      rows - the number of rows
      cols - the number of columns
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols, or when the number of rows or columns is not positive

  • Method Details

    • ofSi

      public static DenseDoubleDataSi ofSi(double[] dataSi, int rows, int cols)
      Instantiate a data object with one array in row-major format. A safe copy of the data is stored.
      Parameters:
      dataSi - the data with SI-values in row-major format
      rows - the number of rows
      cols - the number of columns
      Returns:
      a dense double data object with SI values for vectors, matrices and tables
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols, or when the number of rows or columns is not positive

    • of

      public static <Q extends Quantity<Q>> DenseDoubleDataSi of(double[] dataInUnit, int rows, int cols, Unit<?,Q> unit)
      Instantiate a data object based on a row-major double[] array in a given unit. A safe copy of the data is stored.
      Type Parameters:
      Q - the quantity type
      Parameters:
      dataInUnit - the data in row-major format, expressed in the given unit
      rows - the number of rows
      cols - the number of columns
      unit - the unit of the data
      Returns:
      a dense double data object with SI values for vectors, matrices and tables
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols, or when the number of rows or columns is not positive

    • of

      public static <Q extends Quantity<Q>> DenseDoubleDataSi of(Q[] data, int rows, int cols)
      Instantiate a data object based on a row-major Q[] array. A safe copy of the data is stored.
      Type Parameters:
      Q - the quantity type
      Parameters:
      data - the quantity data in row-major format
      rows - the number of rows
      cols - the number of columns
      Returns:
      a dense double data object with SI values for vectors, matrices and tables
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols, or when the number of rows or columns is not positive

    • of

      public static <A extends AbsQuantity<A, Q, ?>, Q extends Quantity<Q>> DenseDoubleDataSi of(A[] absData, int rows, int cols)
      Instantiate a data object based on a row-major A[] array. A safe copy of the data is stored.
      Type Parameters:
      A - the absolute quantity type
      Q - the quantity type
      Parameters:
      absData - the absolute quantities as a array in row-major format
      rows - the number of rows
      cols - the number of columns
      Returns:
      a dense double data object with SI values for vectors, matrices and tables
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols, or when the number of rows or columns is not positive

    • of

      public static <A extends AbsQuantity<A, Q, ?>, Q extends Quantity<Q>> DenseDoubleDataSi of(List<A> absData, int rows, int cols)
      Instantiate a data object based on a row-major list of absolute quantities. A safe copy of the data is stored.
      Type Parameters:
      A - the absolute quantity type
      Q - the quantity type
      Parameters:
      absData - the absolute quantities as a list in row-major format
      rows - the number of rows
      cols - the number of columns
      Returns:
      a dense double data object with SI values for vectors, matrices and tables
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols, or when the number of rows or columns is not positive

    • ofSi

      public static DenseDoubleDataSi ofSi(double[][] gridSi)
      Instantiate a data object with a double[rows][cols]. A safe copy of the data is stored.
      Parameters:
      gridSi - the data as a double[][] array in row-major format, with SI-values
      Returns:
      a dense double data object with SI values for vectors, matrices and tables
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols

    • of

      public static <Q extends Quantity<Q>> DenseDoubleDataSi of(double[][] gridInUnit, Unit<?,Q> unit)
      Instantiate a data object based on a row x column double[][] array in a given unit. A safe copy of the data is stored.
      Type Parameters:
      Q - the quantity type
      Parameters:
      gridInUnit - the data as a double[][] array in row-major format, expressed in the given unit
      unit - the unit of the data
      Returns:
      a dense double data object with SI values for vectors, matrices and tables
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols

    • of

      public static <Q extends Quantity<Q>> DenseDoubleDataSi of(Q[][] grid)
      Instantiate a data object with a Q[rows][cols]. A safe copy of the data is stored.
      Type Parameters:
      Q - the quantity type
      Parameters:
      grid - the quantities as a [][] array in row-major format
      Returns:
      a dense double data object with SI values for vectors, matrices and tables
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols

    • of

      public static <A extends AbsQuantity<A, Q, ?>, Q extends Quantity<Q>> DenseDoubleDataSi of(A[][] absGrid)
      Instantiate a data object with a A[rows][cols]. A safe copy of the data is stored.
      Type Parameters:
      A - the absolute quantity type
      Q - the quantity type
      Parameters:
      absGrid - the quantities as a [][] array in row-major format
      Returns:
      a dense double data object with SI values for vectors, matrices and tables
      Throws:
      IllegalArgumentException - when the size of the data object is not equal to rows*cols

    • rows

      public int rows()
      Description copied from interface: DataGridSi
      Return the number of rows in the grid.
      Specified by:
      rows in interface DataGridSi<DenseDoubleDataSi>
      Returns:
      the number of rows in the grid

    • cols

      public int cols()
      Description copied from interface: DataGridSi
      Return the number of columns in the grid.
      Specified by:
      cols in interface DataGridSi<DenseDoubleDataSi>
      Returns:
      the number of columns in the grid

    • isDense

      public boolean isDense()
      Description copied from interface: DataGridSi
      Return whether the data is dense.
      Specified by:
      isDense in interface DataGridSi<DenseDoubleDataSi>
      Returns:
      whether the data is dense

    • isDouble

      public boolean isDouble()
      Description copied from interface: DataGridSi
      Return whether the data is double precision.
      Specified by:
      isDouble in interface DataGridSi<DenseDoubleDataSi>
      Returns:
      whether the data is double precision

    • get

      public double get(int row, int col)
      Description copied from interface: DataGridSi
      Return element (row, col) from the grid as a double value, independent of the fact whether it is stored as a double. Note that row and col are 0-based for fast calculations.
      Specified by:
      get in interface DataGridSi<DenseDoubleDataSi>
      Parameters:
      row - the row number (0-based)
      col - the column number (0-based)
      Returns:
      element (row, col) from the grid as a double value

    • unsafeSiArray

      public double[] unsafeSiArray()
      Description copied from interface: DataGridSi
      Return the data in row-major format. When the data is available in the correct format, NO safe copy is made.
      Specified by:
      unsafeSiArray in interface DataGridSi<DenseDoubleDataSi>
      Returns:
      the data in row-major format

    • getSiArray

      public double[] getSiArray()
      Description copied from interface: DataGridSi
      Return a safe copy of the data in row-major format.
      Specified by:
      getSiArray in interface DataGridSi<DenseDoubleDataSi>
      Returns:
      the data in row-major format

    • copy

      public DenseDoubleDataSi copy()
      Description copied from interface: DataGridSi
      Return a deep copy of the DataGrid object.
      Specified by:
      copy in interface DataGridSi<DenseDoubleDataSi>
      Returns:
      a deep copy of the DataGrid object

    • nonZeroCount

      public int nonZeroCount()
      Description copied from interface: DataGridSi
      Compute and return the number of non-zero cells in this indexed value. Counts entries that are not exactly 0.0 (including -0.0 as zero). NaN and infinite values are counted as non-zero.
      Specified by:
      nonZeroCount in interface DataGridSi<DenseDoubleDataSi>
      Returns:
      the number of non-zero cells

    • instantiateNew

      public DenseDoubleDataSi instantiateNew(double[] newData)
      Description copied from interface: DataGridSi
      Instantiate a new version of the DataGrid object with the given data and the same number of rows and columns.
      Specified by:
      instantiateNew in interface DataGridSi<DenseDoubleDataSi>
      Parameters:
      newData - the data in row-major format
      Returns:
      a new version of the DataGrid object with the given data, same number of rows and columns

    • instantiateNew

      public DenseDoubleDataSi instantiateNew(double[] newData, int newRows, int newCols)
      Description copied from interface: DataGridSi
      Instantiate a new version of the DataGrid object with the given data and the given number of rows and columns.
      Specified by:
      instantiateNew in interface DataGridSi<DenseDoubleDataSi>
      Parameters:
      newData - the data in row-major format
      newRows - the new number of rows
      newCols - the new number of columms
      Returns:
      a new version of the DataGrid object with the given data, new number of rows and columns

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object