Arti argumen epsilon dari assertEquals untuk nilai ganda

Saya punya pertanyaan tentang junit assertEqualsuntuk menguji nilai ganda. Membaca dokumen API saya bisa melihat:

@Deprecated
public static void assertEquals(double expected, double actual)

Usang. Gunakan assertEquals sebagai gantinya

Apa artinya epsilonnilainya? (Epsilon adalah huruf dalam alfabet Yunani, kan?).

Adakah yang bisa menjelaskan kepada saya bagaimana cara menggunakannya?

Epsilon adalah nilai yang bisa dimatikan oleh 2 angka. Jadi itu akan menegaskan kebenaran selamaMath.abs(expected - actual) < epsilon

Versi JUnit manakah ini? Saya hanya pernah melihat delta, bukan epsilon - tapi itu masalah sampingan!

Dari jUnit javadoc :

delta - delta maksimum antara yang diharapkan dan aktual yang kedua bilangannya masih dianggap sama.

Ini mungkin berlebihan, tetapi saya biasanya menggunakan jumlah yang sangat kecil, misalnya

private static final double DELTA = 1e-15;

@Test
public void testDelta(){
    assertEquals(123.456, 123.456, DELTA);
}

Jika Anda menggunakan pernyataan hamcrest , Anda bisa menggunakan standar equalTo()dengan dua ganda (tidak menggunakan delta). Namun jika Anda ingin delta, Anda bisa menggunakan closeTo()(lihat javadoc ), mis

private static final double DELTA = 1e-15;

@Test
public void testDelta(){
    assertThat(123.456, equalTo(123.456));
    assertThat(123.456, closeTo(123.456, DELTA));
}

FYI JUnit 5 mendatang juga akan membuat delta opsional saat memanggil assertEquals()dengan dua ganda. The pelaksanaan (jika Anda tertarik) adalah:

private static boolean doublesAreEqual(double value1, double value2) {
    return Double.doubleToLongBits(value1) == Double.doubleToLongBits(value2);
}

Perhitungan floating point tidak tepat - sering ada kesalahan pembulatan, dan kesalahan karena representasi. (Misalnya, 0,1 tidak dapat secara tepat direpresentasikan dalam titik mengambang biner.)

Karena itu, secara langsung membandingkan dua nilai floating point untuk kesetaraan biasanya bukan ide yang baik, karena mereka dapat berbeda dengan jumlah kecil, tergantung pada bagaimana mereka dihitung.

"Delta", seperti yang disebut dalam javadocs JUnit , menjelaskan jumlah perbedaan yang dapat Anda toleransi dalam nilai agar mereka dianggap sama. Ukuran nilai ini sepenuhnya tergantung pada nilai yang Anda bandingkan. Saat membandingkan ganda, saya biasanya menggunakan nilai yang diharapkan dibagi 10 ^ 6.

Masalahnya adalah bahwa dua ganda mungkin tidak persis sama karena masalah presisi yang melekat pada angka floating point. Dengan nilai delta ini, Anda dapat mengontrol evaluasi kesetaraan berdasarkan faktor kesalahan.

Juga beberapa nilai floating-point dapat memiliki nilai khusus seperti NAN dan -Infinity / + Infinity yang dapat mempengaruhi hasil.

Jika Anda benar-benar berniat untuk membandingkan bahwa dua ganda sama persis, lebih baik membandingkannya sebagai representasi panjang

Assert.assertEquals(Double.doubleToLongBits(expected), Double.doubleToLongBits(result));

Atau

Assert.assertEquals(0, Double.compareTo(expected, result));

Yang bisa memperhitungkan nuansa ini.

Saya belum mempelajari metode Assert yang dipermasalahkan, tetapi saya hanya bisa berasumsi bahwa sebelumnya sudah tidak digunakan lagi untuk masalah seperti ini dan yang baru memperhitungkannya.

Epsilon adalah perbedaan antara expecteddan actualnilai - nilai yang dapat Anda terima dengan menganggap mereka setara. Anda dapat mengatur .1misalnya.

Perhatikan bahwa jika Anda tidak melakukan matematika, tidak ada yang salah dengan menyatakan nilai floating point yang tepat. Misalnya:

public interface Foo {
    double getDefaultValue();
}

public class FooImpl implements Foo {
    public double getDefaultValue() { return Double.MIN_VALUE; }
}

Dalam hal ini, Anda ingin memastikan itu benar-benar MIN_VALUE, bukan nol atau -MIN_VALUEatau MIN_NORMALatau nilai yang sangat kecil lainnya. Bisa dibilang begitu

double defaultValue = new FooImpl().getDefaultValue();
assertEquals(Double.MIN_VALUE, defaultValue);

tetapi ini akan memberi Anda peringatan penghentian. Untuk menghindarinya, Anda bisa menelepon assertEquals(Object, Object):

// really you just need one cast because of autoboxing, but let's be clear
assertEquals((Object)Double.MIN_VALUE, (Object)defaultValue);

Dan, jika Anda benar-benar ingin terlihat pintar:

assertEquals(
    Double.doubleToLongBits(Double.MIN_VALUE), 
    Double.doubleToLongBits(defaultValue)
);

Atau Anda bisa menggunakan pernyataan gaya lancar Hamcrest:

// equivalent to assertEquals((Object)Double.MIN_VALUE, (Object)defaultValue);
assertThat(defaultValue, is(Double.MIN_VALUE));

Jika nilai Anda memeriksa sedang tidak datang dari melakukan beberapa matematika, meskipun, menggunakan epsilon tersebut.

Assert.assertTrue(Math.abs(actual-expected) == 0)