public class DenseObjectMatrix1D extends ObjectMatrix1D
Implementation:
Internally holds one single contigous one-dimensional array. Note that this implementation is not synchronized.
Memory requirements:
memory [bytes] = 8*size(). Thus, a 1000000 matrix uses 8 MB.
Time complexity:
O(1) (i.e. constant time) for the basic operations get, getQuick, set, setQuick and size,
serialVersionUID| Constructor and Description |
|---|
DenseObjectMatrix1D(int size)
Constructs a matrix with a given number of cells.
|
DenseObjectMatrix1D(java.lang.Object[] values)
Constructs a matrix with a copy of the given values.
|
| Modifier and Type | Method and Description |
|---|---|
ObjectMatrix1D |
assign(java.lang.Object[] values)
Sets all cells to the state specified by values.
|
ObjectMatrix1D |
assign(ObjectFunction function)
Assigns the result of a function to each cell; x[i] = function(x[i]).
|
ObjectMatrix1D |
assign(ObjectMatrix1D source)
Replaces all cell values of the receiver with the values of another matrix.
|
ObjectMatrix1D |
assign(ObjectMatrix1D y,
ObjectObjectFunction function)
Assigns the result of a function to each cell; x[i] = function(x[i],y[i]).
|
java.lang.Object |
getQuick(int index)
Returns the matrix cell value at coordinate index.
|
ObjectMatrix1D |
like(int size)
Construct and returns a new empty matrix of the same dynamic type as the receiver, having the specified size.
|
ObjectMatrix2D |
like2D(int rows,
int columns)
Construct and returns a new 2-d matrix of the corresponding dynamic type, entirelly independent of the receiver.
|
void |
setQuick(int index,
java.lang.Object value)
Sets the matrix cell at coordinate index to the specified value.
|
void |
swap(ObjectMatrix1D other)
Swaps each element this[i] with other[i].
|
void |
toArray(java.lang.Object[] values)
Fills the cell values into the specified 1-dimensional array.
|
aggregate, aggregate, assign, cardinality, copy, equals, equals, get, getNonZeros, like, set, toArray, toString, viewFlip, viewPart, viewSelection, viewSelection, viewSorted, viewStridescheckSize, size, toStringShortensureCapacity, trimToSizeclonepublic DenseObjectMatrix1D(java.lang.Object[] values)
values - The values to be filled into the new matrix.public DenseObjectMatrix1D(int size)
size - the number of cells the matrix shall have.java.lang.IllegalArgumentException - if size<0.public ObjectMatrix1D assign(java.lang.Object[] values)
The values are copied. So subsequent changes in values are not reflected in the matrix, and vice-versa.
assign in class ObjectMatrix1Dvalues - the values to be filled into the cells.java.lang.IllegalArgumentException - if values.length != size().public ObjectMatrix1D assign(ObjectFunction function)
Example:
// change each cell to its sine matrix = 0.5 1.5 2.5 3.5 matrix.assign(cern.jet.math.Functions.sin); --> matrix == 0.479426 0.997495 0.598472 -0.350783For further examples, see the package doc.
assign in class ObjectMatrix1Dfunction - a function object taking as argument the current cell's value.Functionspublic ObjectMatrix1D assign(ObjectMatrix1D source)
assign in class ObjectMatrix1Dsource - the source matrix to copy from (may be identical to the receiver).java.lang.IllegalArgumentException - if size() != other.size().public ObjectMatrix1D assign(ObjectMatrix1D y, ObjectObjectFunction function)
Example:
// assign x[i] = x[i]y[i]
m1 = 0 1 2 3;
m2 = 0 2 4 6;
m1.assign(m2, cern.jet.math.Functions.pow);
-->
m1 == 1 1 16 729
// for non-standard functions there is no shortcut:
m1.assign(m2,
new ObjectObjectFunction() {
public Object apply(Object x, Object y) { return Math.pow(x,y); }
}
);
For further examples, see the package doc.assign in class ObjectMatrix1Dy - the secondary matrix to operate on.function - a function object taking as first argument the current cell's value of this,
and as second argument the current cell's value of y,java.lang.IllegalArgumentException - if size() != y.size().Functionspublic java.lang.Object getQuick(int index)
Provided with invalid parameters this method may return invalid objects without throwing any exception. You should only use this method when you are absolutely sure that the coordinate is within bounds. Precondition (unchecked): index<0 || index>=size().
getQuick in class ObjectMatrix1Dindex - the index of the cell.public ObjectMatrix1D like(int size)
like in class ObjectMatrix1Dsize - the number of cell the matrix shall have.public ObjectMatrix2D like2D(int rows, int columns)
like2D in class ObjectMatrix1Drows - the number of rows the matrix shall have.columns - the number of columns the matrix shall have.public void setQuick(int index,
java.lang.Object value)
Provided with invalid parameters this method may access illegal indexes without throwing any exception. You should only use this method when you are absolutely sure that the coordinate is within bounds. Precondition (unchecked): index<0 || index>=size().
setQuick in class ObjectMatrix1Dindex - the index of the cell.value - the value to be filled into the specified cell.public void swap(ObjectMatrix1D other)
swap in class ObjectMatrix1Djava.lang.IllegalArgumentException - if size() != other.size().public void toArray(java.lang.Object[] values)
toArray in class ObjectMatrix1Djava.lang.IllegalArgumentException - if values.length < size().Jump to the Colt Homepage