\doxysection{serif\+::discretization\+::quadrature Namespace Reference} \hypertarget{namespaceserif_1_1discretization_1_1quadrature}{}\label{namespaceserif_1_1discretization_1_1quadrature}\index{serif::discretization::quadrature@{serif::discretization::quadrature}} \doxysubsubsection*{Namespaces} \begin{DoxyCompactItemize} \item namespace \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_1_1backend}{backend}} \end{DoxyCompactItemize} \doxysubsubsection*{Classes} \begin{DoxyCompactItemize} \item struct \mbox{\hyperlink{structserif_1_1discretization_1_1quadrature_1_1_form_rule}{Form\+Rule}} \begin{DoxyCompactList}\small\item\em A struct to represent a form rule, which contains a form descriptor and a rule control. Used to tie some form to a specific quadrature rule control. \end{DoxyCompactList}\item class \mbox{\hyperlink{classserif_1_1discretization_1_1quadrature_1_1_policy}{Policy}} \begin{DoxyCompactList}\small\item\em The \doxylink{classserif_1_1discretization_1_1quadrature_1_1_policy}{Policy} class is used to determine the appropriate order and other relevant information for the integration rule based on a given quadrature query. It uses a \doxylink{classserif_1_1discretization_1_1quadrature_1_1_rule_set}{Rule\+Set} to determine the appropriate order and other relevant information for the integration rule. \end{DoxyCompactList}\item struct \mbox{\hyperlink{structserif_1_1discretization_1_1quadrature_1_1_query}{Query}} \begin{DoxyCompactList}\small\item\em The \doxylink{structserif_1_1discretization_1_1quadrature_1_1_query}{Query} struct is used to represent a quadrature query, which contains all the information needed to determine the appropriate order and other relevant information for the integration rule. \end{DoxyCompactList}\item struct \mbox{\hyperlink{structserif_1_1discretization_1_1quadrature_1_1_resolution}{Resolution}} \begin{DoxyCompactList}\small\item\em A struct to hold the resolution of a quadrature query. This contains the base order, boost, and final order of the quadrature rule, as well as a flag indicating whether a fixed order was used. \end{DoxyCompactList}\item struct \mbox{\hyperlink{structserif_1_1discretization_1_1quadrature_1_1_rule_control}{Rule\+Control}} \begin{DoxyCompactList}\small\item\em A struct to control the behavior of a quadrature rule for a given form or role. Rule control always contains boost (default to 0) and may contain some fixed order (think of this as an override). If the fixed order is empty then the quadrature system will determine the order based on the form and role + boost. \end{DoxyCompactList}\item class \mbox{\hyperlink{classserif_1_1discretization_1_1quadrature_1_1_rule_set}{Rule\+Set}} \begin{DoxyCompactList}\small\item\em The \doxylink{classserif_1_1discretization_1_1quadrature_1_1_rule_set}{Rule\+Set} class is used to determine the appropriate order and other relevant information for the integration rule based on a given quadrature query. It contains a set of form rules and role controls, as well as a fallback control. \end{DoxyCompactList}\end{DoxyCompactItemize} \doxysubsubsection*{Enumerations} \begin{DoxyCompactItemize} \item enum class \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88}{Quadrature\+Role}} \{ \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88a39629fd04651ccd980a12031e92a4bbf}{discretization}} , \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88ad0fce4b31a695a89aea9c06e8231f7bf}{preconditioner}} , \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88a1b2415052ea497897c757a8069a97686}{diagnostic}} , \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88adfa555786d19f339a13e6719241e9d6f}{projection}} \} \begin{DoxyCompactList}\small\item\em An enumeration of the different roles that a quadrature rule can play. \end{DoxyCompactList}\item enum class \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efa}{Mapping\+Kind}} \{ \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaa334c4a4c42fdb79d7ebc3e73b517e6f8}{none}} , \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaa0877ad41eb90f8787b48ea22b0aea241}{affine}} , \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaa958153f1b8b96ec4c4eb2147429105d9}{general}} , \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaab2c6de510d584484d74c9aa9f8fa9f04}{kelvin}} \} \begin{DoxyCompactList}\small\item\em An enumeration of the different mapping kinds that a quadrature rule can have. \end{DoxyCompactList}\end{DoxyCompactItemize} \doxysubsubsection*{Functions} \begin{DoxyCompactItemize} \item {\footnotesize template$<$forms\+::\+Form FormT$>$ }\\constexpr \mbox{\hyperlink{structserif_1_1discretization_1_1quadrature_1_1_query}{Query}} \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a24dd0addeeb7b9ea7cd8fbc12c4a7ac0}{make\+\_\+query}} (const \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88}{Quadrature\+Role}} role, const \mbox{\hyperlink{classserif_1_1discretization_1_1domain_1_1_domain_or_set}{domain\+::\+Domain\+Or\+Set}} domain, const \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efa}{Mapping\+Kind}} mapping, const int trial\+Order, const int test\+Order, const int coefficient\+Order, const int geometry\+Weight\+Order, const std\+::optional$<$ int $>$ base\+Order=std\+::nullopt) noexcept \begin{DoxyCompactList}\small\item\em A helper function to create a \doxylink{structserif_1_1discretization_1_1quadrature_1_1_query}{Query} object for a given form type. This function is used to simplify the creation of \doxylink{structserif_1_1discretization_1_1quadrature_1_1_query}{Query} objects by automatically filling in the form descriptor and other relevant information. \end{DoxyCompactList}\end{DoxyCompactItemize} \doxysubsection{Enumeration Type Documentation} \Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efa}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!MappingKind@{MappingKind}} \index{MappingKind@{MappingKind}!serif::discretization::quadrature@{serif::discretization::quadrature}} \doxysubsubsection{\texorpdfstring{MappingKind}{MappingKind}} {\footnotesize\ttfamily \label{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efa} enum class \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efa}{serif\+::discretization\+::quadrature\+::\+Mapping\+Kind}}\hspace{0.3cm}{\ttfamily [strong]}} An enumeration of the different mapping kinds that a quadrature rule can have. The idea here is that different mapping kinds might require or allow different levels of accuracy. For example, an affine mapping generally requires less accuracy than a general mapping. \begin{DoxyEnumFields}[2]{Enumerator} \raisebox{\heightof{T}}[0pt][0pt]{\index{none@{none}!serif::discretization::quadrature@{serif::discretization::quadrature}}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!none@{none}}}\Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaa334c4a4c42fdb79d7ebc3e73b517e6f8}\label{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaa334c4a4c42fdb79d7ebc3e73b517e6f8} none&The quadrature rule has no mapping. \\ \hline \raisebox{\heightof{T}}[0pt][0pt]{\index{affine@{affine}!serif::discretization::quadrature@{serif::discretization::quadrature}}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!affine@{affine}}}\Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaa0877ad41eb90f8787b48ea22b0aea241}\label{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaa0877ad41eb90f8787b48ea22b0aea241} affine&The quadrature rule has an affine mapping. \\ \hline \raisebox{\heightof{T}}[0pt][0pt]{\index{general@{general}!serif::discretization::quadrature@{serif::discretization::quadrature}}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!general@{general}}}\Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaa958153f1b8b96ec4c4eb2147429105d9}\label{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaa958153f1b8b96ec4c4eb2147429105d9} general&The quadrature rule has a general mapping. \\ \hline \raisebox{\heightof{T}}[0pt][0pt]{\index{kelvin@{kelvin}!serif::discretization::quadrature@{serif::discretization::quadrature}}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!kelvin@{kelvin}}}\Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaab2c6de510d584484d74c9aa9f8fa9f04}\label{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efaab2c6de510d584484d74c9aa9f8fa9f04} kelvin&The quadrature rule has a Kelvin mapping (compactified). \\ \hline \end{DoxyEnumFields} \Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!QuadratureRole@{QuadratureRole}} \index{QuadratureRole@{QuadratureRole}!serif::discretization::quadrature@{serif::discretization::quadrature}} \doxysubsubsection{\texorpdfstring{QuadratureRole}{QuadratureRole}} {\footnotesize\ttfamily \label{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88} enum class \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88}{serif\+::discretization\+::quadrature\+::\+Quadrature\+Role}}\hspace{0.3cm}{\ttfamily [strong]}} An enumeration of the different roles that a quadrature rule can play. The idea here is that different roles might require or allow different levels of accuracy. For example, integrating for a preconditioner generally need not be as accurate as integrating for the discretization itself. \begin{DoxyEnumFields}[2]{Enumerator} \raisebox{\heightof{T}}[0pt][0pt]{\index{discretization@{discretization}!serif::discretization::quadrature@{serif::discretization::quadrature}}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!discretization@{discretization}}}\Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88a39629fd04651ccd980a12031e92a4bbf}\label{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88a39629fd04651ccd980a12031e92a4bbf} discretization&The quadrature rule is being used for discretization. \\ \hline \raisebox{\heightof{T}}[0pt][0pt]{\index{preconditioner@{preconditioner}!serif::discretization::quadrature@{serif::discretization::quadrature}}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!preconditioner@{preconditioner}}}\Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88ad0fce4b31a695a89aea9c06e8231f7bf}\label{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88ad0fce4b31a695a89aea9c06e8231f7bf} preconditioner&The quadrature rule is being used for preconditioning. \\ \hline \raisebox{\heightof{T}}[0pt][0pt]{\index{diagnostic@{diagnostic}!serif::discretization::quadrature@{serif::discretization::quadrature}}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!diagnostic@{diagnostic}}}\Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88a1b2415052ea497897c757a8069a97686}\label{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88a1b2415052ea497897c757a8069a97686} diagnostic&The quadrature rule is being used for diagnostics. \\ \hline \raisebox{\heightof{T}}[0pt][0pt]{\index{projection@{projection}!serif::discretization::quadrature@{serif::discretization::quadrature}}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!projection@{projection}}}\Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88adfa555786d19f339a13e6719241e9d6f}\label{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88adfa555786d19f339a13e6719241e9d6f} projection&The quadrature rule is being used for projection. \\ \hline \end{DoxyEnumFields} \doxysubsection{Function Documentation} \Hypertarget{namespaceserif_1_1discretization_1_1quadrature_a24dd0addeeb7b9ea7cd8fbc12c4a7ac0}\index{serif::discretization::quadrature@{serif::discretization::quadrature}!make\_query@{make\_query}} \index{make\_query@{make\_query}!serif::discretization::quadrature@{serif::discretization::quadrature}} \doxysubsubsection{\texorpdfstring{make\_query()}{make\_query()}} {\footnotesize\ttfamily \label{namespaceserif_1_1discretization_1_1quadrature_a24dd0addeeb7b9ea7cd8fbc12c4a7ac0} template$<$forms\+::\+Form FormT$>$ \\ \mbox{\hyperlink{structserif_1_1discretization_1_1quadrature_1_1_query}{Query}} serif\+::discretization\+::quadrature\+::make\+\_\+query (\begin{DoxyParamCaption}\item[{const \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a2170ba7c65dd986e68afb2cc85f2ad88}{Quadrature\+Role}}}]{role}{, }\item[{const \mbox{\hyperlink{classserif_1_1discretization_1_1domain_1_1_domain_or_set}{domain\+::\+Domain\+Or\+Set}}}]{domain}{, }\item[{const \mbox{\hyperlink{namespaceserif_1_1discretization_1_1quadrature_a41f6d96b8d77bc2944e8b328062e5efa}{Mapping\+Kind}}}]{mapping}{, }\item[{const int}]{trial\+Order}{, }\item[{const int}]{test\+Order}{, }\item[{const int}]{coefficient\+Order}{, }\item[{const int}]{geometry\+Weight\+Order}{, }\item[{const std\+::optional$<$ int $>$}]{base\+Order}{ = {\ttfamily std\+:\+:nullopt}}\end{DoxyParamCaption})\hspace{0.3cm}{\ttfamily [nodiscard]}, {\ttfamily [constexpr]}, {\ttfamily [noexcept]}} A helper function to create a \doxylink{structserif_1_1discretization_1_1quadrature_1_1_query}{Query} object for a given form type. This function is used to simplify the creation of \doxylink{structserif_1_1discretization_1_1quadrature_1_1_query}{Query} objects by automatically filling in the form descriptor and other relevant information. \begin{DoxyTemplParams}{Template Parameters} {\em FormT} & The form type for which we are creating the query.\\ \hline \end{DoxyTemplParams} \begin{DoxyParams}{Parameters} {\em role} & The role of the quadrature rule. \\ \hline {\em domain} & The domain or set of domains for which we are trying to resolve an MFEM integration rule. \\ \hline {\em mapping} & The mapping kind of the quadrature rule. \\ \hline {\em trial\+Order} & The order of the trial space. \\ \hline {\em test\+Order} & The order of the test space. \\ \hline {\em coefficient\+Order} & The order of the coefficient space. \\ \hline {\em geometry\+Weight\+Order} & The order of the geometry weight. \\ \hline {\em base\+Order} & An optional base order for the quadrature rule.\\ \hline \end{DoxyParams} \begin{DoxyReturn}{Returns} A \doxylink{structserif_1_1discretization_1_1quadrature_1_1_query}{Query} object containing all the relevant information for the quadrature query. \end{DoxyReturn}