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,
| Modifier and Type | Field and Description |
|---|---|
protected Object[] |
elements
The elements of this matrix.
|
size, stride, zeroisNoViewserialVersionUID| Modifier | Constructor and Description |
|---|---|
|
DenseObjectMatrix1D(int size)
Constructs a matrix with a given number of cells.
|
protected |
DenseObjectMatrix1D(int size,
Object[] elements,
int zero,
int stride)
Constructs a matrix view with the given parameters.
|
|
DenseObjectMatrix1D(Object[] values)
Constructs a matrix with a copy of the given values.
|
| Modifier and Type | Method and Description |
|---|---|
ObjectMatrix1D |
assign(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]).
|
Object |
getQuick(int index)
Returns the matrix cell value at coordinate index.
|
protected boolean |
haveSharedCellsRaw(ObjectMatrix1D other)
Returns true if both matrices share at least one identical cell.
|
protected int |
index(int rank)
Returns the position of the element with the given relative rank within the (virtual or non-virtual) internal 1-dimensional array.
|
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,
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(Object[] values)
Fills the cell values into the specified 1-dimensional array.
|
protected ObjectMatrix1D |
viewSelectionLike(int[] offsets)
Construct and returns a new selection view.
|
aggregate, aggregate, assign, cardinality, copy, equals, equals, get, getContent, getNonZeros, haveSharedCells, like, set, toArray, toString, view, viewFlip, viewPart, viewSelection, viewSelection, viewSorted, viewStrides_offset, _rank, checkIndex, checkIndexes, checkRange, checkSize, checkSize, setUp, setUp, size, stride, toStringShort, vFlip, vPart, vStridesensureCapacity, isView, trimToSizecloneprotected Object[] elements
public DenseObjectMatrix1D(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.IllegalArgumentException - if size<0.protected DenseObjectMatrix1D(int size,
Object[] elements,
int zero,
int stride)
size - the number of cells the matrix shall have.elements - the cells.zero - the index of the first element.stride - the number of indexes between any two elements, i.e. index(i+1)-index(i).IllegalArgumentException - if size<0.public ObjectMatrix1D assign(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.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).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,IllegalArgumentException - if size() != y.size().Functionspublic 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.protected boolean haveSharedCellsRaw(ObjectMatrix1D other)
haveSharedCellsRaw in class ObjectMatrix1Dprotected int index(int rank)
index in class AbstractMatrix1Drank - the rank of the element.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,
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 ObjectMatrix1DIllegalArgumentException - if size() != other.size().public void toArray(Object[] values)
toArray in class ObjectMatrix1DIllegalArgumentException - if values.length < size().protected ObjectMatrix1D viewSelectionLike(int[] offsets)
viewSelectionLike in class ObjectMatrix1Doffsets - the offsets of the visible elements.Copyright © 2006–2019 SYSTAP, LLC DBA Blazegraph. All rights reserved.