tboudreaux/MeanField_SERiF
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
MeanField_SERiF/docs/xml/coupled_8hpp.xml

398 lines
23 KiB
XML
Raw Permalink Normal View History

docs(docs): built docs Note for now much of the docs is LLM written. This was done to save time and focus on code development. The docs have been LOOSLEY reviewed. However, the code itself has been either fully written by hand or fully reviewed. Therefore, the docs should at the moment be seen as a loose resource rather than authoratiative (and this is on top of the general ability for docs to drift)
2026-11-09 14:09:44 -05:00
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<doxygen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="compound.xsd" version="1.13.2" xml:lang="en-US">
<compounddef id="coupled_8hpp" kind="file" language="C++">
<compoundname>coupled.hpp</compoundname>
<includes local="no">utility</includes>
<includes refid="solver_2preconditioner_2keys_8hpp" local="yes">serif/solver/preconditioner/keys.hpp</includes>
<includes refid="policies_8hpp" local="yes">serif/solver/preconditioner/strategies/coupling/policies.hpp</includes>
<includedby refid="computations_2coupling_8hpp" local="yes">src/include/serif/backend/mfem/solver/preconditioner/computations/coupling.hpp</includedby>
<includedby refid="bordered_8hpp" local="yes">src/include/serif/solver/preconditioner/recipes/bordered.hpp</includedby>
<incdepgraph>
<node id="10">
<label>serif/discretization/blocks/base.hpp</label>
<link refid="base_8hpp"/>
</node>
<node id="6">
<label>serif/discretization/blocks/system_layout.hpp</label>
<link refid="system__layout_8hpp"/>
<childnode refid="7" relation="include">
</childnode>
<childnode refid="8" relation="include">
</childnode>
<childnode refid="9" relation="include">
</childnode>
<childnode refid="5" relation="include">
</childnode>
<childnode refid="10" relation="include">
</childnode>
<childnode refid="11" relation="include">
</childnode>
</node>
<node id="4">
<label>serif/operators/linearized_system_view.hpp</label>
<link refid="linearized__system__view_8hpp"/>
<childnode refid="5" relation="include">
</childnode>
<childnode refid="6" relation="include">
</childnode>
<childnode refid="18" relation="include">
</childnode>
</node>
<node id="3">
<label>serif/solver/preconditioner/keys.hpp</label>
<link refid="solver_2preconditioner_2keys_8hpp"/>
<childnode refid="4" relation="include">
</childnode>
</node>
<node id="1">
<label>src/include/serif/solver/preconditioner/recipes/coupled.hpp</label>
<link refid="coupled_8hpp"/>
<childnode refid="2" relation="include">
</childnode>
<childnode refid="3" relation="include">
</childnode>
<childnode refid="26" relation="include">
</childnode>
</node>
<node id="27">
<label>serif/solver/preconditioner/strategies/coupling/order.hpp</label>
<link refid="solver_2preconditioner_2strategies_2coupling_2order_8hpp"/>
</node>
<node id="26">
<label>serif/solver/preconditioner/strategies/coupling/policies.hpp</label>
<link refid="policies_8hpp"/>
<childnode refid="27" relation="include">
</childnode>
</node>
<node id="14">
<label>serif/utils/dependencies/binding.hpp</label>
<link refid="utils_2dependencies_2binding_8hpp"/>
<childnode refid="7" relation="include">
</childnode>
<childnode refid="5" relation="include">
</childnode>
<childnode refid="15" relation="include">
</childnode>
</node>
<node id="18">
<label>serif/utils/dependencies/dependency_context.hpp</label>
<link refid="dependency__context_8hpp"/>
<childnode refid="19" relation="include">
</childnode>
<childnode refid="20" relation="include">
</childnode>
<childnode refid="5" relation="include">
</childnode>
<childnode refid="2" relation="include">
</childnode>
<childnode refid="21" relation="include">
</childnode>
<childnode refid="12" relation="include">
</childnode>
<childnode refid="25" relation="include">
</childnode>
</node>
<node id="12">
<label>serif/utils/dependencies/detail/type_lists.hpp</label>
<link refid="type__lists_8hpp"/>
<childnode refid="7" relation="include">
</childnode>
<childnode refid="8" relation="include">
</childnode>
<childnode refid="5" relation="include">
</childnode>
<childnode refid="13" relation="include">
</childnode>
</node>
<node id="13">
<label>serif/utils/dependencies/key_list.hpp</label>
<link refid="key__list_8hpp"/>
<childnode refid="5" relation="include">
</childnode>
<childnode refid="14" relation="include">
</childnode>
<childnode refid="15" relation="include">
</childnode>
<childnode refid="17" relation="include">
</childnode>
</node>
<node id="11">
<label>serif/utils/dependencies/key_list_operations.hpp</label>
<link refid="key__list__operations_8hpp"/>
<childnode refid="8" relation="include">
</childnode>
<childnode refid="5" relation="include">
</childnode>
<childnode refid="12" relation="include">
</childnode>
</node>
<node id="21">
<label>serif/utils/dependencies/resource.hpp</label>
<link refid="resource_8hpp"/>
<childnode refid="22" relation="include">
</childnode>
<childnode refid="5" relation="include">
</childnode>
<childnode refid="2" relation="include">
</childnode>
<childnode refid="23" relation="include">
</childnode>
</node>
<node id="23">
<label>serif/utils/dependencies/snapshot.hpp</label>
<link refid="snapshot_8hpp"/>
<childnode refid="19" relation="include">
</childnode>
<childnode refid="22" relation="include">
</childnode>
<childnode refid="24" relation="include">
</childnode>
<childnode refid="5" relation="include">
</childnode>
<childnode refid="2" relation="include">
</childnode>
</node>
<node id="25">
<label>serif/utils/misc/concepts/concat.hpp</label>
<link refid="concat_8hpp"/>
<childnode refid="17" relation="include">
</childnode>
</node>
<node id="16">
<label>serif/utils/misc/std_helper/cleaning.hpp</label>
<link refid="cleaning_8hpp"/>
<childnode refid="5" relation="include">
</childnode>
</node>
<node id="15">
<label>serif/utils/misc/traits/type_uniqueness.hpp</label>
<link refid="traits_2type__uniqueness_8hpp"/>
<childnode refid="7" relation="include">
</childnode>
<childnode refid="16" relation="include">
</childnode>
</node>
<node id="17">
<label>serif/utils/types/type_list.hpp</label>
<link refid="type__list_8hpp"/>
</node>
<node id="7">
<label>array</label>
</node>
<node id="19">
<label>concepts</label>
</node>
<node id="8">
<label>cstddef</label>
</node>
<node id="22">
<label>functional</label>
</node>
<node id="24">
<label>memory</label>
</node>
<node id="9">
<label>span</label>
</node>
<node id="20">
<label>tuple</label>
</node>
<node id="5">
<label>type_traits</label>
</node>
<node id="2">
<label>utility</label>
</node>
</incdepgraph>
<invincdepgraph>
<node id="16">
<label>src/compile_time_checks/serif/backend_independent.cpp</label>
<link refid="backend__independent_8cpp"/>
</node>
<node id="7">
<label>src/compile_time_checks/serif/model/state.cpp</label>
<link refid="state_8cpp"/>
</node>
<node id="17">
<label>src/compile_time_checks/serif/solver/preconditioner/layout.cpp</label>
<link refid="layout_8cpp"/>
</node>
<node id="6">
<label>src/include/serif/backend/mfem/model/equilibrium.hpp</label>
<link refid="backend_2mfem_2model_2equilibrium_8hpp"/>
<childnode refid="7" relation="include">
</childnode>
<childnode refid="8" relation="include">
</childnode>
</node>
<node id="5">
<label>src/include/serif/backend/mfem/model/equilibrium_evaluator.hpp</label>
<link refid="equilibrium__evaluator_8hpp"/>
<childnode refid="6" relation="include">
</childnode>
</node>
<node id="4">
<label>src/include/serif/backend/mfem/model/preconditioning/computations.hpp</label>
<link refid="backend_2mfem_2model_2preconditioning_2computations_8hpp"/>
<childnode refid="5" relation="include">
</childnode>
</node>
<node id="19">
<label>src/include/serif/backend/mfem/serialize/configuration.hpp</label>
<link refid="backend_2mfem_2serialize_2configuration_8hpp"/>
</node>
<node id="20">
<label>src/include/serif/backend/mfem/serialize/options.hpp</label>
<link refid="backend_2mfem_2serialize_2options_8hpp"/>
</node>
<node id="9">
<label>src/include/serif/backend/mfem/solver/equilibrium.hpp</label>
<link refid="backend_2mfem_2solver_2equilibrium_8hpp"/>
<childnode refid="10" relation="include">
</childnode>
</node>
<node id="8">
<label>src/include/serif/backend/mfem/solver/nonlinear/stellar_problem.hpp</label>
<link refid="stellar__problem_8hpp"/>
<childnode refid="9" relation="include">
</childnode>
</node>
<node id="2">
<label>src/include/serif/backend/mfem/solver/preconditioner/computations/coupling.hpp</label>
<link refid="computations_2coupling_8hpp"/>
<childnode refid="3" relation="include">
</childnode>
</node>
<node id="3">
<label>src/include/serif/backend/mfem/solver/preconditioner/graph.hpp</label>
<link refid="backend_2mfem_2solver_2preconditioner_2graph_8hpp"/>
<childnode refid="4" relation="include">
</childnode>
<childnode refid="13" relation="include">
</childnode>
</node>
<node id="11">
<label>src/include/serif/solver/continuation/equilibrium.hpp</label>
<link refid="solver_2continuation_2equilibrium_8hpp"/>
<childnode refid="12" relation="include">
</childnode>
</node>
<node id="10">
<label>src/include/serif/solver/equilibrium.hpp</label>
<link refid="solver_2equilibrium_8hpp"/>
<childnode refid="11" relation="include">
</childnode>
<childnode refid="12" relation="include">
</childnode>
</node>
<node id="15">
<label>src/include/serif/solver/preconditioner/default_preconditioners.hpp</label>
<link refid="default__preconditioners_8hpp"/>
<childnode refid="16" relation="include">
</childnode>
<childnode refid="17" relation="include">
</childnode>
<childnode refid="9" relation="include">
</childnode>
<childnode refid="13" relation="include">
</childnode>
<childnode refid="18" relation="include">
</childnode>
</node>
<node id="13">
<label>src/include/serif/solver/preconditioner/preconditioner.hpp</label>
<link refid="preconditioner_8hpp"/>
<childnode refid="12" relation="include">
</childnode>
</node>
<node id="14">
<label>src/include/serif/solver/preconditioner/recipes/bordered.hpp</label>
<link refid="bordered_8hpp"/>
<childnode refid="2" relation="include">
</childnode>
<childnode refid="15" relation="include">
</childnode>
</node>
<node id="1">
<label>src/include/serif/solver/preconditioner/recipes/coupled.hpp</label>
<link refid="coupled_8hpp"/>
<childnode refid="2" relation="include">
</childnode>
<childnode refid="14" relation="include">
</childnode>
</node>
<node id="12">
<label>src/include/serif/solver/solver.hpp</label>
<link refid="solver_2solver_8hpp"/>
</node>
<node id="18">
<label>src/include/serif/utils/serialize/numerics.hpp</label>
<link refid="numerics_8hpp"/>
<childnode refid="19" relation="include">
</childnode>
<childnode refid="20" relation="include">
</childnode>
<childnode refid="21" relation="include">
</childnode>
</node>
<node id="22">
<label>src/include/serif/utils/serialize/serialize.hpp</label>
<link refid="serialize_8hpp"/>
<childnode refid="16" relation="include">
</childnode>
</node>
<node id="21">
<label>src/include/serif/utils/serialize/solver.hpp</label>
<link refid="utils_2serialize_2solver_8hpp"/>
<childnode refid="22" relation="include">
</childnode>
</node>
</invincdepgraph>
<innerclass refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner" prot="public">serif::solver::preconditioner::CoupledPreconditioner</innerclass>
<innernamespace refid="namespaceserif">serif</innernamespace>
<innernamespace refid="namespaceserif_1_1solver">serif::solver</innernamespace>
<innernamespace refid="namespaceserif_1_1solver_1_1preconditioner">serif::solver::preconditioner</innernamespace>
<briefdescription>
</briefdescription>
<detaileddescription>
</detaileddescription>
<programlisting>
<codeline lineno="1"><highlight class="preprocessor">#pragma<sp/>once</highlight><highlight class="normal"></highlight></codeline>
<codeline lineno="2"><highlight class="normal"></highlight></codeline>
<codeline lineno="3"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/>&lt;utility&gt;</highlight><highlight class="normal"></highlight></codeline>
<codeline lineno="4"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/>&quot;<ref refid="solver_2preconditioner_2keys_8hpp" kindref="compound">serif/solver/preconditioner/keys.hpp</ref>&quot;</highlight><highlight class="normal"></highlight></codeline>
<codeline lineno="5"><highlight class="normal"></highlight><highlight class="preprocessor">#include<sp/>&quot;<ref refid="policies_8hpp" kindref="compound">serif/solver/preconditioner/strategies/coupling/policies.hpp</ref>&quot;</highlight><highlight class="normal"></highlight></codeline>
<codeline lineno="6"><highlight class="normal"></highlight></codeline>
<codeline lineno="7"><highlight class="normal"></highlight><highlight class="keyword">namespace<sp/></highlight><highlight class="normal"><ref refid="namespaceserif_1_1solver_1_1preconditioner" kindref="compound">serif::solver::preconditioner</ref></highlight></codeline>
<codeline lineno="8"><highlight class="normal">{</highlight></codeline>
<codeline lineno="10"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">template</highlight><highlight class="normal"><sp/>&lt;</highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>First,<sp/></highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>Second&gt;</highlight></codeline>
<codeline lineno="11" refid="conceptserif_1_1solver_1_1preconditioner_1_1_disjoint_subsystems" refkind="compound"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">concept<sp/></highlight><highlight class="normal"><ref refid="conceptserif_1_1solver_1_1preconditioner_1_1_disjoint_subsystems" kindref="compound">DisjointSubsystems</ref><sp/>=</highlight></codeline>
<codeline lineno="12"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><ref refid="namespaceserif_1_1utils_1_1dependencies_1a317a69acc139be6b2d45f95cf1c1412c" kindref="member">utils::dependencies::key_count_v&lt;utils::dependencies::CombinedKeyList&lt;typename First::Rows, typename Second::Rows&gt;</ref>&gt;<sp/>==</highlight></codeline>
<codeline lineno="13"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><ref refid="namespaceserif_1_1utils_1_1dependencies_1a317a69acc139be6b2d45f95cf1c1412c" kindref="member">utils::dependencies::key_count_v&lt;typename First::Rows&gt;</ref><sp/>+<sp/><ref refid="namespaceserif_1_1utils_1_1dependencies_1a317a69acc139be6b2d45f95cf1c1412c" kindref="member">utils::dependencies::key_count_v&lt;typename Second::Rows&gt;</ref><sp/>&amp;&amp;</highlight></codeline>
<codeline lineno="14"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><ref refid="namespaceserif_1_1utils_1_1dependencies_1a317a69acc139be6b2d45f95cf1c1412c" kindref="member">utils::dependencies::key_count_v&lt;utils::dependencies::CombinedKeyList&lt;typename First::Values, typename Second::Values&gt;</ref>&gt;<sp/>==</highlight></codeline>
<codeline lineno="15"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><ref refid="namespaceserif_1_1utils_1_1dependencies_1a317a69acc139be6b2d45f95cf1c1412c" kindref="member">utils::dependencies::key_count_v&lt;typename First::Values&gt;</ref><sp/>+<sp/><ref refid="namespaceserif_1_1utils_1_1dependencies_1a317a69acc139be6b2d45f95cf1c1412c" kindref="member">utils::dependencies::key_count_v&lt;typename Second::Values&gt;</ref>;</highlight></codeline>
<codeline lineno="16"><highlight class="normal"></highlight></codeline>
<codeline lineno="18"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">template</highlight><highlight class="normal"><sp/>&lt;</highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>First,<sp/></highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>Second,<sp/></highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>Policy&gt;</highlight></codeline>
<codeline lineno="19"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">requires</highlight><highlight class="normal"><sp/><ref refid="conceptserif_1_1solver_1_1preconditioner_1_1_disjoint_subsystems" kindref="compound">DisjointSubsystems&lt;First, Second&gt;</ref></highlight></codeline>
<codeline lineno="20" refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner" refkind="compound"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">struct<sp/></highlight><highlight class="normal"><ref refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner" kindref="compound">CoupledPreconditioner</ref><sp/>final</highlight></codeline>
<codeline lineno="21"><highlight class="normal"><sp/><sp/><sp/><sp/>{</highlight></codeline>
<codeline lineno="22"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">using<sp/></highlight><highlight class="normal"><ref refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner_1ab62cb31d6fc902136afc3b3e06a4cf23" kindref="member">Rows</ref><sp/>=<sp/><ref refid="namespaceserif_1_1utils_1_1dependencies_1a4b225a37465f007a877f89860d3627c1" kindref="member">utils::dependencies::CombinedKeyList&lt;typename First::Rows, typename Second::Rows&gt;</ref>;</highlight></codeline>
<codeline lineno="23"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">using<sp/></highlight><highlight class="normal"><ref refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner_1a5361622c475851adbebdce8187240a59" kindref="member">Values</ref><sp/>=<sp/><ref refid="namespaceserif_1_1utils_1_1dependencies_1a4b225a37465f007a877f89860d3627c1" kindref="member">utils::dependencies::CombinedKeyList&lt;typename First::Values, typename Second::Values&gt;</ref>;</highlight></codeline>
<codeline lineno="24"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">using<sp/></highlight><highlight class="normal"><ref refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner_1ae56505dd57cb79735730d1bf5ab202a9" kindref="member">Result</ref><sp/>=<sp/><ref refid="structserif_1_1solver_1_1preconditioner_1_1keys_1_1_inverse" kindref="compound">keys::Inverse&lt;Rows, Values&gt;</ref>;</highlight></codeline>
<codeline lineno="25"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>First<sp/><ref refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner_1a1c983711e7ddc483cd78812f9748662a" kindref="member">first</ref>;</highlight></codeline>
<codeline lineno="26"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>Second<sp/><ref refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner_1ad8c0a6194915537e4ebbf3b90c8ccef1" kindref="member">second</ref>;</highlight></codeline>
<codeline lineno="27"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/>Policy<sp/><ref refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner_1a6d0a2dd58cbbb738fd2e8c27f4d23b4c" kindref="member">coupling</ref>;</highlight></codeline>
<codeline lineno="28"><highlight class="normal"><sp/><sp/><sp/><sp/>};</highlight></codeline>
<codeline lineno="29"><highlight class="normal"></highlight></codeline>
<codeline lineno="31"><highlight class="normal"><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">template</highlight><highlight class="normal"><sp/>&lt;</highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>First,<sp/></highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>Second,<sp/></highlight><highlight class="keyword">typename</highlight><highlight class="normal"><sp/>Policy&gt;</highlight></codeline>
<codeline lineno="32"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keyword">requires</highlight><highlight class="normal"><sp/><ref refid="conceptserif_1_1solver_1_1preconditioner_1_1_disjoint_subsystems" kindref="compound">DisjointSubsystems&lt;First, Second&gt;</ref></highlight></codeline>
<codeline lineno="33"><highlight class="normal"><sp/><sp/><sp/><sp/>[[nodiscard]]<sp/></highlight><highlight class="keyword">auto</highlight><highlight class="normal"><sp/><ref refid="namespaceserif_1_1solver_1_1preconditioner_1a4083a10bc61fd512d53a3c1523ae2f95" kindref="member">couple</ref>(First<sp/>first,<sp/>Second<sp/>second,<sp/>Policy<sp/>coupling)</highlight></codeline>
<codeline lineno="34"><highlight class="normal"><sp/><sp/><sp/><sp/>{</highlight></codeline>
<codeline lineno="35"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/></highlight><highlight class="keywordflow">return</highlight><highlight class="normal"><sp/><ref refid="structserif_1_1solver_1_1preconditioner_1_1_coupled_preconditioner" kindref="compound">CoupledPreconditioner&lt;First, Second, Policy&gt;</ref>{.first<sp/>=<sp/>std::move(first),<sp/>.second<sp/>=<sp/>std::move(second),<sp/>.coupling<sp/>=<sp/>coupling};</highlight></codeline>
<codeline lineno="36"><highlight class="normal"><sp/><sp/><sp/><sp/>}</highlight></codeline>
<codeline lineno="37"><highlight class="normal">}<sp/></highlight><highlight class="comment">//<sp/>namespace<sp/>serif::solver::preconditioner</highlight><highlight class="normal"></highlight></codeline>
</programlisting>
<location file="src/include/serif/solver/preconditioner/recipes/coupled.hpp"/>
</compounddef>
</doxygen>
Reference in New Issue Copy Permalink