plume

Class FuzzyFloat

java.lang.Object

plume.FuzzyFloat

Deprecated.

use org.plumelib.util.FuzzyFloat

@Deprecated
public class FuzzyFloat
extends java.lang.Object

Routines for doing approximate ('fuzzy') floating point comparisons. Those are comparisons that only require the floating point numbers to be relatively close to one another to be equal, rather than exactly equal.

Floating point numbers are compared for equality by dividing them by one another and comparing the ratio. By default they must be within 0.0001 (0.01%) to be considered equal; supply this value to the FuzzyFloat constructor, or set the value with the set_rel_diff method. Note that zero is never equal to a non-zero number using this method.

Two NaN floats are not considered equal (consistent with the == operator).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	FuzzyFloat.DoubleArrayComparatorLexical Deprecated. Lexically compares two double arrays.

Constructor Summary

Constructors

Constructor and Description
FuzzyFloat() Deprecated. Creates a FuzzyFloat with the default rel_diff value of .0001.
FuzzyFloat(double rel_diff) Deprecated. Creates a FuzzyFloat.

Method Summary

Modifier and Type	Method and Description
boolean	eq(double d1, double d2) Deprecated. Test d1 and d2 for equality using the current ratio.
boolean	gt(double d1, double d2) Deprecated. test d1 and d2 for d1 > d2.
boolean	gte(double d1, double d2) Deprecated. test d1 and d2 for d1 ≥ d2.
int	indexOf(double[] a, double elt) Deprecated. Searches for the first occurrence of elt in a.
int	indexOf(double[] a, double[] sub) Deprecated. Searches for the first subsequence of a that matches sub elementwise.
boolean	isElemMatch(double[] a1, double[] a2) Deprecated. Determines whether or not a1 and a2 are set equivalent (contain only the same elements).
boolean	isSubset(double[] smaller, double[] bigger) Deprecated. Determines whether smaller is a subset of bigger.
boolean	lt(double d1, double d2) Deprecated. Test d1 and d2 for d1 < d2.
boolean	lte(double d1, double d2) Deprecated. Test d1 and d2 for d1 &le; d2.
boolean	ne(double d1, double d2) Deprecated. Test d1 and d2 for non-equality using the current ratio.
void	set_rel_diff(double rel_diff) Deprecated. Set all the fields of this class.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FuzzyFloat

public FuzzyFloat()

Deprecated.

Creates a FuzzyFloat with the default rel_diff value of .0001.

FuzzyFloat

public FuzzyFloat(double rel_diff)

Deprecated.

Creates a FuzzyFloat. Specify the specific relative difference allowed between two floats in order for them to be equal. The default is 0.0001 a relative diff of zero, disables it (i.e., only exact matches work).

Parameters:

rel_diff - the relative diff to use

Method Detail

set_rel_diff

public void set_rel_diff(double rel_diff)

Deprecated.

Set all the fields of this class.

Parameters:

rel_diff - the new relative diff to use

See Also:

FuzzyFloat(double)

eq

public boolean eq(double d1,
                  double d2)

Deprecated.

Test d1 and d2 for equality using the current ratio. Two NaN floats are not considered equal (consistent with the == operator).

Note that if one of the numbers if 0.0, then the other number must be less than the square of the fuzzy ratio. This policy accommodates round off errors in floating point values.

Parameters:

d1 - the first value to compare

d2 - the second value to compare

Returns:

true if d1 and d2 are considered equal, false otherwise

ne

public boolean ne(double d1,
                  double d2)

Deprecated.

Test d1 and d2 for non-equality using the current ratio.

Parameters:

d1 - the first value to compare

d2 - the second value to compare

Returns:

whether d1 and d2 are non-equal

See Also:

eq(double, double)

lt

public boolean lt(double d1,
                  double d2)

Deprecated.

Test d1 and d2 for d1 < d2. If d1 is equal to d2 using the current ratio this returns false.

Parameters:

d1 - the first value to compare

d2 - the second value to compare

Returns:

whether d1 < d2

See Also:

eq(double, double)

lte

public boolean lte(double d1,
                   double d2)

Deprecated.

Test d1 and d2 for d1 ≤ d2. If d1 is equal to d2 using the current ratio, this returns true.

Parameters:

d1 - the first value to compare

d2 - the second value to compare

Returns:

whether d1 ≤ d2

See Also:

eq(double, double)

gt

public boolean gt(double d1,
                  double d2)

Deprecated.

test d1 and d2 for d1 > d2. IF d1 is equal to d2 using the current ratio, this returns false.

Parameters:

d1 - the first value to compare

d2 - the second value to compare

Returns:

whether d1 > d2

See Also:

eq(double, double)

gte

public boolean gte(double d1,
                   double d2)

Deprecated.

test d1 and d2 for d1 ≥ d2. If d1 is equal to d2 using the current ratio, this returns true.

Parameters:

d1 - the first value to compare

d2 - the second value to compare

Returns:

whether d1 ≥ d2

See Also:

eq(double, double)

indexOf

public int indexOf(double[] a,
                   double elt)

Deprecated.

Searches for the first occurrence of elt in a. elt is considered equal to a[i] if it passes the eq(double, double) test.

Parameters:

a - the array to search

elt - the element to search for

Returns:

the first index containing the specified element, or -1 if the element is not found in the array

See Also:

ArrayList.indexOf(java.lang.Object)

indexOf

public int indexOf(double[] a,
                   double[] sub)

Deprecated.

Searches for the first subsequence of a that matches sub elementwise. Elements of sub are considered to match elements of a if they pass the eq(double, double) test.

Parameters:

a - the sequence to search in

sub - the sequence to search for

Returns:

the first index whose subarray is equal to the specified array or -1 if no such subarray is found in the array

See Also:

ArrayList.indexOf(java.lang.Object), String.indexOf(java.lang.String)

isElemMatch

public boolean isElemMatch(double[] a1,
                           double[] a2)

Deprecated.

Determines whether or not a1 and a2 are set equivalent (contain only the same elements). Element comparison uses eq(double, double).

Note that this implementation is optimized for cases where the elements are actually the same, since it does a sort of both arrays before starting the comparisons.

Parameters:

a1 - the first set to compare

a2 - the second set to compare

Returns:

true if a1 and a2 are set equivalent, false otherwise

isSubset

public boolean isSubset(double[] smaller,
                        double[] bigger)

Deprecated.

Determines whether smaller is a subset of bigger. Element comparison uses eq(double, double).

Note that this implementation is optimized for cases where the elements are actually the same, since it does a sort of both arrays before starting the comparisons.

Parameters:

smaller - the possibly-smaller subset

bigger - the possibly-larger set

Returns:

true if smaller is a subset (each element of smaller is also a element of bigger) of bigger, false otherwise