test/interface/ObsOperator.h

Go to the documentation of this file.

/*
 * (C) Copyright 2017-2018 UCAR
 *
 * This software is licensed under the terms of the Apache Licence Version 2.0
 * which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
 */
 
#ifndef TEST_INTERFACE_OBSOPERATOR_H_
#define TEST_INTERFACE_OBSOPERATOR_H_
 
#include <memory>
#include <string>
#include <vector>
 
#define ECKIT_TESTING_SELF_REGISTER_CASES 0
 
#include <boost/noncopyable.hpp>
 
#include "eckit/config/LocalConfiguration.h"
#include "eckit/testing/Test.h"
#include "oops/base/Variables.h"
#include "oops/interface/GeoVaLs.h"
#include "oops/interface/ObsAuxControl.h"
#include "oops/interface/ObsDataVector.h"
#include "oops/interface/ObsDiagnostics.h"
#include "oops/interface/ObsOperator.h"
#include "oops/interface/ObsVector.h"
#include "oops/runs/Test.h"
#include "test/interface/ObsTestsFixture.h"
#include "test/TestEnvironment.h"
 
namespace test {
 
// -----------------------------------------------------------------------------
 
template <typename OBS> void testConstructor() {
  typedef ObsTestsFixture<OBS> Test_;
  typedef oops::ObsOperator<OBS>       ObsOperator_;
 
  std::vector<eckit::LocalConfiguration> conf;
  TestEnvironment::config().get("observations", conf);
 
  for (std::size_t jj = 0; jj < Test_::obspace().size(); ++jj) {
    eckit::LocalConfiguration obsopconf(conf[jj], "obs operator");
    std::unique_ptr<ObsOperator_> hop(new ObsOperator_(Test_::obspace()[jj], obsopconf));
    EXPECT(hop.get());
 
    hop.reset();
    EXPECT(!hop.get());
  }
}
 
// -----------------------------------------------------------------------------
 
template <typename OBS> void testSimulateObs() {
  typedef ObsTestsFixture<OBS> Test_;
  typedef oops::GeoVaLs<OBS>           GeoVaLs_;
  typedef oops::ObsDiagnostics<OBS>    ObsDiags_;
  typedef oops::ObsAuxControl<OBS>     ObsAuxCtrl_;
  typedef oops::ObsOperator<OBS>       ObsOperator_;
  typedef oops::ObsVector<OBS>         ObsVector_;
 
  std::vector<eckit::LocalConfiguration> conf;
  TestEnvironment::config().get("observations", conf);
 
  for (std::size_t jj = 0; jj < Test_::obspace().size(); ++jj) {
    // initialize observation operator (set variables requested from the model,
    // variables simulated by the observation operator, other init)
    eckit::LocalConfiguration obsopconf(conf[jj], "obs operator");
    ObsOperator_ hop(Test_::obspace()[jj], obsopconf);
 
    // initialize bias correction
    const ObsAuxCtrl_ ybias(Test_::obspace()[jj], conf[jj]);
 
    // read geovals from the file
    eckit::LocalConfiguration gconf(conf[jj], "geovals");
    oops::Variables hopvars = hop.requiredVars();
    hopvars += ybias.requiredVars();
    const GeoVaLs_ gval(gconf, Test_::obspace()[jj], hopvars);
 
    // create obsvector to hold H(x)
    ObsVector_ hofx(Test_::obspace()[jj]);
 
    // create diagnostics to hold HofX diags
    oops::Variables diagvars;
    diagvars += ybias.requiredHdiagnostics();
    ObsDiags_ diags(Test_::obspace()[jj],
                    hop.locations(Test_::obspace()[jj].windowStart(),
                                  Test_::obspace()[jj].windowEnd()),
                    diagvars);
 
    // call H(x), save result in the output file as @hofx
    hop.simulateObs(gval, hofx, ybias, diags);
    hofx.save("hofx");
 
    // apply bias correction if it is required
    if (conf[jj].has("obs bias")) {
      const ObsVector_ bias(Test_::obspace()[jj], "ObsBias", false);
      hofx += bias;
    }
 
    const double tol = conf[jj].getDouble("tolerance");
    if (conf[jj].has("vector ref")) {
      // if reference h(x) is saved in file as a vector, read from file
      // and compare the norm of difference to zero
      ObsVector_ obsref(Test_::obspace()[jj], conf[jj].getString("vector ref"));
      obsref -= hofx;
      const double zz = obsref.rms();
      oops::Log::info() << "Vector difference between reference and computed: " << obsref;
      EXPECT(zz < 100*tol);  //  change tol from percent to actual value.
                             //  tol used in is_close is relative
    } else if (conf[jj].has("norm ref")) {
      // if reference h(x) is saved in file as a vector, read from file
      // and compare the difference, normalised by the reference values to zero
      ObsVector_ obsref(Test_::obspace()[jj], conf[jj].getString("norm ref"));
      obsref -= hofx;
      obsref /= hofx;
      const double zz = obsref.rms();
      oops::Log::info() << "Normalised vector difference between reference and computed: "
                        << obsref;
      EXPECT(zz < 100*tol);  //  change tol from percent to actual value.
                             //  tol used in is_close is relative
    } else {
      // else compare h(x) norm to the norm from the config
      const double zz = hofx.rms();
      const double xx = conf[jj].getDouble("rms ref");
 
      oops::Log::debug() << "zz: " << std::fixed << std::setprecision(8) << zz << std::endl;
      oops::Log::debug() << "xx: " << std::fixed << std::setprecision(8) << xx << std::endl;
 
      EXPECT(oops::is_close(xx, zz, tol));
    }
  }
}
 
// -----------------------------------------------------------------------------
 
template <typename OBS>
class ObsOperator : public oops::Test {
  typedef ObsTestsFixture<OBS> Test_;
 public:
  ObsOperator() {}
  virtual ~ObsOperator() {}
 private:
  std::string testid() const override {return "test::ObsOperator<" + OBS::name() + ">";}
 
  void register_tests() const override {
    std::vector<eckit::testing::Test>& ts = eckit::testing::specification();
 
    ts.emplace_back(CASE("interface/ObsOperator/testConstructor")
      { testConstructor<OBS>(); });
    ts.emplace_back(CASE("interface/ObsOperator/testSimulateObs")
      { testSimulateObs<OBS>(); });
  }
 
  void clear() const override {
    Test_::reset();
  }
};
 
// =============================================================================
 
}  // namespace test
 
#endif  // TEST_INTERFACE_OBSOPERATOR_H_