Parallel Colt 0.7.2

cern.colt.matrix.tint
Class IntFactory3D

java.lang.Object
  extended by cern.colt.PersistentObject
      extended by cern.colt.matrix.tint.IntFactory3D
All Implemented Interfaces:
Serializable, Cloneable

public class IntFactory3D
extends PersistentObject

Factory for convenient construction of 3-d matrices holding int cells. Use idioms like IntFactory3D.dense.make(4,4,4) to construct dense matrices, IntFactory3D.sparse.make(4,4,4) to construct sparse matrices. If the factory is used frequently it might be useful to streamline the notation. For example by aliasing:

  IntFactory3D F = IntFactory3D.dense;
  F.make(4,4,4);
  F.descending(10,20,5);
  F.random(4,4,5);
  ...
 

Version:
1.0, 09/24/99
Author:
wolfgang.hoschek@cern.ch
See Also:
Serialized Form

Field Summary
static IntFactory3D dense
          A factory producing dense matrices.
static IntFactory3D sparse
          A factory producing sparse matrices.
 
Fields inherited from class cern.colt.PersistentObject
serialVersionUID
 
Method Summary
 IntMatrix3D ascending(int slices, int rows, int columns)
          Constructs a matrix with cells having ascending values.
 IntMatrix3D descending(int slices, int rows, int columns)
          Constructs a matrix with cells having descending values.
 IntMatrix3D make(int[][][] values)
          Constructs a matrix with the given cell values.
 IntMatrix3D make(int slices, int rows, int columns)
          Constructs a matrix with the given shape, each cell initialized with zero.
 IntMatrix3D make(int slices, int rows, int columns, int initialValue)
          Constructs a matrix with the given shape, each cell initialized with the given value.
 IntMatrix3D random(int slices, int rows, int columns)
          Constructs a matrix with uniformly distributed values in (0,1) (exclusive).
 
Methods inherited from class cern.colt.PersistentObject
clone
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

dense

public static final IntFactory3D dense
A factory producing dense matrices.


sparse

public static final IntFactory3D sparse
A factory producing sparse matrices.

Method Detail

ascending

public IntMatrix3D ascending(int slices,
                             int rows,
                             int columns)
Constructs a matrix with cells having ascending values. For debugging purposes.


descending

public IntMatrix3D descending(int slices,
                              int rows,
                              int columns)
Constructs a matrix with cells having descending values. For debugging purposes.


make

public IntMatrix3D make(int[][][] values)
Constructs a matrix with the given cell values. values is required to have the form values[slice][row][column] and have exactly the same number of slices, rows and columns as the receiver.

The values are copied. So subsequent changes in values are not reflected in the matrix, and vice-versa.

Parameters:
values - the values to be filled into the cells.
Returns:
this (for convenience only).
Throws:
IllegalArgumentException - if values.length != slices() || for any 0 <= slice < slices(): values[slice].length != rows() .
IllegalArgumentException - if for any 0 <= column < columns(): values[slice][row].length != columns() .

make

public IntMatrix3D make(int slices,
                        int rows,
                        int columns)
Constructs a matrix with the given shape, each cell initialized with zero.


make

public IntMatrix3D make(int slices,
                        int rows,
                        int columns,
                        int initialValue)
Constructs a matrix with the given shape, each cell initialized with the given value.


random

public IntMatrix3D random(int slices,
                          int rows,
                          int columns)
Constructs a matrix with uniformly distributed values in (0,1) (exclusive).


Parallel Colt 0.7.2

Jump to the Parallel Colt Homepage