Adaptivity

Adaptivity provides framework for modyfying elements in order to decrease errors of the solution. More...

Classes
class	Adapt
	Evaluation of an error between a (coarse) solution and a refernece solution and adaptivity. More...
class	ElementToRefine
	A refinement record. More...
class	ElementToRefineStream
	Refinement stream capable of input and output. More...
class	H1Adapt
	Evaluation of an error between a (coarse) solution and a reference solution and adaptivity in H1 space. More...
class	L2Adapt
	Evaluation of an error between a (coarse) solution and a reference solution and adaptivity in L2 space. More...
Defines
#define	H2D_TOTAL_ERROR_REL   0x00
	A flag which defines interpretation of the total error. The total error is divided by the norm and therefore it should be in a range [0, 1].
#define	H2D_TOTAL_ERROR_ABS   0x01
	A flag which defines interpretation of the total error. The total error is absolute, i.e., it is an integral over squares of differencies.
#define	H2D_ELEMENT_ERROR_REL   0x00
	A flag which defines interpretation of an error of an element. An error of an element is a square of an error divided by a square of a norm of a corresponding component. When norms of 2 components are very different (e.g. microwave heating), it can help. Navier-stokes on different meshes work only when absolute error (see H2D_ELEMENT_ERROR_ABS) is used.
#define	H2D_ELEMENT_ERROR_ABS   0x10
	A flag which defines interpretation of of an error of an element. An error of an element is a square of an asolute error, i.e., it is an integral over squares of differencies.
Functions
H2D_API std::ostream &	operator<< (std::ostream &stream, const ElementToRefine &elem_ref)
	Dumps contents of the structure to a stream in a text form.
H2D_API ElementToRefineStream &	operator<< (ElementToRefineStream &stream, const std::vector< ElementToRefine > &elem_refs)
	Operator. Stores a vector of refinements to a stream.
H2D_API ElementToRefineStream &	operator>> (ElementToRefineStream &stream, std::vector< ElementToRefine > &elem_refs)
	Operator. Reads a vector of refinemens. It erases the contents of the vector that it is reading to.

---

Detailed Description

Adaptivity provides framework for modyfying elements in order to decrease errors of the solution.

Adaptivity classes calculates error of every element. An error of an element is calculated by comparing an coarse solution with a reference solution. Errors of elements defines an order in which elements are examined. During examining an element, a refinement is proposed and the element is refined if applicable. The refinement is proposed through refinement selectors, see Refinement Selectors.

All adaptivity classes have to be derived from the class Adapt. Curently available classes are:

• H1Adapt
• L2Adapt

---

Define Documentation

#define H2D_ELEMENT_ERROR_ABS   0x10

A flag which defines interpretation of of an error of an element. An error of an element is a square of an asolute error, i.e., it is an integral over squares of differencies.

Note:

Used by Adapt::calc_error(). This flag is mutually exclusive with H2D_ELEMENT_ERROR_REL.

#define H2D_ELEMENT_ERROR_REL   0x00

A flag which defines interpretation of an error of an element. An error of an element is a square of an error divided by a square of a norm of a corresponding component. When norms of 2 components are very different (e.g. microwave heating), it can help. Navier-stokes on different meshes work only when absolute error (see H2D_ELEMENT_ERROR_ABS) is used.

Note:

Used by Adapt::calc_error(). This flag is mutually exclusive with H2D_ELEMENT_ERROR_ABS.

#define H2D_TOTAL_ERROR_ABS   0x01

A flag which defines interpretation of the total error. The total error is absolute, i.e., it is an integral over squares of differencies.

Note:

Used by Adapt::calc_error(). This flag is mutually exclusive with H2D_TOTAL_ERROR_REL.

#define H2D_TOTAL_ERROR_REL   0x00

A flag which defines interpretation of the total error. The total error is divided by the norm and therefore it should be in a range [0, 1].

Note:

Used by Adapt::calc_error().. This flag is mutually exclusive with H2D_TOTAL_ERROR_ABS.

---

Function Documentation

H2D_API ElementToRefineStream& operator<<	(	ElementToRefineStream &	stream,
		const std::vector< ElementToRefine > &	elem_refs
	)

Operator. Stores a vector of refinements to a stream.

H2D_API std::ostream& operator<<	(	std::ostream &	stream,
		const ElementToRefine &	elem_ref
	)

Dumps contents of the structure to a stream in a text form.

Used for debugging purposes to dump the structure to a stringstream.

H2D_API ElementToRefineStream& operator>>	(	ElementToRefineStream &	stream,
		std::vector< ElementToRefine > &	elem_refs
	)

Operator. Reads a vector of refinemens. It erases the contents of the vector that it is reading to.