ARTS  2.2.66
MdRecord Class Reference

All information for one workspace method. More...

#include <methods.h>

Collaboration diagram for MdRecord:

Public Member Functions

 MdRecord ()
 Default constructor. More...
 
 MdRecord (const char name[], const char description[], const MakeArray< String > &authors, const MakeArray< String > &output, const MakeArray< String > &gout, const MakeArray< String > &gouttype, const MakeArray< String > &goutdesc, const MakeArray< String > &input, const MakeArray< String > &gin, const MakeArray< String > &gintype, const MakeArray< String > &gindefault, const MakeArray< String > &gindesc, bool set_method=false, bool agenda_method=false, bool uses_templates=false, bool pass_workspace=false, bool pass_wsv_names=false)
 Initializing constructor for MdRecord. More...
 
const StringName () const
 
const StringDescription () const
 
const ArrayOfStringAuthors () const
 
const ArrayOfIndexOut () const
 
const ArrayOfStringGOut () const
 
const ArrayOfIndexGOutType () const
 
const ArrayOfArrayOfIndexGOutSpecType () const
 
const Array< String > & GOutDescription () const
 
const ArrayOfIndexIn () const
 
const ArrayOfStringGIn () const
 
const ArrayOfIndexGInType () const
 
const ArrayOfArrayOfIndexGInSpecType () const
 
const Array< String > & GInDefault () const
 
const Array< String > & GInDescription () const
 
const ArrayOfIndexInOnly () const
 
const ArrayOfIndexInOut () const
 
const ArrayOfIndexOutOnly () const
 
bool SetMethod () const
 
bool AgendaMethod () const
 
bool Supergeneric () const
 
bool UsesTemplates () const
 
bool PassWorkspace () const
 
bool PassWsvNames () const
 
const StringActualGroups () const
 
void SetPassWorkspace ()
 
void subst_any_with_group (Index g)
 Expand supergeneric record for given group. More...
 
void subst_any_with_specific_group (Index g)
 Expand supergeneric record for given Index in GOutSpecType and GInSpecType. More...
 
ostream & PrintTemplate (ostream &os, bool show_description=true) const
 Print method template for the control file. More...
 
MdRecordoperator= (const MdRecord &m)
 To override the default assignment operator. More...
 

Private Attributes

String mname
 The name of this method. More...
 
String mdescription
 A text string describing this method. More...
 
ArrayOfString mauthors
 Author(s) of this method. More...
 
ArrayOfIndex moutput
 Workspace Output. More...
 
ArrayOfString mgout
 Generic Workspace Output Names. More...
 
ArrayOfIndex mgouttype
 Generic Workspace Output Type. More...
 
ArrayOfArrayOfIndex mgoutspectype
 Generic Workspace Output Types (Contains the valid types if the method. More...
 
ArrayOfString mgoutdesc
 Generic Workspace Output Description. More...
 
ArrayOfIndex minput
 Workspace Input. More...
 
ArrayOfString mgin
 Generic Workspace Input Names. More...
 
ArrayOfIndex mgintype
 Generic Workspace Input. More...
 
ArrayOfArrayOfIndex mginspectype
 Generic Workspace Input Types (Contains the valid types if the method. More...
 
ArrayOfString mgindefault
 Generic Workspace Input Defaults. More...
 
ArrayOfString mgindesc
 Generic Workspace Input Description. More...
 
ArrayOfIndex minonly
 Indexes of Input-only variables. More...
 
ArrayOfIndex moutonly
 Indexes of Output-only variables. More...
 
ArrayOfIndex minout
 Indexes of Input-Output variables. More...
 
bool mset_method
 Flag, whether this is a set method. More...
 
bool magenda_method
 Flag, whether this is an agenda method. More...
 
bool msupergeneric
 Flag, whether this method is supergeneric. More...
 
bool muses_templates
 Flag, whether method implementation relies on templates. More...
 
bool mpass_workspace
 Flag, whether a workspace reference should be passed to the WSM. More...
 
bool mpass_wsv_names
 Flag, whether WSV names should be passed to the WSM. More...
 
String mactual_groups
 The actual groups of a supergeneric method. More...
 

Friends

void subst_any_with_group (MdRecord &mdd, Index g)
 

Detailed Description

All information for one workspace method.

Definition at line 42 of file methods.h.

Constructor & Destructor Documentation

◆ MdRecord() [1/2]

MdRecord::MdRecord ( )
inline

Default constructor.

Definition at line 46 of file methods.h.

References _U_.

◆ MdRecord() [2/2]

MdRecord::MdRecord ( const char  name[],
const char  description[],
const MakeArray< String > &  authors,
const MakeArray< String > &  output,
const MakeArray< String > &  gout,
const MakeArray< String > &  gouttype,
const MakeArray< String > &  goutdesc,
const MakeArray< String > &  input,
const MakeArray< String > &  gin,
const MakeArray< String > &  gintype,
const MakeArray< String > &  gindefault,
const MakeArray< String > &  gindesc,
bool  set_method = false,
bool  agenda_method = false,
bool  uses_templates = false,
bool  pass_workspace = false,
bool  pass_wsv_names = false 
)

Initializing constructor for MdRecord.

This is the only non-trivial constructor, which sets all the fields. The flag for supergenericity is not set directly, but inferred from the presence of Any_ in the generic input or output list.

Definition at line 65 of file methods_aux.cc.

References get_wsv_group_id(), get_wsv_group_ids(), get_wsv_id(), mgin, mgindefault, mginspectype, mgintype, mgout, mgoutspectype, mgouttype, minonly, minout, minput, mname, moutonly, moutput, msupergeneric, muses_templates, and Array< base >::nelem().

Member Function Documentation

◆ ActualGroups()

const String& MdRecord::ActualGroups ( ) const
inline

Definition at line 112 of file methods.h.

References mactual_groups.

Referenced by define_md_map(), and main().

◆ AgendaMethod()

bool MdRecord::AgendaMethod ( ) const
inline

◆ Authors()

const ArrayOfString& MdRecord::Authors ( ) const
inline

Definition at line 91 of file methods.h.

References mauthors.

Referenced by operator<<(), and write_method_header_documentation().

◆ Description()

const String& MdRecord::Description ( ) const
inline

Definition at line 90 of file methods.h.

References mdescription.

Referenced by operator<<(), and write_method_header_documentation().

◆ GIn()

◆ GInDefault()

const Array<String>& MdRecord::GInDefault ( ) const
inline

◆ GInDescription()

const Array<String>& MdRecord::GInDescription ( ) const
inline

Definition at line 102 of file methods.h.

References mgindesc.

Referenced by operator<<().

◆ GInSpecType()

const ArrayOfArrayOfIndex& MdRecord::GInSpecType ( ) const
inline

◆ GInType()

◆ GOut()

const ArrayOfString& MdRecord::GOut ( ) const
inline

◆ GOutDescription()

const Array<String>& MdRecord::GOutDescription ( ) const
inline

Definition at line 96 of file methods.h.

References mgoutdesc.

Referenced by operator<<().

◆ GOutSpecType()

const ArrayOfArrayOfIndex& MdRecord::GOutSpecType ( ) const
inline

◆ GOutType()

◆ In()

const ArrayOfIndex& MdRecord::In ( ) const
inline

◆ InOnly()

const ArrayOfIndex& MdRecord::InOnly ( ) const
inline

◆ InOut()

const ArrayOfIndex& MdRecord::InOut ( ) const
inline

Definition at line 104 of file methods.h.

References minout.

Referenced by Agenda::execute().

◆ Name()

◆ operator=()

MdRecord& MdRecord::operator= ( const MdRecord m)
inline

To override the default assignment operator.

MdRecords cannot be assigned!

Definition at line 134 of file methods.h.

References arts_exit(), and subst_any_with_group().

◆ Out()

◆ OutOnly()

const ArrayOfIndex& MdRecord::OutOnly ( ) const
inline

Definition at line 105 of file methods.h.

References moutonly.

◆ PassWorkspace()

bool MdRecord::PassWorkspace ( ) const
inline

Definition at line 110 of file methods.h.

References mpass_workspace.

Referenced by main(), write_method_header(), and write_method_header_documentation().

◆ PassWsvNames()

bool MdRecord::PassWsvNames ( ) const
inline

Definition at line 111 of file methods.h.

References mpass_wsv_names.

Referenced by main(), write_method_header(), and write_method_header_documentation().

◆ PrintTemplate()

ostream & MdRecord::PrintTemplate ( ostream &  os,
bool  show_description = true 
) const

Print method template for the control file.

This prints the method data exactly in the same way how it can be included in the control file. The description string is also printed as a comment, but this can be turned off by setting show_comment to false.

Parameters
osOutput stream
show_descriptionShould the description string also be printed?

Definition at line 588 of file methods_aux.cc.

References GIn(), GInType(), GOutType(), Name(), Array< base >::nelem(), and global_data::wsv_group_names.

Referenced by SetPassWorkspace().

◆ SetMethod()

bool MdRecord::SetMethod ( ) const
inline

Definition at line 106 of file methods.h.

References mset_method.

Referenced by Agenda::execute(), main(), and ArtsParser::parse_generic_input().

◆ SetPassWorkspace()

void MdRecord::SetPassWorkspace ( )
inline

◆ subst_any_with_group()

void MdRecord::subst_any_with_group ( Index  g)

Expand supergeneric record for given group.

This function will substitute any occurance of Any_ in the GOutType and GInType list of MdRecord by group g.

It also adds the group to the name like this: Copy becomes Copy_sg_Vector, Copy_sg_Matrix, etc..

Parameters
gThe group for which to expand.

Definition at line 300 of file methods_aux.cc.

References get_wsv_group_id(), mactual_groups, mgintype, mgouttype, Array< base >::nelem(), Supergeneric(), and global_data::wsv_group_names.

Referenced by expand_md_data_raw_to_md_data(), operator=(), and SetPassWorkspace().

◆ subst_any_with_specific_group()

void MdRecord::subst_any_with_specific_group ( Index  g)

Expand supergeneric record for given Index in GOutSpecType and GInSpecType.

This function will substitute any occurance of Any_ in the GOutType and GInType list of MdRecord by group GOutSpecType[g] and GInSpecType[g].

It also adds the group to the name like this: Copy becomes Copy_sg_Vector, Copy_sg_Matrix, etc..

Parameters
gThe SpecType index for which to expand.

Definition at line 345 of file methods_aux.cc.

References get_wsv_group_id(), mactual_groups, mginspectype, mgintype, mgoutspectype, mgouttype, Array< base >::nelem(), Supergeneric(), and global_data::wsv_group_names.

Referenced by expand_md_data_raw_to_md_data(), and SetPassWorkspace().

◆ Supergeneric()

◆ UsesTemplates()

bool MdRecord::UsesTemplates ( ) const
inline

Definition at line 109 of file methods.h.

References muses_templates.

Referenced by main(), and write_method_header().

Friends And Related Function Documentation

◆ subst_any_with_group

void subst_any_with_group ( MdRecord mdd,
Index  g 
)
friend

Member Data Documentation

◆ mactual_groups

String MdRecord::mactual_groups
private

The actual groups of a supergeneric method.

This holds the actual groups after expansion of a supergeneric method.

Definition at line 248 of file methods.h.

Referenced by ActualGroups(), subst_any_with_group(), and subst_any_with_specific_group().

◆ magenda_method

bool MdRecord::magenda_method
private

Flag, whether this is an agenda method.

Agenda methods expect other method definitions inside their body in the controlfile.

Definition at line 213 of file methods.h.

Referenced by AgendaMethod().

◆ mauthors

ArrayOfString MdRecord::mauthors
private

Author(s) of this method.

Definition at line 155 of file methods.h.

Referenced by Authors().

◆ mdescription

String MdRecord::mdescription
private

A text string describing this method.

Definition at line 152 of file methods.h.

Referenced by Description().

◆ mgin

ArrayOfString MdRecord::mgin
private

Generic Workspace Input Names.

Definition at line 177 of file methods.h.

Referenced by GIn(), and MdRecord().

◆ mgindefault

ArrayOfString MdRecord::mgindefault
private

Generic Workspace Input Defaults.

Definition at line 187 of file methods.h.

Referenced by GInDefault(), and MdRecord().

◆ mgindesc

ArrayOfString MdRecord::mgindesc
private

Generic Workspace Input Description.

Definition at line 190 of file methods.h.

Referenced by GInDescription().

◆ mginspectype

ArrayOfArrayOfIndex MdRecord::mginspectype
private

Generic Workspace Input Types (Contains the valid types if the method.

Definition at line 184 of file methods.h.

Referenced by GInSpecType(), MdRecord(), and subst_any_with_specific_group().

◆ mgintype

ArrayOfIndex MdRecord::mgintype
private

Generic Workspace Input.

Definition at line 180 of file methods.h.

Referenced by GInType(), MdRecord(), subst_any_with_group(), and subst_any_with_specific_group().

◆ mgout

ArrayOfString MdRecord::mgout
private

Generic Workspace Output Names.

Definition at line 161 of file methods.h.

Referenced by GOut(), and MdRecord().

◆ mgoutdesc

ArrayOfString MdRecord::mgoutdesc
private

Generic Workspace Output Description.

Definition at line 171 of file methods.h.

Referenced by GOutDescription().

◆ mgoutspectype

ArrayOfArrayOfIndex MdRecord::mgoutspectype
private

Generic Workspace Output Types (Contains the valid types if the method.

Definition at line 168 of file methods.h.

Referenced by GOutSpecType(), MdRecord(), and subst_any_with_specific_group().

◆ mgouttype

ArrayOfIndex MdRecord::mgouttype
private

Generic Workspace Output Type.

Definition at line 164 of file methods.h.

Referenced by GOutType(), MdRecord(), subst_any_with_group(), and subst_any_with_specific_group().

◆ minonly

ArrayOfIndex MdRecord::minonly
private

Indexes of Input-only variables.

Definition at line 193 of file methods.h.

Referenced by InOnly(), and MdRecord().

◆ minout

ArrayOfIndex MdRecord::minout
private

Indexes of Input-Output variables.

Definition at line 199 of file methods.h.

Referenced by InOut(), and MdRecord().

◆ minput

ArrayOfIndex MdRecord::minput
private

Workspace Input.

Definition at line 174 of file methods.h.

Referenced by In(), and MdRecord().

◆ mname

String MdRecord::mname
private

The name of this method.

Definition at line 149 of file methods.h.

Referenced by MdRecord(), and Name().

◆ moutonly

ArrayOfIndex MdRecord::moutonly
private

Indexes of Output-only variables.

Definition at line 196 of file methods.h.

Referenced by MdRecord(), and OutOnly().

◆ moutput

ArrayOfIndex MdRecord::moutput
private

Workspace Output.

Definition at line 158 of file methods.h.

Referenced by MdRecord(), and Out().

◆ mpass_workspace

bool MdRecord::mpass_workspace
private

Flag, whether a workspace reference should be passed to the WSM.

Some WSMs (like Delete) need direct access to the workspace object. If this flag is set to true, the gateway function will take care of that.

Definition at line 234 of file methods.h.

Referenced by PassWorkspace(), and SetPassWorkspace().

◆ mpass_wsv_names

bool MdRecord::mpass_wsv_names
private

Flag, whether WSV names should be passed to the WSM.

Some WSMs (like ReadXML, WriteXML) need to know the names of the WSVs that have been passed to them. If this flag is set to true, the gateway function will take care of that.

Definition at line 242 of file methods.h.

Referenced by PassWsvNames().

◆ mset_method

bool MdRecord::mset_method
private

Flag, whether this is a set method.

Set methods have exactly one generic input. Unlike other inputs these are not stored in a workspace variable.

Definition at line 206 of file methods.h.

Referenced by SetMethod().

◆ msupergeneric

bool MdRecord::msupergeneric
private

Flag, whether this method is supergeneric.

This flag is set automatically if the gouttype or gintype contains Any_.

Definition at line 220 of file methods.h.

Referenced by MdRecord(), and Supergeneric().

◆ muses_templates

bool MdRecord::muses_templates
private

Flag, whether method implementation relies on templates.

If we want to implement a supergeneric method by a template function, we must not generate explicit method headers in auto_md.h.

Definition at line 227 of file methods.h.

Referenced by MdRecord(), and UsesTemplates().


The documentation for this class was generated from the following files: