A B C D E F G H I J L M N O P Q R S T U V Z

A

ABSTRACT_FILTER - Static variable in class org.jutil.java.reflect.Methods
 
AbstractRevision - class org.jutil.junit.AbstractRevision.
A class that implements the non-basic methods of Revision.
AbstractRevision() - Constructor for class org.jutil.junit.AbstractRevision
 
AbstractSolver - class org.jutil.math.matrix.AbstractSolver.
A helper class for classes that solve systems of equations using matrices.
AbstractSolver() - Constructor for class org.jutil.math.matrix.AbstractSolver
 
accumulate(Collection) - Method in class org.jutil.java.collections.Accumulator
public behavior

pre (\forall Object o, collection.contains(o); isValidElement(o));

post (* the result of the accumulation is returned *);
post collection == null => \result == initialAccumulator();

signals (ConcurrentModificationException) (* The collection was modified while accumulating *);
accumulate(Object, boolean) - Method in class org.jutil.java.collections.BooleanAccumulator
public behavior

pre isValidElement(element);
accumulate(Object, boolean) - Method in class org.jutil.java.collections.ForAll
also public behavior

post \result == (acc && criterion(element));
accumulate(Object, boolean) - Method in class org.jutil.java.collections.Exists
also public behavior

post \result == acc || criterion(element);
accumulate(Object, int) - Method in class org.jutil.java.collections.IntegerAccumulator
// The given element may not be null
pre element != null;
accumulate(Object, int) - Method in class org.jutil.java.collections.Counter
also public behavior

// If the element satisfies the criterion, acc + 1 is returned to
// indicate 1 more element satisfies the criterion.
// otherwise acc is returned.
post criterion(element) == false ==> \result == acc;
post criterion(element) == true ==> \result == acc + 1;
accumulate(Object, Object) - Method in class org.jutil.java.collections.Accumulator
public behavior

pre isValidElement(element);
Accumulator - class org.jutil.java.collections.Accumulator.
A class of objects that accumulate over a collection.
Accumulator() - Constructor for class org.jutil.java.collections.Accumulator
 
add(ApplicabilityNotifier) - Method in class org.jutil.event.ChainNotifier
public behavior
assignable notifiers if notifier != null;
post notifier != null ==>
notifiers.equals(\old(notifiers.insertBack(notifier)));
Appends the specified element to the end of this list.
add(EventListener) - Method in class org.jutil.event.EventSourceSupport
public behavior
pre listener != null ==> isValidListener(listener);
assignable listeners;
// The given Listener is now in the set of listeners, if it is not null.
post listener != null ==> listeners.equals(\old(listeners.insert(listener)));
ensures_redundantly listener != null ==> listeners.has(listener);
Add an event Listener to the listeners to be notified by this.
add(int, ApplicabilityNotifier) - Method in class org.jutil.event.ChainNotifier
public behavior
assignable notifiers if notifier != null;
post notifier != null ==>
notifiers.equals(\old(notifiers.
insertBeforeIndex(index, notifier)));
signals (IndexOutOfBoundsException)
(index < 0) || (index >= notifiers.length());
Inserts the specified element at the specified position in this list.
add(Matrix) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre other != null;
pre sameDimensions(other);

post (\forall int i; i>=1 && i <= getNbRows();
(\forall int j; j>=1 && j <= getNbColumns();
elementAt(i,j) ==
\old(elementAt(i,j)) + other.elementAt(i,j)));
Add the given matrix to this matrix.
add(Object) - Method in class org.jutil.java.collections.SkipListPQ
See superclass.
add(Object) - Method in class org.jutil.java.collections.SkipList
See superclass
add(Object) - Method in interface org.jutil.java.collections.PriorityQueue
public behavior

pre element != null;

post nbExplicitOccurrences(element) == \old(nbExplicitOccurrences(element)) + 1;
Add the given object to this PriorityQueue.
add(Object) - Method in class org.jutil.java.collections.BinomialHeap
See superclass.
add(Object) - Method in class org.jutil.java.collections.Singleton
also public behavior

post false;
exception UnsupportedOperationException true;
See superclass
add(StructureElement) - Method in class org.jutil.structure.StructureSet
public behavior

pre element != null;

post element.getStructuredSet() == this;
post \old(element.getStructuredSet()) != null &&
\old(element.getStructuredSet()) != this ==>
! \old(element.getStructuredSet()).contains(element);
post contains(element);
Remove the given StructureElement from this StructureSet.
addAll(Collection) - Method in class org.jutil.java.collections.Singleton
also public behavior

post false;
exception UnsupportedOperationException true;
See superclass
AndFilter - class org.jutil.java.collections.AndFilter.
The effect of this filter is the same as of a filter with the conjunction of the criteria of the filters it was build with.
AndFilter(Filter[]) - Constructor for class org.jutil.java.collections.AndFilter
public behavior

// The given array of filters may not be null.
pre filters != null;
// The given array may only contain effective Filter objects
pre (\forall int i; (i>=0) && (i
// The filters of this AndFilter are set to the given filters.
post Arrays.equals(getFilters(),filters);
ApplicabilityNotifier - interface org.jutil.event.ApplicabilityNotifier.
Instances of this type add the posibility for users to ask whether the instance is applicable to a given listener/event combination.
applyFromTo(Collection, Collection) - Method in class org.jutil.java.collections.Mapping
public behavior

pre (\forall Object o, fromCollection.contains(o); isValidElement(o));

// The elements are mapped into according to the
// mapping under public Object mapping(Object).
post (\forall Object o; fromCollection.contains(o);
\result.contains(mapping(o))) &&
(\forall Object o; toCollection.contains(o);
(\exists Object o2; fromCollection.contains(o2);
o.equals(mapping(o2))));
// is changed and returned
post \result == toCollection;

signals (ConcurrentModificationException) (* The collection was modified while mapping *);
applyTo(Collection) - Method in class org.jutil.java.collections.RobustVisitor
public behavior

pre (\forall Object o, collection.contains(o); isValidElement(o));

// The changes are applied to the given collection,
// which is returned afterwards
post \result == collection;
// public void visit(Object) is called for all
// elements of .
post (* for all e in collection: visit(e) *);

signals (ConcurrentModificationException) (* The collection was modified while visiting.
applyTo(Collection) - Method in class org.jutil.java.collections.Mapping
public behavior

pre (\forall Object o, collection.contains(o); isValidElement(o));

// The elements of the given set are replaced by their mapping under
// public Object mapping(Object).
post (\forall Object o; collection.contains(o);
\result.contains(mapping(o))) &&
(\forall Object o; \result.contains(o);
(\exists Object o2; collection.contains(o2);
mapping(o2).equals(o)));
post collection.size() == \old(collection.size());
// The given collection is changed and returned
post \result == collection;

signals (ConcurrentModificationException) (* The collection was modified while mapping *);
applyTo(Collection) - Method in class org.jutil.java.collections.Visitor
public behavior

pre (\forall Object o, collection.contains(o); isValidElement(o));

// The changes are applied to the given collection,
// which is returned afterwards
post \result == collection;

// public void visit(Object) is called for all elements.
post (* for all e in collection: visit(e) *);

signals (ConcurrentModificationException)
(* The collection was modified while calculating the tranitive closure.
applyTo(Enumeration) - Method in class org.jutil.java.collections.RobustVisitor
pre (* The enumeration must be at the beginning of its enumeration.
applyTo(Enumeration) - Method in class org.jutil.java.collections.Visitor
pre (* The enumeration must be at the beginning of its enumeration.
applyTo(Iterator) - Method in class org.jutil.java.collections.RobustVisitor
pre (* The iterator must be at the beginning of its iteration.
applyTo(Iterator) - Method in class org.jutil.java.collections.Visitor
pre (* The iterator must be at the beginning of its iteration.
applyTo(Map) - Method in class org.jutil.java.collections.MapVisitor
public behavior

pre (\forall Map.Entry entry; map.entrySet().contains(entry);
isValidPair(entry.getKey(), entry.getValue()));

// code>public void visit(Object) is called for all elements of
post (* for all k, for all v: (map.containsKey(k) and (map.get(k) = v) ==> visit(k, v) *)
// The changes are applied to the given set and it is returned afterwards.
post \result == map;

signals (ConcurrentModificationException) (* The collection was modified while performing the visit.
applyTo(Map) - Method in class org.jutil.java.collections.RobustMapVisitor
public behavior

pre (\forall Map.Entry entry; map.entrySet().contains(entry);
isValidPair(entry.getKey(), entry.getValue()));

// The changes are applied to the given set and it is returned afterwards.
post \result == map;
post (* public void visit(Object) is called for all elements of
.
| for all k, for all v: (map.containsKey(k) and (map.get(k) = v))
==> visit(k, v) *);

signals (ConcurrentModificationException) (* The collection was modified while visiting the map.
applyTo(Object[]) - Method in class org.jutil.java.collections.RobustVisitor
// The changes are applied to the given array,
// which is returned afterwards
post \result == array;
// public void visit(Object) is called for all
// elements of .
post (* for all e in collection: visit(e) *);

signals (Exception)
(* Something has gone wrong during the visit *);
applyTo(Object[]) - Method in class org.jutil.java.collections.Visitor
// The changes are applied to the given object array,
// which is returned afterwards
post \result == array;
areInSamePackage(Class, Class) - Static method in class org.jutil.java.reflect.Classes
// The types to compare are not null.
pre (t1 != null) && (t2 != null);

// The result is true if the 2 given classes are defined
// in the same package.
ArrayCursor - class org.jutil.java.collections.ArrayCursor.
A class of objects that point to a certain index in a multi-dimensional array.
ArrayCursor(Object[]) - Constructor for class org.jutil.java.collections.ArrayCursor
// An ArrayCursor can not have null as dimensions.
public invariant getDimensions() != null;

// Dimensions can only have positive sizes.
public invariant (\forall int i; i >= 0 && i getDimensions()[i] > 0);

// The dimensions of a cursor are the dimension of its array.
public invariant getDimensions().equals(Arrays.getArrayDimensions(array));

// An ArrayCursor can not have null as cursor.
public invariant getCursor() != null;

// The cursor of an ArrayCursor has the same number of elements as
// there are dimensions
public invariant getCursor().length == getDimensions().length;

// An ArrayCursor can only point to a valid index for the
// represented array
public invariant (\forall int i; i >= 0 && i (getCursor()[i] >= 0) && (getCursor()[i] < getDimensions()[i]));

public model Object[] array;

// may not be null.
pre array != null;

// The dimensions of the new ArrayCursor are set to the
// dimensions of .
post getDimensions().equals(Arrays.getArrayDimensions(theArray));
// The array of this ArrayCursor is set to
post array == theArray;
Initialize a new ArrayCursor for a given array of objects.
Arrays - class org.jutil.java.collections.Arrays.
A class with static methods for arrays
Arrays() - Constructor for class org.jutil.java.collections.Arrays
 
asList(Throwable) - Static method in class org.jutil.java.throwable.StackTrace
pre t != null;

// The result is not null.
// The result does not contain null references.
post (\result != null) &&
(\forall Object o;\result.contains(o); o != null) &&
(\forall Object o;\result.contains(o); o instanceof String);
atEnd() - Method in class org.jutil.java.collections.ObjectArrayIterator
Check whether this iterator is positioned at the end of its array Result True if this iterator is positioned at the end of its array, false otherwise.
atEnd() - Method in class org.jutil.java.collections.ArrayCursor
// True if the elements in the cursor are equal to
// the maximum size of their dimension - 1 or if
// at least 1 dimension has size 0
post \result == (\forall int i; i>=0 && i < getCursor().length;
getCursor()[i]==getDimensions()[i]-1) ||
(\exists int i; i>=0 && i < getDimensions().length;
getDimensions()[i]==0);
Check whether this cursor points to the end of the array.
atStart() - Method in class org.jutil.java.collections.ObjectArrayIterator
Check whether this iterator is positioned at the beginning of its array Result True if this iterator is positioned at the beginning of its array, false otherwise.
atStart() - Method in class org.jutil.java.collections.ArrayCursor
// True if the cursor only contains 0's.
post \result == (\forall int i; i>=0 && i < getCursor().length;
getCursor()[i]==0);
Check whether this cursor points to the beginning of the array.

B

backSubstitute(Matrix, Column) - Method in class org.jutil.math.matrix.AbstractSolver
public behavior

pre R != null;
pre b != null;
pre R.isSquare();
pre R.isUpperTriangular;
pre b.size() == R.getNbRows();
pre (* R is nonsingular *);

post (* R.times(\result).equals(b) *);
BinomialHeap - class org.jutil.java.collections.BinomialHeap.
A BinomialHeap is a Heap that consists of a forest of Binomial Trees.
BinomialHeap(Comparator) - Constructor for class org.jutil.java.collections.BinomialHeap
public behavior

pre comparator != null;

post getComparator() == comparator;
post size() == 0;
Initialize a new BinomialHeap with the given comparator.
BinomialHeap(Comparator, Object) - Constructor for class org.jutil.java.collections.BinomialHeap
public behavior

pre comparator != null;
pre element != null;

post getComparator() == comparator;
post nbExplicitOccurrences(element) == 1;
post size() == 1;
Initialize a new BinomialHeap with the given comparator and element.
BlockingFifoList - class org.jutil.java.collections.BlockingFifoList.
Synchronized fifo list that will block the request to pop the first object until a first object is present.
BlockingFifoList() - Constructor for class org.jutil.java.collections.BlockingFifoList
public behavior

post size() == 0;
Initialize a new empty blocking fifo list.
BooleanAccumulator - class org.jutil.java.collections.BooleanAccumulator.
A boolean accumulator for collections.
BooleanAccumulator() - Constructor for class org.jutil.java.collections.BooleanAccumulator
 

C

ChainNotifier - class org.jutil.event.ChainNotifier.
 
ChainNotifier() - Constructor for class org.jutil.event.ChainNotifier
public behavior
assignable notifiers;
post notifiers.isEmpty();
CholeskyDecomposer - interface org.jutil.math.matrix.CholeskyDecomposer.
A class of objects that compute the Cholesky factorization of a symmetric matrix.
CholeskyDecomposition - interface org.jutil.math.matrix.CholeskyDecomposition.
This class represents a Cholesky factorization of a symmetric matrix.
Classes - class org.jutil.java.reflect.Classes.
Utility methods for class reflection.
Classes() - Constructor for class org.jutil.java.reflect.Classes
 
clear() - Method in class org.jutil.java.collections.SkipListPQ
See superclass.
clear() - Method in class org.jutil.java.collections.SkipList
See superclass
clear() - Method in interface org.jutil.java.collections.PriorityQueue
public behavior

post isEmpty();
Remove all elements.
clear() - Method in class org.jutil.java.collections.FifoList
See superclass/
clear() - Method in class org.jutil.java.collections.BlockingFifoList
See superclass/
clear() - Method in class org.jutil.java.collections.SynchronizedFifoList
See superclass/
clear() - Method in interface org.jutil.java.collections.Fifo
public behavior

post size() == 0;
Clear the list.
clear() - Method in class org.jutil.java.collections.BinomialHeap
See superclass
clear() - Method in class org.jutil.java.collections.Singleton
also public behavior

post false;
exception UnsupportedOperationException true;
See superclass
clear() - Method in class org.jutil.event.ChainNotifier
public behavior
assignable notifiers;
post notifiers.isEmpty();
clone() - Method in class org.jutil.math.matrix.Matrix
public behavior

post equals(\result);
post \result instanceof Matrix;
Return a clone
clone() - Method in class org.jutil.math.matrix.Column
also public behavior

post \result instanceof Column;
See superclass
closure(Object) - Method in class org.jutil.java.collections.TransitiveClosure
// The given node may not be null.
pre startNode != null ;

post \result.equals(closureFromAll(new Singleton(o)));

signals (ConcurrentModificationException)
(* The collection was modified while calculating the tranitive closure.
closureFromAll(Set) - Method in class org.jutil.java.collections.TransitiveClosure
// The given set may not be null
pre startSet != null;
// The given set may not contain null references.
pre (\forall Object o ; startSet.contains(o) ; o != null);

// The result is effective.
post \result != null
// The transitive closure is the set of all nodes that can be reached from
// a start set of nodes via connections defined by
// public Set getConnectedNodes(Object node).
post isNaiveClosure(startSet, \result);
// Least Fixed Point
post (\forall Set cn;
(cn != null) && isNaiveClosure(startSet, cn);
(\result.size() <= cn.size()));
post_redundantly (\forall Object o; \result.contains(o); o != null);

signals (ConcurrentModificationException)
(* The collection was modified while calculating the tranitive closure.
CollectionOperator - interface org.jutil.java.collections.CollectionOperator.
CollectionOperator is the toplevel interface for collection operators.
Collections - class org.jutil.java.collections.Collections.
A utility class for perform operations on collections similar to java.util.Collections.
Collections() - Constructor for class org.jutil.java.collections.Collections
 
Column - class org.jutil.math.matrix.Column.
A class of matrices containing only 1 column.
Column(double[]) - Constructor for class org.jutil.math.matrix.Column
pre elements != 0
pre elements.length > 0

post size() == elements.length
post (\forall int i; i>0 && i <= size();
elementAt(i) == elements[i-1]);
Create a new Column with the given elements.
Column(int) - Constructor for class org.jutil.math.matrix.Column
public invariant getNbColumns() == 1;

pre size > 0;

post size() == size;
post (\forall int i; i > 0 && i <= size();
elementAt(i) == 0);
Create a new Column with the given size.
ComparableComparator - class org.jutil.java.collections.ComparableComparator.
Trivial Comparator that uses the Comparable interface of objects to compare.
ComparableComparator() - Constructor for class org.jutil.java.collections.ComparableComparator
 
compare(Object, Object) - Method in class org.jutil.java.collections.InverseComparator
public behavior

post \result == -getComparator().compare(first, second);
Return the inverse of the what the inverted comparator would return.
compare(Object, Object) - Method in class org.jutil.java.collections.ComparableComparator
public behavior

pre o1 instanceof Comparable;

post \result == ((Comparable)o1).compareTo(o2);
See superclass.
connectTo(StructureSet) - Method in class org.jutil.structure.StructureElement
public behavior

post getStructureSet() == set;
// If this StructureElement was connected before, and will now be
// connected to another StructureSet, it will be removed from the first one.
post \old(getStructureSet()) != null && \old(getStructureSet()) != set =>
! \old(getStructureSet()).contains(this);
post set != null ==> set.contains(this);
Set the 1 side of this 10n binding.
contains(ApplicabilityNotifier) - Method in class org.jutil.event.ChainNotifier
public behavior
post \result == notifiers.has(notifier);
contains(Object) - Method in class org.jutil.java.collections.SkipList
See superclass
contains(Object) - Method in class org.jutil.java.collections.Singleton
also public behavior

post \result ==
((getOnlyElement() == null) && (o == null)) ||
getOnlyElement().equals(o);
See superclass
contains(StructureElement) - Method in class org.jutil.structure.StructureSet
Check whether or not the given element is connected to this StructureSet.
containsExplicitly(Collection, Object) - Static method in class org.jutil.java.collections.Collections
public invariant_redundantly
(\forall Collection c; c != null;
(\forall Object o1; c.contains(o1);
(\exists Object o2; containsEplicitly(c, o2);
((o1 == null) && (o2 == null)) ||
((o1 != null) && (o1.equals(o2)))));

public invariant_redundantly
(\forall Collection c; c!= null;
(\forall Object o2; containsEplicitly(collection, o2);
c.contains(o2)));

public behavior

pre collection != null;

post \result == (\exists int i; i >= 0 && i < collection.toArray().length;
collection.toArray()[i] == element);
Check whether or not the given collection contains the given element when using == for comparison instead of equals().
copy(File, File) - Static method in class org.jutil.java.io.File
public behavior

pre source != null;
pre destination != null;
// both files must be different
pre ! source.getCanonicalPath().equals(destination.getCanonicalPath());

post (* The source file is copied to the destination file *);

signals (FileNotFoundException) (* The source file does not exist, is a directory
or not readable *);
signals (FileNotFoundException) (* The destination file does not exist and can not
be create, is a directory or exists, but is not
writable *);
signals (SecurityException) (* The source file may not be read from *);
signals (SecurityException) (* The destination file may not be writen to *);
signals (IOException) (* An IO errors occurs *);
Copies the given source file to the given destination file.
copyTo(File) - Method in class org.jutil.java.io.File
public behavior

pre destination != null;
// both files must be different
pre ! getCanonicalPath().equals(destination.getCanonicalPath());

post (* This file is copied to the destination file *);

signals (FileNotFoundException) (* This file does not exist, is a directory
or not readable *);
signals (FileNotFoundException) (* The destination file does not exist and can not
be create, is a directory or exists, but is not
writable *);
signals (SecurityException) (* This file may not be read from *);
signals (SecurityException) (* The destination file may not be writen to *);
signals (IOException) (* An IO errors occurs *);
Copies this file to the given destination file.
Counter - class org.jutil.java.collections.Counter.
An IntegerAccumulator that counts the number of items in a collection that satisfies some criterion.
Counter() - Constructor for class org.jutil.java.collections.Counter
 
criterion(Object) - Method in class org.jutil.java.collections.Filter
public behavior

pre isValidElement(element);
criterion(Object) - Method in class org.jutil.java.collections.ForAll
public behavior

pre isValidElement(element);

// criterion should be consistent with equals; subclass can say more
post (\forall object o1;;
(\forall object o2; o2.equals(o1); criterion(o1) == criterion(o2)));
Check whether the given object satisfies the criterion for this ForAll accumulator.
criterion(Object) - Method in class org.jutil.java.collections.Exists
also public behavior

post ! getCollection().contains(element) => \result == false;

public model boolean isValidElement(Object element);

public behavior

// criterion should be consistent with equals
post (\forall object o1;;
(\forall object o2;o2.equals(o1);criterion(o1) == criterion(o2)));

Check whether the given object satisfies the criterion for this Exists accumulator
criterion(Object) - Method in class org.jutil.java.collections.Counter
//As usual, criterion must be consistent with the semantics of equals
post (\forall Object o1;;
(\forall Object o2; o1.equals(o2);
criterion(o1) == criterion(o2)));
The criterion used to determine whether or not an element has to be counted.
criterion(Object) - Method in class org.jutil.java.collections.TypeFilter
also public behavior

// is of the desired type.
post \result == getType().isInstance(element);
See superclass
criterion(Object) - Method in class org.jutil.java.collections.AndFilter
also public behavior

post (\forall int i; i>=0 && i getFilters()[i].criterion(element));
See superclass
CVS_REVISION - Static variable in class org.jutil.java.collections.MapVisitor
 
CVS_REVISION - Static variable in class org.jutil.java.collections.TransitiveClosure
 
CVS_REVISION - Static variable in class org.jutil.java.collections.Filter
 
CVS_REVISION - Static variable in class org.jutil.java.collections.ObjectArrayIterator
 
CVS_REVISION - Static variable in class org.jutil.java.collections.Collections
 
CVS_REVISION - Static variable in interface org.jutil.java.collections.MapOperator
 
CVS_REVISION - Static variable in class org.jutil.java.collections.SkipListPQ
 
CVS_REVISION - Static variable in class org.jutil.java.collections.RobustVisitor
 
CVS_REVISION - Static variable in class org.jutil.java.collections.BooleanAccumulator
 
CVS_REVISION - Static variable in class org.jutil.java.collections.ForAll
 
CVS_REVISION - Static variable in class org.jutil.java.collections.Exists
 
CVS_REVISION - Static variable in class org.jutil.java.collections.Accumulator
 
CVS_REVISION - Static variable in class org.jutil.java.collections.RobustMapVisitor
 
CVS_REVISION - Static variable in class org.jutil.java.collections.IntegerAccumulator
 
CVS_REVISION - Static variable in class org.jutil.java.collections.Counter
 
CVS_REVISION - Static variable in class org.jutil.java.collections.Mapping
 
CVS_REVISION - Static variable in class org.jutil.java.collections.ZeroDimensionException
 
CVS_REVISION - Static variable in class org.jutil.java.collections.SkipList
 
CVS_REVISION - Static variable in class org.jutil.java.collections.Visitor
 
CVS_REVISION - Static variable in class org.jutil.java.collections.Arrays
 
CVS_REVISION - Static variable in class org.jutil.java.collections.TypeFilter
 
CVS_REVISION - Static variable in class org.jutil.java.collections.BinomialHeap
 
CVS_REVISION - Static variable in class org.jutil.java.collections.AndFilter
 
CVS_REVISION - Static variable in class org.jutil.java.collections.Singleton
 
CVS_REVISION - Static variable in class org.jutil.java.collections.ArrayCursor
 
CVS_REVISION - Static variable in interface org.jutil.java.collections.CollectionOperator
 
CVS_REVISION - Static variable in class org.jutil.java.reflect.Methods
 
CVS_REVISION - Static variable in class org.jutil.java.reflect.Classes
 
CVS_REVISION - Static variable in class org.jutil.java.throwable.StackTrace
 
CVS_REVISION - Static variable in class org.jutil.math.Math
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.ExplicitShiftQRSchurDecomposer
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.NMatrix
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.Matrix
MvDMvDMvD : some operations don't have 2 sensible names for use as a mutator and inspector.
CVS_REVISION - Static variable in class org.jutil.math.matrix.Row
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.SchurDecomposition
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.QRDecomposer
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.HouseholderQRDecomposition
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.DefaultSchurDecomposition
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.EigenvalueDecomposition
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.SchurDecomposer
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.QRLeastSquaresSolver
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.HessenbergReduction
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.HouseholderHessenbergReduction
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.LinSolver
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.QRDecomposition
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.LUDecomposition
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.PartialPivotGauss
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.CholeskyDecomposition
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.HouseholderHessenbergReducer
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.SchurEigenvalueDecomposer
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.QRLinSolver
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.SchurEigenvalueDecomposition
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.EigenvalueDecomposer
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.LULinSolver
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.CholeskyDecomposer
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.HouseholderQRDecomposer
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.HessenbergReducer
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.Column
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.LeastSquaresSolver
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.DefaultCholeskyDecomposition
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.DefaultCholeskyDecomposer
 
CVS_REVISION - Static variable in interface org.jutil.math.matrix.LUDecomposer
 
CVS_REVISION - Static variable in class org.jutil.math.matrix.DefaultLUDecomposition
 
CVS_REVISION - Static variable in class org.jutil.junit.AbstractRevision
 
CVS_REVISION - Static variable in class org.jutil.junit.JutilTest
 
CVS_REVISION - Static variable in class org.jutil.junit.CVSRevision
 
CVS_REVISION - Static variable in class org.jutil.junit.RevisionError
 
CVS_REVISION - Static variable in interface org.jutil.junit.Revision
 
CVS_REVISION - Static variable in class org.jutil.structure.StructureElement
 
CVS_REVISION - Static variable in class org.jutil.structure.DoubleBinding
 
CVS_REVISION - Static variable in class org.jutil.structure.StructureSet
 
CVS_REVISION - Static variable in interface org.jutil.event.Notifier
 
CVS_REVISION - Static variable in class org.jutil.event.TypeApplicabilityNotifier
 
CVS_REVISION - Static variable in interface org.jutil.event.ApplicabilityNotifier
 
CVS_REVISION - Static variable in class org.jutil.event.ChainNotifier
 
CVS_REVISION - Static variable in class org.jutil.event.EventSourceSupport
 
CVSRevision - class org.jutil.junit.CVSRevision.
A class of CVS revisions.
CVSRevision(String) - Constructor for class org.jutil.junit.CVSRevision
public behavior

pre revision != null;
// The revision must either be a revision number, or a CVS revision string.
// In other words : "x.x.x.x" or "$Revision: 1.4 $".
pre new Pattern("\\d*(\\.(\\d)*)*").matcher(revision).matches() ||
new Pattern("$Revision: 1.4 $").matcher(revision).matches();

post (* number i == the i'th x *);
Initialize a new CVSRevision with the given String.

D

decompose(Matrix) - Method in class org.jutil.math.matrix.ExplicitShiftQRSchurDecomposer
See superclass
decompose(Matrix) - Method in interface org.jutil.math.matrix.QRDecomposer
public behavior

pre matrix != null;
pre matrix.getNbRows() >= matrix.getNbColumns();

post \result != null;
post (* \result.Q().times(\result.R()).equals(matrix) *);
post \result.R().getNbRows() == matrix.getNbRows();
post \result.R().getNbColumns() == matrix.getNbColumns();
decompose(Matrix) - Method in interface org.jutil.math.matrix.SchurDecomposer
public behavior

pre matrix != null;
pre matrix.isSquare();

post \result != null;
post (* \result.Q().times(\result.R()).equals(matrix) *);
post \result.Q().getNbRows() == matrix.getNbRows();
decompose(Matrix) - Method in class org.jutil.math.matrix.PartialPivotGauss
See superclass
decompose(Matrix) - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposer
See superclass
decompose(Matrix) - Method in interface org.jutil.math.matrix.EigenvalueDecomposer
public behavior

pre matrix != null;
pre matrix.getNbRows() = matrix.getNbColumns();
pre (* matrix is not singular *);

post \result != null;
post (* \result.Q().times(\result.lambda()).equals(matrix) *);
post (* (\forall int i; i>=1 && i<= matrix.getNbRows();
\result.Q().times(\result.getEigenvector(i)).equals(\result.getEigenvector(i).times(\result.getEigenvalue(i))) *);
post \result.Q().getNbRows() == matrix.getNbRows();
post \result.Q().getNbColumns() == matrix.getNbColumns();
decompose(Matrix) - Method in interface org.jutil.math.matrix.CholeskyDecomposer
public behavior

pre matrix != null;
pre matrix.isSymmetric();
pre (* matrix is non-singular *);

post \result != null;
post (* \result.R().times(\result.R()).equals(matrix) *);
decompose(Matrix) - Method in class org.jutil.math.matrix.HouseholderQRDecomposer
The decomposition is done using the Householder algorithm.
decompose(Matrix) - Method in class org.jutil.math.matrix.DefaultCholeskyDecomposer
See superclass
decompose(Matrix) - Method in interface org.jutil.math.matrix.LUDecomposer
public behavior

pre matrix != null;
pre matrix.isSquare();

post \result != null;
post (* \result.L().times(\result.U()).equals(matrix) *);
post \result.L().getNbRows() == matrix.getNbRows();
DEFAULT - Static variable in class org.jutil.java.regex.Pattern
public invariant pattern() != null;
DefaultCholeskyDecomposer - class org.jutil.math.matrix.DefaultCholeskyDecomposer.
A class of objects that compute the Cholesky factorization of a symmetric matrix using the algorithm in the book of Trefethen and Bau.
DefaultCholeskyDecomposer() - Constructor for class org.jutil.math.matrix.DefaultCholeskyDecomposer
 
DefaultCholeskyDecomposition - class org.jutil.math.matrix.DefaultCholeskyDecomposition.
This class represents a Cholesky factorization of a matrix.
DefaultCholeskyDecomposition(Matrix) - Constructor for class org.jutil.math.matrix.DefaultCholeskyDecomposition
public behavior

pre R != null;
pre R.isUpperTriangular();
pre R.isSquare();

post R().equals(R);
Initialize a new DefaultCholeskyDecomposition with the given R matrix.
DefaultLUDecomposition - class org.jutil.math.matrix.DefaultLUDecomposition.
This class represents a default LU factorization of a square non-singular matrix.
DefaultLUDecomposition(Matrix, Matrix, Matrix) - Constructor for class org.jutil.math.matrix.DefaultLUDecomposition
public behavior

pre L != null;
pre L.isSquare();
pre L.isLowerTriangular();
pre (\forall int i; i>=1 && i<=L.getNbColumns();
L.elementAt(i,i) == 1);
pre U != null;
pre U.sameDimensions(L);
pre U.isUpperTriangular();
pre P != null;
pre P.isPermutationMatrix();
pre P.sameDimensions(L);

post L().equals(L);
post U().equals(U);
post P().equals(P);
Initialize a new DefaultLUDecomposition with the given L and U matrices
DefaultSchurDecomposition - class org.jutil.math.matrix.DefaultSchurDecomposition.
A class of schur decompositions of a matrix.
DefaultSchurDecomposition(Matrix, Matrix) - Constructor for class org.jutil.math.matrix.DefaultSchurDecomposition
public behavior

pre R != null;
pre R.isUpperTriangular;
pre Q != null;
pre Q.isUnary();

post R().equals(R);
post Q().equals(Q);
Initialize a new DefaultSchurDecomposition with the given R and Q matrices.
discard(Collection) - Method in class org.jutil.java.collections.Filter
public behavior

pre (\forall Object o, collection.contains(o); isValidElement(o));

// All elements that meet the criterion are removed from the collection
post collection != null ==> (\forall Object o; (o!= null) && (criterion(o)); ! \result.contains(o));
// is changed and returned.
post \result == collection;

signals (ConcurrentModificationException) (* The collection was modified while filtering *);
divide(double) - Method in class org.jutil.math.matrix.Matrix
public behavior

post (\forall int i; i>=1 && i<= getNbRows();
(\forall int j; j>=1 && j<= getNbColumns();
elementAt(i,j) == \old(elementAt(i,j)) / factor));
Divide this matrix by a given factor.
DOTALL - Static variable in class org.jutil.java.regex.Pattern
 
DoubleBinding - class org.jutil.structure.DoubleBinding.
A class of "components" for implementing a double binding.
DoubleBinding(DoubleBinding, Object) - Constructor for class org.jutil.structure.DoubleBinding
public behavior

pre object != null;

post getOtherBinding() == otherBinding;
post otherBinding != null ==> otherBinding.getOtherBinding == this;
// If was connected before to another object, that other object will
// be disconnected.
post (otherBinding != null) && \old(otherBinding.getOtherBinding()) != null ==>
\old(otherBinding.getOtherBinding()).getOtherBinding() == null;
post getObject() == object;
Initialize a new double binding connected to the given other DoubleBinding.
DoubleBinding(Object) - Constructor for class org.jutil.structure.DoubleBinding
public invariant getObject() != null;
public invariant getOtherBinding() != null =>
getOtherBinding().getOtherBinding() == this;

public behavior

pre object != null;

post getOtherBinding() == null;
post getObject() == object;
Initialize a new unconnected DoubleBinding.

E

EigenvalueDecomposer - interface org.jutil.math.matrix.EigenvalueDecomposer.
A class of objects that compute the eigenvalue factorization of a matrix.
EigenvalueDecomposition - interface org.jutil.math.matrix.EigenvalueDecomposition.
A class of eigenvalue decompositions of a matrix.
elementAt(int) - Method in class org.jutil.math.matrix.Row
pre validIndex(index);

post elementAt(1, index);
Return the element at the given index.
elementAt(int) - Method in class org.jutil.math.matrix.Column
pre validIndex(index);

post elementAt(index, 1);
Return the element at the given index
elementAt(int[]) - Method in class org.jutil.math.matrix.NMatrix
pre validIndex(index);
Return the element at the given index.
elementAt(int[]) - Method in class org.jutil.math.matrix.Matrix
 
elementAt(int, int) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre validIndex(row, column);

post elementAt({row, column});
Return the element at the given row and column.
ensureExtended(Comparator) - Static method in class org.jutil.java.collections.ExtendedComparator
public behavior

pre comparator != null;

// The result must behave exactly the same as the given comparator.
post (\forall Object o1; ;
(\forall Object o2; ;
\result.compare(o1, o2) == comparator.compare(o1, o2)));
Ensure that the result is an ExtendedComparator.
equals(Object) - Method in class org.jutil.math.matrix.Matrix
public behavior

post !(other instanceof Matrix) ==> false;
post !(sameDimensions((Matrix)other)) ==> false;
post (other instanceof Matrix) && (sameDimensions((Matrix)other)) ==>
\result == (\forall int i; i>=1 i<=getNbRows();
(\forall int j; j>=1 j<=getNbColumns();
((Matrix)\result).elementAt(i,j) ==
elementAt(i,j);
post \result != this;
Check whether the given object is equal to this matrix.
equals(Object) - Method in class org.jutil.junit.AbstractRevision
See superclass.
equals(Object) - Method in interface org.jutil.junit.Revision
public behavior

post (! (other instanceof Revision)) ==> (\result == false);
post (other instanceof Revision) ==> \result ==
(\forall int i; i>=1;
getNumber(i) == ((Revision)other).getNumber(i));
Check whether or not this revision is equal to another
EventSourceSupport - class org.jutil.event.EventSourceSupport.
This class is a support class for event sources.
EventSourceSupport() - Constructor for class org.jutil.event.EventSourceSupport
 
Exists - class org.jutil.java.collections.Exists.
A boolean exists operator.
Exists() - Constructor for class org.jutil.java.collections.Exists
 
ExplicitShiftQRSchurDecomposer - class org.jutil.math.matrix.ExplicitShiftQRSchurDecomposer.
A class of schur decomposers using an explict shift
ExplicitShiftQRSchurDecomposer(HessenbergReducer) - Constructor for class org.jutil.math.matrix.ExplicitShiftQRSchurDecomposer
public behavior

pre reducer != null;

post getHessenbergReducer() == reducer;
post getEpsilon ==
Initialize a new ExplicitShiftQRSchurDecomposer with the given HessenbergReducer
ExplicitShiftQRSchurDecomposer(HessenbergReducer, double) - Constructor for class org.jutil.math.matrix.ExplicitShiftQRSchurDecomposer
public behavior

pre reducer != null;
pre epsilon > 0;

post getHessenbergReducer() == reducer;
post getEpsilon() == epsilon;
Initialize a new ExplicitShiftQRSchurDecomposer with the given HessenbergReducer
ExtendedComparator - class org.jutil.java.collections.ExtendedComparator.
A Comparator with more convenient methods than java.util.Comparator.
ExtendedComparator() - Constructor for class org.jutil.java.collections.ExtendedComparator
 

F

Fifo - interface org.jutil.java.collections.Fifo.
Interface for first-in first-out like datastructures.
FifoList - class org.jutil.java.collections.FifoList.
FifoList is a class of objects that represent simple first-in first-out lists .
FifoList() - Constructor for class org.jutil.java.collections.FifoList
public behavior

post size() == 0;
Initialize a new empty FifoList.
File - class org.jutil.java.io.File.
A class that acts as an extension of java.io.File.
File(File, String) - Constructor for class org.jutil.java.io.File
Initialize a new File using the given parent and child.
File(String) - Constructor for class org.jutil.java.io.File
Initialize a new File See java.io.File.File(File, String).
File(String, String) - Constructor for class org.jutil.java.io.File
Initialize a new File See java.io.File.File(File, String).
Filter - class org.jutil.java.collections.Filter.
A filter for collections.
Filter() - Constructor for class org.jutil.java.collections.Filter
 
fireEvent(EventObject, Notifier) - Method in class org.jutil.event.EventSourceSupport
public behavior
pre notifier != null;
pre (\forall EventListener l; isValidListener(l);
notifier.isValidListener(l));
requires_redundantly (\forall EventListener l; listeners.has(l);
notifier.isValidListener(l));
pre notifier.isValidEvent(event);
assignable \fields_of(\reach(listeners)), \fields_of(\reach(event)),
\fields_of(\reach(notifier));
post (\forall EventListener l; listeners.has(l);
notifier.notifyEventListenerCalled(l, event));
flags() - Method in class org.jutil.java.regex.Pattern
Return the flags of this Pattern.
ForAll - class org.jutil.java.collections.ForAll.
A boolean for-all operator.
ForAll() - Constructor for class org.jutil.java.collections.ForAll
 
forwardSubstitute(Matrix, Column) - Method in class org.jutil.math.matrix.AbstractSolver
public behavior

pre L!= null;
pre b != null;
pre L.isSquare();
pre L.isLowerTriangular;
pre b.size() == L.getNbRows();
pre (* L is nonsingular *);

post (* L.times(\result).equals(b) *);

G

get(int) - Method in class org.jutil.event.ChainNotifier
public behavior
post \result == notifiers.itemAt(index);
signals (IndexOutOfBoundsException)
(index < 0) || (index >= notifiers.length());
getAllApplicableMethods(Class) - Static method in class org.jutil.java.reflect.Methods
// The given Class must be effective.
pre clazz != null;

// The result is Member
post \result instanceof Member;
getArray() - Method in class org.jutil.java.collections.ObjectArrayIterator
Return the array of this ObjectArrayIterator.
getArray() - Method in class org.jutil.java.collections.ZeroDimensionException
Return the array that caused this ZeroDimensionException.
getArrayDimensions(Object[]) - Static method in class org.jutil.java.collections.Arrays
// may not be null.
pre array != null;
Return the dimensions of the given array
getArrayType(Object) - Static method in class org.jutil.java.collections.Arrays
// may not be null.
pre array != null;
// must be an array.
pre array.getClass().isArray();
Return the type of an array
getColumn(int) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre index > 0 && index <= getNbColumns();

post \result != null;
post \result.size() == getNbRows();
post (\forall int i; i>0 && i < getNbRows();
\result.elementAt(i) == elementAt(i,index));
Return the column with the given index.
getComparator() - Method in class org.jutil.java.collections.InverseComparator
public behavior

post \result != null;
Return the comparator inverted by this.
getComparator() - Method in class org.jutil.java.collections.SkipListPQ
See superclass.
getComparator() - Method in class org.jutil.java.collections.SkipList
public behavior

post \result != null;
Return the Comparator used to determine the order in which the elements are added to this SkipList.
getComparator() - Method in interface org.jutil.java.collections.PriorityQueue
public behavior

post \result != null;
Return the comparator that is used to determine the order of the elements.
getComparator() - Method in class org.jutil.java.collections.BinomialHeap
See superclass.
getConnectedNodes(Object) - Method in class org.jutil.java.collections.TransitiveClosure
// The given node may not be null
pre node != null;

// Never returns null.
post \result != null;
// Never contains null.
post (\forall Object o; \result.contains(o); o != null);
getCursor() - Method in class org.jutil.java.collections.ArrayCursor
Return the index this ArrayCursor is pointing at.
getDecomposer() - Method in class org.jutil.math.matrix.QRLeastSquaresSolver
Return the QRDecomposer of this QRLeastSquaresSolver.
getDecomposer() - Method in class org.jutil.math.matrix.QRLinSolver
Return the QRDecomposer of this QRLinSolver.
getDecomposer() - Method in class org.jutil.math.matrix.LULinSolver
Return the LUDecomposer of this LULinSolver.
getDimensions() - Method in class org.jutil.java.collections.ArrayCursor
Return the dimensions of the array of this cursor.
getDimensions() - Method in class org.jutil.math.matrix.NMatrix
post \result.length == getNbDimensions();
Return the dimensions of this matrix
getDimensions() - Method in class org.jutil.math.matrix.Matrix
 
getEigenvalue(int) - Method in interface org.jutil.math.matrix.EigenvalueDecomposition
public behavior

pre index >= 1;
pre index <= getNbEigenvalues();

post \result == getEigenvalues().elementAt(index);
Return the index'th eigenvalue.
getEigenvalue(int) - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposition
See superclass
getEigenvalues() - Method in interface org.jutil.math.matrix.EigenvalueDecomposition
public behavior

post \result != null;
post (\forall int i; i>=1 && i<=getNbEigenvalues();
\result.elementAt(i) != 0);
Return the eigenvalues.
getEigenvalues() - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposition
See superclass
getEigenvector(int) - Method in interface org.jutil.math.matrix.EigenvalueDecomposition
public behavior

pre index >= 1;
pre index <= getNbEigenvalues();

post \result.equals(getEigenvectors.getColumn(index));
Return the index'th eigenvector.
getEigenvector(int) - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposition
See superclass
getEigenvectors() - Method in interface org.jutil.math.matrix.EigenvalueDecomposition
public behavior

post \result != null;
Return the eigenvectors.
getEigenvectors() - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposition
See superclass
getElement() - Method in class org.jutil.java.collections.ObjectArrayIterator
Return the element of the array at the current position of the iterator.
getEpsilon() - Method in class org.jutil.math.matrix.ExplicitShiftQRSchurDecomposer
public behavior

post \result > 0;
Return the precision with which the results must be computed.
getEventType() - Method in class org.jutil.event.TypeApplicabilityNotifier
public behavior
post \result == eventType;
getFilters() - Method in class org.jutil.java.collections.AndFilter
public behavior

post \result != null;
post (\forall int i; (i>=0) && (i Return the filters used by this AndFilter.
getFirst() - Method in class org.jutil.java.collections.SkipList
public behavior

pre ! isEmpty();

post contains(\result);
post (\forall Object o; contains(o);
getComparator().compare(\result,o)<=0);
Return the first object of this SkipList.
getHessenbergReducer() - Method in class org.jutil.math.matrix.ExplicitShiftQRSchurDecomposer
public behavior

post \result != null;
Return the HessenbergReducer used by this ExplicitShiftQRSchurDecomposer to calculate Schur decompositions.
getImmediateSuperTypes(Class) - Static method in class org.jutil.java.reflect.Classes
// The given Class must be effective
pre clazz != null;

// The set contains elements of type Class
post (\forall Object o; \result.contains(o); o instanceof Class);
// The set contains no null references
post (\forall Object o; \result.contains(o); o != null);
// The set only contains immediate supertypes of .
post (\forall Class c; \result.contains(c);
c == clazz.getSuperClass() || clazz.getInterfaces().contains(c));
// If the this method is applied to class Class, the result is the empty set.
post (clazz == Class.class) ==> \result.isEmpty();
getLinSolver() - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposer
public behavior

post \result != null;
Return the LinSolver used by this SchurEigenvalueDecomposer to calculate eigenvalue decompositions.
getLinSolver() - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposition
Return the LinSolver used to compute the eigenvectors.
getListenerType() - Method in class org.jutil.event.TypeApplicabilityNotifier
public behavior
post \result == listenerType;
getMajor() - Method in class org.jutil.junit.AbstractRevision
See superclass
getMajor() - Method in interface org.jutil.junit.Revision
public behavior

post \result == getNumber(1);
Return the major number of this Revision.
getMaxLevel() - Method in class org.jutil.java.collections.SkipList
public behavior

post \result >= 1;
Return the maximum level of this SkipList
getMicro() - Method in class org.jutil.junit.AbstractRevision
See superclass
getMicro() - Method in interface org.jutil.junit.Revision
public behavior

post \result == getNumber(3);
Return the micro number of this Revision.
getMinor() - Method in class org.jutil.junit.AbstractRevision
See superclass
getMinor() - Method in interface org.jutil.junit.Revision
public behavior

post \result == getNumber(2);
Return the minor number of this Revision.
getNbColumns() - Method in class org.jutil.math.matrix.Matrix
public behavior

post \result == getDimensions()[1];
Return the number of columns of this matrix.
getNbDimensions() - Method in class org.jutil.java.collections.ArrayCursor
// Returns the number of dimensions of the represented array.
post \result == getDimensions().length;
Return the number of dimensions of the array
getNbDimensions() - Method in class org.jutil.math.matrix.NMatrix
public invariant getDimensions().length == getNbDimensions();
public invariant (\forall int i; i>=0 && i getDimensions()[i] > 0);
Return the number of dimensions of this matrix.
getNbDimensions() - Method in class org.jutil.math.matrix.Matrix
 
getNbEigenvalues() - Method in interface org.jutil.math.matrix.EigenvalueDecomposition
public behavior

post \result > 0;
Return the number of eigenvalues.
getNbEigenvalues() - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposition
See superclass
getNbRows() - Method in class org.jutil.math.matrix.Matrix
public behavior

post \result == getDimensions()[0];
Return the number of rows of this matrix.
getNotifiers() - Method in class org.jutil.event.ChainNotifier
public behavior
post isModelFor(notifiers, \result);
getNumber(int) - Method in class org.jutil.junit.CVSRevision
See superclass.
getNumber(int) - Method in interface org.jutil.junit.Revision
pre index >= 1;

post \result >=0;
post (index > length()) ==> (\result == 0);
Return the index'th number of this Revision.
getObject() - Method in class org.jutil.structure.StructureElement
public behavior

post \result != null;
Return the object on the n side of the 1-n binding represented by this StructureElement
getObject() - Method in class org.jutil.structure.DoubleBinding
Return the object at this side of the double binding.
getObject() - Method in class org.jutil.structure.StructureSet
Return the object at the 1 side of the 1-n binding.
getOnlyElement() - Method in class org.jutil.java.collections.Singleton
Return the only element in this Singleton.
getOtherBinding() - Method in class org.jutil.structure.DoubleBinding
Return the DoubleBinding object this one is connected to.
getOtherEnd() - Method in class org.jutil.structure.StructureElement
public behavior

post getStructureSet() == null => \result == null;
post getStructureSet() != null => \result == getStructureSet().getObject();
Return the Object at the other end of this double binding.
getOtherEnd() - Method in class org.jutil.structure.DoubleBinding
public behavior

post getOtherBinding() == null => \result == null;
post getOtherBinding() != null => \result == getOtherBinding().getObject();
Return the Object at the other end of this double binding.
getOtherEnds() - Method in class org.jutil.structure.StructureSet
public behavior

post (\forall Object o;;
\result.contains(o) <=>
(\exists StructureElement s; contains(s);
s.getObject().equals(o)));
post \result != null;
Return a set containing the objects at the n side of the 1-n binding.
getPattern() - Method in class org.jutil.java.regex.RegexReplacer
public behavior

post \result != null;
Return the pattern of this RegexReplacer.
getProbability() - Method in class org.jutil.java.collections.SkipList
public behavior

post \result >= 0;
post \result <= 1;
Return the probability that a node of level >= i is a node of level >= i + 1
getReplacement() - Method in class org.jutil.java.regex.RegexReplacer
public behavior

post \result != null;
Return the replacement string of this RegexReplacer.
getRow(int) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre index > 0 && index <= getNbRows();

post \result != null;
post \result.size() == getNbColumns();
post (\forall int i; i>0 && i < getNbColumns();
\result.elementAt(i) == elementAt(i,index));
Return the row with the given index.
getSchurDecomposer() - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposer
public behavior

post \result != null;
Return the SchurDecomposer used by this SchurEigenvalueDecomposer to calculate eigenvalue decompositions.
getSlider() - Method in class org.jutil.java.swing.SliderControlledLabel
Return the slider that controls the value of this SliderControlledLabel.
getStructureElements() - Method in class org.jutil.structure.StructureSet
public behavior

post (\forall StructuredElement s;;
contains(s) <=> \result.contains(s));
post \result != null;
Return a set containing the StructureElements at the n side of the 1-n binding.
getStructureSet() - Method in class org.jutil.structure.StructureElement
return the set this StructureElement belongs to
getSuperClasses(Class) - Static method in class org.jutil.java.reflect.Classes
// The given Class must be effective
pre clazz != null;

// The set contains elements of type Class
post (\forall Object o; \result.contains(o); o instanceof Class);
// The set contains no null references
post (\forall Class c; \result.contains(c); c != null);
// The set contains only classes, no interfaces.
post (\forall Class c; \result.contains(c); ! c.isInterface());
// The set contains only super classes of clazz.
post (\forall Class c; \result.contains(c); c.isAssignableFrom(clazz));
// The set contains all the super classes of .
post (\forall Class c; (c.isAssignableFrom(clazz)) && (! c.isInterface()); \result.contains(c));
// If is an interface, the set is empty.
post (clazz.isInterface()) ==> \result.size() == 0;

post (* The order of the result set is that subclasses are smaller
than superclasses.*);
getSuperTypes(Class) - Static method in class org.jutil.java.reflect.Classes
// The given Class must be effective
pre clazz != null;

// The set contains elements of type Class
post (\forall Object o; \result.contains(o); o instanceof Class);
// The set contains no null references
post (\forall Class c; \result.contains(c); c != null);
// The set contains only super types of clazz.
post (\forall Class c; \result.contains(c); c.isAssignableFrom(clazz));
// The set contains .
post \result.contains(clazz);
//If the this method is applied to class Object, the result
//is the singleton {Object}.
post (clazz == Object.class) ==> (\result.contains(Object.class)) &&
(\result.size() == 1);
getTestedClass() - Method in class org.jutil.junit.JutilTest
public behavior

post \result != null;
Return the class that is tested by this test class.
getTestedClassRevision() - Method in class org.jutil.junit.JutilTest
public behavior

post \result != null;
Return the field representing the revision of the tested class.
getTestedRevision() - Method in class org.jutil.junit.JutilTest
public behavior

post \result != null;
Return the revision of the tested class that is tested by this class.
getType() - Method in class org.jutil.java.collections.TypeFilter
public behavior

post \result != null;
Return the type of this TypeFilter.
getV(int) - Method in class org.jutil.math.matrix.HouseholderQRDecomposition
Return the i-th v vector as computed by the Householder algorithm that computed this QR decomposition.
getV(int) - Method in class org.jutil.math.matrix.HouseholderHessenbergReduction
public behavior

pre i>=1;
pre i<=H().getNbColumns() - 2;

post \result != null;
greater(Object, Object) - Method in class org.jutil.java.collections.ExtendedComparator
public behavior

post \result == (compare(first, second) > 0);

H

H() - Method in interface org.jutil.math.matrix.HessenbergReduction
public behavior

post \result != null;
post \result.isSquare();
post \result.isHessenberg();
Return the Hessenberg matrix of this HessenbergReduction.
H() - Method in class org.jutil.math.matrix.HouseholderHessenbergReduction
See superclass
hasNext() - Method in class org.jutil.java.collections.Singleton.SingletonIterator
also public behavior

post \result == onlyElementNotReturnedYet;
See superclass
HessenbergReducer - interface org.jutil.math.matrix.HessenbergReducer.
A class of matrix operators that compute the Hessenberg reduction of a matrix.
HessenbergReduction - interface org.jutil.math.matrix.HessenbergReduction.
A HessenbergReduction represents a Hessenberg reduction of a matrix.
HouseholderHessenbergReducer - class org.jutil.math.matrix.HouseholderHessenbergReducer.
A class of matrix operators that compute the Hessenberg reduction of a matrix using Householder reflections.
HouseholderHessenbergReducer() - Constructor for class org.jutil.math.matrix.HouseholderHessenbergReducer
 
HouseholderHessenbergReduction - class org.jutil.math.matrix.HouseholderHessenbergReduction.
This class represents a HouseHolder Hessenberg factorization of a matrix.
HouseholderHessenbergReduction(Matrix, Column[]) - Constructor for class org.jutil.math.matrix.HouseholderHessenbergReduction
public behavior

pre H != null;
pre H.isSquare();
pre H.isHessenberg();
pre vs != null;
pre vs.length == H.getNbColumns() - 2;
pre (\forall int i; i>=0 && i vs[i] != null
vs[i].size() == H.getNbRows() - i - 1);

post H().equals(H);
post (\forall int i; i>=1 && i<= vs.length;
getV(i).equals(vs[i-1]));
Initialize a new HouseholderHessenbergReduction combination with the given H matrix and v vectors.
HouseholderQRDecomposer - class org.jutil.math.matrix.HouseholderQRDecomposer.
A class of objects that compute the QR factorization of a matrix using the Householder Algorithm.
HouseholderQRDecomposer() - Constructor for class org.jutil.math.matrix.HouseholderQRDecomposer
 
HouseholderQRDecomposition - class org.jutil.math.matrix.HouseholderQRDecomposition.
This class represents a HouseHolder QR factorization of a matrix.
HouseholderQRDecomposition(Matrix, Column[]) - Constructor for class org.jutil.math.matrix.HouseholderQRDecomposition
public behavior

pre R != null;
pre R.isUpperTriangular();
pre vs != null;
pre vs.length == R.getNbRows();
pre (\forall int i; i>=0 && i vs[i] != null
vs[i].size() == R.getNbRows() - i);

post R().equals(R);
post (\forall int i; i>=1 && i<= vs.length;
getV(i).equals(vs[i-1]));
Initialize a new HouseholderQRDecomposition combination with the given R matrix and v vectors.

I

identical(Collection, Collection) - Static method in class org.jutil.java.collections.Collections
public behavior

// True if both collections are null
post ((first == null) && (second == null)) ==> \result == true;

// False if only one of both is null.
post ((first == null) || (second == null)) &&
!((first == null) && (second == null)) ==> \result ==false;

// If both collections are non-null, true if both collections
// have the same size and contains the exact same elements.
post ((first != null) && (second != null)) ==>
\result == (first.size() == second.size()) &&
(\forall Object o1; containsExplicitly(first, o1);
nbExplicitOccurrences(first,o1) == nbExplicitOccurrences(second, o2));
Check whether the two given collections contain the same elements.
identical(Map, Map) - Static method in class org.jutil.java.collections.Collections
// True if both maps are null
post ((first == null) && (second == null)) ==> \result == true;

// False if only one of both is null.
post ((first == null) || (second == null)) &&
!((first == null) && (second == null)) ==> \result ==false;

// If both maps are non-null, true if both maps
// have the same size and contains the same (key,value) pairs.
post ((first != null) && (second != null)) ==>
\result == (first.size() == second.size()) &&
(\forall Object k; first.containsKey(k);
second.containsKey(k) && second.get(k) == first.get(k)) &&
first.size() == second.size();
post (\forall Map.Entry e1; first.entrySet().contains(e1);
(\exists Map.Entry e2; second.entrySet().contains(e2);
(e1.getKey() == e2.getKey()) &&
Check whether the two given maps contain the same entries.
in(Collection) - Method in class org.jutil.java.collections.BooleanAccumulator
public behavior

pre (\forall Object o, collection.contains(o); isValidElement(o));

post (* the result of the accumulation is returned *);
post collection == null => \result == initialAccumulator();

signals (ConcurrentModificationException) (* The collection was modified while accumulating *);
in(Collection) - Method in class org.jutil.java.collections.ForAll
also public behavior

post \result == (\forall Object o; collection.contains(o); criterion(o));
in(Collection) - Method in class org.jutil.java.collections.Exists
also public behavior

post \result == (\exists Object o;collection.contains(o);criterion(o));
in(Collection) - Method in class org.jutil.java.collections.IntegerAccumulator
public behavior

pre (\forall Object o, collection.contains(o); isValidElement(o));

post (* the result of the accumulation is returned *);
post collection == null => \result == initialAccumulator();

signals (ConcurrentModificationException) (* The collection was modified while filtering *);
indexOf(ApplicabilityNotifier) - Method in class org.jutil.event.ChainNotifier
public behavior
post notifiers.has(notifier) ==>
\result == notifiers.indexOf(notifier);
post ! notifiers.has(notifier) ==> \result == -1;
ensures_redundantly \result >= -1;
Returns the index in this list of the first occurrence of the specified element, or -1 if this list does not contain this element.
initialAccumulator() - Method in class org.jutil.java.collections.BooleanAccumulator
Subclasses should implement this method to return the initialized accumulator.
initialAccumulator() - Method in class org.jutil.java.collections.ForAll
also public behavior

post \result == true;
initialAccumulator() - Method in class org.jutil.java.collections.Exists
also public behavior

// Returns false
post \result == false;
initialAccumulator() - Method in class org.jutil.java.collections.Accumulator
Subclasses should implement this method to return the initialized accumulator.
initialAccumulator() - Method in class org.jutil.java.collections.IntegerAccumulator
Subclasses should implement this method to return the initialized accumulator.
initialAccumulator() - Method in class org.jutil.java.collections.Counter
also public behavior

post \result == 0;
IntegerAccumulator - class org.jutil.java.collections.IntegerAccumulator.
An integer accumulator for collections.
IntegerAccumulator() - Constructor for class org.jutil.java.collections.IntegerAccumulator
 
InverseComparator - class org.jutil.java.collections.InverseComparator.
An ExtendedComparator that inverts another Comparator.
InverseComparator(Comparator) - Constructor for class org.jutil.java.collections.InverseComparator
public behavior

pre comparator != null;

post getComparator() == comparator;
Initialize a new InverseComparator with the given comparator.
isApplicable(EventListener, EventObject) - Method in class org.jutil.event.TypeApplicabilityNotifier
also
public behavior
pre listener != null;
post \result ==>
(listenerType.isInstance(listener) &&
((event == null) || eventType.isInstance(event)));
// remember that isInstance would be false when event == null
isApplicable(EventListener, EventObject) - Method in interface org.jutil.event.ApplicabilityNotifier
public behavior
pre listener != null;
post \result <== isValidListener(listener) && isValidEvent(event);
isConnected() - Method in class org.jutil.structure.DoubleBinding
Check whether or not this DoubleBinding is connected to another.
isDiagonal() - Method in class org.jutil.math.matrix.Matrix
public behavior

post \result == (\forall int i; i>=1 && i<=getNbRows();
(\forall int j; j>=1 && j<=getNbColumns();
(j != i) => elementAt(i,j) == 0));
Check whether or not this matrix is a diagonal matrix.
isEmpty() - Method in class org.jutil.java.collections.SkipListPQ
See superclass.
isEmpty() - Method in interface org.jutil.java.collections.PriorityQueue
public behavior

post \result == (size() == 0);
Check whether or not this PriorityQueue is empty.
isEmpty() - Method in class org.jutil.java.collections.FifoList
See superclass.
isEmpty() - Method in interface org.jutil.java.collections.Fifo
public behavior

post \result == (size() == 0);
Check whether or not this Fifo is empty.
isEmpty() - Method in class org.jutil.java.collections.BinomialHeap
See superclass.
isEmpty() - Method in class org.jutil.java.collections.Singleton
also public behavior

post \result == false;
See superclass
isEmpty() - Method in class org.jutil.event.ChainNotifier
public behavior
post \result == notifiers.isEmpty();
isEmpty() - Method in class org.jutil.event.EventSourceSupport
// The set of listeners.
isLowerTriangular() - Method in class org.jutil.math.matrix.Matrix
public behavior

post \result == (\forall int i; i>=1 && i<=getNbRows();
(\forall int j; j>=1 && j<=getNbColumns();
(i > j) => elementAt(i,j) == 0));
Check whether or not this matrix is lower triangular
isNaiveClosure(Set, Set) - Method in class org.jutil.java.collections.TransitiveClosure
pre startSet != null
pre naiveClosureSet != null
post \result == (\forall Object o; startSet.contains(o);
(naiveClosureSet.contains(o) &&
(\exists Set ccn; isNaiveClosure(getConnectedNodes(o), ccn));
naiveClosureSet.containsAll(ccn)));
Transitive closure is a recursive definition.
isObjectArray(Class) - Static method in class org.jutil.java.collections.Arrays
// False is is null.
post (clazz == null) ==> (\result == false);
//Return true if is an array of objects.
post \result == clazz.isArray() &&
(clazz.getName().indexOf("[L") != -1);
Check whether the given class is an array of objects
isObjectArray(Object) - Static method in class org.jutil.java.collections.Arrays
// False is is null.
post (object == null) ==> (\result == false);
// True if is an array of objects, false otherwise.
post isObjectArray(object.getClass());
Check whether the given object is an array of objects
isPermutationMatrix() - Method in class org.jutil.math.matrix.Matrix
post \result == isSquare() &&
// 1 non-zero element in each row
(\forall int i; i>=1 && i<=getNbRows();
(\num_of int j; j>=1 && j<=getNbColumns() && elementAt(i,j) != 0;1) == 1) &&
// 1 non-zero element in each column
(\forall int i; i>=1 && i<=getNbColumns();
(\num_of int j; j>=1 && j<=getNbRows() && elementAt(j,i) != 0;1) == 1) &&
// each element is 0 or 1
(\forall int i; i>=1 && i<=getNbRows();
(\forall int j; j>=1 && j<=getNbColumns();
elementAt(i,j) == 0 || elementAt(i,j) == 1));
Check whether or not this matrix is a permutation matrix.
isSquare() - Method in class org.jutil.math.matrix.Matrix
public behavior

post getNbColumns() == getNbRows();
Check whether or not this matrix is square.
isSymmetric() - Method in class org.jutil.math.matrix.Matrix
public behavior

post \result == isSquare() &&
(\forall int i; i>=1 && i<=getNbRows();
(\forall int j; j>=1 && j<=getNbColumns();
elementAt(i,j) == elementAt(j,i)));
Check whether or not this matrix is symmetric.
isUpperTriangular() - Method in class org.jutil.math.matrix.Matrix
public behavior

post \result == (\forall int i; i>=1 && i<=getNbRows();
(\forall int j; j>=1 && j<=getNbColumns();
(i < j) => elementAt(i,j) == 0));
Check whether or not this matrix is upper triangular
iterator() - Method in class org.jutil.java.collections.SkipList
See superclass
iterator() - Method in class org.jutil.java.collections.Singleton
also public behavior

post \result instanceof SingletonIterator;
post \result != null;
See superclass

J

JutilTest - class org.jutil.junit.JutilTest.
This is an extension for the junit TestCase class.
JutilTest(String, Class, Revision) - Constructor for class org.jutil.junit.JutilTest
public behavior

pre testedRevision != null;
pre class != null;

// The tested class of this JutilTest is set to the given class.
post getTestedClass() == testedClass;
// The cvs revision of the tested class is assigned to getTestedClassRevision()
post getTestedClassRevision().equals(
new CVSRevision(
getTestedClass().getField("CVS_REVISION").get(null).toString()
)
);
post getTestedRevision() == testedRevision;

// Throws an AssertionFailedError if the actual class does not contain a field named CVS_REVISION.
signals (AssertionFailedError) (\forall Field f; new Vector(getTestedClass().getFields()).contains(f);
! f.getName().equals("CVS_REVISION"));
// Throws a RevisionError if the tested revision doesn't match the revision of the tested class.
signals (RevisionError) ! getTestedRevision().equals(getTestedClassRevision());
Initialize a new JutilTest with the given name, tested class and tested revision.
JutilTest(String, Revision) - Constructor for class org.jutil.junit.JutilTest
public invariant getTestedRevision().equals(getTestedClassRevision());

public behavior

pre testedRevision != null;

// The tested class is the corresponding class in the org.jutil package
// with the name X, when the name of the testclass is TestX
post getTestedClass().getName().equals(
new Pattern("org\\.jutiltest\\").replacer("org.jutil").replace(
new Pattern("\\.Test[^\\.]*").replacer("").replace(
getClass().getName()
)
)
);
// The cvs revision of the tested class is assigned to getTestedClassRevision()
post getTestedClassRevision().equals(
new CVSRevision(
getTestedClass().getField("CVS_REVISION").get(null).toString()
)
);
post getTestedRevision == testedRevision;

// Throws an AssertionFailedError if the actual class does not contain a field named CVS_REVISION.
signals (AssertionFailedError) (\forall Field f; new Vector(getTestedClass().getFields()).contains(f);
! f.getName().equals("CVS_REVISION"));
// The default tested claas is not found.
signals (AssertionFailedError) (* There is no class with the name
new Pattern("org\\.jutiltest\\").replacer("org.jutil").replace(
new Pattern("\\.Test[^\\.]*").replacer("").replace(
getClass().getName()
)
)
*);
// Throws a RevisionError if the tested revision doesn't match the revision of the tested class.
signals (RevisionError) ! getTestedRevision().equals(getTestedClassRevision());

L

L() - Method in interface org.jutil.math.matrix.LUDecomposition
private invariant L().sameDimensions(U());
private invariant P().sameDimensions(U());

public behavior

post \result != null;
post \result.isSquare();
post \result.isLowerTriangular();
post (\forall int i; i>=1 && i<=\result.getNbColumns();
elementAt(i,i) == 1);
Return the L matrix of this LU factorization.
L() - Method in class org.jutil.math.matrix.DefaultLUDecomposition
See superclass
lambda() - Method in interface org.jutil.math.matrix.EigenvalueDecomposition
public behavior

post \result != null;
post \result.isDiagonal();
post (\forall int i; i>=1 && i <= getNbEigenValues();
\result.elementAt(i,i) == getEigenvalue(i));
Return the eigenvalue matrix of this EigenvalueDecomposition.
lambda() - Method in class org.jutil.math.matrix.SchurEigenvalueDecomposition
See superclass
lastIndexOf(ApplicabilityNotifier) - Method in class org.jutil.event.ChainNotifier
public behavior
post notifiers.has(notifier) ==>
\result == notifiers.length() -
notifiers.reverse().indexOf(notifier);
post ! notifiers.has(notifier) ==> \result == -1;
ensures_redundantly \result >= -1;
Returns the index in this list of the last occurrence of the specified element, or -1 if this list does not contain this element.
LeastSquaresSolver - interface org.jutil.math.matrix.LeastSquaresSolver.
A class of objects that solve least square problems represented as a matrix.
leftGivens(double, double, int, int) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre (1 <= i) && (i < k) && (k <= getNbRows());

post getColumn(i).equals(\old(getColumn(i).times(c).minus(getColumn(k).times(s))));
post getColumn(k).equals(\old(getColumn(i).times(s).plus(getColumn(k).times(c))));
length() - Method in class org.jutil.junit.CVSRevision
See superclass.
length() - Method in interface org.jutil.junit.Revision
public behavior

post \result >= 1;
Return the number of numbers in this Revision.
LinSolver - interface org.jutil.math.matrix.LinSolver.
A class of objects that solve linear systems of equations represented as a matrix.
lpower(long, long) - Static method in class org.jutil.math.Math
public behavior

pre exponent > 0;

post \result == java.lang.Math.pow(base,exponent);
LUDecomposer - interface org.jutil.math.matrix.LUDecomposer.
A class of objects that compute the LU factorization of a matrix.
LUDecomposition - interface org.jutil.math.matrix.LUDecomposition.
This class represents an LU factorization of a matrix.
LULinSolver - class org.jutil.math.matrix.LULinSolver.
A class of objects that solve linear systems of equations represented as a matrix using the LU decomposition of that matrix.
LULinSolver(LUDecomposer) - Constructor for class org.jutil.math.matrix.LULinSolver
public behavior

pre decomposer != null;

post getDecomposer() == decomposer;
Initialize a new LULinSolver with the given LUDecomposer.

M

main(String[]) - Static method in class org.jutil.java.regex.RegexReplacer
 
main(String[]) - Static method in class org.jutil.math.Math
 
MapOperator - interface org.jutil.java.collections.MapOperator.
MapOperator is the toplevel interface for map operators.
Mapping - class org.jutil.java.collections.Mapping.
A mapping of collections.
Mapping() - Constructor for class org.jutil.java.collections.Mapping
 
mapping(Object) - Method in class org.jutil.java.collections.Mapping
public behavior

isValidElement(element);

post (\forall object o1;;
(\forall object o2; (o2 != null) && o2.equals(o1);
mapping(o1).equals(mapping(o2))));
The mapping to be applied to all elements of a collection.
MapVisitor - class org.jutil.java.collections.MapVisitor.
A visitor of maps.
MapVisitor() - Constructor for class org.jutil.java.collections.MapVisitor
 
Math - class org.jutil.math.Math.
This is a general utility class for mathematical stuff.
Math() - Constructor for class org.jutil.math.Math
 
Matrix - class org.jutil.math.matrix.Matrix.
A class of 2D matrices.
Matrix(double[]) - Constructor for class org.jutil.math.matrix.Matrix
public behavior

pre elements != null;
pre elements.length > 0;

post getNbRows() == elements.length;
post isSquare();
post isDiagonal();
post (\forall int i; i>=0 && i elements[i] == elementAt(i+1,i+1)));
Initialize a new diagonal Matrix with the given array of diagonal element.
Matrix(double[][]) - Constructor for class org.jutil.math.matrix.Matrix
public behavior

pre elements != null;
pre elements.length > 0;
pre (\exist int nbColumns; nbColumns > 0;
(\forall int i; i>=0 && i elements[i] != null &&
elements[i].length == nbColumns));

post getNbRows() == elements.length;
post getNbColumns() == elements[0].length;
post (\forall int i; i>=0 && i (\forall int j; j>=0 && j elements[i][j] == elementAt(i+1,j+1)));
Initialize a new Matrix from the given 2D array of doubles.
Matrix(int, int) - Constructor for class org.jutil.math.matrix.Matrix
public invariant getNbDimensions() == 2;

public behavior

post getNbColumns() == columns;
post getNbRows() == rows;
post (\forall int i; i>0 && i < getNbRows();
(\forall int j; j > 0 && j < getNbColumns();
elementAt(i,j) == 0));
Initialize a new Matrix with the given number of rows and columns
max(Object, Object) - Method in class org.jutil.java.collections.ExtendedComparator
public behavior

post \result == first | \result == second;
post compare(\result, first) >= 0;
post compare(\result, second) >= 0;
merge(BinomialHeap) - Method in class org.jutil.java.collections.BinomialHeap
public behavior

pre heap != null;

post size() == \old(size()) + \old(heap.size())
post (\forall Object element; ;
nbExplicitOccurrences(element) == \old(nbExplicitOccurrences(element)) +
\old(heap.nbExplicitOccurrences(element)));
post (\forall Object element; ;
heap.nbExplicitOccurences(element) == 0);
Methods - class org.jutil.java.reflect.Methods.
Utility methods for method reflection.
Methods() - Constructor for class org.jutil.java.reflect.Methods
 
min() - Method in class org.jutil.java.collections.SkipListPQ
See superclass.
min() - Method in interface org.jutil.java.collections.PriorityQueue
public behavior

pre ! isEmpty();

// The result is in this PriorityQueue.
post nbExplicitOccurrences(\result) > 0;
// The result is the minimum element.
post (\forall Object o; nbExplicitOccurrences(o) > 0;
ExtendedComparator.ensureExtended(getComparator()).notGreater(o,\result));
Return the smallest object in this PriorityQueue.
min() - Method in class org.jutil.java.collections.BinomialHeap
See superclass.
min(Object, Object) - Method in class org.jutil.java.collections.ExtendedComparator
public behavior

post \result == first | \result == second;
post compare(\result, first) <= 0;
post compare(\result, second) <= 0;
minus(Matrix) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre other != null;
pre sameDimensions(other);

post \result != null;
post \result.sameDimensions(this);
post (\forall int i; i>=1 && i <= getNbRows();
(\forall int j; j>=1 && j <= getNbColumns();
\result.elementAt(i,j) ==
elementAt(i,j) - other.elementAt(i,j)));
Return a new matrix that equals this matrix minus the given matrix.
MULTILINE - Static variable in class org.jutil.java.regex.Pattern
 
multiply(double) - Method in class org.jutil.math.matrix.Matrix
public behavior

post (\forall int i; i>=1 && i<= getNbRows();
(\forall int j; j>=1 && j<= getNbColumns();
elementAt(i,j) == \old(elementAt(i,j)) * factor));
Multiply this matrix by a given factor.

N

nbExplicitOccurrences(Object) - Method in class org.jutil.java.collections.SkipListPQ
See superclass.
nbExplicitOccurrences(Object) - Method in interface org.jutil.java.collections.PriorityQueue
public behavior

post \result >= 0;
Return the number of times the given element itself is in this PriorityQueue.
nbExplicitOccurrences(Object) - Method in class org.jutil.java.collections.BinomialHeap
See superclass.
nbExplicitOccurrences(Object, Collection) - Static method in class org.jutil.java.collections.Collections
public behavior

pre collection != null;

post \result == (\num_of int i; i >= 0 && i < collection.toArray().length;
collection.toArray()[i] == element);
Return the number of times has been added to .
newArray(Object[]) - Static method in class org.jutil.java.collections.Arrays
// may not be null
pre array != null;

// The returned array is not null
post \result != null;
// The returned array has the same type as .
post getArrayType(\result) == getArrayType(array);
// The returned array has the same dimensions as .
post (\forall int i; i >= 0 && i < getArrayDimensions(array).length;
getArrayDimensions(\result)[i] == getArrayDimensions(array)[i]);
Return a new array of the same type and dimension as the given array.
next() - Method in class org.jutil.java.collections.ObjectArrayIterator
Go to the next element of the array Effects If the iterator wasn't at the end of the array, the iterator will be positioned at the next element.
next() - Method in class org.jutil.java.collections.Singleton.SingletonIterator
also public behavior

post \result == getOnlyElement();
post onlyElementNotReturnedYet == false;
exception NoSuchElementException (\old(! onlyElementNotReturnedYet));
See superclass
next() - Method in class org.jutil.java.collections.ArrayCursor
// The cursor is set to the next element.
Set this cursor to the next element in the array.
NMatrix - class org.jutil.math.matrix.NMatrix.
This is a class of N-dimensional matrices The name Matrix has been reserved for 2D matrices since they are use more frequently than a general N-dimensional matrix.
NMatrix() - Constructor for class org.jutil.math.matrix.NMatrix
 
norm(int) - Method in class org.jutil.math.matrix.Column
public behavior

pre p > 0;

post \result == Math.pow((\sum int i; i>=1 && i <= size();
Math.pow(elementAt(i),p)),
1/p)
Return the p-norm of this vector.
normalize() - Method in class org.jutil.math.matrix.Column
public behavior

pre norm(2) > 0;

post (\forall int i; i>=1 && i <= size();
elementAt(i) = \old(elementAt(i)/norm(2)));
Normalize this vector
notGreater(Object, Object) - Method in class org.jutil.java.collections.ExtendedComparator
public behavior

post \result == ! greater(first, second);
Notifier - interface org.jutil.event.Notifier.
Notifier instances are used to call the correct call-back method defined in a listener type when EventSourceSupport fires events.
notifyEventListener(EventListener, EventObject) - Method in interface org.jutil.event.Notifier
public behavior
pre listener != null;
pre isValidListener(listener);
pre isValidEvent(event);
assignable \fields_of(\reach(listener)), \fields_of(\reach(event)),
\fields_of(\reach(this));
post notifyEventListenerCalled(listener, event);
notifyEventListener(EventListener, EventObject) - Method in class org.jutil.event.ChainNotifier
public invariant notifiers != null;
public invariant (\forall Object o; notifiers.has(o); o != null);
public invariant (\forall Object o; notifiers.has(o);
o instanceof ApplicabilityNotifier);

public model JMLObjectSequence notifiers;
notSmaller(Object, Object) - Method in class org.jutil.java.collections.ExtendedComparator
public behavior

post \result == ! smaller(first, second);

O

ObjectArrayIterator - class org.jutil.java.collections.ObjectArrayIterator.
A class of iterators for multi-dimensional arrays of objects.
ObjectArrayIterator(Object[]) - Constructor for class org.jutil.java.collections.ObjectArrayIterator
// The array of an ObjectArrayIterator is not null.
public invariant getArray() != null;

// may not be null.
pre array != null;

// The array of this ObjectArrayIterator will be set to
post getArray() == array;
// The iterator will be positioned at the start of the array.
post atStart() == true;
Initialize a new ObjectArrayIterator with the given array of objects
org.jutil.event - package org.jutil.event
 
org.jutil.java.collections - package org.jutil.java.collections
Provides for operations on collections.
org.jutil.java.io - package org.jutil.java.io
 
org.jutil.java.reflect - package org.jutil.java.reflect
 
org.jutil.java.regex - package org.jutil.java.regex
 
org.jutil.java.swing - package org.jutil.java.swing
 
org.jutil.java.throwable - package org.jutil.java.throwable
 
org.jutil.junit - package org.jutil.junit
Provides for extended functionality for test classes.
org.jutil.math - package org.jutil.math
 
org.jutil.math.matrix - package org.jutil.math.matrix
 
org.jutil.structure - package org.jutil.structure
 

P

P() - Method in interface org.jutil.math.matrix.LUDecomposition
public behavior

post \result != null;
post \result.isPermutationMatrix();
Return the P matrix of this LU factorization.
P() - Method in class org.jutil.math.matrix.DefaultLUDecomposition
See superclass
PACKAGE_ACCESS_FILTER - Static variable in class org.jutil.java.reflect.Methods
 
PACKAGE_ACCESS_FILTER - Static variable in class org.jutil.java.reflect.Classes
 
packageName(Class) - Static method in class org.jutil.java.reflect.Classes
// The given class must be effective.
pre t != null;

// The result is never null.
post \result != null;
// The result never contains illegal characters.
post Character.isJavaIdentifierStart(\result.charAt(1));
post (\forall int i; (i>0) && (i<\result.length()); Character.isJavaIdentifierPart(\result.charAt(i)));
The fully qualified package name of type .
PartialPivotGauss - class org.jutil.math.matrix.PartialPivotGauss.
A class of objects that compute the LU factorization of a square non-singular matrix using Gauss elimination with partial pivoting.
PartialPivotGauss() - Constructor for class org.jutil.math.matrix.PartialPivotGauss
 
Pattern - class org.jutil.java.regex.Pattern.
A class that adapts the jregex.Pattern interface to the java.util.regex.Pattern interface.
pattern() - Method in class org.jutil.java.regex.Pattern
public behavior

post \result.equals(toString());
Return the pattern used to build this Pattern.
Pattern(String) - Constructor for class org.jutil.java.regex.Pattern
public behavior

pre regex != null;

post pattern().equals(regex);
post flags() == DEFAULT;

signals (PatternSyntaxException) (* The given String is not a valid regular expression *);
Initialize a new Pattern with default flags and the given regular expression
Pattern(String, int) - Constructor for class org.jutil.java.regex.Pattern
public behavior

pre regex != null;
pre (* The given flags must be valid.
plus(Matrix) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre other != null;
pre sameDimensions(other);

post \result != null;
post \result.sameDimensions(this);
post (\forall int i; i>=1 && i <= getNbRows();
(\forall int j; j>=1 && j <= getNbColumns();
\result.elementAt(i,j) ==
elementAt(i,j) + other.elementAt(i,j)));
Return a new matrix that is the sum of this matrix and the given matrix
pop() - Method in class org.jutil.java.collections.SkipListPQ
See superclass.
pop() - Method in interface org.jutil.java.collections.PriorityQueue
public behavior

pre ! isEmpty();

// The minimum is returned.
post \result == \old(min());
// The instance that is returned, is removed.
post nbExplicitOccurrences(\result) == \old(nbExplicitOccurrences(\result)) - 1;
Return the smallest object in this PriorityQueue and remove it.
pop() - Method in class org.jutil.java.collections.FifoList
See superclass.
pop() - Method in class org.jutil.java.collections.BlockingFifoList
also public behavior

pre true;
See superclass.
pop() - Method in class org.jutil.java.collections.SynchronizedFifoList
See superclass.
pop() - Method in interface org.jutil.java.collections.Fifo
public behavior

pre size() > 0;

post elements.size() == \old(elements.size()) - 1;
post \result == \old(elements.get(elements.size() - 1));
Pop the first object from this fifo.
pop() - Method in class org.jutil.java.collections.BinomialHeap
See superclass.
power(double, long) - Static method in class org.jutil.math.Math
public behavior

pre exponent > 0;

post \result == java.lang.Math.pow(base,exponent);
previous() - Method in class org.jutil.java.collections.ObjectArrayIterator
Go to the previous element of the array Effects If the iterator wasn't at the start of the array, the iterator will be positioned at the previous element.
previous() - Method in class org.jutil.java.collections.ArrayCursor
// The cursor is set to the previous element.
Set this cursor to the previous element in the array.
PriorityQueue - interface org.jutil.java.collections.PriorityQueue.
A PriorityQueue is a container of objects with an associated priority/ordering, that allows the retrieval of the element with the smallest value.
PRIVATE_ACCESS_FILTER - Static variable in class org.jutil.java.reflect.Methods
 
PRIVATE_ACCESS_FILTER - Static variable in class org.jutil.java.reflect.Classes
 
PROTECTED_ACCESS_FILTER - Static variable in class org.jutil.java.reflect.Methods
 
PROTECTED_ACCESS_FILTER - Static variable in class org.jutil.java.reflect.Classes
 
PUBLIC_ACCESS_FILTER - Static variable in class org.jutil.java.reflect.Methods
 
PUBLIC_ACCESS_FILTER - Static variable in class org.jutil.java.reflect.Classes
 
push(Object) - Method in class org.jutil.java.collections.FifoList
See superclass.
push(Object) - Method in class org.jutil.java.collections.BlockingFifoList
See superclass.
push(Object) - Method in class org.jutil.java.collections.SynchronizedFifoList
See superclass.
push(Object) - Method in interface org.jutil.java.collections.Fifo
public invariant size() >= 0;

// A model field representing the elements in this Fifo.

Q

Q() - Method in interface org.jutil.math.matrix.SchurDecomposition
public behavior

\result != null;
post \result.isUnary();
post \result.isSquare();
Return the Q matrix of this SchurDecomposition.
Q() - Method in class org.jutil.math.matrix.HouseholderQRDecomposition
See superclass
Q() - Method in class org.jutil.math.matrix.DefaultSchurDecomposition
See superclass
Q() - Method in interface org.jutil.math.matrix.HessenbergReduction
public behavior

post \result != null;
post \result.isSquare();
post (* \result.isUnitary() *);
Return the unitary Q matrix of this HessenbergReduction.
Q() - Method in class org.jutil.math.matrix.HouseholderHessenbergReduction
See superclass
Q() - Method in interface org.jutil.math.matrix.QRDecomposition
public invariant Q().getNbColumns() == R().getNbRows();

public behavior

post \result != null;
post \result.getNbRows() == R().getNbRows();
post \result.getNbColumns() == R().getNbRows();
post \result.isOrthoNormal();
Return the Q matrix of this QR factorization.
QRDecomposer - interface org.jutil.math.matrix.QRDecomposer.
A class of objects that compute the QR factorization of a matrix.
QRDecomposition - interface org.jutil.math.matrix.QRDecomposition.
This class represents a QR factorization of a matrix.
Qreduced() - Method in class org.jutil.math.matrix.HouseholderQRDecomposition
See superclass
Qreduced() - Method in interface org.jutil.math.matrix.QRDecomposition
public behavior

post \result.equals(Q().subMatrix(1,1,Q().getNbRows(), R().getNbColumns()));
Return the reduced Q matrix.
QreducedTimes(Column) - Method in class org.jutil.math.matrix.HouseholderQRDecomposition
See superclass
QreducedTimes(Column) - Method in interface org.jutil.math.matrix.QRDecomposition
public behavior

pre column != null;
pre column.size() = Qreduced().getNbColumns();

post \result.equals(Qreduced().times(column));
Return Qreduced().times(column)
QreducedTransposeTimes(Column) - Method in class org.jutil.math.matrix.HouseholderQRDecomposition
See superclass
QreducedTransposeTimes(Column) - Method in interface org.jutil.math.matrix.QRDecomposition
public behavior

pre column != null;
pre column.size() = Qreduced().getNbRows();

post \result.equals(Qreduced().returnTranspose().times(column));
Return Qreduced().returnTranspose().times(column)
QRLeastSquaresSolver - class org.jutil.math.matrix.QRLeastSquaresSolver.
A class of objects that solve least squares problems using its QR decomposition.
QRLeastSquaresSolver(QRDecomposer) - Constructor for class org.jutil.math.matrix.QRLeastSquaresSolver
public behavior

pre decomposer != null;

post getDecomposer() == decomposer;
Initialize a new QRLeastSquaresSolver with the given QRDecomposer.
QRLinSolver - class org.jutil.math.matrix.QRLinSolver.
A class of objects that solve linear systems of equations represented as a matrix using its QR decomposition.
QRLinSolver(QRDecomposer) - Constructor for class org.jutil.math.matrix.QRLinSolver
public behavior

pre decomposer != null;

post getDecomposer() == decomposer;
Initialize a new QRLinSolver with the given QRDecomposer.
Qtimes(Column) - Method in class org.jutil.math.matrix.HouseholderQRDecomposition
See superclass
Qtimes(Column) - Method in interface org.jutil.math.matrix.HessenbergReduction
public behavior

pre column != null;
pre column.size() = Q().getNbColumns();

post \result.equals(Q().times(column));
Return Q().times(column)
Qtimes(Column) - Method in class org.jutil.math.matrix.HouseholderHessenbergReduction
See superclass
Qtimes(Column) - Method in interface org.jutil.math.matrix.QRDecomposition
public behavior

pre column != null;
pre column.size() = Q().getNbColumns();

post \result.equals(Q().times(column));
Return Q().times(column)
QtransposeTimes(Column) - Method in class org.jutil.math.matrix.HouseholderQRDecomposition
See superclass
QtransposeTimes(Column) - Method in interface org.jutil.math.matrix.HessenbergReduction
public behavior

pre column != null;
pre column.size() = Q().getNbRows();

post \result.equals(Q().returnTranspose().times(column));
Return Q().returnTranspose().times(column)
QtransposeTimes(Column) - Method in class org.jutil.math.matrix.HouseholderHessenbergReduction
See superclass
QtransposeTimes(Column) - Method in interface org.jutil.math.matrix.QRDecomposition
public behavior

pre column != null;
pre column.size() = Q().getNbRows();

post \result.equals(Q().returnTranspose().times(column));
Return Q().returnTranspose().times(column)

R

R() - Method in interface org.jutil.math.matrix.SchurDecomposition
public invariant Q().getNbColumns() == R().getNbColumns();

public behavior

post \result != null;
post \result.isUpperTriangular();
post \result.isSquare();
Return the R matrix of this SchurDecomposition.
R() - Method in class org.jutil.math.matrix.HouseholderQRDecomposition
See superclass
R() - Method in class org.jutil.math.matrix.DefaultSchurDecomposition
See superclass
R() - Method in interface org.jutil.math.matrix.QRDecomposition
public behavior

post \result != null;
post \result.isUpperTriangular();
Return the R matrix of this QR factorization.
R() - Method in interface org.jutil.math.matrix.CholeskyDecomposition
public behavior

post \result != null;
post \result.isUpperTriangular();
post \result.isSquare();
Return the uppertriangular matrix of this CholeskyDecomposition.
R() - Method in class org.jutil.math.matrix.DefaultCholeskyDecomposition
See superclass
reduce(Matrix) - Method in class org.jutil.math.matrix.HouseholderHessenbergReducer
See superclass
reduce(Matrix) - Method in interface org.jutil.math.matrix.HessenbergReducer
public behavior

pre matrix != null;
pre matrix.isSquare();

post \result != null;
Compute the Hessenberg reduction of the given matrix
RegexReplacer - class org.jutil.java.regex.RegexReplacer.
A class of object the replace regular expressions for others.
RegexReplacer(String, String) - Constructor for class org.jutil.java.regex.RegexReplacer
public behavior

pre pattern != null;
pre replacement != null;
pre (* pattern must be a valid regular expression *);

post getPattern().pattern().equals(pattern);
// The pattern is a multi line pattern.
post getPattern().flags() == Pattern.MULTILINE;
post getReplacement() == replacement;
Initialize a new RegexReplacer for the given pattern and replacement.
RegexReplacer(String, String, int) - Constructor for class org.jutil.java.regex.RegexReplacer
public behavior

pre pattern != null;
pre replacement != null;
pre (* pattern must be a valid regular expression *);
pre (* flags must be a valid flag for a pattern.
remove() - Method in class org.jutil.java.collections.Singleton.SingletonIterator
also public behavior

post false;
exception UnsupportedOperationException true;
See superclass
remove(ApplicabilityNotifier) - Method in class org.jutil.event.ChainNotifier
public behavior
assignable notifiers;
post notifiers.equals(\old(notifiers.removeItemAt(
notifiers.indexOf(notifier))));
remove(EventListener) - Method in class org.jutil.event.EventSourceSupport
public behavior
assignable listeners;
// The given listener is not in the set of listeners.
post listeners.equals(\old(listeners.remove(listener)));
ensures_redundantly ! listeners.has(listener);
Remove an event EventListener from the listeners to be notified by this.
remove(int) - Method in class org.jutil.event.ChainNotifier
public behavior
assignable notifiers;
post notifiers.equals(\old(notifiers.removeItemAt(index)));
signals (IndexOutOfBoundsException)
(index < 0) || (index >= notifiers.length());
remove(Object) - Method in class org.jutil.java.collections.SkipList
See superclass
remove(Object) - Method in class org.jutil.java.collections.Singleton
also public behavior

post false;
exception UnsupportedOperationException true;
See superclass
remove(StructureElement) - Method in class org.jutil.structure.StructureSet
public behavior

post contains(element) ==> element.getStructuredSet() == null;
post contains(element) ==> ! contains(element);
Add the given StructureElement to this StructureSet.
removeAll(Collection) - Method in class org.jutil.java.collections.Singleton
also public behavior

post false;
exception UnsupportedOperationException true;
See superclass
removeAll(Object) - Method in class org.jutil.java.collections.SkipList
See superclass
removeFirst() - Method in class org.jutil.java.collections.SkipList
public behavior

pre ! isEmpty();

post (! \old(isEmpty())) ==> (size() == \old(size()) - 1);
post (! \old(isEmpty())) ==> (Collections.nbExplicitOccurrences(\old(getFirst()),this) ==
\old(Collections.nbExplicitOccurrences(\old(getFirst()),this)) - 1);
Remove the first element of this SkipList.
replace(File, File) - Method in class org.jutil.java.regex.RegexReplacer
public behavior

pre input != null;
pre output != null;

post (* all occurrences of getPattern() will be replaced by getReplacement()
in the input file, and the result will be written the output file.
retain(Collection) - Method in class org.jutil.java.collections.Filter
public behavior

pre (\forall Object o, collection.contains(o); isValidElement(o));

// All elements that do not meet the criterion are removed from the collection.
post collection != null ==> (\forall Object o; (o!= null) && (! criterion(o)); ! \result.contains(o));
// The given collection is changed and returned.
post \result == collection;

signals (ConcurrentModificationException) (* The collection was modified while filtering *);
retainAll(Collection) - Method in class org.jutil.java.collections.Singleton
also public behavior

post false;
exception UnsupportedOperationException true;
See superclass
returnTranspose() - Method in class org.jutil.math.matrix.Matrix
public behavior

post \result.sameDimensions(this);
post (\forall int i; i>0 && i<= getNbRows();
(\forall int j; j>0 && j elementAt(i,j) == \result.elementAt(j,i)));
Return the transpose of this matrix.
Revision - interface org.jutil.junit.Revision.
A class of Revisions of something.
RevisionError - error org.jutil.junit.RevisionError.
A class of errors indicating the use of a test class when the tested revision is no longer the latest revision of the tested class.
RevisionError() - Constructor for class org.jutil.junit.RevisionError
public behavior

post getMessage() == null;
Initialize a new RevisionError with a null message
RevisionError(String) - Constructor for class org.jutil.junit.RevisionError
public behavior

post getMessage() == msg;
Initialize a new RevisionError with the given message.
rightGivens(double, double, int, int) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre (1 <= i) && (i < k) && (k <= getNbColumns());

post getColumn(i).equals(\old(getColumn(i).times(c).minus(getColumn(k).times(s))));
post getColumn(k).equals(\old(getColumn(i).times(s).plus(getColumn(k).times(c))));
RobustMapVisitor - class org.jutil.java.collections.RobustMapVisitor.
A robust visitor of maps.
RobustMapVisitor() - Constructor for class org.jutil.java.collections.RobustMapVisitor
 
RobustVisitor - class org.jutil.java.collections.RobustVisitor.
A robust visitor of collections.
RobustVisitor() - Constructor for class org.jutil.java.collections.RobustVisitor
 
Row - class org.jutil.math.matrix.Row.
A class of matrices containing only 1 row.
Row(double[]) - Constructor for class org.jutil.math.matrix.Row
pre elements != 0
pre elements.length > 0

post size() == elements.length
post (\forall int i; i>0 && i <= size();
elementAt(i) == elements[i-1]);
Create a new Row with the given elements.
Row(int) - Constructor for class org.jutil.math.matrix.Row
public invariant getNbRows() == 1;

pre size > 0;

post size() == size;
post (\forall int i; i > 0 && i <= size();
elementAt(i) == 0);
Create a new Row with the given size.
Rreduced() - Method in class org.jutil.math.matrix.HouseholderQRDecomposition
See superclass
Rreduced() - Method in interface org.jutil.math.matrix.QRDecomposition
public behavior

post \result.equals(R().subMatrix(1,1,R().getNbColumns(), R().getNbColumns()));
Return the reduced R matrix.

S

sameDimensions(Matrix) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre other != null

post getNbColumns() == other.getNbColumns();
post getNbRows() == other.getNbRows();
Check wether the given matrix has the same dimensions as this one.
SchurDecomposer - interface org.jutil.math.matrix.SchurDecomposer.
A class of objects that compute the Schur factorization of a matrix.
SchurDecomposition - interface org.jutil.math.matrix.SchurDecomposition.
A class of schur decompositions of a matrix.
SchurEigenvalueDecomposer - class org.jutil.math.matrix.SchurEigenvalueDecomposer.
A class of eigenvalue decomposers using an explict shift algorithm.
SchurEigenvalueDecomposer(SchurDecomposer, LinSolver) - Constructor for class org.jutil.math.matrix.SchurEigenvalueDecomposer
public behavior

pre decomposer != null;
pre linSolver != null;

post getSchurDecomposer() == decomposer;
post getLinSolver() == linSolver;
Initialize a new SchurEigenvalueDecomposer with the given HessenbergReducer
SchurEigenvalueDecomposition - class org.jutil.math.matrix.SchurEigenvalueDecomposition.
A class of eigenvalue decomposers using an explict shift algorithm.
SchurEigenvalueDecomposition(SchurDecomposition, LinSolver) - Constructor for class org.jutil.math.matrix.SchurEigenvalueDecomposition
public behavior

pre decomposition != null;
pre linSolver != null;

post getLinSolver() == linSolver;
Initialize a new SchurEigenvalueDecomposition with the given decomposition and LinSolver.
set(int, ApplicabilityNotifier) - Method in class org.jutil.event.ChainNotifier
public behavior
assignable notifiers if notifier != null;
post notifier != null ==>
notifiers.equals(\old(notifiers.replaceItemAt(index, notifier)));
post notifier != null ==> \result == \old(notifiers.itemAt(index));
post notifier == null ==> \result == null;
signals (IndexOutOfBoundsException)
(index < 0) || (index >= notifiers.length());
Replaces the element at the specified position in this list with the specified element.
setColumn(int, Column) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre i>=1 && i<=getNbColumns();
pre column != null;
pre column.size() == getNbRows();

post getColumn(i).equals(column);
Set the i-th column of this matrix
setElement(Object) - Method in class org.jutil.java.collections.ObjectArrayIterator
Set the element of the array at the current position of the iterator to the given element.
setElementAt(int[], double) - Method in class org.jutil.math.matrix.NMatrix
pre validIndex(index);

post elementAt(index) == value;
Set the element at the given index to the given value.
setElementAt(int[], double) - Method in class org.jutil.math.matrix.Matrix
 
setElementAt(int, double) - Method in class org.jutil.math.matrix.Row
pre validIndex(index);

post elementAt(index) == value;
Set the element at the given index
setElementAt(int, double) - Method in class org.jutil.math.matrix.Column
pre validIndex(index);

post elementAt(index) == value;
Set the element at the given index
setElementAt(int, int, double) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre validIndex(row, column);

post elementAt(row, column) == value;
Set the element at the given row and column to the given value.
setOtherBinding(DoubleBinding) - Method in class org.jutil.structure.DoubleBinding
public behavior

post getOtherBinding() == otherBinding;
// If this DoubleBinding was connected before, and will now be
// connected to another DoubleBinding, the DoubleBinding it was
// connected to will be disconnected.
post \old(getOtherBinding()) != null && \old(getOtherBinding()) != otherBinding =>
\old(getOtherBinding()).getOtherBinding() == null;
post otherBinding != null ==> otherBinding.getOtherBinding() == this;
// If was connected before to another object, that other object will
// be disconnected.
post otherBinding != null &&
\old(otherBinding.getOtherBinding()) != null &&
\old(otherBinding.getOtherBinding()) != this ==>
\old(otherBinding.getOtherBinding()).getOtherBinding() == null;
Set the other end of this binding
setRow(int, Row) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre i>=1 && i<=getNbRows();
pre row != null;
pre row.size() == getNbColumns();

post getRow(i).equals(row);
Set the i-th row of this matrix
setSubColumn(int, Column) - Method in class org.jutil.math.matrix.Column
public behavior

pre validIndex(lower);
pre validIndex(lower + column.size() - 1);
pre column != null;

post subColumn(lower, lower + column.size() - 1).equals(column);
Replace a subcolumn of this Column, starting at the given position with the given column.
setSubMatrix(int, int, Matrix) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre matrix != null;
pre validIndex(row, column);
pre validIndex(row + matrix.getNbRows() - 1, column + matrix.getNbColumns() - 1);

post subMatrix(row, column, row + matrix.getNbRows() - 1, column + matrix.getNbColumns() - 1).equals(matrix);
Replace a submatrix of this matrix with the given matrix at the given coordinates.
setSubRow(int, Row) - Method in class org.jutil.math.matrix.Row
public behavior

pre validIndex(lower);
pre validIndex(lower + column.size() - 1);
pre row != null;

post subRow(lower, lower + row.size() - 1).equals(row);
Replace a sub-row of this Row, starting at the given position with the given row.
sign(double) - Static method in class org.jutil.math.Math
public behavior

post (x>=0) => \result == 1;
post (x<0) => \result == -1;
Return the sign of x
Singleton - class org.jutil.java.collections.Singleton.
 
Singleton.SingletonIterator - class org.jutil.java.collections.Singleton.SingletonIterator.
 
Singleton.SingletonIterator(Singleton) - Constructor for class org.jutil.java.collections.Singleton.SingletonIterator
 
Singleton(Object) - Constructor for class org.jutil.java.collections.Singleton
public behavior

post getOnlyElement() == onlyElement;
Initialize a new Singleton containing the given element.
size() - Method in class org.jutil.java.collections.SkipListPQ
See superclass.
size() - Method in class org.jutil.java.collections.SkipList
See superclass
size() - Method in interface org.jutil.java.collections.PriorityQueue
public behavior

post \result == (\sum Object o; ; nbExplicitOccurrences(o));
Return the size of this PriorityQueue.
size() - Method in class org.jutil.java.collections.FifoList
See superclass.
size() - Method in class org.jutil.java.collections.BlockingFifoList
See superclass.
size() - Method in class org.jutil.java.collections.SynchronizedFifoList
See superclass.
size() - Method in interface org.jutil.java.collections.Fifo
public behavior

post \result == elements.size();
Return the size of this BlockingFifoList.
size() - Method in class org.jutil.java.collections.BinomialHeap
See superclass.
size() - Method in class org.jutil.java.collections.Singleton
also public behavior

post \result == 1;
See superclass
size() - Method in class org.jutil.math.matrix.Row
post \result == getNbColumns();
Return the size of this Row.
size() - Method in class org.jutil.math.matrix.Column
post \result == getNbRows();
Return the size of this Column.
size() - Method in class org.jutil.structure.StructureSet
public behavior

post \reulst == (\num_of StructureElement e; contains(e); 1);
Return the size of the StructureSet
size() - Method in class org.jutil.event.ChainNotifier
public behavior
post \result == notifiers.length();
SkipList - class org.jutil.java.collections.SkipList.
A collections which is actually a sorted list.
SkipList(Comparator) - Constructor for class org.jutil.java.collections.SkipList
public behavior

pre comparator != null;

post getMaxLevel() == 8;
post size() == 0;
post getProbability() == 0.25;


private behavior

post level() == 1;
Initialize a new SkipList with the given comparator.
SkipList(int, Comparator, float) - Constructor for class org.jutil.java.collections.SkipList
public behavior

pre maxLevel >= 1;
pre comparator != null;
pre probability >= 0;
pre probability <= 1;

post getMaxLevel() == maxLevel;
post size() == 0;
post getProbability() == probability;


private behavior

post level() == 1;
Initialize a new SkipList with the given maximum level, comparator and probability.
SkipListPQ - class org.jutil.java.collections.SkipListPQ.
A SkipList based priority queue
SkipListPQ(Comparator) - Constructor for class org.jutil.java.collections.SkipListPQ
public behavior

post size() == 0;
post getComparator() == comparator;
Initialize a new SkipListPQ with the given comparator.
SliderControlledLabel - class org.jutil.java.swing.SliderControlledLabel.
A SliderControlledLabel is a JLabel that keeps its text equal to the value of a JSlider.
SliderControlledLabel(JSlider) - Constructor for class org.jutil.java.swing.SliderControlledLabel
public invariant (* If getSlider() is not sending events,
getText().equals(
Integer.toString(getSlider().getValue())
)
*);
// The slider may not be null
public invariant getSlider() != null;
// This SliderControlledLabel is registered as a ChangeListener with the slider.
smaller(Object, Object) - Method in class org.jutil.java.collections.ExtendedComparator
public behavior

post \result == (compare(first, second) < 0);
solve(Matrix, Column) - Method in class org.jutil.math.matrix.QRLeastSquaresSolver
see superclass
solve(Matrix, Column) - Method in interface org.jutil.math.matrix.LinSolver
public behavior

pre A != null;
pre b != null;
pre b.size() == A.getNbRows();
pre A.isSquare();
pre (* A is nonsingular *);

// Aside from rounding errors, A * x = b
post (* A.times(\result).equals(b) *)
Solve the system of linear equations as defined by A * x = b
solve(Matrix, Column) - Method in class org.jutil.math.matrix.QRLinSolver
see superclass
solve(Matrix, Column) - Method in class org.jutil.math.matrix.LULinSolver
see superclass
solve(Matrix, Column) - Method in interface org.jutil.math.matrix.LeastSquaresSolver
public behavior

pre A != null;
pre b != null;
pre b.size() == A.getNbRows();

post (* (\forall Column col; col.size() == b.size();
b.minus(A.times(\result)).norm(2) <=
b.minus(A.times(col)).norm(2)) *);
StackTrace - class org.jutil.java.throwable.StackTrace.
Utility methods to deal with the stack trace of throwables.
StackTrace() - Constructor for class org.jutil.java.throwable.StackTrace
 
stateChanged(ChangeEvent) - Method in class org.jutil.java.swing.SliderControlledLabel
public behavior

post getText().equals(Integer.toString(slider.getValue()));
Update this SliderControlledLabel.
StructureElement - class org.jutil.structure.StructureElement.
A class of "components" for inplementing a 1-n binding.
StructureElement(Object) - Constructor for class org.jutil.structure.StructureElement
public invariant getStructureSet() != null =>
getStructureSet().contains(this);

public behavior

pre object != null;

post getObject() == object;
post getStructuredSet() == null;
Initialize a new StructureElement for the given object.
StructureElement(Object, StructureSet) - Constructor for class org.jutil.structure.StructureElement
public behavior

pre object != null;

post getObject() == object;
post getStructuredSet() == set;
post set != null => set.contains(this);
Initialize a new StructureElement for the given object, connected to the given StructureSet.
StructureSet - class org.jutil.structure.StructureSet.
A class of "components" for inplementing a 1-n binding.
StructureSet(Object) - Constructor for class org.jutil.structure.StructureSet
public invariant (\forall StructureElement e; contains(e);
e.getStructureSet() == this);

public behavior

pre object != null;

post getObject() == object;
post (\forall StructuredElement s;; !contains(s));
Initialize an empty StructureSet for the given object.
subColumn(int, int) - Method in class org.jutil.math.matrix.Column
public behavior

pre validIndex(lower);
pre validIndex(upper);
pre lower <= upper;

post \result != null;
post \result.size() == upper - lower + 1;
post (\forall int i; i >= lower && i <= upper;
\result.elementAt(i - lower + 1) == elementAt(i));
Return a sub-column of this column starting from and ending at
subMatrix(int, int, int, int) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre validIndex(x1, y1);
pre validIndex(x2, y2);
pre x2 >= x1;
pre y2 >= y1;

post \fresh(\result);
post \result.getNbRows() == x2 - x1 + 1;
post \result.getNbColumns() == y2 - y1 + 1;
post (\forall int i; i>=x1 && i <=x2;
(\forall int j; j>=y1 && j <=y2;
\result.elementAt(i - x1 + 1, j - y1 + 1) == elementAt(i, j)));
Return the submatrix starting from (x1,y1) to (x2,y2).
subRow(int, int) - Method in class org.jutil.math.matrix.Row
public behavior

pre validIndex(lower);
pre validIndex(upper);
pre lower <= upper;

post \result != null;
post \result.size() == upper - lower + 1;
post (\forall int i; i >= lower && i <= upper;
\result.elementAt(i - lower + 1) == elementAt(i));
Return a sub-row of this row starting from and ending at
subtract(Matrix) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre other != null;
pre sameDimensions(other);

post (\forall int i; i>=1 && i <= getNbRows();
(\forall int j; j>=1 && j <= getNbColumns();
elementAt(i,j) ==
\old(elementAt(i,j)) - other.elementAt(i,j)));
Subtract the given matrix from this matrix.
SynchronizedFifoList - class org.jutil.java.collections.SynchronizedFifoList.
Synchronized version of a FifoList.
SynchronizedFifoList() - Constructor for class org.jutil.java.collections.SynchronizedFifoList
 

T

terminate() - Method in class org.jutil.java.swing.SliderControlledLabel
public behavior

post getSlider() == null;
// Can not work correct for pre-1.4 jdk's.
post (\forall int i; i >= 0 && i< \old(getSlider()).getChangeListeners().length;
\old(getSlider()).getChangeListeners()[i] != this);
Terminate this SliderControlledLabel.
times(double) - Method in class org.jutil.math.matrix.Matrix
public behavior

post \result != null;
post \result.sameDimensions(this);
post (\forall int i; i>=1 && i<= getNbRows();
(\forall int j; j>=1 && j<= getNbColumns();
\result.elementAt(i,j) == elementAt(i,j) * factor));
Return a matrix that equals this matrix times a given factor.
times(Matrix) - Method in class org.jutil.math.matrix.Matrix
public behavior

pre other != null;
pre other.getNbRows() == getNbColumns();
pre other.getNbColumns() == getNbRows();

post \result != null;
post (\forall int i; i>=1 && i<= getNbRows();
(\forall int j; j>=1 && j<= other.getNbColumns();
\result.elementAt(i,j) ==
(\sum int k; k>=1 && k<= getNbColumns();
elementAt(i,k) * other.elementAt(k,j))));
post \result.getNbRows() == getNbRows();
post \result.getNbColumns() == other.getNbColumns();
post \fresh(result);

// MvDMvDMvD We should put this everywhere we return a matrix
// since matrices are mutable.
toArray() - Method in class org.jutil.java.collections.Singleton
also public behavior

post \result.length = 1;
post \result[0] == getOnlyElement();
See superclass
toArray(Object[]) - Method in class org.jutil.java.collections.Singleton
also public behavior

post \result.getClass().getComponentType() == a.getClass().getComponentType();
post \result[0] == getOnlyElement();
post (a.length >= 1) ==> (\result == a);
post (a.length < 1) ==> (\result.length == 1);
exception NullPointerException
a == null;
exception ArrayStoreException
(getOnlyElement() != null) &&
(! a.getClass().isInstance(getOnlyElement()));
See superclass
toEnd() - Method in class org.jutil.java.collections.ObjectArrayIterator
Set this iterator to the end of the array.
toEnd() - Method in class org.jutil.java.collections.ArrayCursor
// The iterator will be positioned at the end of the array.
post atEnd()==true;
Set this ArrayCursor to the end of the array.
toStart() - Method in class org.jutil.java.collections.ObjectArrayIterator
Set this iterator to the beginning of the array.
toStart() - Method in class org.jutil.java.collections.ArrayCursor
// The iterator will be positioned at the beginning of the array.
post atStart()==true;
Set this ArrayCursor to the beginning of the array.
toString() - Method in class org.jutil.java.collections.SkipList
See superclass
toString() - Method in class org.jutil.math.matrix.Matrix
see superclass
toString() - Method in class org.jutil.junit.AbstractRevision
See superclass
toString() - Method in class org.jutil.event.EventSourceSupport
A String representation of this.
TransitiveClosure - class org.jutil.java.collections.TransitiveClosure.
An operator that calculates the transitive closure of a graph of objects.
TransitiveClosure() - Constructor for class org.jutil.java.collections.TransitiveClosure
 
transpose() - Method in class org.jutil.math.matrix.Matrix
public behavior

post getNbColumns() == \old(getNbRows());
post getNbRows() == \old(getNbColumns());
post (\forall int i; i>=1 && i<=getNbRows();
(\forall int j; j>=1 && j elementAt(i,j) == \old(elementAt(j,i))));
Transpose this matrix.
TypeApplicabilityNotifier - class org.jutil.event.TypeApplicabilityNotifier.
A support class for optional notifiers that depend on the type of the listener and the event to be processed.
TypeApplicabilityNotifier(Class) - Constructor for class org.jutil.event.TypeApplicabilityNotifier
public behavior
pre listenerType != null;
pre Class.forName("java.util.EventListener").isAssignableFrom(listenerType);
assignable listenerType, eventType;
post this.listenerType == listenerType;
post this.eventType == Class.forName("java.util.EventObject");
TypeApplicabilityNotifier(Class, Class) - Constructor for class org.jutil.event.TypeApplicabilityNotifier
public behavior
pre listenerType != null;
pre Class.forName("java.util.EventListener").isAssignableFrom(listenerType);
pre eventType != null;
pre Class.forName("java.util.EventObject").isAssignableFrom(eventType);
assignable listenerType, eventType;
post this.listenerType == listenerType;
post this.eventType == eventType;
TypeFilter - class org.jutil.java.collections.TypeFilter.
A class of filters that use the type of an object as criterion.
TypeFilter(Class) - Constructor for class org.jutil.java.collections.TypeFilter
public behavior

// The given type may not be null.
pre type != null;

// The type of this TypeFilter is set to the given type.
post getType() == type;
TypeFilter(String) - Constructor for class org.jutil.java.collections.TypeFilter
public behavior

// may not be null
pre name != null;
// must be a valid classname
pre (* must be a valid classname *);

// The type of this TypeFilter is set to the type
// with the given name.
post getType() == Clazz.forName(name);

signals (LinkageError) (* something went wrong *);
signals (ExceptionInInitializerError) (* something went wrong *);
signals (IllegalArgumentException) (* Illegal Class Name *);

U

U() - Method in interface org.jutil.math.matrix.LUDecomposition
public behavior

post \result != null;
post \result.isSquare();
post \result.isUpperTriangular();
Return the U matrix of this LU factorization.
U() - Method in class org.jutil.math.matrix.DefaultLUDecomposition
See superclass
unity(int) - Static method in class org.jutil.math.matrix.Matrix
public behavior

pre size > 0;

post \fresh(\result);
post \result.getNbRows() == size;
post \result.getNbColumns() == size;
post (\forall int i; i>=1 && i<=size;
(\forall int j; j>=1 && j<=size;
((i==j) => \result.elementAt(i,j)==1) &&
((i!=j) => \result.elementAt(i,j)==0)));
Return a new unity matrix of the given size
unvisit(Object, Object) - Method in class org.jutil.java.collections.RobustVisitor
public behavior

pre isValidElement(element);

// unvisitData is the data returned by the visit method.
pre unvisitData == visit(element);

post (* the changes on done by visit are undone *);
This method will be called when the visit method has raised an exception for some element which was visited after .
unvisit(Object, Object, Object) - Method in class org.jutil.java.collections.RobustMapVisitor
public behavior

pre isValidPair(key, value);
// unvisitData is the data returned by the visit method.
pre unvisitData == visit(key,value);

post (* the changes on , done by visit are undone *);
This method will be called when the visit method has raised an exception for some key,value pair which was visited after ,.

V

validIndex(int) - Method in class org.jutil.math.matrix.Row
post \result == (index > 0) && (index <= size());
Check whether or not the given index is a valid index for this Column.
validIndex(int) - Method in class org.jutil.math.matrix.Column
post \result == (index > 0) && (index <= size());
Check whether or not the given index is a valid index for this Column.
validIndex(int[]) - Method in class org.jutil.math.matrix.NMatrix
post \result == (index != null) &&
(index.length == getNbDimensions()) &&
(\forall int i; i>=0 && i (index[i] > 0) && (index[i] <= getDimensions()[i]));
Check whether or not the given index is a valid index for this matrix.
validIndex(int, int) - Method in class org.jutil.math.matrix.Matrix
public behavior

post \result == (row > 0) &&
(row <= getNbRows()) &&
(column > 0) &&
(column <= getNbColumns());
Check whether or not the given row and column point to a valid position for this Matrix.
visit(Object) - Method in class org.jutil.java.collections.RobustVisitor
public behavior

pre isValidElement(element);

post (* Data which enables to undo what visit has done
in unvisit is returned.
visit(Object) - Method in class org.jutil.java.collections.Visitor
public behavior

pre isValidElement(element);
The code to be applied to all elements of a collection.
visit(Object, Object) - Method in class org.jutil.java.collections.MapVisitor
public behavior

pre isValidPair(key, value);
The code to be applied to all element pairs of a map.
visit(Object, Object) - Method in class org.jutil.java.collections.RobustMapVisitor
public behavior

pre isValidPair(key, value);

post (* returns Data which enables to undo what visit has done
in unvisit.
Visitor - class org.jutil.java.collections.Visitor.
A class of collection operators that can perform a certain action on all element of a collection.
Visitor() - Constructor for class org.jutil.java.collections.Visitor
 

Z

ZeroDimensionException - exception org.jutil.java.collections.ZeroDimensionException.
A class of exceptions indicating the attempt to use a class in this package with an object array that has at least one dimension equal to zero.
ZeroDimensionException(Object[]) - Constructor for class org.jutil.java.collections.ZeroDimensionException
// The array that causes a ZeroDimensionException
// can not be null
public invariant getArray() != null;

// may not be null
pre array != null;

// The array of this ZeroDimensionException is set to .
post getArray() == array;
Initialize a new ZeroDimensionException with the given array.
ZeroDimensionException(Object[], String) - Constructor for class org.jutil.java.collections.ZeroDimensionException
// may not be null
pre array != null;

// The array of this ZeroDimensionException is set to .
post getArray() == array;
// The message of this ZeroDimensionException is set to .
post getMessage() == msg;
Initialize a new ZeroDimensionException with the given array and message.

A B C D E F G H I J L M N O P Q R S T U V Z