cern.colt.matrix.AbstractMatrix Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of parallelcolt Show documentation

Parallel Colt is a multithreaded version of Colt - a library for high performance scientific computing in Java. It contains efficient algorithms for data analysis, linear algebra, multi-dimensional arrays, Fourier transforms, statistics and histogramming.

The newest version!

/*
Copyright (C) 1999 CERN - European Organization for Nuclear Research.
Permission to use, copy, modify, distribute and sell this software and its documentation for any purpose 
is hereby granted without fee, provided that the above copyright notice appear in all copies and 
that both that copyright notice and this permission notice appear in supporting documentation. 
CERN makes no representations about the suitability of this software for any purpose. 
It is provided "as is" without expressed or implied warranty.
 */
package cern.colt.matrix;

/**
 * Abstract base class for arbitrary-dimensional matrices holding objects or
 * primitive data types such as int, float, etc. First
 * see the package summary and javadoc tree view to get the broad picture.
 * 
 * Note that this implementation is not synchronized.
 * 
 * @author [email protected]
 * @version 1.0, 09/24/99
 */
public abstract class AbstractMatrix extends cern.colt.PersistentObject {
    private static final long serialVersionUID = 1L;

    protected boolean isNoView = true;

    // public static boolean debug = true;
    /**
     * Makes this class non instantiable, but still let's others inherit from
     * it.
     */
    protected AbstractMatrix() {
    }

    /**
     * Ensures that the receiver can hold at least the specified number of
     * non-zero (non-null) cells without needing to allocate new internal
     * memory. If necessary, allocates new internal memory and increases the
     * capacity of the receiver.
     * 

     * This default implementation does nothing. Override this method if
     * necessary.
     * 
     * @param minNonZeros
     *            the desired minimum number of non-zero (non-null) cells.
     */
    public void ensureCapacity(int minNonZeros) {
    }

    /**
     * Returns whether the receiver is a view or not.
     */
    public boolean isView() {
        return !this.isNoView;
    }

    /**
     * Returns the number of cells.
     */
    public abstract long size();

    /**
     * Releases any superfluous internal memory. An application can use this
     * operation to minimize the storage of the receiver.
     * 
     * This default implementation does nothing. Override this method if
     * necessary.
     */
    public void trimToSize() {
    }
}