All information for one workspace method. More...

#include <methods.h>

Public Member Functions
	MdRecord ()
	Default constructor.

	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)
	Initializing constructor for MdRecord.

	MdRecord (const MdRecord &)=default

	MdRecord (MdRecord &&)=default

const String &	Name () const

const String &	Description () const

const ArrayOfString &	Authors () const

const ArrayOfIndex &	Out () const

const ArrayOfString &	GOut () const

const ArrayOfIndex &	GOutType () const

const ArrayOfArrayOfIndex &	GOutSpecType () const

const Array< String > &	GOutDescription () const

const ArrayOfIndex &	In () const

const ArrayOfString &	GIn () const

const ArrayOfIndex &	GInType () const

const ArrayOfArrayOfIndex &	GInSpecType () const

const Array< String > &	GInDefault () const

const Array< String > &	GInDescription () const

const ArrayOfIndex &	InOnly () const

const ArrayOfIndex &	InOut () const

const ArrayOfIndex &	OutOnly () const

bool	SetMethod () const

bool	AgendaMethod () const

bool	Supergeneric () const

bool	UsesTemplates () const

bool	PassWorkspace () const

bool	PassWsvNames () const

const String &	ActualGroups () const

void	SetPassWorkspace ()

void	subst_any_with_group (Index g)
	Expand supergeneric record for given group.

void	subst_any_with_specific_group (Index g)
	Expand supergeneric record for given Index in GOutSpecType and GInSpecType.

ostream &	PrintTemplate (ostream &os, bool show_description=true) const
	Print method template for the control file.

MdRecord &	operator= (MdRecord &&m)=default

MdRecord &	operator= (const MdRecord &m)=default

Private Attributes
String	mname
	The name of this method.

String	mdescription
	A text string describing this method.

ArrayOfString	mauthors
	Author(s) of this method.

ArrayOfIndex	moutput
	Workspace Output.

ArrayOfString	mgout
	Generic Workspace Output Names.

ArrayOfIndex	mgouttype
	Generic Workspace Output Type.

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

ArrayOfString	mgoutdesc
	Generic Workspace Output Description.

ArrayOfIndex	minput
	Workspace Input.

ArrayOfString	mgin
	Generic Workspace Input Names.

ArrayOfIndex	mgintype
	Generic Workspace Input.

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

ArrayOfString	mgindefault
	Generic Workspace Input Defaults.

ArrayOfString	mgindesc
	Generic Workspace Input Description.

ArrayOfIndex	minonly
	Indexes of Input-only variables.

ArrayOfIndex	moutonly
	Indexes of Output-only variables.

ArrayOfIndex	minout
	Indexes of Input-Output variables.

bool	mset_method
	Flag, whether this is a set method.

bool	magenda_method
	Flag, whether this is an agenda method.

bool	msupergeneric
	Flag, whether this method is supergeneric.

bool	muses_templates
	Flag, whether method implementation relies on templates.

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

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

String	mactual_groups
	The actual groups of a supergeneric method.

Friends
void	subst_any_with_group (MdRecord &mdd, Index g)

ostream &	operator<< (ostream &os, const MdRecord &mdr)
	Output operator for MdRecord.

Detailed Description

All information for one workspace method.

Definition at line 21 of file methods.h.

Constructor & Destructor Documentation

◆ MdRecord() [1/4]

MdRecord::MdRecord ( )

inline

Default constructor.

Definition at line 24 of file methods.h.

◆ MdRecord() [2/4]

MdRecord::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`
	)

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 52 of file methods_aux.cc.

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

◆ MdRecord() [3/4]

MdRecord::MdRecord ( const MdRecord & )

default

◆ MdRecord() [4/4]

MdRecord::MdRecord ( MdRecord && )

default

Member Function Documentation

◆ ActualGroups()

const String & MdRecord::ActualGroups ( ) const

inline

Definition at line 91 of file methods.h.

References mactual_groups.

Referenced by define_md_map(), and main().

◆ AgendaMethod()

bool MdRecord::AgendaMethod ( ) const

inline

Definition at line 86 of file methods.h.

References magenda_method.

Referenced by main(), ArtsParser::parse_method(), write_method_header(), and write_method_header_documentation().

◆ Authors()

const ArrayOfString & MdRecord::Authors ( ) const

inline

Definition at line 70 of file methods.h.

References mauthors.

Referenced by write_method_header_documentation().

◆ Description()

const String & MdRecord::Description ( ) const

inline

Definition at line 69 of file methods.h.

References mdescription.

Referenced by write_method_header_documentation().

◆ GIn()

const ArrayOfString & MdRecord::GIn ( ) const

inline

Definition at line 77 of file methods.h.

References mgin.

Referenced by ArtsParser::parse_generic_input(), ArtsParser::parse_method_args(), PrintTemplate(), ArtsParser::set_gin_to_default(), ArtsParser::use_default_method_args(), write_method_header(), and write_method_header_documentation().

◆ GInDefault()

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

inline

Definition at line 80 of file methods.h.

References mgindefault.

Referenced by ArtsParser::set_gin_to_default(), ArtsParser::use_default_method_args(), and write_method_header_documentation().

◆ GInDescription()

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

inline

Definition at line 81 of file methods.h.

References mgindesc.

◆ GInSpecType()

const ArrayOfArrayOfIndex & MdRecord::GInSpecType ( ) const

inline

Definition at line 79 of file methods.h.

References mginspectype.

Referenced by expand_md_data_raw_to_md_data(), option_input(), and ArtsParser::parse_generic_input().

◆ GInType()

const ArrayOfIndex & MdRecord::GInType ( ) const

inline

Definition at line 78 of file methods.h.

References mgintype.

Referenced by main(), option_input(), option_workspacevariables(), ArtsParser::parse_generic_input(), MRecord::print(), PrintTemplate(), ArtsParser::set_gin_to_default(), write_method_header(), and write_method_header_documentation().

◆ GOut()

const ArrayOfString & MdRecord::GOut ( ) const

inline

Definition at line 72 of file methods.h.

References mgout.

Referenced by ArtsParser::parse_generic_output(), ArtsParser::parse_method_args(), ArtsParser::use_default_method_args(), write_method_header(), and write_method_header_documentation().

◆ GOutDescription()

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

inline

Definition at line 75 of file methods.h.

References mgoutdesc.

◆ GOutSpecType()

const ArrayOfArrayOfIndex & MdRecord::GOutSpecType ( ) const

inline

Definition at line 74 of file methods.h.

References mgoutspectype.

Referenced by expand_md_data_raw_to_md_data(), option_methods(), and ArtsParser::parse_generic_output().

◆ GOutType()

const ArrayOfIndex & MdRecord::GOutType ( ) const

inline

Definition at line 73 of file methods.h.

References mgouttype.

Referenced by main(), option_methods(), ArtsParser::parse_generic_output(), MRecord::print(), PrintTemplate(), write_method_header(), and write_method_header_documentation().

◆ In()

const ArrayOfIndex & MdRecord::In ( ) const

inline

Definition at line 76 of file methods.h.

References minput.

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

◆ InOnly()

const ArrayOfIndex & MdRecord::InOnly ( ) const

inline

Definition at line 82 of file methods.h.

References minonly.

Referenced by main(), ArtsParser::parse_specific_input(), ArtsParser::use_default_method_args(), write_method_header(), and write_method_header_documentation().

◆ InOut()

const ArrayOfIndex & MdRecord::InOut ( ) const

inline

Definition at line 83 of file methods.h.

References minout.

Referenced by Agenda::execute().

◆ Name()

const String & MdRecord::Name ( ) const

inline

◆ operator=() [1/2]

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

default

◆ operator=() [2/2]

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

default

◆ Out()

const ArrayOfIndex & MdRecord::Out ( ) const

inline

Definition at line 71 of file methods.h.

References moutput.

Referenced by main(), option_methods(), ArtsParser::parse_specific_input(), ArtsParser::parse_specific_output(), ArtsParser::use_default_method_args(), write_method_header(), and write_method_header_documentation().

◆ OutOnly()

const ArrayOfIndex & MdRecord::OutOnly ( ) const

inline

Definition at line 84 of file methods.h.

References moutonly.

◆ PassWorkspace()

bool MdRecord::PassWorkspace ( ) const

inline

Definition at line 89 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 90 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

os	Output stream
show_description	Should the description string also be printed?

Definition at line 557 of file methods_aux.cc.

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

◆ SetMethod()

bool MdRecord::SetMethod ( ) const

inline

Definition at line 85 of file methods.h.

References mset_method.

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

◆ SetPassWorkspace()

void MdRecord::SetPassWorkspace ( )

inline

Definition at line 92 of file methods.h.

References mpass_workspace.

◆ 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

g	The group for which to expand.

Definition at line 306 of file methods_aux.cc.

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

Referenced by expand_md_data_raw_to_md_data().

◆ 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

g	The SpecType index for which to expand.

Definition at line 349 of file methods_aux.cc.

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

Referenced by expand_md_data_raw_to_md_data().

◆ Supergeneric()

bool MdRecord::Supergeneric ( ) const

inline

Definition at line 87 of file methods.h.

References msupergeneric.

Referenced by define_md_map(), expand_md_data_raw_to_md_data(), main(), ArtsParser::parse_method_args(), subst_any_with_group(), subst_any_with_specific_group(), write_method_header(), and write_method_header_documentation().

◆ UsesTemplates()

bool MdRecord::UsesTemplates ( ) const

inline

Definition at line 88 of file methods.h.

References muses_templates.

Referenced by main(), and write_method_header().

Friends And Related Function Documentation

◆ operator<<

ostream & operator<<	(	ostream &	os,
		const MdRecord &	mdr
	)

friend

Output operator for MdRecord.

Definition at line 633 of file methods_aux.cc.

◆ 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 220 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 185 of file methods.h.

Referenced by AgendaMethod().

◆ mauthors

ArrayOfString MdRecord::mauthors

private

Author(s) of this method.

Definition at line 127 of file methods.h.

Referenced by Authors().

◆ mdescription

String MdRecord::mdescription

private

A text string describing this method.

Definition at line 124 of file methods.h.

Referenced by Description().

◆ mgin

ArrayOfString MdRecord::mgin

private

Generic Workspace Input Names.

Definition at line 149 of file methods.h.

Referenced by GIn(), and MdRecord().

◆ mgindefault

ArrayOfString MdRecord::mgindefault

private

Generic Workspace Input Defaults.

Definition at line 159 of file methods.h.

Referenced by GInDefault(), and MdRecord().

◆ mgindesc

ArrayOfString MdRecord::mgindesc

private

Generic Workspace Input Description.

Definition at line 162 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 156 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 152 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 133 of file methods.h.

Referenced by GOut(), and MdRecord().

◆ mgoutdesc

ArrayOfString MdRecord::mgoutdesc

private

Generic Workspace Output Description.

Definition at line 143 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 140 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 136 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 165 of file methods.h.

Referenced by InOnly(), and MdRecord().

◆ minout

ArrayOfIndex MdRecord::minout

private

Indexes of Input-Output variables.

Definition at line 171 of file methods.h.

Referenced by InOut(), and MdRecord().

◆ minput

ArrayOfIndex MdRecord::minput

private

Workspace Input.

Definition at line 146 of file methods.h.

Referenced by In(), and MdRecord().

◆ mname

String MdRecord::mname

private

The name of this method.

Definition at line 121 of file methods.h.

Referenced by MdRecord(), and Name().

◆ moutonly

ArrayOfIndex MdRecord::moutonly

private

Indexes of Output-only variables.

Definition at line 168 of file methods.h.

Referenced by MdRecord(), and OutOnly().

◆ moutput

ArrayOfIndex MdRecord::moutput

private

Workspace Output.

Definition at line 130 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 206 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 214 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 178 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 192 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 199 of file methods.h.

Referenced by MdRecord(), and UsesTemplates().

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

Public Member Functions

Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ MdRecord() [1/4]

◆ MdRecord() [2/4]

◆ MdRecord() [3/4]

◆ MdRecord() [4/4]

Member Function Documentation

◆ ActualGroups()

◆ AgendaMethod()

◆ Authors()

◆ Description()

◆ GIn()

◆ GInDefault()

◆ GInDescription()

◆ GInSpecType()

◆ GInType()

◆ GOut()

◆ GOutDescription()

◆ GOutSpecType()

◆ GOutType()

◆ In()

◆ InOnly()

◆ InOut()

◆ Name()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ Out()

◆ OutOnly()

◆ PassWorkspace()

◆ PassWsvNames()

◆ PrintTemplate()

◆ SetMethod()

◆ SetPassWorkspace()

◆ subst_any_with_group()

◆ subst_any_with_specific_group()

◆ Supergeneric()

◆ UsesTemplates()

Friends And Related Function Documentation

◆ operator<<

◆ subst_any_with_group

Member Data Documentation

◆ mactual_groups

◆ magenda_method

◆ mauthors

◆ mdescription

◆ mgin

◆ mgindefault

◆ mgindesc

◆ mginspectype

◆ mgintype

◆ mgout

◆ mgoutdesc

◆ mgoutspectype

◆ mgouttype

◆ minonly

◆ minout

◆ minput

◆ mname

◆ moutonly

◆ moutput

◆ mpass_workspace

◆ mpass_wsv_names

◆ mset_method

◆ msupergeneric

◆ muses_templates