Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Replace ppt generated illustrations for graphviz #1186

Merged
merged 1 commit into from
Feb 15, 2023
Merged

Replace ppt generated illustrations for graphviz #1186

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file removed doc/user/images/looseCouplingIllustration.png
View file
Open in desktop
Binary file not shown.
Binary file removed doc/user/images/tightCouplingIllustration.png
View file
Open in desktop
Binary file not shown.
40 changes: 40 additions & 0 deletions doc/user/inputs/looseCouplingIllustration.dot
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
digraph looseCoupling {
label="Loose Coupling"
layout="dot";
rankdir=TB;
a [label="Temp.", shape="Rec", style="rounded,filled", color="white"]
a1 [label="Temp.", shape="Rec", style="rounded,filled", color="white"]
a2 [label="Temp.", shape="Rec", style="rounded,filled", color="white"]
b [label="Power", shape="Rec", style="rounded,filled", color="white"]
b1 [label="Power", shape="Rec", style="rounded,filled", color="white"]
b2 [label="Power", shape="Rec", style="rounded,filled", color="white"]
c [label="Cross Sections", shape="Rec", style="rounded,filled", color="white"]
c1 [label="Cross Sections", shape="Rec", style="rounded,filled", color="white"]
c2 [label="Cross Sections", shape="Rec", style="rounded,filled", color="white"]
d [label="...", shape="plaintext"]

subgraph cluster_c00n00{
label="Cycle 0, Node 0";
style="rounded,filled";
color=lightblue;
c -> b
b -> a [constraint=false]
}
a -> c1 //[constraint=false]
subgraph cluster_c00n01{
label="Cycle 0, Node 1"
style="rounded,filled";
color=lightblue;
c1 -> b1
b1 -> a1 [constraint=false]
}
a1 -> c2 //[constraint=false]
subgraph cluster_c00n02{
label="Cycle 0, Node 2"
style="rounded,filled";
color=lightblue;
c2 -> b2
b2 -> a2 [constraint=false]
}
a2 -> d //[constraint=false]
}
49 changes: 49 additions & 0 deletions doc/user/inputs/tightCouplingIllustration.dot
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
digraph tightCoupling {
label="Tight Coupling"
layout="dot";
rankdir=TB;
e [label="Converged?", shape="diamond", style="filled", color="white"]
e1 [label="Converged?", shape="diamond", style="filled", color="white"]
e2 [label="Converged?", shape="diamond", style="filled", color="white"]
a [label="Temp.", shape="Rectangle", style="rounded,filled", color="white"]
a1 [label="Temp.", shape="Rectangle", style="rounded,filled", color="white"]
a2 [label="Temp.", shape="Rectangle", style="rounded,filled", color="white"]
b [label="Power", shape="Rectangle", style="rounded,filled", color="white"]
b1 [label="Power", shape="Rectangle", style="rounded,filled", color="white"]
b2 [label="Power", shape="Rectangle", style="rounded,filled", color="white"]
c [label="Cross Sections", shape="Rectangle", style="rounded,filled", color="white"]
c1 [label="Cross Sections", shape="Rectangle", style="rounded,filled", color="white"]
c2 [label="Cross Sections", shape="Rectangle", style="rounded,filled", color="white"]
d [label="...", shape="plaintext"]

subgraph cluster_c00n00{
label="Cycle 0, Node 0";
style="rounded,filled";
color=lightblue;
c -> b
b -> a
a -> e [constraint=false]
e -> c [constraint=false, label="no"]
}
e -> c1 [label="yes"]
subgraph cluster_c00n01{
label="Cycle 0, Node 1"
style="rounded,filled";
color=lightblue;
c1 -> b1
b1 -> a1
a1 -> e1 [constraint=false]
e1 -> c1 [constraint=false, label="no"]
}
e1 -> c2 [label="yes"]
subgraph cluster_c00n02{
label="Cycle 0, Node 2"
style="rounded,filled";
color=lightblue;
c2 -> b2
b2 -> a2
a2 -> e2 [constraint=false]
e2 -> c2 [constraint=false, label="no"]
}
e2 -> d [label="yes"]
}
8 changes: 2 additions & 6 deletions doc/user/physics_coupling.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,15 @@ Loose Coupling
----------------
ARMI supports loose and tight coupling. Loose coupling is interpreted as one-way coupling between physics for a single time node. For example, a power distribution in cycle 0 node 0 is used to calculate a temperature distribution in cycle 0 node 0. This temperature is then used in cycle 0 node 1 to compute new cross sections and a new power distribution. This process repeats itself for the lifetime of the simulation.

.. image:: images/looseCouplingIllustration.png
:width: 800
:alt: Loose coupling illustration.
.. graphviz:: inputs/looseCouplingIllustration.dot

Loose coupling is enabled by default in ARMI simulations.

Tight Coupling
-----------------
Tight coupling is interpreted as two-way communication between physics within a given time node. Revisiting our previous example, enabling tight coupling results in the temperature distribution being used to generate updated cross sections (new temperatures induce changes such as Doppler broadening feedback) and ultimately an updated power distribution. This process is repeated iteratively until a numerical convergence criteria is met.

.. image:: images/tightCouplingIllustration.png
:width: 800
:alt: Tight coupling illustration.
.. graphviz:: inputs/tightCouplingIllustration.dot

The following settings are involved with enabling tight coupling in ARMI:

Expand Down