Flow123d  release_3.0.0-910-g56968e3
Public Member Functions | Protected Attributes | Friends | List of all members
FieldSet Class Reference

Container for various descendants of FieldCommonBase. More...

#include <field_set.hh>

Inheritance diagram for FieldSet:
Inheritance graph
[legend]
Collaboration diagram for FieldSet:
Collaboration graph
[legend]

Public Member Functions

 DECLARE_EXCEPTION (ExcUnknownField,<< "Field set has no field with name: "<< FieldCommon::EI_Field::qval)
 
Input::Type::Record make_field_descriptor_type (const std::string &equation_name) const
 
void set_field (const std::string &dest_field_name, FieldCommon &source)
 
FieldCommonfield (const std::string &field_name) const
 
FieldCommonoperator[] (const std::string &field_name) const
 
void set_components (const std::vector< string > &names)
 
void set_mesh (const Mesh &mesh)
 
void set_input_list (Input::Array input_list, const TimeGovernor &tg)
 
void flags_add (FieldFlag::Flags::Mask mask)
 
bool set_time (const TimeStep &time, LimitSide limit_side)
 
void output_type (OutputTime::DiscreteSpace rt)
 
void mark_input_times (const TimeGovernor &tg)
 
bool changed () const
 
bool is_constant (Region reg) const
 
bool is_jump_time () const
 

Protected Attributes

std::vector< FieldCommon * > field_list
 List of all fields. More...
 

Friends

std::ostream & operator<< (std::ostream &stream, const FieldSet &set)
 

Additional Inherited Members

- Public Types inherited from FieldFlag
typedef FlagArray< FieldFlagFlags
 
typedef Flags::Mask Mask
 
- Static Public Attributes inherited from FieldFlag
static constexpr unsigned int flags_size_ = 3
 Number of bits used by Field itself. More...
 
static constexpr Mask equation_input {1 << 0}
 The field is data parameter of the owning equation. (default on) More...
 
static constexpr Mask declare_input {1 << 1}
 The field can be set from input. The key in input field descriptor is declared. (default on) More...
 
static constexpr Mask allow_output {1 << 2}
 The field can output. Is part of generated output selection. (default on) More...
 
static constexpr Mask input_copy = ~declare_input & equation_input
 
static constexpr Mask in_time_term {1 << 8}
 A field is part of time term of the equation. More...
 
static constexpr Mask in_main_matrix {1 << 9}
 A field is part of main "stiffness matrix" of the equation. More...
 
static constexpr Mask in_rhs {1 << 10}
 A field is part of the right hand side of the equation. More...
 
static constexpr Mask equation_result = allow_output & ~declare_input & ~equation_input
 Match result fields. These are never given by input or copy of input. More...
 
static constexpr Mask equation_external_output = allow_output & input_copy
 Match an output field, that can be also copy of other field. More...
 

Detailed Description

Container for various descendants of FieldCommonBase.

Provides various collective operations. Typical usage:

class EqData : public FieldSet { EqData() { *this += scalar_field .name("scalar_field") .description("Some description for input and output documentation.") .input_default("{0.0}") .units("m"); *this += vector_field .name("vector_field") .description("Some description for input and output documentation.") .units("m"); }

Field<3, FieldValue<3>::Scalar> scalar_field; Field<3, FieldValue<3>::VectorFixed> vector_field; };

This way the fields are destructed just before their pointers stored in the FieldSet.

TODO: Some set_XY functions set also to the fields added to the FieldSet in future. This behavior should be removed, since it is misleading in combination with mask subsets. If one set something to mask subset, it does not influence fields added to the original field set even if they match the mask of the subset.

Definition at line 71 of file field_set.hh.

Member Function Documentation

bool FieldSet::changed ( ) const

Collective interface to FieldCommonBase::set_mesh().

Definition at line 165 of file field_set.cc.

Here is the caller graph for this function:

FieldSet::DECLARE_EXCEPTION ( ExcUnknownField  ,
<< "Field set has no field with name: "<< FieldCommon::EI_Field::qval   
)
FieldCommon * FieldSet::field ( const std::string &  field_name) const

Return pointer to the field given by name field_name. Return nullptr if not found.

Definition at line 140 of file field_set.cc.

Here is the caller graph for this function:

void FieldSet::flags_add ( FieldFlag::Flags::Mask  mask)
inline

Collective interface to FieldCommonBase::flags_add().

Parameters
maskmask to set for all fields in the field set.

Definition at line 198 of file field_set.hh.

bool FieldSet::is_constant ( Region  reg) const

Collective interface to FieldCommonBase::set_mesh().

Definition at line 173 of file field_set.cc.

Here is the caller graph for this function:

bool FieldSet::is_jump_time ( ) const

Collective interface to FieldCommonBase::is_jump_time().

Definition at line 180 of file field_set.cc.

Here is the caller graph for this function:

Input::Type::Record FieldSet::make_field_descriptor_type ( const std::string &  equation_name) const

Add an existing Field to the list. It stores just pointer to the field. Be careful to not destroy passed Field before the FieldSet.

Using operator allows elegant setting and adding of a field to the field set:

Field<...> init_quantity; // member of a FieldSet descendant
field_set +=
some_field
.disable_where(type, {dirichlet, neumann}) // this must come first since it is not member of FieldCommonBase
.name("init_temperature")
.description("Initial temperature");
/
FieldSet &operator +=(FieldCommon &add_field);
/**
* Add other FieldSet to current one.
*/
FieldSet &operator +=(const FieldSet &other);
/**
* Make new FieldSet as a subset of *this. The new FieldSet contains fields with names given by the @p names parameter.
*/
FieldSet subset(std::vector<std::string> names) const;
/**
* Make new FieldSet as a subset of *this.
* The new FieldSet contains all fields that match given @p mask.
*/
FieldSet subset( FieldFlag::Flags::Mask mask) const;
/**
* Number of fields in the FieldSet.
*/
inline unsigned int size() const {
return field_list.size();
}
/**
* Returns input type for a field descriptor, that can contain any of the fields in the set.
* Typical usage is from derived class, where we add fields in the constructor
* and make auxiliary temporary instance
* to get the record of the field descriptor.
* The returned Record has name equation_name + "_Data".
* Simplest example:
* @code
* class EqData : public FieldSet {
* public:
* // fields
* Field<..> field_a;
* Field<..> field_b
* EqData() {
* add(field_a);
* add(field_b);
* }
* }
* Input::Type::Record SomEquation::input_type=
* Record("SomeEquation","equation's description")
* .declare_key("data",Input::Type::Array(
* EqData().make_field_descriptor_type("SomeEquation")),"List of field descriptors.");
*

Definition at line 62 of file field_set.cc.

Here is the caller graph for this function:

void FieldSet::mark_input_times ( const TimeGovernor tg)
inline

Collective interface to FieldCommonBase::mark_input_times().

Definition at line 218 of file field_set.hh.

Here is the caller graph for this function:

FieldCommon & FieldSet::operator[] ( const std::string &  field_name) const

Returns reference to the field given by field_name. Throws if the field with given name is not found.

Definition at line 148 of file field_set.cc.

void FieldSet::output_type ( OutputTime::DiscreteSpace  rt)
inline

Collective interface to FieldCommonBase::output_type().

Parameters
rtDiscrete function space (element, node or corner data).

Definition at line 211 of file field_set.hh.

Here is the caller graph for this function:

void FieldSet::set_components ( const std::vector< string > &  names)
inline

Collective interface to FieldCommonBase::set_components(). It is safe to call this for field sets containing also fields with return value other then variable vector as long as all variable vector fields should be set to the same number of components.

Definition at line 177 of file field_set.hh.

Here is the caller graph for this function:

void FieldSet::set_field ( const std::string &  dest_field_name,
FieldCommon source 
)

Make Selection with strings for all field names in the FieldSet. Use FieldCommonBase::copy_from() to set field of the field set given by the first parameter dest_field_name. The source field is given as the second parameter source. The field copies share the same input descriptor list and the same instances of FieldBase classes but each copy can be set to different time and different limit side.

See FieldCommonBase::copy_from documentation for details.

Definition at line 132 of file field_set.cc.

void FieldSet::set_input_list ( Input::Array  input_list,
const TimeGovernor tg 
)
inline

Collective interface to FieldCommon::set_mesh().

Definition at line 190 of file field_set.hh.

Here is the caller graph for this function:

void FieldSet::set_mesh ( const Mesh mesh)
inline

Collective interface to FieldCommonBase::set_mesh().

Definition at line 183 of file field_set.hh.

Here is the caller graph for this function:

bool FieldSet::set_time ( const TimeStep time,
LimitSide  limit_side 
)

Collective interface to FieldCommonBase::set_mesh().

Definition at line 157 of file field_set.cc.

Here is the caller graph for this function:

Friends And Related Function Documentation

std::ostream& operator<< ( std::ostream &  stream,
const FieldSet set 
)
friend

Stream output operator

Definition at line 187 of file field_set.cc.

Member Data Documentation

std::vector<FieldCommon *> FieldSet::field_list
protected

List of all fields.

Definition at line 241 of file field_set.hh.


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