Files
MeanField_SERiF/docs/man/man3/serif_equations_EquationSum.3

140 lines
4.2 KiB
Groff
Raw Permalink Normal View History

.TH "serif::equations::EquationSum< FirstT, RestTs >" 3 "Version v0.0.1a" "SERiF" \" -*- nroff -*-
.ad l
.nh
.SH NAME
serif::equations::EquationSum< FirstT, RestTs > \- Sum multiple equations together\&.
.SH SYNOPSIS
.br
.PP
.PP
\fR#include <arithmetic\&.hpp>\fP
.SS "Public Types"
.in +1c
.ti -1c
.RI "using \fBTest\fP = typename FirstT::Test"
.br
.RI "The test type of the summed equations is the same as the test type of the first equation\&. "
.in -1c
.SS "Public Member Functions"
.in +1c
.ti -1c
.RI "\fBEquationSum\fP (FirstT first, RestTs\&.\&.\&. rest)"
.br
.RI "Construct a summed equation\&. "
.ti -1c
.RI "const auto & \fBcontributions\fP () const noexcept"
.br
.RI "Return the contributions of the summed equations\&. "
.in -1c
.SS "Static Public Attributes"
.in +1c
.ti -1c
.RI "static constexpr std::string_view \fBname\fP = 'equation sum'"
.br
.RI "Compile time name for the summed equations, used for debugging and logging\&. "
.in -1c
.SS "Private Attributes"
.in +1c
.ti -1c
.RI "std::tuple< FirstT, RestTs\&.\&.\&. > \fBm_equations\fP"
.br
.RI "The equations being summed together\&. "
.in -1c
.SH "Detailed Description"
.PP
.SS "template<Equation FirstT, Equation\&.\&.\&. RestTs>
.br
requires (std::same_as<typename FirstT::Test, typename RestTs::Test> && \&.\&.\&.)
.br
class serif::equations::EquationSum< FirstT, RestTs >"Sum multiple equations together\&.
This class is a compile-time tag that indicates that the weak contributions from multiple equations should be summed together\&. The actual summation is performed by the backend\&. A simple example would be if two equations are summed together, then the weak contributions from both equations would be integrated and then added together to form the final residual\&. Note also that we do not define a coefficient here\&. The backend only ever sums things, as you can see in \fBEquationDifference\fP to subtract we locally introduce a -1 scaling factor\&.
.PP
Requirements
.PD 0
.IP "\(bu" 2
The FirstT and RestTs equations must share the same test type, otherwise the summation is not well-defined\&.
.PP
.PP
\fBEquation\fP \fBContributions\fP
.PD 0
.IP "\(bu" 2
Residuals to all rows which are shared by the summed equations
.PP
.PP
\fBNote\fP
.RS 4
Only equations sharing a residual row can or should be summed together\&.
.RE
.PP
\fBTemplate Parameters\fP
.RS 4
\fIFirstT\fP The first equation type to sum\&.
.br
\fIRestTs\fP The remaining equation types to sum\&.
.RE
.PP
.SH "Member Typedef Documentation"
.PP
.SS "template<Equation FirstT, Equation\&.\&.\&. RestTs> using \fBserif::equations::EquationSum\fP< FirstT, RestTs >::Test = typename FirstT::Test"
.PP
The test type of the summed equations is the same as the test type of the first equation\&.
.SH "Constructor & Destructor Documentation"
.PP
.SS "template<Equation FirstT, Equation\&.\&.\&. RestTs> \fBserif::equations::EquationSum\fP< FirstT, RestTs >::EquationSum (FirstT first, RestTs\&.\&.\&. rest)\fR [inline]\fP, \fR [explicit]\fP"
.PP
Construct a summed equation\&.
.PP
\fBParameters\fP
.RS 4
\fIfirst\fP The first equation to sum\&.
.br
\fIrest\fP Pack of the remaining equations to sum\&.
.RE
.PP
\fBNote\fP
.RS 4
the constructor uses the initializer list for m_equations, note that the coefficient defaults to 1\&.0
.RE
.PP
.SH "Member Function Documentation"
.PP
.SS "template<Equation FirstT, Equation\&.\&.\&. RestTs> const auto & \fBserif::equations::EquationSum\fP< FirstT, RestTs >::contributions () const\fR [inline]\fP, \fR [nodiscard]\fP, \fR [noexcept]\fP"
.PP
Return the contributions of the summed equations\&.
.PP
\fBReturns\fP
.RS 4
A tuple containing the contributions of the summed equations\&.
.RE
.PP
.SH "Member Data Documentation"
.PP
.SS "template<Equation FirstT, Equation\&.\&.\&. RestTs> std::tuple<FirstT, RestTs\&.\&.\&.> \fBserif::equations::EquationSum\fP< FirstT, RestTs >::m_equations\fR [private]\fP"
.PP
The equations being summed together\&.
.SS "template<Equation FirstT, Equation\&.\&.\&. RestTs> std::string_view \fBserif::equations::EquationSum\fP< FirstT, RestTs >::name = 'equation sum'\fR [static]\fP, \fR [constexpr]\fP"
.PP
Compile time name for the summed equations, used for debugging and logging\&.
.SH "Author"
.PP
Generated automatically by Doxygen for SERiF from the source code\&.