Test cases for scalar/vector-valued functions of vectors/matrices

[sebiniemann]

The project is currently missing test cases for scalar/vector-valued functions of vectors/matrices, which is split in statistic and logic operations.

Both cases seem to be well parameterisable but clearly with some differences. A blank test class can already be found at test/Arma/arma/TestScalarVectorValuedFunctionsOfVectorsMatrices.java, which should be split accordingly into to separate test classes, one for statistic and one for logic operations.

My suggestion would be to split it into test/Arma/arma/TestScalarVectorValuedFunctionsOfVectorsMatricesStatistic.java and test/Arma/arma/TestScalarVectorValuedFunctionsOfVectorsMatricesLogic.java.

Tasks:

• [x] Add test/Arma/arma/TestScalarVectorValuedFunctionsOfVectorsMatricesStatistic.java
• [x] Add test/Arma/arma/TestScalarVectorValuedFunctionsOfVectorsMatricesLogic.java

For the test data, I would like to check the following values:

• statistic operations (5, 10)-matrix: 0 1 2 10 5 -1 -2 -10 -5 0 0 1 2 50 55 -1 -2 -50 -55 -Datum.inf 0 1 2 20 15 -1 -2 -20 -15 Datum.inf 0 1 2 40 45 -1 -2 -40 -45 Datum.eps 0 1 2 30 30 -1 -2 -30 -30 -Datum.eps
• logic operations (5, 9)-matrix: 0 1 0 123 -1 0 -123 0 0 0 1 1 234 -1 -1 -234 Datum.eps Datum.inf 0 1 0 345 -1 0 -345 0 0 0 1 1 456 -1 -1 -456 -Datum.eps -Datum.inf 0 1 0 567 -1 0 -567 0 0
• [x] Parameterise the statistic test class with the matrix above
• [x] Parameterise the logic test class with the matrix above

Tasks continued: The expected results of these tests should be pre-calculated and saved to compare always with the same pre-calculated values. Because of the different results for vectors and matrices and the additional parameters, a bunch of different cases need to be precalculated. In the vector case, the matrix should be computed per column.

An example for the generation of pre-calculated expected results with native java functions:

public class TestExpectedValues {

  public static void main(String[] args) throws FileNotFoundException {
    testScalarVectorValuedFunctionsOfVectorsMatricesStatistic();
  }

  protected static void testScalarVectorValuedFunctionsOfVectorsMatricesStatistic() throws FileNotFoundException {
    Mat testData = (Mat) TestScalarVectorValuedFunctionsOfVectorsMatricesStatistic.getTestData().iterator().next()[0];
    Mat expected =  new Mat(testData.n_rows, 1);

    // Arma.min(...)
    // Arma.minMat(..., 0)
    for(int j = 0; j < testData.n_cols; j++) {
      Mat column = testData.col(j);

      double minimum = column.at(0);
      for(int n = 1; n < column.n_elem; n++) {
        minimum = Math.min(minimum, column.at(n));
      }

      expected.at(j, Op.EQUAL, minimum);
    }
    expected.save("test/data/Arma/TestScalarVectorValuedFunctionsOfVectorsMatrices/Statistic.min.d0.mat");

    // Arma.minMat(..., 1)
    for(int i = 0; i < testData.n_cols; i++) {
      Mat column = testData.row(i);

      double minimum = column.at(0);
      for(int n = 1; n < column.n_elem; n++) {
        minimum = Math.min(minimum, column.at(n));
      }

      expected.at(i, Op.EQUAL, minimum);
    }
    expected.save("test/data/Arma/TestScalarVectorValuedFunctionsOfVectorsMatrices/Statistic.min.d1.mat");

    /* generation of other expected results for the same parameterised test class */
  }

  /* generation of other expected results for another parameterised test class */
}

The example code given above should be inserted in test/util/arma/TestExpectedValues.java.

Tasks continued:

• [x] Create all testdata-files to be used in the statistic test class
• [ ] Create all testdata-files to be used in the logic test class

Continued example of the actual test case:

@Test
public void testMin() {
  Mat expected = new Mat();
  expected.load("test/data/Arma/TestScalarVectorValuedFunctionsOfVectorsMatrices/Statistic.min.d0.mat");

  for(int j = 0; j < _testData.n_cols; j++) {
    assertEquals(expected.at(j), Arma.min(_testData.col(j)), TestUtil.NUMERIC_TOLERANCE);
  }
}

@Test
public void testMinMat() {
  Mat expected = new Mat();
  expected.load("test/data/Arma/TestScalarVectorValuedFunctionsOfVectorsMatrices/Statistic.min.d0.mat");

  assertMatEquals(expected, Arma.minMat(_testData),  TestUtil.NUMERIC_TOLERANCE);
  assertMatEquals(expected, Arma.minMat(_testData, 0),  TestUtil.NUMERIC_TOLERANCE);

  expected.load("test/data/Arma/TestScalarVectorValuedFunctionsOfVectorsMatrices/Statistic.min.d1.mat");

  assertMatEquals(expected, Arma.minMat(_testData, 1),  TestUtil.NUMERIC_TOLERANCE);
}

Tasks continued:

• [x] Fill the statistic test class with tests for all functions classified as statistic.
• [x] Fill the logic test class with tests for all functions classified as logic.