TestUtil (h2o-test-support 3.34.0 API)

java.lang.Object
- water.Iced
- - water.TestUtil

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, java.lang.Cloneable, water.Freezable

Direct Known Subclasses:

H2ORunner.DefaultRulesBlueprint, TestFrameBuilderTest, TestUtilTest
```
public class TestUtil
extends water.Iced
```
See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`TestUtil.Cmp1`
`static class`	`TestUtil.Datasets`
`static class`	`TestUtil.FrameAssertion`
`static class`	`TestUtil.Frames`
`static class`	`TestUtil.GenFrameAssertion`
`static interface`	`TestUtil.ParseSetupTransformer` Tests can hook into the parse process using this interface and modify some of the guessed parameters.
`static class`	`TestUtil.StandardizeColumns`

Field Summary

Fields
Modifier and Type	Field and Description
`protected static int`	`_initial_keycnt`
`static org.junit.runner.Description`	`CURRENT_TEST_DESCRIPTION`
`protected static int`	`DEFAULT_TIME_FOR_CLOUDING` Default time in ms to wait for clouding
`static boolean`	`JACOCO_ENABLED`
`org.junit.rules.TestRule`	`logRule` Execute this rule before each test to print test name and test class
`protected static int`	`MINCLOUDSIZE` Minimal cloud size to start test.
`org.junit.rules.TestRule`	`runRule`
`org.junit.rules.TestRule`	`timerRule`

Constructor Summary

Constructors
Constructor and Description

TestUtil()

TestUtil(int minCloudSize)

Constructors
Constructor and Description
`TestUtil()`
`TestUtil(int minCloudSize)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static byte[]`	`ar(byte... a)`
`static int[][]`	`ar(int[]... a)`
`static long[]`	`ar(long... a)`
`static long[][]`	`ar(long[]... a)`
`static java.lang.String[]`	`ar(java.lang.String... a)`
`static java.lang.String[][]`	`ar(java.lang.String[]... a)`
`static double[]`	`ard(double... a)`
`static double[][]`	`ard(double[]... a)`
`static float[]`	`arf(float... a)`
`static int[]`	`ari(int... a)`
`static <T> T[]`	`aro(T... a)`
`static water.fvec.Frame`	`asFactor(water.fvec.Frame frame, java.lang.String columnName)`
`static void`	`assertBitIdentical(water.fvec.Frame fr1, water.fvec.Frame fr2)` Compare 2 frames
`static void`	`assertCatVecEquals(water.fvec.Vec expecteds, water.fvec.Vec actuals)`
`static void`	`assertFrameAssertion(TestUtil.FrameAssertion frameAssertion)`
`static void`	`assertFrameEquals(water.fvec.Frame expected, water.fvec.Frame actual, double absDelta)`
`static void`	`assertFrameEquals(water.fvec.Frame expected, water.fvec.Frame actual, java.lang.Double absDelta, java.lang.Double relativeDelta)`
`static void`	`assertIdenticalUpToRelTolerance(water.fvec.Frame fr1, water.fvec.Frame fr2, double epsilon)` Compare 2 frames
`static void`	`assertIdenticalUpToRelTolerance(water.fvec.Frame fr1, water.fvec.Frame fr2, double epsilon, boolean expected)`
`static void`	`assertIdenticalUpToRelTolerance(water.fvec.Frame fr1, water.fvec.Frame fr2, double epsilon, boolean expected, java.lang.String messagePrefix)`
`static void`	`assertIdenticalUpToRelTolerance(water.fvec.Frame fr1, water.fvec.Frame fr2, double epsilon, java.lang.String messagePrefix)`
`static <T extends water.Keyed<T>> void`	`assertInDKV(water.Key<T> key, T object)`
`static void`	`assertStringVecEquals(water.fvec.Vec expecteds, water.fvec.Vec actuals)`
`static void`	`assertTwoDimTableEquals(water.util.TwoDimTable expected, water.util.TwoDimTable actual)`
`static void`	`assertUUIDVecEquals(water.fvec.Vec expecteds, water.fvec.Vec actuals)`
`static void`	`assertVecEquals(java.lang.String messagePrefix, water.fvec.Vec expecteds, water.fvec.Vec actuals, double delta)`
`static void`	`assertVecEquals(java.lang.String messagePrefix, water.fvec.Vec expecteds, water.fvec.Vec actuals, java.lang.Double absDelta, java.lang.Double relativeDelta)`
`static void`	`assertVecEquals(water.fvec.Vec expecteds, water.fvec.Vec actuals, double delta)`
`static void`	`assertVecEquals(water.fvec.Vec expecteds, water.fvec.Vec actuals, double delta, double relativeDelta)`
`static void`	`browser()` Deprecated.
`static double[]`	`changeDouble2SingleArray(double[][] arr)` Take a double array and return it as a single array.
`static void`	`checkArrays(double[] expected, double[] actual, double threshold)`
`static void`	`checkDoubleArrays(double[][] expected, double[][] actual, double threshold)`
`static boolean[]`	`checkEigvec(double[][] expected, double[][] actual, double threshold)`
`static boolean[]`	`checkEigvec(double[][] expected, water.util.TwoDimTable actual, double threshold)`
`static boolean[]`	`checkEigvec(water.util.TwoDimTable expected, water.util.TwoDimTable actual, double threshold)`
`static void`	`checkIcedArrays(water.IcedWrapper[][] expected, water.IcedWrapper[][] actual, double threshold)`
`static void`	`checkLeakedKeys()`
`static boolean[]`	`checkProjection(water.fvec.Frame expected, water.fvec.Frame actual, double threshold, boolean[] flipped)`
`static void`	`checkStddev(double[] expected, double[] actual, double threshold)`
`static void`	`cleanupKeys(java.lang.Class... objectType)`
`static boolean`	`compareFrames(water.fvec.Frame f1, water.fvec.Frame f2)`
`static boolean`	`compareFrames(water.fvec.Frame f1, water.fvec.Frame f2, double delta)` Compares two frames.
`static boolean`	`compareFrames(water.fvec.Frame f1, water.fvec.Frame f2, double delta, double relativeDelta)` Compares two frames.
`static water.fvec.Vec`	`createRandomBinaryWeightsVec(long len, long randomSeed)`
`static water.fvec.Vec`	`createRandomCategoricalVec(long len, long randomSeed)`
`static water.fvec.Vec`	`createRandomDoubleVec(long len, long randomSeed)`
`static water.fvec.Vec`	`cvec(java.lang.String... rows)` A categorical Vec from an array of strings
`static water.fvec.Vec`	`cvec(java.lang.String[] domain, java.lang.String... rows)`
`protected static void`	`downloadTestFileFromS3(java.lang.String fname)`
`static water.fvec.Vec`	`dvec(double... rows)` A numeric Vec from an array of doubles
`static double[][]`	`ear(double... a)`
`static water.fvec.Frame`	`ensureDistributed(water.fvec.Frame frame)` Make sure the given frame is distributed in a way that MRTask reduce operation is called and spans at least 2 nodes of the cluster (if running on multinode).
`static water.fvec.Frame`	`ensureDistributed(water.fvec.Frame frame, int minChunks)` Make sure the given frame is distributed at least to given minimum number of chunks and spans at least 2 nodes of the cluster (if running on multinode).
`static boolean`	`equalTwoArrays(double[] array1, double[] array2, double tol)`
`static boolean`	`equalTwoDimTables(water.util.TwoDimTable tab1, water.util.TwoDimTable tab2, double tol)`
`static boolean`	`equalTwoHashMaps(java.util.HashMap<java.lang.String,java.lang.Double> coeff1, java.util.HashMap<java.lang.String,java.lang.Double> coeff2, double tol)`
`protected static water.fvec.Frame`	`generate_enum_only(int numCols, int numRows, int num_factor, double missingfrac)` Deprecated. use `generateEnumOnly(int, int, int, double)` instead Will be removed at version 3.38.0.1
`protected static water.fvec.Frame`	`generate_enum_only(int numCols, int numRows, int num_factor, double missingfrac, long seed)` Deprecated. use `generateEnumOnly(int, int, int, double, long)` instead Will be removed at version 3.38.0.1
`protected static water.fvec.Frame`	`generate_int_only(int numCols, int numRows, int integer_range, double missingfrac)` Deprecated. use `generateIntOnly(int, int, int, double)` instead Will be removed at version 3.38.0.1
`protected static water.fvec.Frame`	`generate_int_only(int numCols, int numRows, int integer_range, double missingfrac, long seed)` Deprecated. use `generateIntOnly(int, int, int, double, long)` instead Will be removed at version 3.38.0.1
`protected static water.fvec.Frame`	`generate_real_only(int numCols, int numRows, double missingfrac)` Deprecated. use `generateRealOnly(int, int, double)` instead Will be removed at version 3.38.0.1
`protected static water.fvec.Frame`	`generate_real_only(int numCols, int numRows, double missingfrac, long seed)` Deprecated. use `generateRealOnly(int, int, double, long)` instead Will be removed at version 3.38.0.1
`protected static water.fvec.Frame`	`generateEnumOnly(int numCols, int numRows, int num_factor, double missingfrac)` generate random frames containing enum columns only
`protected static water.fvec.Frame`	`generateEnumOnly(int numCols, int numRows, int num_factor, double missingfrac, long seed)`
`protected static water.fvec.Frame`	`generateIntOnly(int numCols, int numRows, int integer_range, double missingfrac)`
`protected static water.fvec.Frame`	`generateIntOnly(int numCols, int numRows, int integerRange, double missingfrac, long seed)`
`protected static water.fvec.Frame`	`generateRealOnly(int numCols, int numRows, double missingfrac)`
`protected static water.fvec.Frame`	`generateRealOnly(int numCols, int numRows, double missingfrac, long seed)`
`protected static int`	`getDefaultTimeForClouding()`
`static java.lang.String[]`	`ignoredColumns(water.fvec.Frame frame, java.lang.String... usedColumns)`
`static boolean`	`isCI()`
`static water.fvec.Vec`	`ivec(int... rows)` A numeric Vec from an array of ints
`static void`	`main(java.lang.String[] args)`
`static water.fvec.NFSFileVec`	`makeNfsFileVec(java.lang.String fname)`
`protected water.fvec.Frame`	`parse_test_file(water.Key outputKey, java.lang.String fname)` Deprecated. use `parseTestFile(Key, String)` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(water.Key outputKey, java.lang.String fname, boolean guessSetup)` Deprecated. use `parseTestFile(Key, String, boolean)` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(water.Key outputKey, java.lang.String fname, boolean guessSetup, int[] skippedColumns)` Deprecated. use `parseTestFile(Key, String, boolean, int[])` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(water.Key outputKey, java.lang.String fname, int[] skippedColumns)` Deprecated. use `parseTestFile(Key, String, int[])` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(water.Key outputKey, java.lang.String fname, TestUtil.ParseSetupTransformer transformer)` Deprecated. use `parseTestFile(Key, String, ParseSetupTransformer)` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(water.Key outputKey, java.lang.String fname, TestUtil.ParseSetupTransformer transformer, int[] skippedColumns)` Deprecated. use `parseTestFile(Key outputKey, String fname, ParseSetupTransformer transformer, int[] skippedColumns)` instead Will be removed at version 3.38.0.1
`static water.fvec.Frame`	`parse_test_file(java.lang.String fname)` Deprecated. use `parseTestFile(String)` instead Will be removed at version 3.38.0.1
`static water.fvec.Frame`	`parse_test_file(java.lang.String fname, int[] skipped_columns)` Deprecated. use `parseTestFile(String, int[])` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types)` Deprecated. use `parseTestFile(String fname, String na_string, int check_header, byte[] column_types)` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types, TestUtil.ParseSetupTransformer transformer)` Deprecated. use `parseTestFile(String fname, String na_string, int check_header, byte[] column_types, ParseSetupTransformer transformer)` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types, TestUtil.ParseSetupTransformer transformer, int[] skippedColumns)` Deprecated. use `parseTestFile(String fname, String na_string, int check_header, byte[] column_types, ParseSetupTransformer transformer, int[] skippedColumns)` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(java.lang.String fname, TestUtil.ParseSetupTransformer transformer)` Deprecated. use `parseTestFile(String, ParseSetupTransformer)` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_file(java.lang.String fname, TestUtil.ParseSetupTransformer transformer, int[] skippedColumns)` Deprecated. use `parseTestFile(String, ParseSetupTransformer, int[])` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_folder(java.lang.String fname)` Deprecated. use `parseTestFolder(String)` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_folder(java.lang.String fname, int[] skippedColumns)` Deprecated. use `parseTestFolder(String, int[])` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_folder(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types, TestUtil.ParseSetupTransformer transformer)` Deprecated. use `parseTestFolder(String, String, int, byte[], ParseSetupTransformer)` instead Will be removed at version 3.38.0.1
`protected water.fvec.Frame`	`parse_test_folder(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types, TestUtil.ParseSetupTransformer transformer, int[] skipped_columns)` Deprecated. use `parseTestFolder(String, String, int, byte[], ParseSetupTransformer, int[])` instead Will be removed at version 3.38.0.1
`static water.fvec.Frame`	`parseAndTrackTestFile(java.lang.String fname)` Find & parse & track in `Scope` a CSV file.
`static water.fvec.Frame`	`parseTestFile(water.Key outputKey, java.lang.String fname)`
`protected water.fvec.Frame`	`parseTestFile(water.Key outputKey, java.lang.String fname, boolean guessSetup)`
`protected water.fvec.Frame`	`parseTestFile(water.Key outputKey, java.lang.String fname, boolean guessSetup, int[] skippedColumns)`
`static water.fvec.Frame`	`parseTestFile(water.Key outputKey, java.lang.String fname, int[] skippedColumns)`
`static water.fvec.Frame`	`parseTestFile(water.Key outputKey, java.lang.String fname, TestUtil.ParseSetupTransformer transformer)`
`static water.fvec.Frame`	`parseTestFile(water.Key outputKey, java.lang.String fname, TestUtil.ParseSetupTransformer transformer, int[] skippedColumns)`
`static water.fvec.Frame`	`parseTestFile(java.lang.String fname)` Find & parse a CSV file.
`static water.fvec.Frame`	`parseTestFile(java.lang.String fname, int[] skipped_columns)`
`static water.fvec.Frame`	`parseTestFile(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types)`
`static water.fvec.Frame`	`parseTestFile(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types, TestUtil.ParseSetupTransformer transformer)`
`static water.fvec.Frame`	`parseTestFile(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types, TestUtil.ParseSetupTransformer transformer, int[] skippedColumns)`
`static water.fvec.Frame`	`parseTestFile(java.lang.String fname, TestUtil.ParseSetupTransformer transformer)`
`static water.fvec.Frame`	`parseTestFile(java.lang.String fname, TestUtil.ParseSetupTransformer transformer, int[] skippedColumns)`
`protected water.fvec.Frame`	`parseTestFolder(java.lang.String fname)` Find & parse a folder of CSV files.
`protected water.fvec.Frame`	`parseTestFolder(java.lang.String fname, int[] skippedColumns)` Find & parse a folder of CSV files.
`protected static water.fvec.Frame`	`parseTestFolder(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types, TestUtil.ParseSetupTransformer transformer)` Parse a folder with csv files when a single na_string is specified.
`protected static water.fvec.Frame`	`parseTestFolder(java.lang.String fname, java.lang.String na_string, int check_header, byte[] column_types, TestUtil.ParseSetupTransformer transformer, int[] skipped_columns)` Parse a folder with csv files when a single na_string is specified.
`void`	`printOutColumnsMetadata(water.fvec.Frame fr)`
`static void`	`printOutFrameAsTable(water.fvec.Frame fr)`
`static void`	`printOutFrameAsTable(water.fvec.Frame fr, boolean rollups, long limit)`
`protected static int[]`	`rangeFun(int numEle, int offset)`
`static void`	`setLocale(java.util.Locale locale)` Sets a locale cluster-wide.
`protected static int[]`	`sortDir(int numEle, java.util.Random rand)`
`static TestUtil.Frames`	`split(water.fvec.Frame f)`
`static TestUtil.Frames`	`split(water.fvec.Frame f, double testFraction)`
`static TestUtil.Frames`	`split(water.fvec.Frame f, double testFraction, double validFraction)`
`static void`	`stall_till_cloudsize(int x)`
`static void`	`stall_till_cloudsize(int x, int timeout)`
`static void`	`stall_till_cloudsize(java.lang.String[] args, int x)`
`static void`	`stall_till_cloudsize(java.lang.String[] args, int x, int timeout)`
`static water.fvec.Vec`	`svec(java.lang.String... rows)` A string Vec from an array of strings
`static hex.genmodel.GenModel`	`toMojo(hex.Model model, java.lang.String testName, boolean readModelMetaData)`
`protected static double[]`	`toNumericRow(water.fvec.Frame fr, long row)`
`protected static hex.genmodel.easy.RowData`	`toRowData(water.fvec.Frame fr, java.lang.String[] columns, long row)`
`static water.fvec.Vec`	`transformVec(water.fvec.Vec vec, water.util.fp.Function<java.lang.Double,java.lang.Double> transform)`
`static water.fvec.Vec`	`tvec(int... rows)` A time Vec from an array of ints
`static water.fvec.Vec`	`uvec(java.util.UUID... rows)` A string Vec from an array of strings
`static water.fvec.Vec`	`vec(int... rows)` A Numeric Vec from an array of ints
`static water.fvec.Vec`	`vec(java.lang.String[] domain, int... rows)` A Categorical/Factor Vec from an array of ints - with categorical/domain mapping
`static void`	`writeFrameToCSV(java.lang.String fileNameWithPath, water.fvec.Frame h2oframe, boolean header, boolean hex_string)` Converts a H2OFrame to a csv file for debugging purposes.

Methods inherited from class water.Iced
asBytes, clone, copyOver, frozenType, read, readExternal, readJSON, reloadFromBytes, toJsonString, write, writeExternal, writeJSON

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

JACOCO_ENABLED

public static final boolean JACOCO_ENABLED

_initial_keycnt
```
protected static int _initial_keycnt
```

MINCLOUDSIZE
```
protected static int MINCLOUDSIZE
```
Minimal cloud size to start test.

DEFAULT_TIME_FOR_CLOUDING
```
protected static int DEFAULT_TIME_FOR_CLOUDING
```
Default time in ms to wait for clouding

CURRENT_TEST_DESCRIPTION

public static org.junit.runner.Description CURRENT_TEST_DESCRIPTION

logRule
```
public transient org.junit.rules.TestRule logRule
```
Execute this rule before each test to print test name and test class

runRule

public transient org.junit.rules.TestRule runRule

timerRule

public transient org.junit.rules.TestRule timerRule

Constructor Detail

TestUtil
```
public TestUtil()
```

TestUtil
```
public TestUtil(int minCloudSize)
```

Method Detail

getDefaultTimeForClouding

protected static int getDefaultTimeForClouding()

stall_till_cloudsize

public static void stall_till_cloudsize(int x)

changeDouble2SingleArray
```
public static double[] changeDouble2SingleArray(double[][] arr)
```
Take a double array and return it as a single array. It will take each row on top of each other

Parameters:

arr -

Returns:

stall_till_cloudsize

public static void stall_till_cloudsize(int x,
                                        int timeout)

stall_till_cloudsize

public static void stall_till_cloudsize(java.lang.String[] args,
                                        int x)

stall_till_cloudsize

public static void stall_till_cloudsize(java.lang.String[] args,
                                        int x,
                                        int timeout)

checkLeakedKeys
```
public static void checkLeakedKeys()
```

cleanupKeys

public static void cleanupKeys(java.lang.Class... objectType)

checkArrays

public static void checkArrays(double[] expected,
                               double[] actual,
                               double threshold)

checkDoubleArrays

public static void checkDoubleArrays(double[][] expected,
                                     double[][] actual,
                                     double threshold)

generate_enum_only

@Deprecated
protected static water.fvec.Frame generate_enum_only(int numCols,
                                                                 int numRows,
                                                                 int num_factor,
                                                                 double missingfrac)

Deprecated. use generateEnumOnly(int, int, int, double) instead

Will be removed at version 3.38.0.1

generateEnumOnly

protected static water.fvec.Frame generateEnumOnly(int numCols,
                                                   int numRows,
                                                   int num_factor,
                                                   double missingfrac)

generate random frames containing enum columns only

Parameters:: numCols -; numRows -; num_factor -
Returns:

generate_enum_only

@Deprecated
protected static water.fvec.Frame generate_enum_only(int numCols,
                                                                 int numRows,
                                                                 int num_factor,
                                                                 double missingfrac,
                                                                 long seed)

Deprecated. use generateEnumOnly(int, int, int, double, long) instead

Will be removed at version 3.38.0.1

generateEnumOnly

protected static water.fvec.Frame generateEnumOnly(int numCols,
                                                   int numRows,
                                                   int num_factor,
                                                   double missingfrac,
                                                   long seed)

generate_real_only

@Deprecated
protected static water.fvec.Frame generate_real_only(int numCols,
                                                                 int numRows,
                                                                 double missingfrac)

Deprecated. use generateRealOnly(int, int, double) instead

Will be removed at version 3.38.0.1

generateRealOnly

protected static water.fvec.Frame generateRealOnly(int numCols,
                                                   int numRows,
                                                   double missingfrac)

generate_real_only

@Deprecated
protected static water.fvec.Frame generate_real_only(int numCols,
                                                                 int numRows,
                                                                 double missingfrac,
                                                                 long seed)

Deprecated. use generateRealOnly(int, int, double, long) instead

Will be removed at version 3.38.0.1

generateRealOnly

protected static water.fvec.Frame generateRealOnly(int numCols,
                                                   int numRows,
                                                   double missingfrac,
                                                   long seed)

generate_int_only

@Deprecated
protected static water.fvec.Frame generate_int_only(int numCols,
                                                                int numRows,
                                                                int integer_range,
                                                                double missingfrac)

Deprecated. use generateIntOnly(int, int, int, double) instead

Will be removed at version 3.38.0.1

generateIntOnly

protected static water.fvec.Frame generateIntOnly(int numCols,
                                                  int numRows,
                                                  int integer_range,
                                                  double missingfrac)

generate_int_only

@Deprecated
protected static water.fvec.Frame generate_int_only(int numCols,
                                                                int numRows,
                                                                int integer_range,
                                                                double missingfrac,
                                                                long seed)

Deprecated. use generateIntOnly(int, int, int, double, long) instead

Will be removed at version 3.38.0.1

generateIntOnly

protected static water.fvec.Frame generateIntOnly(int numCols,
                                                  int numRows,
                                                  int integerRange,
                                                  double missingfrac,
                                                  long seed)

rangeFun

protected static int[] rangeFun(int numEle,
                                int offset)

sortDir

protected static int[] sortDir(int numEle,
                               java.util.Random rand)

assertIdenticalUpToRelTolerance

public static void assertIdenticalUpToRelTolerance(water.fvec.Frame fr1,
                                                   water.fvec.Frame fr2,
                                                   double epsilon)

Compare 2 frames

Parameters:: fr1 - Frame; fr2 - Frame; epsilon - Relative tolerance for floating point numbers

assertIdenticalUpToRelTolerance

public static void assertIdenticalUpToRelTolerance(water.fvec.Frame fr1,
                                                   water.fvec.Frame fr2,
                                                   double epsilon,
                                                   java.lang.String messagePrefix)

assertIdenticalUpToRelTolerance

public static void assertIdenticalUpToRelTolerance(water.fvec.Frame fr1,
                                                   water.fvec.Frame fr2,
                                                   double epsilon,
                                                   boolean expected)

assertIdenticalUpToRelTolerance

public static void assertIdenticalUpToRelTolerance(water.fvec.Frame fr1,
                                                   water.fvec.Frame fr2,
                                                   double epsilon,
                                                   boolean expected,
                                                   java.lang.String messagePrefix)

assertBitIdentical

public static void assertBitIdentical(water.fvec.Frame fr1,
                                      water.fvec.Frame fr2)

Compare 2 frames

Parameters:: fr1 - Frame; fr2 - Frame

parse_test_file
```
@Deprecated
public static water.fvec.Frame parse_test_file(java.lang.String fname)
```
Deprecated. use parseTestFile(String) instead
Will be removed at version 3.38.0.1

parse_test_file

@Deprecated
public static water.fvec.Frame parse_test_file(java.lang.String fname,
                                                           int[] skipped_columns)

Deprecated. use parseTestFile(String, int[]) instead

Will be removed at version 3.38.0.1

parseTestFile
```
public static water.fvec.Frame parseTestFile(java.lang.String fname)
```
Find & parse a CSV file. NPE if file not found.

Parameters:

fname - Test filename

Returns:

Frame or NPE

parseTestFile

public static water.fvec.Frame parseTestFile(java.lang.String fname,
                                             int[] skipped_columns)

parseAndTrackTestFile
```
public static water.fvec.Frame parseAndTrackTestFile(java.lang.String fname)
```
Find & parse & track in Scope a CSV file. NPE if file not found.

Parameters:

fname - Test filename

Returns:

Frame or NPE

ensureDistributed
```
public static water.fvec.Frame ensureDistributed(water.fvec.Frame frame)
```
Make sure the given frame is distributed in a way that MRTask reduce operation is called and spans at least 2 nodes of the cluster (if running on multinode).
If a new frame is created - it is automatically tracked in Scope if it is currently active.

Parameters:

frame - input frame

Returns:

possibly new Frame rebalanced to a minimum number of chunks

ensureDistributed
```
public static water.fvec.Frame ensureDistributed(water.fvec.Frame frame,
                                                 int minChunks)
```
Make sure the given frame is distributed at least to given minimum number of chunks and spans at least 2 nodes of the cluster (if running on multinode).
If a new frame is created - it is automatically tracked in Scope if it is currently active.

Parameters:

frame - input frame

minChunks - minimum required number of chunks

Returns:

possibly new Frame rebalanced to a minimum number of chunks

makeNfsFileVec

public static water.fvec.NFSFileVec makeNfsFileVec(java.lang.String fname)

downloadTestFileFromS3

protected static void downloadTestFileFromS3(java.lang.String fname)
                                      throws java.io.IOException

Throws:: java.io.IOException

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(water.Key outputKey,
                                                       java.lang.String fname,
                                                       boolean guessSetup)

Deprecated. use parseTestFile(Key, String, boolean) instead

Will be removed at version 3.38.0.1

parseTestFile

protected water.fvec.Frame parseTestFile(water.Key outputKey,
                                         java.lang.String fname,
                                         boolean guessSetup)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(water.Key outputKey,
                                                       java.lang.String fname,
                                                       boolean guessSetup,
                                                       int[] skippedColumns)

Deprecated. use parseTestFile(Key, String, boolean, int[]) instead

Will be removed at version 3.38.0.1

parseTestFile

protected water.fvec.Frame parseTestFile(water.Key outputKey,
                                         java.lang.String fname,
                                         boolean guessSetup,
                                         int[] skippedColumns)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(water.Key outputKey,
                                                       java.lang.String fname)

Deprecated. use parseTestFile(Key, String) instead

Will be removed at version 3.38.0.1

parseTestFile

public static water.fvec.Frame parseTestFile(water.Key outputKey,
                                             java.lang.String fname)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(water.Key outputKey,
                                                       java.lang.String fname,
                                                       int[] skippedColumns)

Deprecated. use parseTestFile(Key, String, int[]) instead

Will be removed at version 3.38.0.1

parseTestFile

public static water.fvec.Frame parseTestFile(water.Key outputKey,
                                             java.lang.String fname,
                                             int[] skippedColumns)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(java.lang.String fname,
                                                       TestUtil.ParseSetupTransformer transformer)

Deprecated. use parseTestFile(String, ParseSetupTransformer) instead

Will be removed at version 3.38.0.1

parseTestFile

public static water.fvec.Frame parseTestFile(java.lang.String fname,
                                             TestUtil.ParseSetupTransformer transformer)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(java.lang.String fname,
                                                       TestUtil.ParseSetupTransformer transformer,
                                                       int[] skippedColumns)

Deprecated. use parseTestFile(String, ParseSetupTransformer, int[]) instead

Will be removed at version 3.38.0.1

parseTestFile

public static water.fvec.Frame parseTestFile(java.lang.String fname,
                                             TestUtil.ParseSetupTransformer transformer,
                                             int[] skippedColumns)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(water.Key outputKey,
                                                       java.lang.String fname,
                                                       TestUtil.ParseSetupTransformer transformer)

Deprecated. use parseTestFile(Key, String, ParseSetupTransformer) instead

Will be removed at version 3.38.0.1

parseTestFile

public static water.fvec.Frame parseTestFile(water.Key outputKey,
                                             java.lang.String fname,
                                             TestUtil.ParseSetupTransformer transformer)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(water.Key outputKey,
                                                       java.lang.String fname,
                                                       TestUtil.ParseSetupTransformer transformer,
                                                       int[] skippedColumns)

Deprecated. use parseTestFile(Key outputKey, String fname, ParseSetupTransformer transformer, int[] skippedColumns) instead

Will be removed at version 3.38.0.1

parseTestFile

public static water.fvec.Frame parseTestFile(water.Key outputKey,
                                             java.lang.String fname,
                                             TestUtil.ParseSetupTransformer transformer,
                                             int[] skippedColumns)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(java.lang.String fname,
                                                       java.lang.String na_string,
                                                       int check_header,
                                                       byte[] column_types)

Deprecated. use parseTestFile(String fname, String na_string, int check_header, byte[] column_types) instead

Will be removed at version 3.38.0.1

parseTestFile

public static water.fvec.Frame parseTestFile(java.lang.String fname,
                                             java.lang.String na_string,
                                             int check_header,
                                             byte[] column_types)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(java.lang.String fname,
                                                       java.lang.String na_string,
                                                       int check_header,
                                                       byte[] column_types,
                                                       TestUtil.ParseSetupTransformer transformer)

Deprecated. use parseTestFile(String fname, String na_string, int check_header, byte[] column_types, ParseSetupTransformer transformer) instead

Will be removed at version 3.38.0.1

parseTestFile

public static water.fvec.Frame parseTestFile(java.lang.String fname,
                                             java.lang.String na_string,
                                             int check_header,
                                             byte[] column_types,
                                             TestUtil.ParseSetupTransformer transformer)

parse_test_file

@Deprecated
protected water.fvec.Frame parse_test_file(java.lang.String fname,
                                                       java.lang.String na_string,
                                                       int check_header,
                                                       byte[] column_types,
                                                       TestUtil.ParseSetupTransformer transformer,
                                                       int[] skippedColumns)

Deprecated. use

parseTestFile(String fname, String na_string, int check_header, byte[] column_types, ParseSetupTransformer transformer, int[] skippedColumns)

instead

Will be removed at version 3.38.0.1

parseTestFile

public static water.fvec.Frame parseTestFile(java.lang.String fname,
                                             java.lang.String na_string,
                                             int check_header,
                                             byte[] column_types,
                                             TestUtil.ParseSetupTransformer transformer,
                                             int[] skippedColumns)

parse_test_folder
```
@Deprecated
protected water.fvec.Frame parse_test_folder(java.lang.String fname)
```
Deprecated. use parseTestFolder(String) instead
Will be removed at version 3.38.0.1

parseTestFolder
```
protected water.fvec.Frame parseTestFolder(java.lang.String fname)
```
Find & parse a folder of CSV files. NPE if file not found.

Parameters:

fname - Test filename

Returns:

Frame or NPE

parse_test_folder

@Deprecated
protected water.fvec.Frame parse_test_folder(java.lang.String fname,
                                                         int[] skippedColumns)

Deprecated. use parseTestFolder(String, int[]) instead

Will be removed at version 3.38.0.1

parseTestFolder

protected water.fvec.Frame parseTestFolder(java.lang.String fname,
                                           int[] skippedColumns)

Find & parse a folder of CSV files. NPE if file not found.

Parameters:: fname - Test filename
Returns:: Frame or NPE

parse_test_folder

@Deprecated
protected water.fvec.Frame parse_test_folder(java.lang.String fname,
                                                         java.lang.String na_string,
                                                         int check_header,
                                                         byte[] column_types,
                                                         TestUtil.ParseSetupTransformer transformer)

Deprecated. use parseTestFolder(String, String, int, byte[], ParseSetupTransformer) instead

Will be removed at version 3.38.0.1

parseTestFolder

protected static water.fvec.Frame parseTestFolder(java.lang.String fname,
                                                  java.lang.String na_string,
                                                  int check_header,
                                                  byte[] column_types,
                                                  TestUtil.ParseSetupTransformer transformer)

Parse a folder with csv files when a single na_string is specified.

Parameters:: fname - name of folder; na_string - string for NA in a column
Returns:

parse_test_folder

@Deprecated
protected water.fvec.Frame parse_test_folder(java.lang.String fname,
                                                         java.lang.String na_string,
                                                         int check_header,
                                                         byte[] column_types,
                                                         TestUtil.ParseSetupTransformer transformer,
                                                         int[] skipped_columns)

Deprecated. use parseTestFolder(String, String, int, byte[], ParseSetupTransformer, int[]) instead

Will be removed at version 3.38.0.1

parseTestFolder

protected static water.fvec.Frame parseTestFolder(java.lang.String fname,
                                                  java.lang.String na_string,
                                                  int check_header,
                                                  byte[] column_types,
                                                  TestUtil.ParseSetupTransformer transformer,
                                                  int[] skipped_columns)

Parse a folder with csv files when a single na_string is specified.

Parameters:: fname - name of folder; na_string - string for NA in a column
Returns:

split

public static TestUtil.Frames split(water.fvec.Frame f)

split

public static TestUtil.Frames split(water.fvec.Frame f,
                                    double testFraction)

split

public static TestUtil.Frames split(water.fvec.Frame f,
                                    double testFraction,
                                    double validFraction)

vec
```
public static water.fvec.Vec vec(int... rows)
```
A Numeric Vec from an array of ints

Parameters:

rows - Data

Returns:

The Vec

vec
```
public static water.fvec.Vec vec(java.lang.String[] domain,
                                 int... rows)
```
A Categorical/Factor Vec from an array of ints - with categorical/domain mapping

Parameters:

domain - Categorical/Factor names, mapped by the data values

rows - Data

Returns:

The Vec

ivec

public static water.fvec.Vec ivec(int... rows)

A numeric Vec from an array of ints

cvec

public static water.fvec.Vec cvec(java.lang.String... rows)

A categorical Vec from an array of strings

cvec

public static water.fvec.Vec cvec(java.lang.String[] domain,
                                  java.lang.String... rows)

dvec

public static water.fvec.Vec dvec(double... rows)

A numeric Vec from an array of doubles

tvec

public static water.fvec.Vec tvec(int... rows)

A time Vec from an array of ints

svec

public static water.fvec.Vec svec(java.lang.String... rows)

A string Vec from an array of strings

uvec

public static water.fvec.Vec uvec(java.util.UUID... rows)

A string Vec from an array of strings

ar

public static java.lang.String[] ar(java.lang.String... a)

ar

public static java.lang.String[][] ar(java.lang.String[]... a)

ar
```
public static byte[] ar(byte... a)
```

ar
```
public static long[] ar(long... a)
```

ar

public static long[][] ar(long[]... a)

ari
```
public static int[] ari(int... a)
```

ar
```
public static int[][] ar(int[]... a)
```

arf

public static float[] arf(float... a)

ard

public static double[] ard(double... a)

ard

public static double[][] ard(double[]... a)

ear

public static double[][] ear(double... a)

aro
```
public static <T> T[] aro(T... a)
```

assertFrameEquals

public static void assertFrameEquals(water.fvec.Frame expected,
                                     water.fvec.Frame actual,
                                     double absDelta)

assertFrameEquals

public static void assertFrameEquals(water.fvec.Frame expected,
                                     water.fvec.Frame actual,
                                     java.lang.Double absDelta,
                                     java.lang.Double relativeDelta)

assertVecEquals

public static void assertVecEquals(water.fvec.Vec expecteds,
                                   water.fvec.Vec actuals,
                                   double delta)

assertVecEquals

public static void assertVecEquals(water.fvec.Vec expecteds,
                                   water.fvec.Vec actuals,
                                   double delta,
                                   double relativeDelta)

assertVecEquals

public static void assertVecEquals(java.lang.String messagePrefix,
                                   water.fvec.Vec expecteds,
                                   water.fvec.Vec actuals,
                                   double delta)

assertVecEquals

public static void assertVecEquals(java.lang.String messagePrefix,
                                   water.fvec.Vec expecteds,
                                   water.fvec.Vec actuals,
                                   java.lang.Double absDelta,
                                   java.lang.Double relativeDelta)

assertUUIDVecEquals

public static void assertUUIDVecEquals(water.fvec.Vec expecteds,
                                       water.fvec.Vec actuals)

assertStringVecEquals

public static void assertStringVecEquals(water.fvec.Vec expecteds,
                                         water.fvec.Vec actuals)

assertCatVecEquals

public static void assertCatVecEquals(water.fvec.Vec expecteds,
                                      water.fvec.Vec actuals)

assertTwoDimTableEquals

public static void assertTwoDimTableEquals(water.util.TwoDimTable expected,
                                           water.util.TwoDimTable actual)

checkStddev

public static void checkStddev(double[] expected,
                               double[] actual,
                               double threshold)

checkIcedArrays

public static void checkIcedArrays(water.IcedWrapper[][] expected,
                                   water.IcedWrapper[][] actual,
                                   double threshold)

checkEigvec

public static boolean[] checkEigvec(double[][] expected,
                                    double[][] actual,
                                    double threshold)

checkEigvec

public static boolean[] checkEigvec(double[][] expected,
                                    water.util.TwoDimTable actual,
                                    double threshold)

equalTwoArrays

public static boolean equalTwoArrays(double[] array1,
                                     double[] array2,
                                     double tol)

equalTwoHashMaps

public static boolean equalTwoHashMaps(java.util.HashMap<java.lang.String,java.lang.Double> coeff1,
                                       java.util.HashMap<java.lang.String,java.lang.Double> coeff2,
                                       double tol)

equalTwoDimTables

public static boolean equalTwoDimTables(water.util.TwoDimTable tab1,
                                        water.util.TwoDimTable tab2,
                                        double tol)

checkEigvec

public static boolean[] checkEigvec(water.util.TwoDimTable expected,
                                    water.util.TwoDimTable actual,
                                    double threshold)

checkProjection

public static boolean[] checkProjection(water.fvec.Frame expected,
                                        water.fvec.Frame actual,
                                        double threshold,
                                        boolean[] flipped)

main

public static void main(java.lang.String[] args)

assertFrameAssertion

public static void assertFrameAssertion(TestUtil.FrameAssertion frameAssertion)

asFactor

public static water.fvec.Frame asFactor(water.fvec.Frame frame,
                                        java.lang.String columnName)

Parameters:: frame -; columnName - column's name to be factorized
Returns:: Frame with factorized column

printOutFrameAsTable

public static void printOutFrameAsTable(water.fvec.Frame fr)

printOutFrameAsTable

public static void printOutFrameAsTable(water.fvec.Frame fr,
                                        boolean rollups,
                                        long limit)

printOutColumnsMetadata

public void printOutColumnsMetadata(water.fvec.Frame fr)

toRowData

protected static hex.genmodel.easy.RowData toRowData(water.fvec.Frame fr,
                                                     java.lang.String[] columns,
                                                     long row)

toNumericRow

protected static double[] toNumericRow(water.fvec.Frame fr,
                                       long row)

compareFrames
```
public static boolean compareFrames(water.fvec.Frame f1,
                                    water.fvec.Frame f2,
                                    double delta)
```
Compares two frames. Two frames are equal if and only if they contain the same number of columns, rows, and values at each cell (coordinate) are the same. Column names are ignored, as well as chunks sizes and all other aspects besides those explicitly mentioned.

Parameters:

f1 - Frame to be compared, not null

f2 - Frame to be compared, not null

delta - absolute tolerance

Returns:

True if frames are the same up to tolerance - number of columns, rows & values at each cell.

Throws:

java.lang.AssertionError - If any inequalities are found

java.lang.IllegalArgumentException - If input frames don't have the same column and row count

compareFrames
```
public static boolean compareFrames(water.fvec.Frame f1,
                                    water.fvec.Frame f2,
                                    double delta,
                                    double relativeDelta)
```
Compares two frames. Two frames are equal if and only if they contain the same number of columns, rows, and values at each cell (coordinate) are the same. Column names are ignored, as well as chunks sizes and all other aspects besides those explicitly mentioned.

Parameters:

f1 - Frame to be compared, not null

f2 - Frame to be compared, not null

delta - absolute tolerance

relativeDelta - relative tolerance

Returns:

True if frames are the same up to tolerance - number of columns, rows & values at each cell.

Throws:

java.lang.AssertionError - If any inequalities are found

java.lang.IllegalArgumentException - If input frames don't have the same column and row count

ignoredColumns

public static final java.lang.String[] ignoredColumns(water.fvec.Frame frame,
                                                      java.lang.String... usedColumns)

compareFrames

public static boolean compareFrames(water.fvec.Frame f1,
                                    water.fvec.Frame f2)
                             throws java.lang.IllegalStateException

Throws:: java.lang.IllegalStateException

setLocale
```
public static void setLocale(java.util.Locale locale)
```
Sets a locale cluster-wide. Consider returning it back to the default value.

Parameters:

locale - Locale to set to the whole cluster

writeFrameToCSV
```
public static void writeFrameToCSV(java.lang.String fileNameWithPath,
                                   water.fvec.Frame h2oframe,
                                   boolean header,
                                   boolean hex_string)
                            throws java.io.IOException
```
Converts a H2OFrame to a csv file for debugging purposes.

Parameters:

fileNameWithPath: - String containing filename with path that will contain the H2O Frame

h2oframe: - H2O Frame to be saved as CSV file.

header: - boolean to decide if column names should be saved. Set to false if don't care.

hex_string: - boolean to decide if the double values are written in hex. Set to false if don't care.

Throws:

java.io.IOException

createRandomBinaryWeightsVec
```
public static water.fvec.Vec createRandomBinaryWeightsVec(long len,
                                                          long randomSeed)
```
Parameters:

len - Length of the resulting vector

randomSeed - Seed for the random generator (for reproducibility)

Returns:

An instance of Vec with binary weights (either 0.0D or 1.0D, nothing in between).

createRandomDoubleVec
```
public static water.fvec.Vec createRandomDoubleVec(long len,
                                                   long randomSeed)
```
Parameters:

len - Length of the resulting vector

randomSeed - Seed for the random generator (for reproducibility)

Returns:

An instance of Vec with random double values

createRandomCategoricalVec
```
public static water.fvec.Vec createRandomCategoricalVec(long len,
                                                        long randomSeed)
```
Parameters:

len - Length of the resulting vector

randomSeed - Seed for the random generator (for reproducibility)

Returns:

An instance of Vec with random categorical values

toMojo

public static hex.genmodel.GenModel toMojo(hex.Model model,
                                           java.lang.String testName,
                                           boolean readModelMetaData)

isCI
```
public static boolean isCI()
```

assertInDKV

public static <T extends water.Keyed<T>> void assertInDKV(water.Key<T> key,
                                                          T object)

transformVec

public static water.fvec.Vec transformVec(water.fvec.Vec vec,
                                          water.util.fp.Function<java.lang.Double,java.lang.Double> transform)

browser
```
@Deprecated
public static void browser()
```
Deprecated.

Debugging-only function that lets the developer open Flow (or R/Py) during execution of a junit test and inspect the model.

Class TestUtil

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class water.Iced

Methods inherited from class java.lang.Object

Field Detail

JACOCO_ENABLED

_initial_keycnt

MINCLOUDSIZE

DEFAULT_TIME_FOR_CLOUDING

CURRENT_TEST_DESCRIPTION

logRule

runRule

timerRule

Constructor Detail

TestUtil

TestUtil

Method Detail

getDefaultTimeForClouding

stall_till_cloudsize

changeDouble2SingleArray

stall_till_cloudsize

stall_till_cloudsize

stall_till_cloudsize

checkLeakedKeys

cleanupKeys

checkArrays

checkDoubleArrays

generate_enum_only

generateEnumOnly

generate_enum_only

generateEnumOnly

generate_real_only

generateRealOnly

generate_real_only

generateRealOnly

generate_int_only

generateIntOnly

generate_int_only

generateIntOnly

rangeFun

sortDir

assertIdenticalUpToRelTolerance

assertIdenticalUpToRelTolerance

assertIdenticalUpToRelTolerance

assertIdenticalUpToRelTolerance

assertBitIdentical

parse_test_file

parse_test_file

parseTestFile

parseTestFile

parseAndTrackTestFile

ensureDistributed

ensureDistributed

makeNfsFileVec

downloadTestFileFromS3

parse_test_file

parseTestFile

parse_test_file

parseTestFile

parse_test_file

parseTestFile

parse_test_file

parseTestFile

parse_test_file

parseTestFile

parse_test_file

parseTestFile

parse_test_file

parseTestFile

parse_test_file

parseTestFile

parse_test_file

parseTestFile

parse_test_file

parseTestFile

parse_test_file

parseTestFile