blob: 5f88baed47ef7160ad7f6f9d55dc39783dc31758 [file] [log] [blame]
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.datasketches.kll;
import static org.apache.datasketches.kll.KllSketch.SketchType.FLOATS_SKETCH;
import static org.testng.Assert.assertEquals;
import static org.testng.Assert.assertFalse;
import static org.testng.Assert.assertTrue;
import static org.testng.Assert.fail;
import org.apache.datasketches.common.SketchesArgumentException;
import org.apache.datasketches.memory.DefaultMemoryRequestServer;
import org.apache.datasketches.memory.WritableMemory;
import org.apache.datasketches.quantilescommon.FloatsSortedView;
import org.apache.datasketches.quantilescommon.FloatsSortedViewIterator;
import org.testng.annotations.Test;
public class KllMiscDirectFloatsTest {
static final String LS = System.getProperty("line.separator");
private static final DefaultMemoryRequestServer memReqSvr = new DefaultMemoryRequestServer();
@Test
public void checkBounds() {
final KllFloatsSketch kll = getDirectFloatsSketch(200, 0);
for (int i = 0; i < 1000; i++) {
kll.update(i);
}
final double eps = kll.getNormalizedRankError(false);
final float est = kll.getQuantile(0.5);
final float ub = kll.getQuantileUpperBound(0.5);
final float lb = kll.getQuantileLowerBound(0.5);
assertEquals(ub, kll.getQuantile(.5 + eps));
assertEquals(lb, kll.getQuantile(0.5 - eps));
println("Ext : " + est);
println("UB : " + ub);
println("LB : " + lb);
final double rest = kll.getRank(est);
final double restUB = kll.getRankUpperBound(rest);
final double restLB = kll.getRankLowerBound(rest);
assertTrue(restUB - rest < (2 * eps));
assertTrue(rest - restLB < (2 * eps));
}
//@Test //enable static println(..) for visual checking
public void visualCheckToString() {
final int k = 20;
final KllFloatsSketch sk = getDirectFloatsSketch(k, 0);
for (int i = 0; i < 10; i++) { sk.update(i + 1); }
println(sk.toString(true, true));
final KllFloatsSketch sk2 = getDirectFloatsSketch(k, 0);
for (int i = 0; i < 400; i++) { sk2.update(i + 1); }
println("\n" + sk2.toString(true, true));
sk2.merge(sk);
final String s2 = sk2.toString(true, true);
println(LS + s2);
}
@Test
public void viewDirectCompactions() {
int k = 20;
int u = 108;
KllFloatsSketch sk = getDirectFloatsSketch(k, 0);
for (int i = 1; i <= u; i++) {
sk.update(i);
if (sk.levelsArr[0] == 0) {
println(sk.toString(true, true));
sk.update(++i);
println(sk.toString(true, true));
assertEquals(sk.getFloatItemsArray()[sk.levelsArr[0]], i);
}
}
}
@Test
public void viewCompactionAndSortedView() {
int k = 20;
KllFloatsSketch sk = getDirectFloatsSketch(k, 0);
show(sk, 20);
FloatsSortedView sv = sk.getSortedView();
FloatsSortedViewIterator itr = sv.iterator();
printf("%12s%12s\n", "Value", "CumWeight");
while (itr.next()) {
float v = itr.getQuantile();
long wt = itr.getWeight();
printf("%12.1f%12d\n", v, wt);
}
}
private static void show(final KllFloatsSketch sk, int limit) {
int i = (int) sk.getN();
for ( ; i < limit; i++) { sk.update(i + 1); }
println(sk.toString(true, true));
}
@Test
public void checkSketchInitializeFloatHeap() {
int k = 20; //don't change this
KllFloatsSketch sk;
//println("#### CASE: FLOAT FULL HEAP");
sk = getDirectFloatsSketch(k, 0);
for (int i = 1; i <= k + 1; i++) { sk.update(i); }
//println(sk.toString(true, true));
assertEquals(sk.getK(), k);
assertEquals(sk.getN(), k + 1);
assertEquals(sk.getNumRetained(), 11);
assertFalse(sk.isEmpty());
assertTrue(sk.isEstimationMode());
assertEquals(sk.getMinK(), k);
assertEquals(sk.getFloatItemsArray().length, 33);
assertEquals(sk.getLevelsArray(sk.sketchStructure).length, 3);
assertEquals(sk.getMaxItem(), 21.0F);
assertEquals(sk.getMinItem(), 1.0F);
assertEquals(sk.getNumLevels(), 2);
assertFalse(sk.isLevelZeroSorted());
//println("#### CASE: FLOAT HEAP EMPTY");
sk = getDirectFloatsSketch(k, 0);
//println(sk.toString(true, true));
assertEquals(sk.getK(), k);
assertEquals(sk.getN(), 0);
assertEquals(sk.getNumRetained(), 0);
assertTrue(sk.isEmpty());
assertFalse(sk.isEstimationMode());
assertEquals(sk.getMinK(), k);
assertEquals(sk.getFloatItemsArray().length, 20);
assertEquals(sk.getLevelsArray(sk.sketchStructure).length, 2);
try { sk.getMaxItem(); fail(); } catch (SketchesArgumentException e) { }
try { sk.getMinItem(); fail(); } catch (SketchesArgumentException e) { }
assertEquals(sk.getNumLevels(), 1);
assertFalse(sk.isLevelZeroSorted());
//println("#### CASE: FLOAT HEAP SINGLE");
sk = getDirectFloatsSketch(k, 0);
sk.update(1);
//println(sk.toString(true, true));
assertEquals(sk.getK(), k);
assertEquals(sk.getN(), 1);
assertEquals(sk.getNumRetained(), 1);
assertFalse(sk.isEmpty());
assertFalse(sk.isEstimationMode());
assertEquals(sk.getMinK(), k);
assertEquals(sk.getFloatItemsArray().length, 20);
assertEquals(sk.getLevelsArray(sk.sketchStructure).length, 2);
assertEquals(sk.getMaxItem(), 1.0F);
assertEquals(sk.getMinItem(), 1.0F);
assertEquals(sk.getNumLevels(), 1);
assertFalse(sk.isLevelZeroSorted());
}
@Test
public void checkSketchInitializeFloatHeapifyCompactMem() {
int k = 20; //don't change this
KllFloatsSketch sk;
KllFloatsSketch sk2;
byte[] compBytes;
WritableMemory wmem;
//println("#### CASE: FLOAT FULL HEAPIFIED FROM COMPACT");
sk2 = getDirectFloatsSketch(k, 0);
for (int i = 1; i <= k + 1; i++) { sk2.update(i); }
//println(sk.toString(true, true));
compBytes = sk2.toByteArray();
wmem = WritableMemory.writableWrap(compBytes);
//println(KllPreambleUtil.toString(wmem));
sk = KllFloatsSketch.heapify(wmem);
assertEquals(sk.getK(), k);
assertEquals(sk.getN(), k + 1);
assertEquals(sk.getNumRetained(), 11);
assertFalse(sk.isEmpty());
assertTrue(sk.isEstimationMode());
assertEquals(sk.getMinK(), k);
assertEquals(sk.getFloatItemsArray().length, 33);
assertEquals(sk.getLevelsArray(sk.sketchStructure).length, 3);
assertEquals(sk.getMaxItem(), 21.0F);
assertEquals(sk.getMinItem(), 1.0f);
assertEquals(sk.getNumLevels(), 2);
assertFalse(sk.isLevelZeroSorted());
//println("#### CASE: FLOAT EMPTY HEAPIFIED FROM COMPACT");
sk2 = getDirectFloatsSketch(k, 0);
//println(sk.toString(true, true));
compBytes = sk2.toByteArray();
wmem = WritableMemory.writableWrap(compBytes);
//println(KllPreambleUtil.toString(wmem));
sk = KllFloatsSketch.heapify(wmem);
assertEquals(sk.getK(), k);
assertEquals(sk.getN(), 0);
assertEquals(sk.getNumRetained(), 0);
assertTrue(sk.isEmpty());
assertFalse(sk.isEstimationMode());
assertEquals(sk.getMinK(), k);
assertEquals(sk.getFloatItemsArray().length, 20);
assertEquals(sk.getLevelsArray(sk.sketchStructure).length, 2);
try { sk.getMaxItem(); fail(); } catch (SketchesArgumentException e) { }
try { sk.getMinItem(); fail(); } catch (SketchesArgumentException e) { }
assertEquals(sk.getNumLevels(), 1);
assertFalse(sk.isLevelZeroSorted());
//println("#### CASE: FLOAT SINGLE HEAPIFIED FROM COMPACT");
sk2 = getDirectFloatsSketch(k, 0);
sk2.update(1);
//println(sk2.toString(true, true));
compBytes = sk2.toByteArray();
wmem = WritableMemory.writableWrap(compBytes);
//println(KllPreambleUtil.toString(wmem));
sk = KllFloatsSketch.heapify(wmem);
assertEquals(sk.getK(), k);
assertEquals(sk.getN(), 1);
assertEquals(sk.getNumRetained(), 1);
assertFalse(sk.isEmpty());
assertFalse(sk.isEstimationMode());
assertEquals(sk.getMinK(), k);
assertEquals(sk.getFloatItemsArray().length, 20);
assertEquals(sk.getLevelsArray(sk.sketchStructure).length, 2);
assertEquals(sk.getMaxItem(), 1.0F);
assertEquals(sk.getMinItem(), 1.0F);
assertEquals(sk.getNumLevels(), 1);
assertFalse(sk.isLevelZeroSorted());
}
@Test
public void checkSketchInitializeFloatHeapifyUpdatableMem() {
int k = 20; //don't change this
KllFloatsSketch sk;
KllFloatsSketch sk2;
byte[] compBytes;
WritableMemory wmem;
//println("#### CASE: FLOAT FULL HEAPIFIED FROM UPDATABLE");
sk2 = getDirectFloatsSketch(k, 0);
for (int i = 1; i <= k + 1; i++) { sk2.update(i); }
//println(sk2.toString(true, true));
compBytes = KllHelper.toByteArray(sk2,true);
wmem = WritableMemory.writableWrap(compBytes);
sk = KllHeapFloatsSketch.heapifyImpl(wmem);
//println(sk.toString(true, true));
assertEquals(sk.getK(), k);
assertEquals(sk.getN(), k + 1);
assertEquals(sk.getNumRetained(), 11);
assertFalse(sk.isEmpty());
assertTrue(sk.isEstimationMode());
assertEquals(sk.getMinK(), k);
assertEquals(sk.getFloatItemsArray().length, 33);
assertEquals(sk.getLevelsArray(sk.sketchStructure).length, 3);
assertEquals(sk.getMaxItem(), 21.0F);
assertEquals(sk.getMinItem(), 1.0F);
assertEquals(sk.getNumLevels(), 2);
assertFalse(sk.isLevelZeroSorted());
// println("#### CASE: FLOAT EMPTY HEAPIFIED FROM UPDATABLE");
sk2 = getDirectFloatsSketch(k, 0);
//println(sk.toString(true, true));
compBytes = KllHelper.toByteArray(sk2, true);
wmem = WritableMemory.writableWrap(compBytes);
//println(KllPreambleUtil.toString(wmem));
sk = KllHeapFloatsSketch.heapifyImpl(wmem);
assertEquals(sk.getK(), k);
assertEquals(sk.getN(), 0);
assertEquals(sk.getNumRetained(), 0);
assertTrue(sk.isEmpty());
assertFalse(sk.isEstimationMode());
assertEquals(sk.getMinK(), k);
assertEquals(sk.getFloatItemsArray().length, 20);
assertEquals(sk.getLevelsArray(sk.sketchStructure).length, 2);
try { sk.getMaxItem(); fail(); } catch (SketchesArgumentException e) { }
try { sk.getMinItem(); fail(); } catch (SketchesArgumentException e) { }
assertEquals(sk.getNumLevels(), 1);
assertFalse(sk.isLevelZeroSorted());
//println("#### CASE: FLOAT SINGLE HEAPIFIED FROM UPDATABLE");
sk2 = getDirectFloatsSketch(k, 0);
sk2.update(1);
//println(sk.toString(true, true));
compBytes = KllHelper.toByteArray(sk2,true);
wmem = WritableMemory.writableWrap(compBytes);
//println(KllPreambleUtil.toString(wmem));
sk = KllHeapFloatsSketch.heapifyImpl(wmem);
assertEquals(sk.getK(), k);
assertEquals(sk.getN(), 1);
assertEquals(sk.getNumRetained(), 1);
assertFalse(sk.isEmpty());
assertFalse(sk.isEstimationMode());
assertEquals(sk.getMinK(), k);
assertEquals(sk.getFloatItemsArray().length, 20);
assertEquals(sk.getLevelsArray(sk.sketchStructure).length, 2);
assertEquals(sk.getMaxItem(), 1.0F);
assertEquals(sk.getMinItem(), 1.0F);
assertEquals(sk.getNumLevels(), 1);
assertFalse(sk.isLevelZeroSorted());
}
@Test
public void checkMemoryToStringFloatUpdatable() {
int k = 20; //don't change this
KllFloatsSketch sk;
KllFloatsSketch sk2;
byte[] upBytes;
byte[] upBytes2;
WritableMemory wmem;
String s;
println("#### CASE: FLOAT FULL UPDATABLE");
sk = getDirectFloatsSketch(k, 0);
for (int i = 1; i <= k + 1; i++) { sk.update(i); }
upBytes = KllHelper.toByteArray(sk, true);
wmem = WritableMemory.writableWrap(upBytes);
s = KllPreambleUtil.toString(wmem, FLOATS_SKETCH, true);
println("step 1: sketch to byte[]/memory & analyze memory");
println(s);
sk2 = KllFloatsSketch.writableWrap(wmem, memReqSvr);
upBytes2 = KllHelper.toByteArray(sk2, true);
wmem = WritableMemory.writableWrap(upBytes2);
s = KllPreambleUtil.toString(wmem, FLOATS_SKETCH, true);
println("step 2: memory to heap sketch, to byte[]/memory & analyze memory. Should match above");
println(s);
assertEquals(upBytes, upBytes2);
println("#### CASE: FLOAT EMPTY UPDATABLE");
sk = getDirectFloatsSketch(k, 0);
upBytes = KllHelper.toByteArray(sk, true);
wmem = WritableMemory.writableWrap(upBytes);
s = KllPreambleUtil.toString(wmem, FLOATS_SKETCH, true);
println("step 1: sketch to byte[]/memory & analyze memory");
println(s);
sk2 = KllFloatsSketch.writableWrap(wmem, memReqSvr);
upBytes2 = KllHelper.toByteArray(sk2, true);
wmem = WritableMemory.writableWrap(upBytes2);
s = KllPreambleUtil.toString(wmem, FLOATS_SKETCH, true);
println("step 2: memory to heap sketch, to byte[]/memory & analyze memory. Should match above");
println(s);
assertEquals(upBytes, upBytes2);
println("#### CASE: FLOAT SINGLE UPDATABL");
sk = getDirectFloatsSketch(k, 0);
sk.update(1);
upBytes = KllHelper.toByteArray(sk, true);
wmem = WritableMemory.writableWrap(upBytes);
s = KllPreambleUtil.toString(wmem, FLOATS_SKETCH, true);
println("step 1: sketch to byte[]/memory & analyze memory");
println(s);
sk2 = KllFloatsSketch.writableWrap(wmem, memReqSvr);
upBytes2 = KllHelper.toByteArray(sk2, true);
wmem = WritableMemory.writableWrap(upBytes2);
s = KllPreambleUtil.toString(wmem, FLOATS_SKETCH, true);
println("step 2: memory to heap sketch, to byte[]/memory & analyze memory. Should match above");
println(s);
assertEquals(upBytes, upBytes2);
}
@Test
public void checkSimpleMerge() {
int k = 20;
int n1 = 21;
int n2 = 21;
KllFloatsSketch sk1 = getDirectFloatsSketch(k, 0);
KllFloatsSketch sk2 = getDirectFloatsSketch(k, 0);
for (int i = 1; i <= n1; i++) {
sk1.update(i);
}
for (int i = 1; i <= n2; i++) {
sk2.update(i + 100);
}
println(sk1.toString(true, true));
println(sk2.toString(true, true));
sk1.merge(sk2);
println(sk1.toString(true, true));
assertEquals(sk1.getMaxItem(), 121.0F);
assertEquals(sk1.getMinItem(), 1.0F);
}
@Test
public void checkSizes() {
KllFloatsSketch sk = getDirectFloatsSketch(20, 0);
for (int i = 1; i <= 21; i++) { sk.update(i); }
//println(sk.toString(true, true));
byte[] byteArr1 = KllHelper.toByteArray(sk, true);
int size1 = sk.currentSerializedSizeBytes(true);
assertEquals(size1, byteArr1.length);
byte[] byteArr2 = sk.toByteArray();
int size2 = sk.currentSerializedSizeBytes(false);
assertEquals(size2, byteArr2.length);
}
@Test
public void checkNewInstance() {
int k = 200;
WritableMemory dstMem = WritableMemory.allocate(3000);
KllFloatsSketch sk = KllFloatsSketch.newDirectInstance(k, dstMem, memReqSvr);
for (int i = 1; i <= 10_000; i++) {sk.update(i); }
assertEquals(sk.getMinItem(), 1.0F);
assertEquals(sk.getMaxItem(), 10000.0F);
//println(sk.toString(true, true));
}
@Test
public void checkDifferentM() {
int k = 20;
int m = 4;
WritableMemory dstMem = WritableMemory.allocate(1000);
KllFloatsSketch sk = KllDirectFloatsSketch.newDirectUpdatableInstance(k, m, dstMem, memReqSvr);
for (int i = 1; i <= 200; i++) {sk.update(i); }
assertEquals(sk.getMinItem(), 1.0);
assertEquals(sk.getMaxItem(), 200.0);
}
private static KllFloatsSketch getDirectFloatsSketch(final int k, final int n) {
KllFloatsSketch sk = KllFloatsSketch.newHeapInstance(k);
for (int i = 1; i <= n; i++) { sk.update(i); }
byte[] byteArr = KllHelper.toByteArray(sk, true);
WritableMemory wmem = WritableMemory.writableWrap(byteArr);
KllFloatsSketch dfsk = KllFloatsSketch.writableWrap(wmem, memReqSvr);
return dfsk;
}
@Test
public void printlnTest() {
String s = "PRINTING: printf in " + this.getClass().getName();
println(s);
printf("%s\n", s);
}
private final static boolean enablePrinting = false;
/**
* @param format the format
* @param args the args
*/
private static final void printf(final String format, final Object ...args) {
if (enablePrinting) { System.out.printf(format, args); }
}
/**
* @param o the Object to println
*/
private static final void println(final Object o) {
if (enablePrinting) { System.out.println(o.toString()); }
}
}