FV3 Bundle
ObsOperatorBase.h
Go to the documentation of this file.
1 /*
2  * (C) Copyright 2017-2018 UCAR
3  *
4  * This software is licensed under the terms of the Apache Licence Version 2.0
5  * which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
6  */
7 
8 #ifndef UFO_OBSOPERATORBASE_H_
9 #define UFO_OBSOPERATORBASE_H_
10 
11 #include <map>
12 #include <string>
13 
14 #include <boost/noncopyable.hpp>
15 
16 #include "eckit/config/Configuration.h"
17 #include "ioda/ObsSpace.h"
18 #include "oops/base/Variables.h"
19 #include "oops/util/abor1_cpp.h"
20 #include "oops/util/Printable.h"
21 
22 namespace ioda {
23 class ObsVector;
24 }
25 
26 namespace ufo {
27 class GeoVaLs;
28 class ObsBias;
29 
30 // -----------------------------------------------------------------------------
31 /// Base class for observation operators
32 
33 class ObsOperatorBase : public util::Printable,
34  private boost::noncopyable {
35  public:
37  virtual ~ObsOperatorBase() {}
38 
39 /// Obs Operator
40  virtual void simulateObs(const GeoVaLs &, ioda::ObsVector &, const ObsBias &) const = 0;
41 
42 /// Operator input required from Model
43  virtual const oops::Variables & variables() const = 0;
44 
45  private:
46  virtual void print(std::ostream &) const = 0;
47 };
48 
49 // -----------------------------------------------------------------------------
50 
51 /// Obs Operator Factory
53  public:
54  static ObsOperatorBase * create(const ioda::ObsSpace &, const eckit::Configuration &);
55  virtual ~ObsOperatorFactory() { getMakers().clear(); }
56  protected:
57  explicit ObsOperatorFactory(const std::string &);
58  private:
59  virtual ObsOperatorBase * make(const ioda::ObsSpace &, const eckit::Configuration &) = 0;
60  static std::map < std::string, ObsOperatorFactory * > & getMakers() {
61  static std::map < std::string, ObsOperatorFactory * > makers_;
62  return makers_;
63  }
64 };
65 
66 // -----------------------------------------------------------------------------
67 
68 template<class T>
70  virtual ObsOperatorBase * make(const ioda::ObsSpace & odb, const eckit::Configuration & conf)
71  { return new T(odb, conf); }
72  public:
73  explicit ObsOperatorMaker(const std::string & name) : ObsOperatorFactory(name) {}
74 };
75 
76 // -----------------------------------------------------------------------------
77 
78 } // namespace ufo
79 
80 #endif // UFO_OBSOPERATORBASE_H_
ObsOperatorMaker(const std::string &name)
ObsVector class to handle vectors in observation space for IODA.
Definition: conf.py:1
virtual ObsOperatorBase * make(const ioda::ObsSpace &, const eckit::Configuration &)=0
static std::map< std::string, ObsOperatorFactory *> & getMakers()
Base class for observation operators.
virtual void print(std::ostream &) const =0
Wrapper around ObsHelpQG, mostly to hide the factory.
character(len=32) name
virtual const oops::Variables & variables() const =0
Operator input required from Model.
GeoVaLs: geophysical values at locations.
static ObsOperatorBase * create(const ioda::ObsSpace &, const eckit::Configuration &)
************************************************************************GNU Lesser General Public License **This file is part of the GFDL Flexible Modeling System(FMS). ! *! *FMS is free software without even the implied warranty of MERCHANTABILITY or *FITNESS FOR A PARTICULAR PURPOSE See the GNU General Public License *for more details **You should have received a copy of the GNU Lesser General Public *License along with FMS If see< http:! ***********************************************************************!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !! MPP_TRANSMIT !! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! subroutine MPP_TRANSMIT_(put_data, put_len, to_pe, get_data, get_len, from_pe, block, tag, recv_request, send_request)!a message-passing routine intended to be reminiscent equally of both MPI and SHMEM!put_data and get_data are contiguous MPP_TYPE_ arrays!at each call, your put_data array is put to to_pe 's get_data! your get_data array is got from from_pe 's put_data!i.e we assume that typically(e.g updating halo regions) each PE performs a put _and_ a get!special PE designations:! NULL_PE:to disable a put or a get(e.g at boundaries)! ANY_PE:if remote PE for the put or get is to be unspecific! ALL_PES:broadcast and collect operations(collect not yet implemented)!ideally we would not pass length, but this f77-style call performs better(arrays passed by address, not descriptor)!further, this permits< length > contiguous words from an array of any rank to be passed(avoiding f90 rank conformance check)!caller is responsible for completion checks(mpp_sync_self) before and after integer, intent(in) ::put_len, to_pe, get_len, from_pe MPP_TYPE_, intent(in) ::put_data(*) MPP_TYPE_, intent(out) ::get_data(*) logical, intent(in), optional ::block integer, intent(in), optional ::tag integer, intent(out), optional ::recv_request, send_request logical ::block_comm integer ::i MPP_TYPE_, allocatable, save ::local_data(:) !local copy used by non-parallel code(no SHMEM or MPI) integer ::comm_tag integer ::rsize if(.NOT.module_is_initialized) call mpp_error(FATAL, 'MPP_TRANSMIT:You must first call mpp_init.') if(to_pe.EQ.NULL_PE .AND. from_pe.EQ.NULL_PE) return block_comm=.true. if(PRESENT(block)) block_comm=block if(debug) then call SYSTEM_CLOCK(tick) write(stdout_unit,'(a, i18, a, i6, a, 2i6, 2i8)')&'T=', tick, ' PE=', pe, ' MPP_TRANSMIT begin:to_pe, from_pe, put_len, get_len=', to_pe, from_pe, put_len, get_len end if comm_tag=DEFAULT_TAG if(present(tag)) comm_tag=tag!do put first and then get if(to_pe.GE.0 .AND. to_pe.LT.npes) then!use non-blocking sends if(debug .and.(current_clock.NE.0)) call SYSTEM_CLOCK(start_tick)!z1l:truly non-blocking send.! if(request(to_pe).NE.MPI_REQUEST_NULL) then !only one message from pe-> to_pe in queue *PE waiting for to_pe ! call error else get_len so only do gets but you cannot have a pure get with MPI call a get means do a wait to ensure put on remote PE is complete error call increase mpp_nml request_multiply call MPP_TRANSMIT get_len end if return end subroutine MPP_TRANSMIT_ ! MPP_BROADCAST ! subroutine but that doesn t allow !broadcast to a subset of PEs This version and mpp_transmit will remain !backward compatible intent(inout) & T
ObsOperatorFactory(const std::string &)
Class to handle observation bias parameters.
virtual ObsOperatorBase * make(const ioda::ObsSpace &odb, const eckit::Configuration &conf)
Obs Operator Factory.
virtual void simulateObs(const GeoVaLs &, ioda::ObsVector &, const ObsBias &) const =0
Obs Operator.