methods.h

Go to the documentation of this file.

 
#ifndef methods_h
#define methods_h
 
#include <iosfwd>
#include "matpack_data.h"
#include "messages.h"
 
#define NODEF "@@THIS_KEYWORD_HAS_NO_DEFAULT_VALUE@@"
 
class MdRecord {
 public:
  MdRecord()
      : mname(""),
        mdescription(""),
        mauthors(0),
        moutput(0),
        mgout(0),
        mgouttype(0),
        mgoutdesc(0),
        minput(0),
        mgin(0),
        mgintype(0),
        mgindefault(0),
        mgindesc(0),
        mset_method(false),
        magenda_method(false),
        msupergeneric(false),
        muses_templates(false),
        mpass_workspace(true),
        mpass_wsv_names(false),
        mactual_groups("") {}
 
  // Initializing constructor. Implementation in methods_aux.cc.
  MdRecord(const char* name,
           const char* description,
           const ArrayOfString& authors,
           const ArrayOfString& output,
           const ArrayOfString& gout,
           const ArrayOfString& gouttype,
           const ArrayOfString& goutdesc,
           const ArrayOfString& input,
           const ArrayOfString& gin,
           const ArrayOfString& gintype,
           const ArrayOfString& gindefault,
           const ArrayOfString& gindesc,
           bool set_method = false,
           bool agenda_method = false,
           bool uses_templates = false,
           bool pass_workspace = false,
           bool pass_wsv_names = false);
 
  MdRecord(const MdRecord&) = default;
  MdRecord(MdRecord&&) = default;
 
  // Methods returning the lookup information:
  [[nodiscard]] const String& Name() const { return mname; }
  [[nodiscard]] const String& Description() const { return mdescription; }
  [[nodiscard]] const ArrayOfString& Authors() const { return mauthors; }
  [[nodiscard]] const ArrayOfIndex& Out() const { return moutput; }
  [[nodiscard]] const ArrayOfString& GOut() const { return mgout; }
  [[nodiscard]] const ArrayOfIndex& GOutType() const { return mgouttype; }
  [[nodiscard]] const ArrayOfArrayOfIndex& GOutSpecType() const { return mgoutspectype; }
  [[nodiscard]] const Array<String>& GOutDescription() const { return mgoutdesc; }
  [[nodiscard]] const ArrayOfIndex& In() const { return minput; }
  [[nodiscard]] const ArrayOfString& GIn() const { return mgin; }
  [[nodiscard]] const ArrayOfIndex& GInType() const { return mgintype; }
  [[nodiscard]] const ArrayOfArrayOfIndex& GInSpecType() const { return mginspectype; }
  [[nodiscard]] const Array<String>& GInDefault() const { return mgindefault; }
  [[nodiscard]] const Array<String>& GInDescription() const { return mgindesc; }
  [[nodiscard]] const ArrayOfIndex& InOnly() const { return minonly; }
  [[nodiscard]] const ArrayOfIndex& InOut() const { return minout; }
  [[nodiscard]] const ArrayOfIndex& OutOnly() const { return moutonly; }
  [[nodiscard]] bool SetMethod() const { return mset_method; }
  [[nodiscard]] bool AgendaMethod() const { return magenda_method; }
  [[nodiscard]] bool Supergeneric() const { return msupergeneric; }
  [[nodiscard]] bool UsesTemplates() const { return muses_templates; }
  [[nodiscard]] bool PassWorkspace() const { return mpass_workspace; }
  [[nodiscard]] bool PassWsvNames() const { return mpass_wsv_names; }
  [[nodiscard]] const String& ActualGroups() const { return mactual_groups; }
  void SetPassWorkspace() { mpass_workspace = true; }
 
  // Expand supergeneric method record to an actual group
  // (documentation with implementation in method_aux.cc):
  void subst_any_with_group(Index g);
  void subst_any_with_specific_group(Index g);
 
 
  ostream& PrintTemplate(ostream& os, bool show_description = true) const;
 
  MdRecord& operator=(MdRecord&& m) = default;
  MdRecord& operator=(const MdRecord& m) = default;
 
  // Needed by make_auto_md_h.cc. See documentation there.
  friend void subst_any_with_group(MdRecord& mdd, Index g);
 
  friend ostream& operator<<(ostream& os, const MdRecord& mdr);
 
 private:
  String mname;
 
  String mdescription;
 
  ArrayOfString mauthors;
 
  ArrayOfIndex moutput;
 
  ArrayOfString mgout;
 
  ArrayOfIndex mgouttype;
 
  // is not completely supergeneric but only defined for these types).
  ArrayOfArrayOfIndex mgoutspectype;
 
  ArrayOfString mgoutdesc;
 
  ArrayOfIndex minput;
 
  ArrayOfString mgin;
 
  ArrayOfIndex mgintype;
 
  // is not completely supergeneric but only defined for these types).
  ArrayOfArrayOfIndex mginspectype;
 
  ArrayOfString mgindefault;
 
  ArrayOfString mgindesc;
 
  ArrayOfIndex minonly;
 
  ArrayOfIndex moutonly;
 
  ArrayOfIndex minout;
 
 
  bool mset_method;
 
 
  bool magenda_method;
 
 
  bool msupergeneric;
 
 
  bool muses_templates;
 
 
  bool mpass_workspace;
 
 
  bool mpass_wsv_names;
 
 
  String mactual_groups;
};
 
void define_md_data_raw();
 
void expand_md_data_raw_to_md_data();
 
bool format_paragraph(String& s,
                      const String& indent,
                      const size_t linelen,
                      const size_t offset = 0);
 
void define_md_map();
 
void define_md_raw_map();
 
void get_short_wsv_description(String& s, const String& desc);
 
#endif  // methods_h