From 25f555dc6fdfe016611971c263627534c538aa13 Mon Sep 17 00:00:00 2001
From: Jared Thomas <jaredthomas68@gmail.com>
Date: Thu, 26 Mar 2026 10:28:11 -0600
Subject: [PATCH 01/10] move xdsm creation in H2IModel to a method so user has
 to call it if desired instead of having it be automatic

---
 h2integrate/core/h2integrate_model.py   | 25 ++++++--
 h2integrate/core/test/test_framework.py | 83 +++++++++++++++++++++++++
 2 files changed, 102 insertions(+), 6 deletions(-)

diff --git a/h2integrate/core/h2integrate_model.py b/h2integrate/core/h2integrate_model.py
index b14ed0539..7cf6673aa 100644
--- a/h2integrate/core/h2integrate_model.py
+++ b/h2integrate/core/h2integrate_model.py
@@ -1219,12 +1219,6 @@ def connect_technologies(self):
                         f"{dispatching_tech_name}.dispatch_block_rule_function_{tech_name}",
                     )
 
-        if (pyxdsm is not None) and (len(technology_interconnections) > 0):
-            try:
-                create_xdsm_from_config(self.plant_config)
-            except FileNotFoundError as e:
-                print(f"Unable to create system XDSM diagram. Error: {e}")
-
     def create_driver_model(self):
         """
         Add the driver to the OpenMDAO model and add recorder.
@@ -1449,3 +1443,22 @@ def _structured(meta_list):
             "explicit_outputs": _structured(explicit_meta),
             "implicit_outputs": _structured(implicit_meta),
         }
+
+    def create_xdsm(self):
+        """Generates an XDSM diagram for the plant configuration and saves it to a PDF file.
+
+        Reads technology interconnections from the plant configuration and delegates
+        diagram creation to :func:`create_xdsm_from_config`. If ``pyxdsm`` is not
+        installed or no interconnections are defined, this method does nothing. A
+        :class:`FileNotFoundError` is caught and reported without raising.
+
+        Raises:
+            None: All exceptions are caught internally; errors are printed to stdout.
+        """
+
+        technology_interconnections = self.plant_config.get("technology_interconnections", [])
+        if (pyxdsm is not None) and (len(technology_interconnections) > 0):
+            try:
+                create_xdsm_from_config(self.plant_config)
+            except FileNotFoundError as e:
+                print(f"Unable to create system XDSM diagram. Error: {e}")
diff --git a/h2integrate/core/test/test_framework.py b/h2integrate/core/test/test_framework.py
index 524968a64..cf8e53cae 100644
--- a/h2integrate/core/test/test_framework.py
+++ b/h2integrate/core/test/test_framework.py
@@ -1,11 +1,13 @@
 import shutil
 from copy import deepcopy
 from pathlib import Path
+from unittest.mock import MagicMock, patch
 
 import yaml
 import numpy as np
 import pytest
 
+import h2integrate.core.h2integrate_model as h2i_model_module
 from h2integrate import EXAMPLE_DIR
 from h2integrate.core.h2integrate_model import H2IntegrateModel
 from h2integrate.core.inputs.validation import load_tech_yaml, load_plant_yaml, load_driver_yaml
@@ -476,3 +478,84 @@ def test_system_order(subtests):
 
     with subtests.test("Test expected names are in the correct order"):
         assert names == expected_names
+
+
+@pytest.mark.unit
+def test_create_xdsm_calls_create_xdsm_from_config():
+    plant_config = {"technology_interconnections": [("wind", "electrolyzer", "electricity")]}
+    model = object.__new__(H2IntegrateModel)
+    model.plant_config = plant_config
+
+    with (
+        patch.object(h2i_model_module, "pyxdsm", MagicMock()),
+        patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn,
+    ):
+        model.create_xdsm()
+
+    mock_fn.assert_called_once_with(plant_config)
+
+
+@pytest.mark.unit
+def test_create_xdsm_skips_when_pyxdsm_none():
+    plant_config = {"technology_interconnections": [("wind", "electrolyzer", "electricity")]}
+    model = object.__new__(H2IntegrateModel)
+    model.plant_config = plant_config
+
+    with (
+        patch.object(h2i_model_module, "pyxdsm", None),
+        patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn,
+    ):
+        model.create_xdsm()
+
+    mock_fn.assert_not_called()
+
+
+@pytest.mark.unit
+def test_create_xdsm_skips_when_no_interconnections():
+    plant_config = {"technology_interconnections": []}
+    model = object.__new__(H2IntegrateModel)
+    model.plant_config = plant_config
+
+    with (
+        patch.object(h2i_model_module, "pyxdsm", MagicMock()),
+        patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn,
+    ):
+        model.create_xdsm()
+
+    mock_fn.assert_not_called()
+
+
+@pytest.mark.unit
+def test_create_xdsm_skips_when_interconnections_key_missing():
+    plant_config = {}
+    model = object.__new__(H2IntegrateModel)
+    model.plant_config = plant_config
+
+    with (
+        patch.object(h2i_model_module, "pyxdsm", MagicMock()),
+        patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn,
+    ):
+        model.create_xdsm()
+
+    mock_fn.assert_not_called()
+
+
+@pytest.mark.unit
+def test_create_xdsm_catches_file_not_found_error(capsys):
+    plant_config = {"technology_interconnections": [("wind", "electrolyzer", "electricity")]}
+    model = object.__new__(H2IntegrateModel)
+    model.plant_config = plant_config
+
+    with (
+        patch.object(h2i_model_module, "pyxdsm", MagicMock()),
+        patch.object(
+            h2i_model_module,
+            "create_xdsm_from_config",
+            side_effect=FileNotFoundError("latex not found"),
+        ),
+    ):
+        model.create_xdsm()
+
+    captured = capsys.readouterr()
+    assert "Unable to create system XDSM diagram" in captured.out
+    assert "latex not found" in captured.out

From 405607054f65e16979392fb67e55417c223052f7 Mon Sep 17 00:00:00 2001
From: Jared Thomas <jaredthomas68@gmail.com>
Date: Thu, 26 Mar 2026 15:46:53 -0600
Subject: [PATCH 02/10] update changelog and docs and adjust create_xdsm logic
 to reflect that it is an optional call

---
 CHANGELOG.md                                 |  1 +
 docs/user_guide/how_to_set_up_an_analysis.md | 76 ++++++++++++++++++++
 h2integrate/core/h2integrate_model.py        | 31 ++++----
 h2integrate/core/test/test_framework.py      | 63 +++++++---------
 4 files changed, 120 insertions(+), 51 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6cf197f4c..41e5656e2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -27,6 +27,7 @@
 - Added base class (`StorageOpenLoopControlBase`) and base configuration class (`StorageOpenLoopControlBaseConfig`) for open-loop storage control strategies and updated the existing open-loop storage control strategies to inherit these [PR 619](https://github.com/NatLabRockies/H2Integrate/pull/619)
 - Added a generic cost model for converters [PR 622](https://github.com/NatLabRockies/H2Integrate/pull/622)
 - Updated the `StorageAutoSizingModel` model to be compatible with Pyomo control strategies [PR 621](https://github.com/NatLabRockies/H2Integrate/pull/621)
+- Made generating an XDSM diagram from connections in a model optional. [PR 629](https://github.com/NatLabRockies/H2Integrate/pull/629)
 
 ## 0.7.1 [March 13, 2026]
 
diff --git a/docs/user_guide/how_to_set_up_an_analysis.md b/docs/user_guide/how_to_set_up_an_analysis.md
index 2995ad02d..a1ae5197f 100644
--- a/docs/user_guide/how_to_set_up_an_analysis.md
+++ b/docs/user_guide/how_to_set_up_an_analysis.md
@@ -121,6 +121,82 @@ The `resource_to_tech_connections` section defines how resources (like wind or s
 For more information on how to define and interpret technology interconnections, see the {ref}`connecting_technologies` page.
 ```
 
+## Visualizing the model structure
+There are two basic methods for visualizing the model structure of your H2Integrate system model. You can generate a simplified [XDSM diagram](https://mdolab.engin.umich.edu/wiki/xdsm-overview) showing the technologies and connections specified in your config file, or you can generate an interactive [N2 diagram](https://openmdao.org/newdocs/versions/latest/features/model_visualization/n2_details/n2_details.html) of the full OpenMDAO model. The XDSM diagram is primarily useful for publications and presentations. The N2 diagram is primarily useful for debugging. Details for generating XDSM and N2 diagrams of you H2Integrate model are given below.
+
+### XDSM diagram (static and simplified)
+
+Use the built-in `create_xdsm()` method to generate a static system diagram from the
+`technology_interconnections` section of your plant config.
+
+```{code-cell} ipython3
+from h2integrate.core.h2integrate_model import H2IntegrateModel
+from pathlib import Path
+import os
+
+
+# Change to an example directory
+os.chdir("../../examples/08_wind_electrolyzer/")
+
+# Build the model from the top-level config file
+h2i_model = H2IntegrateModel("wind_plant_electrolyzer.yaml")
+
+# Write XDSM output to connections_xdsm.pdf
+h2i_model.create_xdsm(outfile="connections_xdsm")
+
+# Confirm where the file was written
+xdsm_pdf = Path("connections_xdsm.pdf")
+```
+
+This creates a PDF named `connections_xdsm.pdf` in your current working directory.
+
+```{code-cell} ipython3
+:tags: [remove-input]
+from IPython.display import IFrame, display
+
+display(IFrame(src=str(xdsm_pdf), width="100%", height=500))
+```
+
+*Figure: XDSM diagram generated from the technology interconnections.*
+
+
+### N2 diagram (interactive and complete)
+
+Use OpenMDAO's `n2` utility to generate an interactive HTML diagram of the full model.
+
+```{code-cell} ipython3
+from h2integrate.core.h2integrate_model import H2IntegrateModel
+from pathlib import Path
+import openmdao.api as om
+import os
+
+
+# Change to an example directory
+os.chdir("../../examples/08_wind_electrolyzer/")
+
+# Build and set up the model
+h2i_model = H2IntegrateModel("wind_plant_electrolyzer.yaml")
+h2i_model.setup()
+
+# Write interactive N2 HTML diagram
+om.n2(h2i_model.prob, outfile="h2i_n2.html")
+
+# Confirm output file and display it inline
+n2_html = Path("h2i_n2.html")
+```
+
+```{code-cell} ipython3
+:tags: [remove-input]
+from IPython.display import IFrame, display
+
+display(IFrame(src=str(n2_html), width="100%", height=500))
+```
+
+*Figure: OpenMDAO N2 diagram showing the full model structure and variable connections.*
+
+Open `h2i_n2.html` in a browser to explore model groups, components, and variable connections.
+
+
 ## Running the analysis
 
 Once you have the config files defined, you can run the analysis using a simple Python script that inputs the top-level config yaml.
diff --git a/h2integrate/core/h2integrate_model.py b/h2integrate/core/h2integrate_model.py
index 7cf6673aa..df5339c24 100644
--- a/h2integrate/core/h2integrate_model.py
+++ b/h2integrate/core/h2integrate_model.py
@@ -1444,21 +1444,28 @@ def _structured(meta_list):
             "implicit_outputs": _structured(implicit_meta),
         }
 
-    def create_xdsm(self):
-        """Generates an XDSM diagram for the plant configuration and saves it to a PDF file.
+    def create_xdsm(self, outfile="connections_xdsm"):
+        """Create an XDSM diagram from the plant technology interconnections.
 
-        Reads technology interconnections from the plant configuration and delegates
-        diagram creation to :func:`create_xdsm_from_config`. If ``pyxdsm`` is not
-        installed or no interconnections are defined, this method does nothing. A
-        :class:`FileNotFoundError` is caught and reported without raising.
+        This method reads ``technology_interconnections`` from ``self.plant_config``
+        and delegates diagram generation to
+        :func:`h2integrate.core.utilities.create_xdsm_from_config`.
+
+        Args:
+            outfile (str, optional): Base filename for the generated XDSM output.
+                The default is ``"connections_xdsm"``.
 
         Raises:
-            None: All exceptions are caught internally; errors are printed to stdout.
+            ValueError: If ``technology_interconnections`` is empty or missing from
+                the plant configuration.
         """
 
         technology_interconnections = self.plant_config.get("technology_interconnections", [])
-        if (pyxdsm is not None) and (len(technology_interconnections) > 0):
-            try:
-                create_xdsm_from_config(self.plant_config)
-            except FileNotFoundError as e:
-                print(f"Unable to create system XDSM diagram. Error: {e}")
+
+        if len(technology_interconnections) > 0:
+            create_xdsm_from_config(self.plant_config, output_file=outfile)
+        else:
+            raise ValueError(
+                "Generating an XDSM diagram requires technology interconnections, "
+                "but none were found."
+            )
diff --git a/h2integrate/core/test/test_framework.py b/h2integrate/core/test/test_framework.py
index cf8e53cae..bd5a40aff 100644
--- a/h2integrate/core/test/test_framework.py
+++ b/h2integrate/core/test/test_framework.py
@@ -1,7 +1,7 @@
 import shutil
 from copy import deepcopy
 from pathlib import Path
-from unittest.mock import MagicMock, patch
+from unittest.mock import patch
 
 import yaml
 import numpy as np
@@ -481,81 +481,66 @@ def test_system_order(subtests):
 
 
 @pytest.mark.unit
-def test_create_xdsm_calls_create_xdsm_from_config():
+def test_create_xdsm_calls_create_xdsm_from_config_default_outfile():
     plant_config = {"technology_interconnections": [("wind", "electrolyzer", "electricity")]}
     model = object.__new__(H2IntegrateModel)
     model.plant_config = plant_config
 
-    with (
-        patch.object(h2i_model_module, "pyxdsm", MagicMock()),
-        patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn,
-    ):
+    with patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn:
         model.create_xdsm()
 
-    mock_fn.assert_called_once_with(plant_config)
+    mock_fn.assert_called_once_with(plant_config, output_file="connections_xdsm")
 
 
 @pytest.mark.unit
-def test_create_xdsm_skips_when_pyxdsm_none():
+def test_create_xdsm_calls_create_xdsm_from_config_custom_outfile():
     plant_config = {"technology_interconnections": [("wind", "electrolyzer", "electricity")]}
     model = object.__new__(H2IntegrateModel)
     model.plant_config = plant_config
+    outfile = "my_custom_xdsm"
 
-    with (
-        patch.object(h2i_model_module, "pyxdsm", None),
-        patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn,
-    ):
-        model.create_xdsm()
+    with patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn:
+        model.create_xdsm(outfile=outfile)
 
-    mock_fn.assert_not_called()
+    mock_fn.assert_called_once_with(plant_config, output_file=outfile)
 
 
 @pytest.mark.unit
-def test_create_xdsm_skips_when_no_interconnections():
+def test_create_xdsm_raises_when_no_interconnections():
     plant_config = {"technology_interconnections": []}
     model = object.__new__(H2IntegrateModel)
     model.plant_config = plant_config
 
-    with (
-        patch.object(h2i_model_module, "pyxdsm", MagicMock()),
-        patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn,
-    ):
-        model.create_xdsm()
+    with patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn:
+        with pytest.raises(ValueError, match="requires technology interconnections"):
+            model.create_xdsm()
 
     mock_fn.assert_not_called()
 
 
 @pytest.mark.unit
-def test_create_xdsm_skips_when_interconnections_key_missing():
+def test_create_xdsm_raises_when_interconnections_key_missing():
     plant_config = {}
     model = object.__new__(H2IntegrateModel)
     model.plant_config = plant_config
 
-    with (
-        patch.object(h2i_model_module, "pyxdsm", MagicMock()),
-        patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn,
-    ):
-        model.create_xdsm()
+    with patch.object(h2i_model_module, "create_xdsm_from_config") as mock_fn:
+        with pytest.raises(ValueError, match="requires technology interconnections"):
+            model.create_xdsm()
 
     mock_fn.assert_not_called()
 
 
 @pytest.mark.unit
-def test_create_xdsm_catches_file_not_found_error(capsys):
+def test_create_xdsm_propagates_file_not_found_error():
     plant_config = {"technology_interconnections": [("wind", "electrolyzer", "electricity")]}
     model = object.__new__(H2IntegrateModel)
     model.plant_config = plant_config
 
-    with (
-        patch.object(h2i_model_module, "pyxdsm", MagicMock()),
-        patch.object(
-            h2i_model_module,
-            "create_xdsm_from_config",
-            side_effect=FileNotFoundError("latex not found"),
-        ),
+    with patch.object(
+        h2i_model_module,
+        "create_xdsm_from_config",
+        side_effect=FileNotFoundError("latex not found"),
     ):
-        model.create_xdsm()
-
-    captured = capsys.readouterr()
-    assert "Unable to create system XDSM diagram" in captured.out
-    assert "latex not found" in captured.out
+        with pytest.raises(FileNotFoundError, match="latex not found"):
+            model.create_xdsm()

From 219d4ed72d7ea453a7d0d25bcec43958a91f1a71 Mon Sep 17 00:00:00 2001
From: Jared Thomas <jaredthomas68@gmail.com>
Date: Thu, 26 Mar 2026 17:15:10 -0600
Subject: [PATCH 03/10] update docs

---
 docs/user_guide/how_to_set_up_an_analysis.md | 57 ++++++++++++++------
 1 file changed, 40 insertions(+), 17 deletions(-)

diff --git a/docs/user_guide/how_to_set_up_an_analysis.md b/docs/user_guide/how_to_set_up_an_analysis.md
index a1ae5197f..25b95422b 100644
--- a/docs/user_guide/how_to_set_up_an_analysis.md
+++ b/docs/user_guide/how_to_set_up_an_analysis.md
@@ -131,7 +131,6 @@ Use the built-in `create_xdsm()` method to generate a static system diagram from
 
 ```{code-cell} ipython3
 from h2integrate.core.h2integrate_model import H2IntegrateModel
-from pathlib import Path
 import os
 
 
@@ -143,18 +142,28 @@ h2i_model = H2IntegrateModel("wind_plant_electrolyzer.yaml")
 
 # Write XDSM output to connections_xdsm.pdf
 h2i_model.create_xdsm(outfile="connections_xdsm")
-
-# Confirm where the file was written
-xdsm_pdf = Path("connections_xdsm.pdf")
 ```
 
 This creates a PDF named `connections_xdsm.pdf` in your current working directory.
 
 ```{code-cell} ipython3
 :tags: [remove-input]
-from IPython.display import IFrame, display
-
-display(IFrame(src=str(xdsm_pdf), width="100%", height=500))
+import base64
+from pathlib import Path
+from IPython.display import HTML, display
+
+xdsm_pdf = "connections_xdsm.pdf"
+
+pdf_data = base64.b64encode(Path(xdsm_pdf).read_bytes()).decode("utf-8")
+display(
+    HTML(
+        f'<div style="width:100% !important; margin:0 !important; padding:0 !important; border:none !important; background:transparent !important;">'
+        f'<embed src="data:application/pdf;base64,{pdf_data}" '
+        'type="application/pdf" '
+        'style="display:block !important; width:100% !important; height:400px !important; border:none !important; outline:none !important; margin:0 !important; padding:0 !important; background:transparent !important; box-shadow:none !important;" />'
+        '</div>'
+    )
+)
 ```
 
 *Figure: XDSM diagram generated from the technology interconnections.*
@@ -166,7 +175,6 @@ Use OpenMDAO's `n2` utility to generate an interactive HTML diagram of the full
 
 ```{code-cell} ipython3
 from h2integrate.core.h2integrate_model import H2IntegrateModel
-from pathlib import Path
 import openmdao.api as om
 import os
 
@@ -179,22 +187,37 @@ h2i_model = H2IntegrateModel("wind_plant_electrolyzer.yaml")
 h2i_model.setup()
 
 # Write interactive N2 HTML diagram
-om.n2(h2i_model.prob, outfile="h2i_n2.html")
-
-# Confirm output file and display it inline
-n2_html = Path("h2i_n2.html")
+om.n2(
+    h2i_model.prob,
+    outfile="h2i_n2.html",
+    display_in_notebook=False,
+    show_browser=False,
+)
 ```
 
+Open `h2i_n2.html` in a browser to explore model groups, components, and variable connections.
+
 ```{code-cell} ipython3
 :tags: [remove-input]
-from IPython.display import IFrame, display
-
-display(IFrame(src=str(n2_html), width="100%", height=500))
+import html
+from pathlib import Path
+from IPython.display import HTML, display
+
+n2_html = "h2i_n2.html"
+n2_srcdoc = html.escape(Path(n2_html).read_text(encoding="utf-8"))
+display(
+    HTML(
+        f'<div style="width:100%; height:900px; overflow:auto; margin:0; padding:0; border:0;">'
+        f'<iframe srcdoc="{n2_srcdoc}" '
+        'style="display:block; width:200%; height:600px; border:0; margin:0; padding:0; background:transparent;" '
+        'loading="lazy"></iframe>'
+        '</div>'
+    )
+)
 ```
 
-*Figure: OpenMDAO N2 diagram showing the full model structure and variable connections.*
+*Figure: Interactive OpenMDAO N2 diagram showing the full model structure and variable connections.*
 
-Open `h2i_n2.html` in a browser to explore model groups, components, and variable connections.
 
 
 ## Running the analysis

From 189f13eb6fa089534e03dca29258ba40c9ff8bf6 Mon Sep 17 00:00:00 2001
From: Jared Thomas <jaredthomas68@gmail.com>
Date: Thu, 26 Mar 2026 17:15:15 -0600
Subject: [PATCH 04/10] update docs

---
 docs/user_guide/how_to_set_up_an_analysis.md | 42 ++++++++++++--------
 1 file changed, 26 insertions(+), 16 deletions(-)

diff --git a/docs/user_guide/how_to_set_up_an_analysis.md b/docs/user_guide/how_to_set_up_an_analysis.md
index 25b95422b..7ef50be8c 100644
--- a/docs/user_guide/how_to_set_up_an_analysis.md
+++ b/docs/user_guide/how_to_set_up_an_analysis.md
@@ -148,22 +148,32 @@ This creates a PDF named `connections_xdsm.pdf` in your current working director
 
 ```{code-cell} ipython3
 :tags: [remove-input]
-import base64
-from pathlib import Path
-from IPython.display import HTML, display
-
-xdsm_pdf = "connections_xdsm.pdf"
-
-pdf_data = base64.b64encode(Path(xdsm_pdf).read_bytes()).decode("utf-8")
-display(
-    HTML(
-        f'<div style="width:100% !important; margin:0 !important; padding:0 !important; border:none !important; background:transparent !important;">'
-        f'<embed src="data:application/pdf;base64,{pdf_data}" '
-        'type="application/pdf" '
-        'style="display:block !important; width:100% !important; height:400px !important; border:none !important; outline:none !important; margin:0 !important; padding:0 !important; background:transparent !important; box-shadow:none !important;" />'
-        '</div>'
-    )
-)
+import matplotlib.pyplot as plt
+import networkx as nx
+
+interconnections = h2i_model.plant_config.get("technology_interconnections", [])
+G = nx.DiGraph()
+edge_labels = {}
+for conn in interconnections:
+    src, dst = conn[0], conn[1]
+    data = conn[2]
+    label = f"{data[0]} as {data[1]}" if isinstance(data, (list, tuple)) else str(data)
+    if len(conn) == 4:
+        label += f" via {conn[3]}"
+    G.add_edge(src, dst)
+    edge_labels[(src, dst)] = label.replace("_", " ")
+
+pos = nx.spring_layout(G, seed=0, k=2)
+fig, ax = plt.subplots(figsize=(10, 5))
+nx.draw_networkx_nodes(G, pos, ax=ax, node_color="#90EE90", node_size=2500)
+nx.draw_networkx_labels(G, pos, ax=ax, font_size=9)
+nx.draw_networkx_edges(G, pos, ax=ax, arrows=True, arrowsize=20,
+                       connectionstyle="arc3,rad=0.1")
+nx.draw_networkx_edge_labels(G, pos, edge_labels=edge_labels, ax=ax,
+                             font_size=8, bbox=dict(fc="white", ec="none"))
+ax.axis("off")
+plt.tight_layout()
+plt.show()
 ```
 
 *Figure: XDSM diagram generated from the technology interconnections.*

From 359c1c362658257f197e8600bd0f88ee45d8a54d Mon Sep 17 00:00:00 2001
From: Jared Thomas <jaredthomas68@gmail.com>
Date: Fri, 27 Mar 2026 09:55:26 -0600
Subject: [PATCH 05/10] update docs for visualization

---
 docs/user_guide/figures/example_08_xdsm.pdf   | Bin 0 -> 13297 bytes
 docs/user_guide/how_to_set_up_an_analysis.md  |  38 +++---------------
 .../run_wind_electrolyzer.py                  |   3 ++
 3 files changed, 8 insertions(+), 33 deletions(-)
 create mode 100644 docs/user_guide/figures/example_08_xdsm.pdf

diff --git a/docs/user_guide/figures/example_08_xdsm.pdf b/docs/user_guide/figures/example_08_xdsm.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..a02759a44df449f5e7787b86b25911915ff54c34
GIT binary patch
literal 13297
zcmchebx<8$((uvXf#A*!?r_nIy9I)KaCg19yK8{p7k77ecMk*z8r&@q?Bm&Yx4x~~
zx9Z)0cBf{hX3puE>7MS>XQt}cREpw~Oh9ICWU85k!DVC)04u=W$O@UCADKnf!@(55
zqN!kHWoisYW>Il50{^W=(%#7ynMG98-W~9T^-Uhg`nOFNndPsZzg-1HX8CLgcCvhv
z0KQ4Q_5ZbhlTbEwws&zdHgyJYzO^VLv&fm+nS(6=Ku*Blm$$oE+JH@+04$O=hG0{1
zQ)7D*Q)EFwWM{CGsi7^h`;U3_DMi|;O&BPIXXp!LQ#+Ht_q-kbr8@W9jsH6)fc{e^
z@ch?I0RH8i|A-raf4Tg>;|Czyf6R#gUN8awW6{L+myiEDo?!dS>Hm>%Vq^dB8Sz&V
z{LdJ{_1`n%ugLw67{UI}1N-mkn}dhz-%j6!s=aortf-xj4DNF8w;2-?N2~*Eh3yBO
zh+Gfm7*XQEnu-+%UA_%WG_K#PB*H+6a)JU0aSh}RFHwqcE6CE~Y(clV4@jR;$l48$
zgZMam1;Be-mcZY35MqD@p%x!pFBL}sJYAYecw`!-IjAL>jXKhnxUwc}4~s+N`I=B~
zLxasR;J`mI>yQ;6D^2v^eIdbNj~6Er|5CKr)UtNq%y42`CPiEMOY!loVG}!bLrD+3
zjAUi#$V#|(SW(jAz6mxvaWhL>kV=Y0r8`GpEh~|OxS=hMbOIG#(9XN`C}5fjVW@<+
zQIbiu^tR3dRuCDTJejiO=$xZYMY<cAj;YvqlHn~HeUYd-_l1XJcYCLnua+*?xrVu=
z8LN34FN7V=GxAy$G7G_p$<0Exs>!Mf#Exc07NeCfBKOfi%GF{-&YvaP49@%^sgsJ|
zEmTOC;r4Ah_)79Kmd58OjReS2gAskfcX0hi#d&P|?U|iSo4e*aGp(l|x^5_X71iBm
z+;LQp`U$FPk7&y$Di3@P^m_FdH<_P5cT7fBC_j7hKYSZ6yHk$CdW08$Rf#)U|JHG}
zV6<TF*<nO)q8vx|7`BnIW4yJ0(R#tTxgVk-f<sb}g)F!xv(I3;?Aqn`{HuxV70QZ^
zEZ|?~XZF8l{(q#S|A`;q+x*WB`p3rr8-SaWi~ApEZ{z+ShX4>K5BvYb+5i2O5Yr5=
znq-Z~6%7soBZ<kPPsS(Ctqb%(iA`XL$;e2D1Ek$PNq_prA&nI2pTr^U_KnPQ$|LUl
z@zvUABfZfq+xp!4-0S>V=TXl(^^nu0rNDMm9RnVO+B-Ooh7CVbc6e|B11$^?;>H*W
zo1CaXkpPLj)EcuNi><BYI;0+up=xm>;yc=Zg{3%)uyVi`Ug<~b8Asp5!Tg1T3l9VB
zEetpyBVYTB4M4aH{sFbn0zKw{KR}Y9g?qNW^RBU8Y7KHdO|e<aN#u_Qhq?De@;=@*
zv_+({m(`yT-w@rgOK6tx1a2nai`Yj*$m^#|%{9^hhY!EDF0Zb(-|@9O_phH&u7IHR
z6oUnXiMHQ6UI#Bj`8J{|BJhd5*u@ZK5ad{+yS$F)!Zu5|2do49y@Ie72w|MN(J%d1
zgx8>c7sG;+RG|r(F_!gB7P}EM{ky|pH-GItE3|dz`%wk<`62{WR&Gr(8>FIRn<3PM
z@QOeYBA2Zp+QZR6q1Hc0!11;ApYQZ$8<b!zA7x*(gIR?|v{9hC&M(ei)+*O?m=WFV
z+)C!FNj-cETgmGACnRytPEZ3ruGRW2(jd45X>LrfhwYz#J4Ouh>h*pVX;Ms$Ij!ch
z;n#7$F;LV%4^Ld%$n?Ux>*nG^gaIJJ!AST&L4`9wZQI&TUmrv1lHrZm)10$h`=Gyc
zF+1S-pZXAC_?0m2z96iACpkfa2CVS|Ub_5vUx*B^uV8F)mJt1M2Hqq0zi>Zx5*R(=
zb@{#8DcbuZUFi9CKy6k}`(;m@;h4dO@jN`qzCK5KprWGQf*W~W>>h;V2?$!ad%nqr
z<Mj;EAj0_z1N>_Mh?}n)mK?n^-Q)KZsz_!i2>vf+cfNA3swWT4aHOxDWH$b<Q-$xl
z@tEN*?)9@WVBiCme(QI<PFuZ_T)om<>1(}I^S*9GV)JKa`aY7qO5DHR_f9F&K)MNj
z_uUGwu>=r4`QjM7%5wTYHMUw|5S4^ozj`KPY(ARChpzBEo5w4<!Iy9kNMc3SG`-5Q
z_^sUf+NNV+zncwi7xP<Zf@0PKT=;qaJ~lmd_w#Gnh`MS<aq1R$^(o+=Ahf%-p1g+(
zfimFcu0iLz(3ABJ4207E`RLOS;QpEd^baF?C$$y^b+&qqu-vy^<JYMY&+3oxG=77J
z34NjY93>1zdi<KBzj(R)1nmLMA1{;x@JINA&@sJx!_uKaiGG6aPKNRdiwxzy_Tn!J
zMLIxsA(*^RcF{#&?e}rRhaMsXAoJf}vA@?huDf$^ZtrIDm3{CHecjy9z=GRGs~yVD
z4*n7q!mAqAq^ByQ;^kQBBdV`y6&1~S6oVmN<2`=as4*z*#k)suY^fp-Ose2f!@M({
zi%a)8HyT)NV5hJUlmQY2P;Ru7JNG2>Ie4sDBIGs(sI0^w(@0hEuf@%KiW^u4TJ;gy
zvwB>MwnV*34SM$4W;~)B&v5k+D7s5ZL&RgkQ>Ls|C1ct0%(X>P3DYo#Fj~_J+z;pv
zV}6oLi5O3rYU?ZM{i#SDD0uJt`V%tyJ!8Tzsd!G8PL)(rPUcE3P0;#aQtH!O3+k_T
zZj`tLz3eNA?k~@mb_JQaA~&@pI(`h5XIPaJCJIT?*wNJ1V%TN2&wqjico&B>QdP<G
z9N@WFkQmPRU<}MrtQ<GM&T=ku{f5ARGdk@huB<>K2J-H2)kD*d_j|M0(FxZP{!Pw8
z+kJ{F-{A=8FGj17yu0&uP)GC!nD(Y<9+}YU`6+I2TmgEv)nq!40Wu-XU*ahrM_VZ%
zDW$9&poa!>lRp%>6_vf{oGEDWy;2V&7+QusW<EB5V0(!w5zaujb0a;*K_vYeP&GZR
zOz%E#XlZ`zRvgPe64xPg;z^HjP3Wvl)Uls&&+$G(f*EupTJ1;gm$><0f8F8oJXrrN
zuvqnSk3b_5c3S^ZLfhl3+9I0GzEG{EN8%Og_!<0)_eI0X6Ob@I1nYOyVo<C4X(Uf5
zN6$8bgSEl=LoyPqlo!IPnWGx#^$Mmxm1sf8GCG5|x^U2~%1b->Qz>@YxwMOZAH(tT
zUCFty-1uR+>zCF9G!YNinXfjf`TH4Sw$@eZd<Z9z9q{M!(AIgMpZ9k@SiCTM%^}%L
zq!5cdV*vG7V8kYd$mCa>kjS(v_EirNgv;6q?@OXS;w}uPF15#V;XUpKNfp(Vkv)=d
z6#3oNRQlEZ?sY)f8?kYje4bjQL?6_z#<cf@@Hg-rvX)(l@`mipnQHn)`g9k~Uj<E}
z$O!QqlTg%E+A4G?jIe05fPQqO6q|GLTS<G_${jr81vMC0g?+oc<f|pkQ3n?E@fM`S
zyP<t}KQ`D%6x)8jyzv7r0{H;MyVx3M`hb9Jfa9uTsMH@Am+$vZ#q0ePeT~i0G(iNv
zlQh+V*B+J2kMwT%n~ihiOg=-&c$&%FqoJ^O>%ig&s`d*@8KRQlHe?7=!UC_!s`8Zd
zsHs7X29ki+I((^+qx>pL@&I;JHKMFmKC_~W;txUgdZu$vkcp*UCS{o#hkVvpoh+?K
zUKQ3S60z8)I<pCm<I)6Q<b4_6SVU0p;jA;wCUMiz$mO?HZ~dg`<}Gs9P-;6wq@zYD
zg{L(He#^4Yy(2B=2&xg~l`H1zE=ljStp4z#gk=x2UNb}ri+Xu?!mf}wR*gK==}MrL
zPDMU1eNqnQYKvN1=YR72vG!?g&{Xzk3OBT|WBDV}7}aTQ*6CzZWKNm(er)|v^l@Bs
zMnK*aPDSKFLv&~nUVRVF{P7gGq(3Dt*|EKT!-(L6Y;{TWd+eiWaVp_w%F{vZK91N?
zB$=mtqWrFnQmq?P2<C|p7Bai)K{jENg*r1L>fJf^IwJ)#cOH#M#zr@R{*xB2nV0Wa
zsS5G1PT1U>Bf^o8OfZp(tFOkaWw;-a*1mGMEKZ*@HF;ic0xi9o=5Uv78D0RSYy$&(
zaECx}7dCn^wf@*z-a)z#H?En^8}`S6^L!!;H7p_1&McnHl+CAc>y4x;%p4zZt_M)R
z&40IqzsB^lJP5Z2QX<xt_)VINP4uoxlD9W6oH8rpC+AjHJ}qPqO+9RVHMgA0O5H|Q
z+WD7e%J(Yc++%J8EsE0bdoIU{W!c|C=a5b;HrDHxX-O(YI2<L|MUYmEc<8GdF6n3h
z?VXT7oYX{R0sXImQW$%##pfXp9V+V=1?mRg+ktUJTufKB6CEwd$IkL=wTam?qP&_c
z`z1#-IZb5SgG|Bu{=;)K9K^hlw&l=yE9prK&9|&$O7$!6;|umsB9j<1?#6&)bJ}Si
zO@|xoGn?U|siS2_=AJ0=qH5L|5~JoPzC)=zY7`2B4<ymSzS;H>SFC}<=oC%gX(Tk`
z28AkQlwpW)PE^Si%EOXJpYKQdvf`TqXI<@bTob`O<M(+fhay5SIu`rZlnT<wx~uJ`
zKBPH3i^#=jT7u(chiWu}X@aZhtbDDgsE=T|vvbv&3Zma7`H@}nmKz+BFE*<<UbdXO
z6z^^s9b)xD(RlRs21VhK)-t*nBJ-o`6FuNa%&q5JSt3N%!!Z)gSdvJkam@sWeK>T8
z$#7~UW?V=qVzA^1X$*uY24;avH?{?nD#?V>Udm2jH*Y}*EMX8Zg;S+_T%w5Wg?u38
zF}x)Vti$}NBhzcoDQILzGJ{q8*)tRN<!&!T(rHc11v1u45dcPp#mcR6&^AJ~;5nM=
zU9$dNygwj>rPmSRC40n$L6QH8bTzj!_xb9y6tS^u>f+k?gT7(<+y_7GXOgNdV#e!h
zl<6Fu=2@v)zE(MMpcgi^U~S+TZ@R)w^CQf4l3eCW<8NGUQDr<EIZHCeb5|Jx$^6sT
z@YrydVy+Z+&oGTgwKgl~@X}__8UuTJE6i%+E)h6D@6S%BUL5r?T>IRv%UVCBphXeE
zru7tI0b>+_#u*NKo}UoEmTlWtcco@KbDa>4k%q#_HM&BnMi%9?FNGpk8qRv}E$@aQ
zNFK|$XbuLQq52g?s#I~`8@xRcS$OCtlVW~FwTDSa-mY#+wi~Lh13RP-VzWYjL4(>g
zD(W~de~HpecUa4d#YO0NchPz`w_;8Cez4^>5V}FlFg-hNvpQ7rrQO-;Kh8!t$rPmz
z?qqhYRn}h&lQ3qBAap`B1zaQR*J^ohPxGT1!++tZ)RLj&+Q94~m)iT{JwBP0cuIJo
zgd<Q(K&X$;yOLO`_DSJu+z5)OTPy+>oluAUN^jFhP%bALS;6qai7NXyd2*4b#dpD^
zKA$(aKb78i-zcB774tl2)_#3*i54k0)V)tIa*%17)0kS586D<R-}m0F7!fFK#5EOq
zaw|O=2u{YSxgHQzm|llB|CzWkrRCA49VJ&eYgT66sTRFb!-8bxqk@Gx>VWEzFx9HX
zWjM88uyc)**e@{ib)i)Y96axwIxEy=SMY49StShROU=8|U=;ou%TY7RwPrEDXei#b
zrjNQ>SEnJFIxvkcs4ye1OFzsO0c$9Zm4YvBrA$F`_nW4YUV|(Kk9XqQ4UE_-W=jOI
z)hf7{`2qv?RW&$UpiByTd%>yc7CnK8+IQ*Ggi88o!-PW#4GqK0M3u+gMGNJH7Y>_@
zalpyY;B`ifz~_TLf_27uou-!eQgies<2ahd49GIj$OgORmo@6iX?m`{L-n23`WM3d
zkY5$u3Gn--OK?M^ZNDFi{Ss)_&aLQb?-t#^`Mzw{CJH8P^$C6kvpHAHXNqY)!(IAB
zyyK=nU`rM3%UU=HhH0+e{R(k10Q%~R2X&r=AyB%s(SQ(JCoptNS1mm}WgXcc_uy}0
zIZ+q1PdNf%AeZY1xj!w6#iD_gWVZFLF}PycnkE~|^{K89cBW;50(DIj^2)Y7#PFD-
z^Qi)rXbqnaRxfGVm4OQje1IiNY0}u~d%85Z)sHw0eQIs4h@x}~+kCvQKh6iMZ!gv<
z^+qKO&7#+Gr$o?57af#b-O`h@I3+~l#x%oNwn|_Sf<xQHH|K9Twue*Dw`P)GJ4)r_
z6l^FA62Aq-(&0~p3Ml2+xytFQ-PJ2Z<>~$ajdV2%W5&jQ(jv~8O>Jl<nTE~j!)&#t
z!}XX2+yndt80*HlmLClbRZd9s76=JOoa0Tsuj~9Ehn8P9UDj{v`dmNn3D?DrDmKsy
zn~k^f4AEtfds@rfeUU(!N9TANjbh;+*Gkz#9cUS95G`U9L3Wdq<rgTx8dX-Urc@5w
z9M$D4>LVE8D+>G3WY|14{YimwT(@e>pv@5;?^JFFwFbdO=q7_oHgR>kYxKil&gm~n
z5$|?)Sc~BATq&p*H&m9>Dm%P+)PiAam&VLY5@bsm6jQ2$GzbJUI=b(lkcX|LEjAXt
z!zH;NbXe$_3Kx*LWfe&uQ*+Fcx5Mspi!4VRR!6uNlc~T`?<A3)z2D_bH|Q(@%TpE=
zo>FI6x?hmlgZ0U*B%TP+@=!&FzXEci2wP+@3;1@O5f7z8#uaPhYaZ<44|43{a)Pf!
z)t%$Ndb!5sM3Qf!NqPutm-)b_k|m+~#xO1_r3Tf1S9leEeB4u4hB8%_)``VgF7+uU
z2=Nuy8mKK%JY@fBD#T6i@$5T;-#@>lp%RcleLuf;ljtZ_C!a<y!&X!oXe8G+Kcq5T
zg)JPEPV8-biR_1YttBca+ClWVt|OI=hbTvB<PP{H;bE7qLl8o%b@JnLhV2%vD%(M$
zC>q`(voeNSJY;Ag{MR<jP99QN8qS}A^bPaT*yr0C3yJbNTizCZpHSr=ZUGH_F=U1V
zMjh0SIA=~}W+6A1ZcpW>y5n(X=v}D?RnRWTD@r&kl0zUjpT4>rC7dxSc^v%+41~b>
zX&ee9(_19+!wp5M=pD!J`T^_TI+=fU!WW7Le2u8aZ|H^44u&APdq@d4)>D0Gk0U`h
z>-o}o0AfYo;I4AT&b5oL*2{=Hs{gGuyTN~UMO+k`4}htGVC$b<xE_#sk3gRDI0gyO
zy&oNx{{*g<UC<w|RDDBHazG(;KlVg1Cq0yQ-8dEIA7y;s5bKq5*d0(w*!3;Q2+0By
zG=4-fEe`@44!fQC;A~DZDXe8V+ZAy+WgQk$O?E|=+B6dVjP6ZgO)m%`;!jTi`X#Kv
z5PprEE~d1&PR1NE#0AK88)<sH-sPUD&mPUED9;Ln!BH+R=vsH!NTC)UsT!oxa}*YF
zMIJX;2&z;xN3Vvw_)HP%Yp=b?1XCUc!wtjNxCqPateEc#1}ot%HoFfZsoK>O3y{;d
z6$TF372?KGCg=P%x)u)G@fhXW!tJD6cQqRxuy^V04WXnNlE>|eqeCrwFP78#uD?ZD
zHilzJ(wYwTDv`|z%S;(|HRr~l%R{X_-6RU1+^B=9xMmoZJn7GDdm>n=taWxu*-H{C
zBuTk4<I8A3OHK49$*mNoQ`dS8FK{JHcqq8k5O(y3=3yjx_MRpR*>O~OFDan}XxQz}
zl?<sN1AVYmu@dYXskgVq?&_-)DDU67YE-3A@{>u?=MNEB1ULv`pss4`xu%@~3g#TB
zJ~DUGtTIq8Vty;xQtO*+0<9$V-&ARdN9<kRcu-9T4cjEquO62^Ge_%Eo(`YYjEJ#N
znUgc)?P|OA3ObhMxesZa-q~$cXh*63Nv2PtNw*@x)D8rTaHZ-b>v!<49<mgw>u(|}
zGaV5uN1Qfy6AQHMWpbwNpQT$QtjRNv*Nm%f%Xt^h^z>Je4g5xPlA_r&h;Cr5rEVWP
zVe&1a<dxX=2rErVQv8iPGkdK0QXu=-cgI7ivLcp0`Obd0#QYJ%<zeLK<w&U<X<BFC
z_4D-8*D6Fg)f{!~6gXNyd*yc0BkS)oOY=TS;+L5;D0Vg`oJ=1?rKU3p>)AQE(loP<
z7p!5a^JLUAA7P}iXaW*l5I^*_(iA)VLIAW1R-0|b2SiqD7={dvtd;nw+&_!5#9~G9
z!)@of!kR2f6vdR2i=w(U%wMTB-ud+e{ybb9MW%MF+cK%%NexaO4|VeaL|^4~?RuiM
zq}hM{xCxrG-$}_{$+%utKBK_wCOWm|i~9O;{!+fk$r~(T%0Qf>+h=r!)5MC^$~u1)
zC=|}G^Wwz=i6@JA`?snpxchd`AQTXRc`s|77j+z#tA_`j5ore+OWW!#(GZ9#Alwjt
zP_L6?TZ4IefF0I>RK?%=H0I@*Q6;!2esd!sZ$h{osV`ov=lL!e%kQ>dQ0)~Y^o2)7
zlBL+cvbg43e5Yf!SACbD%VdDLwI1oVw#;yS7U|^YdD@$FLS}FX*uU+N-C&!uX))3y
zMQ#*ho)T{vNUec;{_KRd1JsP2*vju5>QlmW0C0N1n1JfZNk*TpP4XqPT0zwzxm7x#
zBj{t`67M(M)q&fS?LJi`mKJxeS}o<N%2aN<tPw39otR5}q<g{p#hr2%r%oNB4#;T0
zX#?LXC$G5>HS5opf-FT7H8ot7UM_OkopF<U>KlhVOdIw&X7*tFwm%+f=&nk!%xwKf
z`O6ryo9*Q08bM#$&EeJ!$$J@7wss|%&?jw7{63&G(ne*VsVtIy5yjC$%&b-eoJ}VU
zr%e4?iIYS5SvK&q3qT7fV?T}3L$Qs9?@pTk;ur4eaFtn~yuJIbH9z-&CJWUsnQxFa
zfd9(F^Y<}3HgufiNC|T8oVVQN?+PL{pD8iO-n@M}<ROi5#!g@by>P!R_V<RGplIaB
zS1$Sen*E=XpqUAs?AX@>7xLO+X$)uB@sCBf@wsCz6O@(1Kl+g-vJ*r<bmX^`xgoH~
z_HQptK57J9O(d0$Us1e!Dqd8)WSe~#W0d2WH3vHDYeWi)e)~VUm)Qvb9x0ojE*7UV
z3xxQW&U+tq;cH2)euuBX&9s05`7vG@`PLM5GgH?^5#YXmrhx^wo*!_+EiGy%41zY<
z4`Xz5#IbS-HCB7Z@gz_HB5@^oXV0OOYmMb?W78K0FOe>2L9yX<Syag+xmE93W^ayM
zGlq;ZiQJ48e1Rm*!!)p4DwvG6a&o1*+FS%x-{A>tqwiH0Rd~G0FZRl|K~3(axRrEf
z$huL|0Sd4UKTsp1b|qV=^^Yj1T|NcdnNQ?jzh`PTd3I~Tx6X7w%?pc~ttWmcFOsMg
z*R0aCV7|J(aaEJJ>$b1g9Y@&{x3C^NG0Cs=6KH)6vrRF3qV@eTHTtO4d{cg8S)N5z
z)|SZh@O9z?$iL5@MRB3%L)-hG5fB?T_bI`)o-%^pj8;u;&2yrazg_?MtWo}HuB;P_
zX1eNXHnVHWOswPgy~$8GoR<ap)a?HfbuiU6rtJ3lNmHQdn@O7P9e>regIo4YZX}Yk
z8yNV@#tz?hVRXkM(Bs3X^%c_6zD<KZIJ}U9>$7>|@w$G(LwxgPRRlp`<o9xnl60-8
z%LWziP}MsPceS%qFC_IW3CFoyb|Fp%@4HY+P#8Ymz?P;;);QA*LyXWE?_r#=9f6H-
zXgdu;p664u)x`EUJT|&5ozrm!9}N(sFItQbJSkVXX7ZgmC8f*#n%!PDo2S33b)*oY
zGV|mu<Fi_Qq8fOjmr0h_vs%EM3<Ee<zq}LcZ}{>JP(M%b-iIaLD&Z=a=E9|lC8E>P
z(^5nDtn9nEUgh({e%P-U5@_9i)9;<Q9IFUSyl!U6eH=qsJ1RsPdt#p$?-k5LpbPYo
zxG9K9h~Q)OnSolsIdWb^HFM(5XhdK9J3!KAQZJ@T6|JlO`^7)1JCdf?o(U&EvO^PW
zU{cZ2WF(5l!xLC3r|^N+5mq2_+5AI|?#6l1O!?1sc(lJ&P}<4des-|3E9~Yw{aQrp
ziIFJ2^WY*UKhaTJf6aycc*aXUxlC+Q!TmsZt9oi2@;I!(v%zk9-)B|qxhuG4E4G5a
z4<E@JeIDB1p9e|T=BKG-v(+Y98@)9UiOni&W6u2j%4`jL{|=u#DdFRfNUCuS4E&hz
zB%AMPgkB;!o2d=SR5#a=Dg!&lyB4{7DaCk7dPT8zS7;qqQ0wz2NlQjzBZmWP?ps@j
z<!e1+=kFSr@^}SyYlzmc2A`zlM8(lSDRDMmkv==Pez}-eBFiov4Uvg5Xd=8J{c!q=
zJ`|X#txSb+=Q#MwQJYS$>ed=&A{|yRtK-E<omKWvZjfnB>sZh)1J;M@q+gQ4T03+P
zoGfF6&PME*+)fwiRul*y{wxk1wz_uB2U*UiYpv3=A#-VcnwLvTSD>8e7u79ad?HF7
zv%#NJs?5VbgG>uWBh<wZbf-<0M@uVFZ5iq=kW!$rf5Bob*wSY9bDiSa$kpvsrq+G-
z&d=pCi?4a~sL=LBT8(7<gHR$u7Kev3#22Tn*Ri?8b@V(j*?uC^zVCjpHsVs(pC}pS
zl(f?841QoBl2Ov&!5zP2SjNHu`ZipXIL)&qe^#-|7;#!V)^AqXSVZ?|1|oc51b&C_
zF>t<d&c2Op^;T#EnTB1&K>MNr5Ws|mOX%DY>?Ud%61S!0fX$qG5j+0w{axm4?q4t@
z5-Kf0&rw&(kpLqK7dD`(Ci%wc(Kr|0nD&}A^wYE8HlqVb{p9SvFcB~HX-<_HkcqqR
z!xTnEeMZYM=DoA2sm9UhIbu9Q&ZP!Zo*4{7$Nq!L6Rt;gG2A?UD^I^J0OjttVE$pA
zx;ksTbQ=d_e5}X?+fqZTnE@`4PCbX#A&vPPJ?&|2Uc8+_8XFr{JDs-#b#k(z5)5fE
zJm-(FvA{^$$QUZ@W8RrLgdfxH`DE2na+dQ7I&(pS2MJV^NOk4SWSU=q?DkK9p9y!O
zC@LU{HuWcbNI&C%{~abV32mIZv|RWkG0t~1J&n$!bNm@${e@b8a?)*I-(P;@()AyX
z!m*UrS@ir@6&~zpBOc|&gNeUgvA@e5*}Z!w%J3nCbrUlIyG1Sn7c(9o|6YXy651p;
zbO;@}9Bi;qiqJ)=NGcHrVQG)2fVk>w8rep-XQ-FD&nMR(eiWROh&*b$=?MP9^}|j3
zi%7$hh)8#gblnclv`8Inn8fwOEECA6M0jgoR%0U6cLqnBOM|_Vw2tCz2fcS;htcHn
zEH%p^u2gn7SKw2YFJH7mwI7ryy1sSebv`pfHSfp9w&HEKGeK*`pAw`3PIWBNEP^HP
zlxXxiH7t1MylhLB?mRVv_jjlUDf9TFV_rQogE!Q&MSVLLYLhozQ3y}}SPhyGQe9hN
ziItBHAS#Nga9_eM^e2MblSW282<#t7>l?nx8D*)(iBuj0n%F^<MQ7nl?%^6dH^CPl
z$qy^11@jAQ;~VQN#i~Uo90<mvTc9)}U!1!Un>faPPRy)*JspQmsn`jAF=umb5Qu)K
z%#qBV#Q5blCpE{|Ta@-Ej$j>l{A}IB)_C6cD2VD2L9Nrl2ivy4vV-vJNvn@FCu3Bc
zHj@tBi|Yo;J!XU(a$1<B-QuQq)8+2Q&HDYsZcgwA1l1%}&9buvKw8=8ZZ!faW|&d2
zpgg`3h590|VMHsip@G;KZo19S+ijOY&u2cG-Z4gl*f4i%JkMsjd-F)pf`i&dTPPFD
zs>z_X#NAR4YD_VUXfnOqy_u#^4s*jgZ?#z@*q;1%K>xWcjrFzooIi>fHgzIzw~u?*
zlPFj&Ktn}=?5M-YDtis7E#K4k=4)6Gf<*`?HYnc1aPbodEuPC5uY+u76feOp<Buu?
z)+abA$BP;__A$@)M-rsZ{39LM8SRw^IyLK=yYWe~UVz+5fBK4TtA*fxtL^?(W|(7H
zDbmuPdf&+d^3}Mt^$TL7z6WL6zYP-VXmBEDnAfo`v2KL?qO3NSz3ykcc3II<Obu9=
zHSKrzs@h;O@~c0Et!CmE_6%}0WprLfU!w$v*f#6i9CR-7_bozfejh0*;wdaRw(6O&
z7r?evWv$)c<qZU!UtNg*k=HyQ3F;+UcDpUmil}d%4zmoD{fT-PYbza6$%o35!goE?
zwLg!w;O(4V7vFTjF&L6bOsXSphkbrdGQe`w%{)EHj`SqSU0|Psn0Uj$iBo37xSwXG
z)aVoe<E3p;ndrcc*0J}b<fN$`p_%-e{?Um1bf6X6o9!kBId#;7IFYV<?=z`2OuGrG
zNW@McnJ^L&8EF<_Jmn&RLa77=-=3}O*K%tU8WaklWfGP{(D=4EV%ewc%qW&6PnIab
zTu`0e5j&L8uAta>u4IE0UQs)LEuKB5)_oEA{xv1*+0x0Uu26r?1)EnNvaG}joG&5K
zc_Cy{Ven%L97$u*vmeJH#AsL%Q6%RBGQ08^$WBwVp}B2x$v8R{qvo_igAf#xPAt=d
zco$sNVY|2$Opscx)5pts!fGvM&e)CQl~wEtpnxW|QtMAtrB5rhg&J}159;KvNfV1n
zy2*oj>LQ3VU@b`m>P8TFnE6s)(Lpqs&;JVt^3QDD-#H>~4%UC0BeGTdY`@Kl-LbFX
zj-LDjcF<KC21m5+`lI7=6aAu9b$qHFrL-dE`{&=smlW<RcTj{vaS-#9-nD1<bvf0=
zvk6M?-IK|i(^iH_%I8)AcsDn#FWGTL1lcjAa-36l3MY-$<1qxwK5bJ=p9T0euiEI)
z_s60u&SidhFT@lZkh#9v`6`SVZ=eXSWF7Y_a$~)}@)96sJY4lKi#ll<S<BNeIzDdl
zFxpOVwnOnyDLnna^~b<7p|2>v#b;f0T>^boL>E9=e&o~=z2@f8upcm(G40Db>{4$Z
z^egf6#)*j#7$UzT#_DrOKfgGM(B7SFR?M|Oe`o**x-@7sdh<f;((Cn|#q!OUIE|^t
z{ZZD#p+Io5t?8fnCXV%{2iD%iYn(5*gY>MQZ#Q&A8C)L|(lzNJI}EC`^qONcMg;ji
zOil1|q3OuZUl38EDCjkb8I27c^K^Q*4blwQWM;!rZWIr4alh+UR4IwDk>Mo!HLXkV
zq2p-|&1!xkg_SK6gGNWP-Xz!}2IY}}9ORa7TTf1wM2oTKZYi-GqtS;-$yivYo<M`3
z*DxWc$W=o3J`aqKQ=&aV0;6!6n0SAJuX}D$mp$T3cR=WDLFyvka~wv<bK79D=e36&
zf4c91zz94Yi2I+#FIYx2w(fW7Trx93n5o_^K7~1}p}us7gzTHatlnV@Dgju^(-@iY
zQ_^Az;0UNGN^*HP`J}J<7U9TOA=yA0K@LiS#a@MQNUnk?@47C%Jg;N+r~5V9L+5-^
z2odLXt5U*rOr(#U>b7%!(sWE-1?_<n-gzwKfxq;LOQEb~^6Or+$K1AccEeLT4apz=
z!?fwIvEJF>lj{O32#vsRk2w?wO{I5s!=1-m>GapBx30760u)Gb(j$Li-#%Tkpu*va
zr}^2pbKgVvjEh7)Naxj>%bf&xy3*_5Vqh_*wQHpKE?DhsC;RHM8#ezN`8`SoxGd>^
z88iP(1}i$*o46Rik<zpdCT6Opnr|342P-ohHytvI*c&Phwtwq+YyQWnrM;c_8&D0P
z73XDRW#eLHXX9q&0djJ(GO=>eu(Hy;$$hpr`M*R|oeUiuOikYCY(pDoQ)CuJRS8XI
zNf#R%BSSm8zjRTxuyh8zt^cDFBS78M$@%Tk0Cr{|2auD8jf<0=iH(`-AIknsMSz^8
zt0~}3D^5CqwSytp!r9ai;QIFqxtKYafpmWn;C~0a{}rNCFtSnszcK0Z0N@)%CTZ#9
z3<dz%Isb_p1O3}+<y2EkVO1Ez_jh&busY7q`B<iplrX{SOo&vu011A^DNIIqzB+E~
zKgWFa^3tGBB3rqIA8N9*9`Bcsh@ivZ$UllWJS7u`N2{WeLyvMY!<ZzA`;$`@z^%aG
zNYT;0*QO>kLDr_C$H;L>3>=V(EV~h=LgQ67f##Kmr^PN#3{u9p)C|a5=6}z{4ZGCN
z(cgjJyGIQW@N!pwbv2p=uF?&gE@q@oz^pcY_b_XJw51$p_=?B6`7zm_0gsJ`;<k=(
z3C&LihS)UAGNHAD(L42FXjrM+4fI_M5_h`G9^rtG*h7{#7$`Wfzl2+{8}(_2;XZv;
z=oiYUD-TmiSU5Dt4yZeYW)45ZOG5oU(+X0~`}qw5t-4Mk^Qe!g%o8n5n;I<3KaiJ|
z)XW5qXK46-oc3t>Py7~o-T%`OS=~G^C#HXH`f>pUeSH1um-X6h_;P&Rz5TQpwMVAp
z!oMWD1F1hVsj0Y6bw}gPuJJ$urPS+Ou3to#fA2d9D97t2Fu`|>)koRK@c6){!>J3q
zlLadl%(l&@2WyNL{n&G1c8~sx5Z@jxTCK~Bf9FWw_n|~_M7qciX7!W*bwoV{dmVIO
zp|F=m5IJPs-^Er}zI<W{tg+35;F_A@>M@@L0An^Oqapdm7ge%H8_|P>zfl&f2e%+-
zvE;Z<t(5h|J}~WdZa5EV>C554EcL3UzndqK%fAyRsIa$R>qs4h>7mY#lHueH>(#9o
zw9GAngUz~N4V4}+L}^&c?UG_3O-Q;X&?uuEkQvaUxNO)rcyLQWIW<$$o=GoJ42YDV
z-TS~#;^iwgtzIa0vTek;5Tg6VTuso?bP@b(MkjZ7clV}c<GI0k<`^k9u$EvkhbX2A
zGA+qy02=^j8L1^nCvV<9Wx?wh8OdjMwX&B#zLJs`ZzDEy7RA29zsf9WjB?Pqf3oOi
zK?Tj1wPFxAGgw$^flHQZxX)-TW~MbYRAE3>o@)I41fktjNQg_z#R*)LM`gf>69FvR
zpR$jjgIVHgyal+c9(88VJZB=9(NtSW5s18boSS_Wkq*{15q;hCvxcW$qdqBKtB_=P
zrPSe!Qpq8s91ui(#aXOUig>n;P;54A02x!7S!T?A!E=<<fcw{E_BPl5e-QNV#U{$8
zX2>iub|$8Ot1aOGzLkuqSbCZQINmBsH2x|kVFUctrfhEy2C)B~n3u6Lvj?#Ml^Nf7
zXBlz87k*JL_P14nRa9JzTZD_13&ag%<>BDw;pXJw6lWLX6a@U=B5zOmM{Nol$G@FD
zaAMlg`h+py_p^jj<9sBgrKQ7R;sFla*dn5cE;Fznkg{fALWmy&XD7N$a#<o=KQIO*
zj|9&?1l_k$37i&yYZ>s7cMVXvBo=$U&{hv1?E$(<&rZ!XELK%#1e<=>IVyY}<GuJd
vM|NEZB<FY9#oXznPtcEMm_Gmdex1RFPGEPZw>Ju8<6&b*rlOKikVO7}DVpwK

literal 0
HcmV?d00001

diff --git a/docs/user_guide/how_to_set_up_an_analysis.md b/docs/user_guide/how_to_set_up_an_analysis.md
index 7ef50be8c..ab3b2be2b 100644
--- a/docs/user_guide/how_to_set_up_an_analysis.md
+++ b/docs/user_guide/how_to_set_up_an_analysis.md
@@ -122,7 +122,7 @@ For more information on how to define and interpret technology interconnections,
 ```
 
 ## Visualizing the model structure
-There are two basic methods for visualizing the model structure of your H2Integrate system model. You can generate a simplified [XDSM diagram](https://mdolab.engin.umich.edu/wiki/xdsm-overview) showing the technologies and connections specified in your config file, or you can generate an interactive [N2 diagram](https://openmdao.org/newdocs/versions/latest/features/model_visualization/n2_details/n2_details.html) of the full OpenMDAO model. The XDSM diagram is primarily useful for publications and presentations. The N2 diagram is primarily useful for debugging. Details for generating XDSM and N2 diagrams of you H2Integrate model are given below.
+There are two basic methods for visualizing the model structure of your H2Integrate system model. You can generate a simplified [XDSM diagram](https://mdolab.engin.umich.edu/wiki/xdsm-overview) showing the technologies and connections specified in your config file, or you can generate an interactive [N2 diagram](https://openmdao.org/newdocs/versions/latest/features/model_visualization/n2_details/n2_details.html) of the full OpenMDAO model. The XDSM diagram is primarily useful for publications and presentations. The N2 diagram is primarily useful for debugging. Details for generating XDSM and N2 diagrams of your H2Integrate model are given below.
 
 ### XDSM diagram (static and simplified)
 
@@ -146,39 +146,12 @@ h2i_model.create_xdsm(outfile="connections_xdsm")
 
 This creates a PDF named `connections_xdsm.pdf` in your current working directory.
 
-```{code-cell} ipython3
-:tags: [remove-input]
-import matplotlib.pyplot as plt
-import networkx as nx
-
-interconnections = h2i_model.plant_config.get("technology_interconnections", [])
-G = nx.DiGraph()
-edge_labels = {}
-for conn in interconnections:
-    src, dst = conn[0], conn[1]
-    data = conn[2]
-    label = f"{data[0]} as {data[1]}" if isinstance(data, (list, tuple)) else str(data)
-    if len(conn) == 4:
-        label += f" via {conn[3]}"
-    G.add_edge(src, dst)
-    edge_labels[(src, dst)] = label.replace("_", " ")
-
-pos = nx.spring_layout(G, seed=0, k=2)
-fig, ax = plt.subplots(figsize=(10, 5))
-nx.draw_networkx_nodes(G, pos, ax=ax, node_color="#90EE90", node_size=2500)
-nx.draw_networkx_labels(G, pos, ax=ax, font_size=9)
-nx.draw_networkx_edges(G, pos, ax=ax, arrows=True, arrowsize=20,
-                       connectionstyle="arc3,rad=0.1")
-nx.draw_networkx_edge_labels(G, pos, edge_labels=edge_labels, ax=ax,
-                             font_size=8, bbox=dict(fc="white", ec="none"))
-ax.axis("off")
-plt.tight_layout()
-plt.show()
+```{figure} figures/example_08_xdsm.pdf
+:width: 70%
+:align: center
 ```
-
 *Figure: XDSM diagram generated from the technology interconnections.*
 
-
 ### N2 diagram (interactive and complete)
 
 Use OpenMDAO's `n2` utility to generate an interactive HTML diagram of the full model.
@@ -217,7 +190,7 @@ n2_html = "h2i_n2.html"
 n2_srcdoc = html.escape(Path(n2_html).read_text(encoding="utf-8"))
 display(
     HTML(
-        f'<div style="width:100%; height:900px; overflow:auto; margin:0; padding:0; border:0;">'
+        f'<div style="width:100%; height:600px; overflow:auto; margin:0; padding:0; border:0;">'
         f'<iframe srcdoc="{n2_srcdoc}" '
         'style="display:block; width:200%; height:600px; border:0; margin:0; padding:0; background:transparent;" '
         'loading="lazy"></iframe>'
@@ -225,7 +198,6 @@ display(
     )
 )
 ```
-
 *Figure: Interactive OpenMDAO N2 diagram showing the full model structure and variable connections.*
 
 
diff --git a/examples/08_wind_electrolyzer/run_wind_electrolyzer.py b/examples/08_wind_electrolyzer/run_wind_electrolyzer.py
index 0c5a03835..fa354ea6f 100644
--- a/examples/08_wind_electrolyzer/run_wind_electrolyzer.py
+++ b/examples/08_wind_electrolyzer/run_wind_electrolyzer.py
@@ -14,6 +14,9 @@
 # Create a GreenHEART model
 h2i_model = H2IntegrateModel(top_level_fpath)
 
+# Generate XDSM diagram
+h2i_model.create_xdsm()
+
 # Run the model
 h2i_model.run()
 

From 9f01edf7f97ac6913924df1a8fb46772a99ba7ff Mon Sep 17 00:00:00 2001
From: Jared Thomas <jaredthomas68@gmail.com>
Date: Fri, 27 Mar 2026 10:12:23 -0600
Subject: [PATCH 06/10] change xdsm code cell to not execute on build

---
 docs/user_guide/how_to_set_up_an_analysis.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/user_guide/how_to_set_up_an_analysis.md b/docs/user_guide/how_to_set_up_an_analysis.md
index ab3b2be2b..6feb63786 100644
--- a/docs/user_guide/how_to_set_up_an_analysis.md
+++ b/docs/user_guide/how_to_set_up_an_analysis.md
@@ -129,7 +129,7 @@ There are two basic methods for visualizing the model structure of your H2Integr
 Use the built-in `create_xdsm()` method to generate a static system diagram from the
 `technology_interconnections` section of your plant config.
 
-```{code-cell} ipython3
+```python
 from h2integrate.core.h2integrate_model import H2IntegrateModel
 import os
 

From ec869dd38951f6cf8ef33b4877e990910f5c6e13 Mon Sep 17 00:00:00 2001
From: Jared Thomas <jaredthomas68@gmail.com>
Date: Fri, 27 Mar 2026 10:49:26 -0600
Subject: [PATCH 07/10] switch pdf for png

---
 docs/user_guide/figures/example_08_xdsm.pdf  | Bin 13297 -> 0 bytes
 docs/user_guide/figures/example_08_xdsm.png  | Bin 0 -> 18280 bytes
 docs/user_guide/how_to_set_up_an_analysis.md |   2 +-
 3 files changed, 1 insertion(+), 1 deletion(-)
 delete mode 100644 docs/user_guide/figures/example_08_xdsm.pdf
 create mode 100644 docs/user_guide/figures/example_08_xdsm.png

diff --git a/docs/user_guide/figures/example_08_xdsm.pdf b/docs/user_guide/figures/example_08_xdsm.pdf
deleted file mode 100644
index a02759a44df449f5e7787b86b25911915ff54c34..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 13297
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

diff --git a/docs/user_guide/figures/example_08_xdsm.png b/docs/user_guide/figures/example_08_xdsm.png
new file mode 100644
index 0000000000000000000000000000000000000000..a9c6b930195d232be6681721d1292dac3180f8df
GIT binary patch
literal 18280
zcmeIaXH-*N)CLF$(nL@Y6%bIQH${p_3!)+=^xlhf0@5LL5D^hjIzgKB-aDa4lO{+)
zD4|KO0U@E6x%jHHX3ebmIX}Mnevp+M?!9N9eV)C~K6^jshN&pYQjpP+;o;#?$h~}~
zhKEOBhlhu+Lvk5txgy^P1%9yG$jGSJ$;iq$+B-U{zcw|ukbdQ8W}zng^r5KeV>~>L
zPv#~jYA<;>zL{P(G5I#Y%}M6$q4w_G2Q?G_&eneBf!5CSf%KR}1B2OHRI}}Pgb(O$
z_%wF4l6>J`59<FK+f81lrWPI(h-G5_uEfW|Woly5k5>`br$7eUU}V<6&q?2JglBdW
z{|?D3NBnZc-3@9JA*#JQWw4LTR?NqjJ`N-hT0RQgm{SNXBLdmy!I_y?5~I^%3-ET}
zZ!@y9L)gOnm`UW-xaC1rE`HJ$s+Q0fVL>bpvea&f??&TXX+B)}(0}U|=;u|{Q&B30
z)DLD>RAwXrRLLxDt+Oq$fq{#ZPy4eH0!;(2Ub=Ly@g@;=_fl|x<fZmz(Vpz*7Aoeq
zl0MwNMe+;Zi9|kd<yHU*pt;8uI&zj^Fdi51odgd*)CP|b_=XSs(E)#elG6$Pwh-8*
zU;6tUU+3bVCVBTL@$f)+a?hkSJn=WDh$pF^pLPFY0;{UfaB`86ydx?PWTw?9^XQz$
z@mPr|4;r0Att7mqaNqrezfa#NGLgpb3?du5af6VEMrAf_Yi=QFK`u4cD#l(o%?mD=
zY@d|0&(pJ&l#&9eVE**s4ITjrbHK$1m0V!XC!QN2Px0^xsX!MWB!ncW$JhS*4#Ep0
zA*U*OUgyL?_xBD^S(oVVTQ5GI=>(YYevOd%@%MWCAffMnp9Et5N<e6L&4J<l+rRx$
z6**n~uVdiuYqZQd;jiaa1po953NVRq`6tJ_GQ2juH}s)j?*8qK(C+i4KVk=f-Vl+X
z?oB?Xq4?Vyv(7xj?*UwV+~Wb2(f;hpu>N~JUK`!=Um=*OO!0%NNkpzbm-*WpFl6Gt
zL-_y6kYTbRCLQmt?X_N_e3tz<mW6<zo6)<-ZEISBfHi~UKfP%vF$=U!)H%&>6cm;e
zd?pl?RWcbh^kCHqHz-tLzL>T^XYyxkIxaV)PGKze)ov?bC&uc7qsd^F&B#8clFkBk
ztN$i<jr19xj@?vF9Pd;!7#_4Ey-8AK3)k7yh=<+#J-;7i0_d+e<CW9>ozJ{1VE$Qg
zJ@kJYzTE|t#b0_i@^?x>tN;YK@|CCmHCzRzl>t=r;_s|-ae~UU<a~GjH8_({6)obK
z3H`;giX3o<{9262-v&Sm6JBDf!fSt!6ev$dRivqw*7UD|0f4k<fKJ3;Flnd-m=s4J
zE&OX(pkmhP!|$;D3+nV};Ep&XyW`&m=1^c@SDCd~{^B~0hFPaDOVaCKgD7Bv|KF=3
za4D|;bJMjv_du4&$6sGWF&b`;q@Vm&?rp-W;@cpxr9^XqBF-&YLc2vATkS2<{!|IH
zL(8eV-E>nuZ)Ly0!-CtI(tz@9^-U(KY=q6bu83_l?cT$eE~5>zOs5***j_6vo%k&3
zvat}OTqAXUI5?t1)cfH=l^>-+61MzsY%~SK;|J{%JN_Ms)jP>C=8A-={%42jZ1j#z
zPKvhAgnk>T-}$MB_h$8|eK3V^nO3phbAmS}yw?XncMDW!$F0(;Yar+epeLh<&fNY#
z@(W(|LKW%Obkgd-($P<f0)R8GRHDiEz->)~Ud+8HU%OZ?hE3Cm{(aPiG_!<8eus-D
zpG*eAw%>!|$ga=}_tWy|P$m7kqS^bh8~{V$H`1n^UT#zln0_6RtNg0>#h~6RSWu8g
z4Bq@mL4Gv{_r;*nTKkh8LHZLP3VUvw*Z~6giN%?62UQC&$2>nFO!dZyu1~`o-PVwt
zesP&E08v2^WFKxl{JJ!dY?bWT?3D!o;ob-XO%5F)n_{9#n(v<O1EXTPUWMDg@wh|%
zZq8FE?z0JR%bqzmVKf2ey0ymAj2!I;q6@GEz96-3(p&zXQY;(A81Y1DOpLlHgtzyX
z8GpJ$IyhOl8voMej^+{#D!{_>ZUj2EoTAv2K3nTM)LSeRD3;OIvt@u(X%nUVn<<zi
zCsDdqcl4cmSThYYdVl+Km4JX$ophRPPBDXDq^Qq?r6db?w^90z<JeV1QUwbox9|lP
z3gkcupt#EvbTsv5yY@rhgh+|rR|L?P(vHX~t}cZRN}Y={Bik28jl4HGT-1aKsW^gL
zv*cnn5Xw>%&U&`_*-w+DcpPR#pwpEluqwOJk}Jh(I<$m#AztNf5#-iQ6LaDG4(lb2
z4)<BFKAsJDRaUc_lRPoyF>|NK`9+3`vHxjx3Un>M=L=7H$94Bp+$j4@C|m_|@|DlO
zJ}Ok(b1sz0ug>@2XJ{M#F>c+8QUa^OK^%qHA0TG(F;UM^ESI?|dY>k_jPhw2Z4F0v
zcyTL#%ZV9_Y~+=k4eK9Yp5I^3C#H(op&nXDpz~kJ1tckX6-CMI;pYc0aJpT(t+!b_
z<43+_GW}@|>q|YtDaIgT{-3g_hNPD2U6uumctfc#98RDu^^j-v^P7f9;mOzSFKJU!
zt6vH$ERy5q_oc==C|h3AzKRplu3$}YNbxZaCvPAu=s2;h9y>zb#wVQPN|*XN<2fHO
zThL<`&P&^4d%Y+wU$^;uNw)FqbHgv0@LC5Oc4H@<Bxio{<o%hW4nE1VrG?0wlYT+P
z^=Di?`_*;nCdD$LS5cK#gL*}Nx@$%FeJ)G=q&v|roctoSjx*CrQm5EhsF2O@{YBqI
zN3wy^&$OnfM@8m0)^2DuGvw|Ox+a{Lww%$`%PJo7N|!C!#lAiq)veqtPMA^X`I*&6
z$vb|K82iB!VI8>Daz5P^L2uQ#S)-pB)rnt0ZvDEHEnDNs{D(&yd6|*D%}y+%RS+~P
zQu1i!1taVE6!}GWhofJ7^l8^Lo1;IePZEBSGy+e5&<#iH%KFORqr!2D$*ZlBF=>dn
zexxNcX-f(KtrF4{twsfND7!ry)LWfMV-ZmU&67;BmcL*u_|XUq2hsNM%aazpOzv;^
z7xqF&bFiA5wgG^r8u*j&{9vL%N`mS|3MlYaX5GQo8mc*SFJ6qH02@JY-$SlwSkv?5
zS9fr^?H#~}xT=0*x>&22@8g5tG@7&py_7WTExp$UD^>lvC=Ag@JA^tKer0&<nor24
zoNABA0axCYc^k_WzTmVB*n2~W4|e58j!&|Xouy%;dv#kdv3?YzL^L|2p2{*6N>#DM
zcf8ZbA56;T797BqJTgGA7RRGmR=D@$O}xAUKin05`<ws4PvYa1%qYdm+S2kax`?Gh
z4GDU~?L;P%y^Zm`v*RuFO=F*HidT!n+!Boayb#aIVBZ=hJ&uI-#5rYs1+`&K*wFH&
znsroha&a|Ek5yFt>q!Y|VF2cu`h`2v3FYZ=B0<T2?UkOtKWll$hhrU5&3r+0X|3gO
zDH-asoZ^uRf#Xo_ZA3TU&~3koTaJ=Cv-Uqm&nSBIuazPd<pR-sjT>e#uy6H<7P)Z!
z=^lEsqK{9(p(MR8o4cg$E2eJ#>b|fiWTGnnbXn>=f1fZ6xMr{`@(#VdOUE_YF~Ggw
z=?~inf|fA~k;#ufNTpIE_y*7lW^^emt`Rs*=YmuY2)qC4yvaUlp~q2^iqWB1)Gq2|
zi4u<%U^%TGHA)`E3LKeE+gA=m%TVl1x(v?dT-8QBHCjB~Zl`4TP;Fd%bY=zk>Kt}R
z-OsDu8|9%XUQ0<m^MVU;lN{yS05XzJVoUw69-;*ur^V}#+5QSpGC59l^T8Nr<Z_Z#
zDrx_V54TKLW6*nBGc!t$e-fgtGb5gwldU(hRS}#zF-K?vUf+9L)@iK!>aORc2~`eT
z_xtRCAR*r$l(!zFzrq1#fesP_KO(Z_Q#YiYcIv(ZhCegSD%(LCR*<>U5L%EUHH-$n
z0L$P$acy@CpdslSu8k+ieD#>~fix+pY}>OZyoH#H<)T*@n%UZ}yrw#C8hYnq*;Tr1
ztCwaZd0N&e-h8yieNKgor&m|@D0{oZje3e7Q5bCG*s#i$U>ICVDS42->f>@OoU^Ru
z|E+F*1=oCxv3uZHtJY3_B9N!utxVxnzll7~nw<lp!(O^P8-1et`;#upuZ=if@@U#_
zc&V)&t%%RqmBNF%x!~Ag1ss7;z4iBpL|YC;4(7#Qk4kLpMThrCZ{SHNc!l%UyfnU1
zzmF|?ULwb#5=)4Lod4=(BBqpd7%9+{d!HlAkl)>}yk6Sk_c0gB@Rou;{>o$QbMKXm
zP#9F5F6L{mdV;tn<LINgUSzgHLi)Z!TSD(i4}01eu*7U=>E|k?1X<u>IjP(^Px*cP
zQ_wGt1!HOQAb|FAR<(u^_riIi&s2@J==BGE1UOM<7oo+7w(%6!UMBmdk>}mItnBHa
zx5I`WQ*j1UIpE}3%D@F;BEBnhf*dQqG^0L7e;+(QZaF8neB-#H;-`|U5PM{vHH56N
z=!*^f*>I&~7K|J9%2DuHb5nm%B<OeIDYlvwBfrBi_TYPr+Nf+>`EjPo(i0D?><5G4
zttXN|s1;;{24He?f~RM*{isBa@j*w3ZDK{cW-Ug4*!QblCy`&OFv9Q1>4i!pN`cQo
zq1G{mCkExa_hVET*J#s5O{BF_Q{-llVd(7JOx|)XJSge4^$76_9?sjG=Y}c&?6y*+
z*qdO~-2HyneXa9{aYHt+q$s>@m|Px?R^YQqFmRUJ9&I^R+>J2wT8xt(43tC=Mv~16
zMiwX1Xr+=3DT!@X#e%@_s8Iu#2;SOBXU^w{8fEccZ%%j9&Z}-evK#|Uo4#n2RrPc^
z8meV5>jC&mbQpW;iq_(3!8Dze&B;I;F%!dwcFvrAjt|hI#h#kUTjWIj4fc!Cd^gg7
zxDNw?k3KZ-A~bKDB%2}~P5fm*r=PEoXzR^7Wt!V(PeEjy=67T>6g=OX4$-gW!*FtL
zPE?Z<L;%JvV7-p*`^<&@F1GdgBv`sFtLeQclYtk)xLsViS2eBus#rhPQ8BO~8rob6
z7{aX7zHAJEf$zEa(Msm($iTX<&Ww<kg;vK4GL&m(+S^OdBt{I%+~;Sus<l&nxX1al
zrF?RD5l;CF$JmfZlnq}c!GyB%cc|O?7iE+cX6`SZ#^p{qWEwHt^g(4W@8l$%8$NMJ
z*oE{igqS;DwlA-_<1+2%pxL`_b8Kvx=3nu8a#+}#qAGK6O62j<W`YzAp)Dsp`!p8Q
z@;(K+Xo||&yuMl}(CmM7roB<Z%~Zase)IAhhs@`+5L0^l>XJ?9OKjsC!z6{%wXVXr
zwQK5YsxJP&3i*!86_{2ErkM@Dt9!udZ@TUdh}^tW6cV@Ga(=p%KH6U$7$j>Lq&^6O
z4nNv=pK{YiJ2Y<g8xnwL*f#d*SaO+Ia924JIfS3XQwtIZt`S)^5aws~4dkXmZC|^{
zZc9&`pBM=hPxzmoB5F8Jiusc3O~BrTS15?=^tN*0`_pKD{h^(Zn?|>=ITqx5TDlf-
zCgLkVh!ZQ08Oo5kl(|40VL-Ag&gtfh^>v<f>dr>$oEr&ZsvKvUYX&8c?~ks|6ha{*
zm$a<`@0l~?vpa4C52Gv1Jt`0pUd#WvPO8f9du>s_-XkG>R9-^+$PpR7WhwDKHA-}^
z`d81U6ytu9uaJ#1YSTaYxG}=h($)D`tN5nE_}=m=xp#kTDYU90+xWV&*z48(ndR{t
zxs#U5j82d)5EvcdJ<lTMmFCZONxIhYs8H!Un$P=NiNtydG!RykBDO5z{p*LwMrmWJ
z<2hWo+T-4-PW6sa8w_LFZ&l`+!M0Y7sJokhHIHM=t9OHrM3s|2nfBQoctsi80xnrB
z+tC;d>msSo!UMzolL&-rBaCiTtyUO{4vQ{-raoa7tu)&ydJ8Qua+a74xD>64TrBe5
zf{PqZ8xMK%w&XtBy!L_;A<tbLD^Q|7pD}5nD&^0+zEc;(n&8^w3@pGdj^utLOl0E(
zLLOz<)`$HzfnOz+<#m~G&|G5M?=MS}?JMNqVl%+zOvyi{DIRbyJ=~S|gonqTMubf|
z_wk00HJ&sg4a#b!+2GU(M{B9)`(4``Z4=423F=2f;W5>5)AYFV)p9jH+>8&TRtLN8
zA|pFi7HX`3naQ?dM`RCTvAEos@zZlC*XexhzDSCH3k7_2HFgmDLc+Olf7KL-sLHGy
z&Q6H-7CRi*A=-9KD?7Q(ud(K+M5Ysahb{QNQ7_ljk1>_uDryWdIKe>hxpW3+k@$?)
za!Rc9X+xj-qX1df)zZb_t55QNbcR7CPRY1*)VJO#(B;PY$%LRdRd&1CLVgr3?O?sT
zX+EBA`JcNKsu>9x2GNUT-#GK*q<?#08FEAG<!z?b<(V;iE~iu){WPDYeMNuElC#G=
zf+09Vb?fFs2V-7!_qrqGq{R>rc|!_|(e2oD=WLJb5>_sjgVoRVQB0mEmTy6rh@V?y
z4xy066E&mLR%LwC7O;12kz;?d<|xK8*Lc^;4sH7LASg-d+$`bq>+lG_Yz(n}f(NA-
zgwn43<*B7+)GW0}%SW|0dwsRlEZ@fvsB@M)<jv#U`Id@4rREXIbI+gIGqHDUHzFK(
zhA1v))0O7n!~J@fMdQdA4Tqy5mLj?Chs5PB@$AO%wLj-v6;PIxlCSS&zyXeRYbYal
zvkIZq!^j;$il9_GV)be12AgNPvODV7pdqysU5{-HzC`o6Swfo&{mlcD)mVxIUWrAX
z%?>B3fD1Dgx-2Zv%^wH3ol;{fB<a)(T-pZ=^BUR6!KS{WG%&|zv|SUd%O<`sS8B%D
z0$p-e3a#Na#~vO9kIG-RYru-QFNC7}hx9mwH1Ki<<7n-wt+$WXi$sO}`m;JLz9)rE
z=N(-#o$<*iNl?PiAZUM}cDy(-p)10W5}oTH{&@W;bK_m{V9i#G(PJfxF0Ag}=FJ&)
z2U?wGqnd`Ie8xu!NEwgu(_Fp2&b1(o(>gbONT<o?soTVcskn+lu@{rZ3KB-Vr+xjD
z9XsWkH~lVvgow&)l*){ybJ>R(N9Bzo_zUCRG6Vg+RLv15CXnGQxi$(e2PvHOA>0YG
zYi5j_&o$B#kxIo7piVr_9t5o-a&r|)GZfCru6$J_>p-Hj#e#*V!ZBC0W<N=GD(HB{
zABl5%_%3`=nCH_$WV`sz&<NCUPh~O8I3CvImcXp1MW%FAHtx(FF5N)6SKlsTg+`zG
zI!$?!;?lE;?Z}Wc-#9t9^*)lgc6~Ttt}9A+a!B5SJ;A*2ux?0~JLX`%!VRh1Z;b^F
z+|ib>?p^*N_O>xf(IY%3x5rpXu0H>Z?yjZ#*G}SWLfbP*vS%Vw87)(Ls#Bg^{=UUL
z+&YMZNCS0dn)OeTskuW;MP__rZ{w_vKEDcyhwD`O>>(EK;?m!I`eHDsh*SSqV8bn_
z93Q>Ztgaj_rhW1-`e>eKG<#psYvD){Kb;&^RSX?HF#(J8)QS03OBN}llXbYVm*otq
zl!mQOsWWCPWj|Kt(q;0h7pqB0aWLY%uS34x*tN*CR7k(8PqABA4;=-z?FP$xZ5lU>
z6%T}8dp>g7&*8&AN&ufIz~H0nx9xLHz^f4*b=6pt&4`<7-4*o;;cZtVPG(vm$CeU7
z(5Vw_Uw^|x7tF34liw!+cZ<R)kqS(qhkK#d0CRfF8Lo~U%&1$iAO)3+0u5^rXDgX5
zuKJxAdW{5M>tc5EXzFTO`}Nc`n`88m{+*G=r63`2cRC(8jq}j_8?rFHRd}On31*km
zf1ER`DB``sM#6f|r$R(%s+bJGxRf|}2@#xAwjRIfX`03!R}!_B<d7tJM_HJB-wTK$
zFrKE(4TmFi4H?}1Ctn|H4NRHL4xyL~L=OBXD1n{*e#`5^pw_OItorY73&&xXwB$;d
zQb;BYN|TR=m}YWB`)H`%euC9nJM@(#p6VoZ<z_D*YtAiQlEN8O7M{m1Ub#s7<aZTv
z_TA7nc$ie#)wB{?jl6)k|ALzrZ)85*dOkbd!J<0?zEY9S_Rg)R#T)5Miz<}D1!H27
z=HFt0+!B>Rs_UV(Uv1ZPlgoUB$Ytg8?O<|T5vFmgx$ScZnU+xL=e1Nuje2Lny^(!X
zIo<BoT{4{N9YM=c)>C|qm8@C75!4C1IV>puOgDcU^*Zc9U;L(y5PcDDMjR)wn3u4I
z=||AqLFAq=B-%{s){babF~S>k)`i1~(*_RRO5nTDsoCvSb^n^EnNuE{4dS34%5Vdn
z2H$!9WgiJnA)WOKXHN;r=UUu5jrAtH{Z{kY+7oHDF9Ttgsr+ta+{)*Vxm-k{L<*3Y
z)q@coWg@9i2IrR*PslWAzKQRRnfDB0=k+(TdV7Ke%hKtUPRc<SnVzz0|Jzzjf;G!}
zxZ%&QFeTbk4~sc1G_1gU#R1@i5M2A@SbACD8Y(%sXw08dH9x8=;ZT`D7YK*x3;ep=
z&RSBOeOoMeUQUG4(WZ-Ox{)GVVDUA&3)3k3GE}9<Xe|4src-&tGU2t5keG>rYSdJn
z_JczIN=tC@V3*x}`k|SnfsQ>)-&6W5V8AKwb-uYK*k*(#MSD&JradV}{_yW}zKl;1
zIg$Y8>^8Fr((!l5a~YHn@jUQ+JNIT!RmW>BV+ZE{oz-xH%w?MEPHpU<qwC^#oL(e!
zi7Oa&(>BA&<c#Nxu5S@q>ncw4u$~c}z4;zYhhCVmC~$gp^lLwjFC*8`6^NS0c!Ev^
zUrx3Z?gB{$O6a)2z<zH2GkLdQX`N*`(X~vmNf%ZLu6|{@9MwOum<z-h@_T8tFUxt?
zaGoxdA~W<z*sklVRrg^a8aj=oKidK3ouEN=+Atj|7)#K`k&SIs6B_5|Yz*i!UJdPR
z3FkXTb(a2!S_Pucc=3QUm;?}#1d+<bFj?vheVBvYYfIziZnwNG1x)Z1PUO|MkFOYy
z?jkcY1W~0KSpiB3&69}*Sjbczn=fA!Hp}OPX&H+%ZQ<9H*yXe`=W)HQqD=Ez&V0m`
zR83Ao@ytTL7CcsZ7IDdC`MZ#WTRY`SJ4f)jY(?)@a`vdKM|J^2_Dj<g_QkxY%V)>)
zmk|<-p0k0mtwwIgh_tiVX5H`m0LmBo^I9nioSI+-I+blOt}Ww|&r*)f@Z%%dwy9X^
z>Eow`!96a=_8R-|A|$2x(O*g3{9lR(f~dRKZYP@?>p$)c-BZQ8Rb8Sf!PcitAraCx
zQ=*kH#X6)$Y_~JwV}i+8g8Hu)*It&&N@9Fka=R9XXFHIc{Yy5f=Ep<l?6Mv4#aMN<
z-V(7Qnr8(bt>^28wLR+<vArb<lt5BaP~y=8^_?wY#FYcS)}flC=#jItN{vT%ST+Xb
zRR?`~$8^Zg)$+W*HSTEgf8-;Ne_}%tDCHmrH{#<=#ClIpE{8NX$bFgegK8C@K@Oy&
zg1immT}5>3Ankq>^WvP^zE}<cLl}xlif<L8D?zLgWxb2ICd*)YHb8LJV9<A=p5EM#
zxHVnGeD`qoZCd9K^7i^M9>Gsms;`SsR4Iyg`0Vk!1Vzy*4Lp=Or1XvJcve-6u5wOB
zUstHE&>UTLU}}PI^CKU!NLJZ|l|x|u1KDSHmBxQYj*n?eq)#cwNS+9YUMo4TZz;-`
zw-w^lK}@Qj9^tq}0~x>g0NGt)$~Jez?UlY~F;hUw>(MQ|LaR_Nm0jY{LKB!&L1N!a
z)5UzINgzwhcgrIyKv8axf5emZRI_-;E|m?ZaU_*G@qJ(>%R*|^IXp7sKILipI-mN;
z6mDX5jO?U0?zax7b;2E{8i=C!z0VGp)hoz%!-zPEmAo^h^hO#zR<jdwipx#-gmGhn
z!ko8|2V(nz1S#xC!P0>xe3iD7pU))ft#X8gTi)(b{-;n!g~5K!*Ex8q386xf+@}KN
z_EF+H-`*BX%{G)Z+tKxB1;hdQ+ZkD)I%kjX{oEV@!{`DLV|d5oDx;qGTl-7hVLi?_
zFPj~e&E&Wx$W6U~8pJ7(VUYC8(F85k#6@e<FP5r3S~S&qzj%!cmOIL<CU-0}R3{=?
zvckk~<c0h)kB-V<jL2$n#&xbl2hmU6Eg)4&^PCF<Hae+RqlsbG?Y-*8ST64)$Z5l~
z!agOs2PuqsoFqU56jf;3Tj*zfnl;~ajA`rvf!As3jwC$J_OkV^Hl`lNKDrW)oxV@>
zI=jh+4Q>Qv(qy~1Db84jvA$%!rHsYcEK-9spB*_wN*SLD_u?&y1piwXzGnUmzNTbI
zv<u_9FQKAumEsn(#prKPTxfN-^dj7hwyJ>?x;4Sp)DdkkyptX~H(dl%IBJj{kpqc4
zak7Kb=J}JlPIa)V69uR$aJw6$p!@odwLkaf$ZDQ;C(}HJH>I&M3gLF<Gl!-4j=kOB
z+{~QI{zqSj>*Ada2yoJ)dUnOLY7uAeNA5t9qJz4ngD(>WSGm;-j%M?mJ2WYFlXEK%
z6lV7+LJhQPD!Bc9ZR{#EAcagpigIx0aYn;zrdvczbVbucDZUgD`n|Ea$2<wzi8zha
z`W^E2r|N?T3HO9Z9YjNIR<5@&UcuxV!J#*VES?JUM;s#q4(!*33`4uLuL30}*YAxQ
z8(wpJgL@NWyIDxw52lcY@n<taNmr0EdArZ%8C-n34=#_NRD*#q!_Tji$BrYUSxk7!
z6=CLHx*`d_?vHyh2TfRt|Iy>pc87focB<|jB+r>8E4bO%7MAnS&QH%h#NEBGZ1*%O
zx{ufq3On82jOy8U`1vNBvPN30bZZ*rE#X<&;TKl!Am7l3ZPGtebENm3b<7Q|nK?k#
z->yZ3M$O=YrVjSKW7Y?oe_5~B>Yg&TX{SNad`Iixp3SNuksk`4lZVH-lQ+b6>L0qF
zih7{2`H$3U;In(r8jFlm-M!{8H#gtzVjf25a(N870(GWwsk2{Ev!%}G;Sxld9geQ!
z>IwH<MOA8(xOEKOMl_27_sx2oLBXwjM>gS;n@a#6!gd%Dr=`bPXHdu#=o8bWv&u#|
zu$k4DepLGLbax<kZ1Zb@mE@sF*HeiYC^P`WHbPnHp!BQz>tc+5wSA_-`r5z<_zD>V
zwmbE^#3`E7Dqzi9Xz3y+?kcLWo4-0!^!?hYbhb%DEc_z?!GrIIJcS}g@FST1CXgc>
zuu6CdQAe1gkk{!#QH5K*!kCDLzNDk3jB=|rL+_o`geqMDA+X}+&;15g?Psq{Ga*M~
ztyaeqePN;SMy%FcBua`xvb|w{&3-f9@JXHN)2M-h#jNh#JdeES7}f${`>T#Mu2%zA
z`^R*S+AEiq5bOCi>L*^X;Zf})UmaY3E@MQw=fWr1XoR0VkkBlrKrZCjxC^rQ##&}O
z_Is&C9&rSWdKikfYynBvp5>XymIw#&ABJbDPoz$E7WGOF`_c(^_(PtQVXZ<M25~S>
zj`fjTS*n9W^mE8z9XX|<A}0ALky9e<XZsK8V5`suP%#+Is+izv$7^%arSAy0pm(S<
zl{>E}64GAN7Yzi;zK@c;IMZ}K_P-$_yvH@0vyqpx9C#E<Xh#}>ZB<m}S{bPg-HNR!
z>I)3#fjto}&Pc6`O*!|B88rV=wK`W!-e}GRH}IQ=ne2aQRIY$WjZX`JYZ_O~!pD?|
zuh!TxN%UQ||MVn>V`k^*P!nCz^>kHh&)FDSEX>}ke}@1j{~S&#zm|ev<-1N$&6S=^
z?ppaK)mk+oe~CZ1;77b+d5Xl@kCq(=DWWHo&EAk{bR&hM@6V^TW3zV6=v8L)R;})~
zaWFAft45LV)iGmZFr;x5L@%|cevB#Pta;f-i^{j_?x?yy6)im}9ELk8jgL;AOOGAA
zRLrWprYDLYG5BLlA;EQ*m^4uD#?TlzVid^`JdmtyHKv}DT{7~BuLHU+M}Da$&pXlg
zU1-UKj7<~l@-Gof`40uf;zXskfsY2oAJx4nH8M?Uhkh^e`yAWgvE?9!sWaCcjrz(m
zbPFF0{<0jSweBf2l44T)&<gLk>jfyr#<s?1szT{$`UIhCXv$I=!ryP$@FNWMCDvpA
z@UZ*?h=!=Zw+W_5iu&SdshU$kUKeWMLRz(feRV4clyg`{lb+(cH{LesbN5x-U8+1i
z{0MEti8D}F(HlVpniSh6M+Sv*rkjA_R1MUzZ$Q<g3_yU?#-Ii@Dq31XfYt_t(LA0D
z+SMZ=JNKw^0?xo6n53q$j#)73Ha($QMhnX4pxvi-?k)pDG^3<4GJ$i<pKc5-v;!Fk
z!&iN>ZB%)&0p1-N)xdf`nb^=Sx2;!600VY8A&)F%2T}<%81M<rxMqVcN@Ln?6r`wv
zhC>dYTLg;Z*WTXizF=&8VF!eZN>bZ$5n>Ojwsnx`WqcpdRak95UQra~L6$wsK=`{t
zSJ=v)=3^Gau3Tf=LRdg{y~qM$sf7$`-59R~`+MQmNBKR6+<1{mPcFDA)y!0(K#g1M
zT9GKJk)7HFX(lHi;+L(^_=yI<Rx#sAm+H{3vc49+<q=eUD=klhw>BWzIKqUt_J;li
z*J<S5_VHE=`r9WK$RECfrb2mTe2fV%HwCw?G^kAvT>}XwHXMEGo6iEU22{uiGG(J`
zbSo`8&6;2n;U>kj-}TlKRZZ5A`NEd{w-D;&f_M2ye-DI_z@azN){il7<~pHW^W{Dv
z)(1WZuMuzR#LWtFU@5)#0zecbD@#GbkO`fcW?yqv{h(?cL6$g<7XiO)JM+pZf&Qo<
zfk3jJP#X*s>0b@Ngu>lTcX{qaCHGRlADCm`-l!bZJKo#eL_4-noP`@x<X^jx(VKv7
zTEKC-Y3zfxI{EdYk!df*2x<aqcBQI|ihkLcO>WAAi}F9!yCjf7S7E*`3ChgfSuN#+
zaA`2jQQOGN!jHc427x9|y28_~=3|FEp%r9)jN9gf5YpWF0pVAgp%Yu~(kAD`(4v)c
zfUVK1ycBnRNNR3AQmjO6JcggZf_iA)ozZLIlgh3>zy&GxKR?T0j0wIQ0CLB7c<{}k
zo$fE+CVdVd;M{N|Ap6U=A$fHZpy>SX75|U=2)sf7h6(m;b20&{%m?@<@~nMM|JYAd
zK*Lke0@ZI;%>`fO|LqEp2GIp+X5@=1A0gE@^>nXPbR47-D4+DPHSK$i@33U9kor7^
znqkSFhyCXDQ009DEd*8PVtnhL(!2`)OR;*Ue8EEdcvq$fC=2|c{_^YwwGI#laL0?>
z{*N+6btCW_q1`6BR^(Ln|0FWzQO{luenKAq-=lw1b^t0PP+X(}0Q`IGD(nD1%&P7B
z-``ZC03Gatq4Mt`YruHdcy#{#z6ad#n-}v>0Vx2PD}_km-|q$Bj(el`X-F=xUjvF^
z1Aj3D$%lgafp#-gx(4xu-2#R&#|k{DbT3Qz&z)3{fW8xjI7WV34Ir&2DOFKtp+r6f
zAl=7%WdNTbcE3p)FK~?-V2d>iXLkG@gbV<0A>^3GjXzH=PzD%jM-v~e|KXE?D1ax8
zsF<s3{;`NWNuaAWyGQcBnOA@&gzf`+kcj|m{+Z|WBS6@K(gBW#e>8*q2#k_KNLcgv
zg-HX#{SOd=`AQ%g81}~LR%9R^ffqpYTO{qY{5OrPgfQ)U>O0SXp;9G2vWk@0ZoM?3
zsw1DI`kUHj*`N4f{r%}SkRGf2HQ#-+QSA6R$Yi!P5Ct%LNMhgITVNS_C4FzP@-7-M
zl1);@B!SL}T1R8=8@XL19R?;VLm9$AHY0IVKyoD0idPaM2d3gk0?h>4jny36t5wXq
zm;g+us8(V}<+2PBDfQI;Z>)mAtPOF9QW5;3etoG&tf=e*4sAbhp!t#Ru8KK<i`BW7
zxlp96TYVcd<K|1=Kd5KU0nqUfqEis^$C`ct^u%ykF*Wi(V0f1gOsyh)yzL*FEl3=g
z`?(*HNP<6bGUEb(ig=r?_ZO&?fE=DxEY*K0l8J!sI;%|cY5#zw<AOu^zasq4)WVQ>
z4(`hZ6asujohra*YoVYo1H%eBgF=m8)L!79^t}UXm0$3>-FDSP0V3$^Buhzkk1^jB
z6p;H&Nb%@1wx!SNukLQ?pM7;xAD=I{tHvh(76D0rvIylHGO}4?X`hP7H~^AGu$bOI
zOmWcU1td{lkbixr8Eb1|wT=*b9N-S?NPL8BDh5)H^;J^7PbJhY@xnT@ZIPGo3CRFj
zEjQJNfeUJ#Gs(&P3cVtJ@~|{J#<uZJjizV?D<$Be)A16dS;jbMF2bp8BFpn9-Tr+7
z1SH5rK!gaP$0Pq7-gUt1mh640`s;Pg2|nl+mS4_oAkm0vZSvZMY<#2KocEBd&YuC-
z<_y3loKw(fX!2gojRs!*=z=#%%duNI<NEw?s~LZxk(~3#?JyBX%W(ekL^n+H=VEx9
zEviN)d1(EC`4LaDByM@OPJw5nH(t-OCssTMd^p~Gut1M!a40NJtl&Ex7)|rF$~5+x
zX+A%aO%~eKwreraUq@EUsO(+P1Dn0<XGHcslT?Du!WBE|06o}!42=V#HqJmwS>>wm
zsFv{@#Z;|QlJjQIJc=<Nh}h0&-=`FwUwe0#Z60kFJi?TTgtpj`)AHnL`}w9fiiwOj
zr)@fK)1utsl=eFOjVsQLc6FT5w-Hus30rUssrOoHLd;h6P?im~7*MRUkE_;_KRo#?
zQ(6<%?Mv&EV}8DhoZ6_ZZ$Se!;!0viFI4m4$+5|ld|`>nsJOFMZ!;#Mzw|Lq*n7G9
z7bY`y^tnEtnf{gW);)1sG5rQZ+Xsmirk5NYnrHpIf0c{G=zsQHy;}p6OW0?u^bahS
z?8TtRE)dM;5Rcvhh6eokHh(F*a|L8+VwFL{p8G01_tm7(2bX&vgnM)zOBUS*92m^T
zmg_wTM<VXDAMUO`*X=XCHJ%3Ap4c^q%!L|HSnQ|ixwg)R0~EFn%I31&sQQOL=!Hh4
zeBg^S{>fJDj8NW#t>I&(a?#4=3FWZqT6<2!6C$J4wh8`9%Up)JP)Gl&7A7w^SY9VP
ztN&qE1k~oUp;Ip;C*YC3nl6)a)sOY|>GH~Rw<<UN>Yt1airuSHp1j@*d!{{_lrwui
zMr{+}QE=0O7=@BhHy~q5hjl?)K_OF?zZ9ADb(Wu*qwkylJSfW{yj7{CJ^;43_O7{g
zC^@x;{(B=ktBSrkJPuOZUR#rLmBGHxWA$Uv8-g#u815c6kA(m%GS)%r{iZsj^qP(L
zn-IjEqw&^FROLmTy7+p+)6=ZJaB#9<xn)>i7Dmb+9zV5wW`}sTr6(gNJwV!MtRbbM
zuz@uDbmU(s<vY{oj`=y7Lui|#wPvlq+5BnK4eMU>1LfP_a+1$j7qi#UA$jLqQ>OD<
zox{Lc;h213(MN;*y}m8<XqsPwPa5QBzV|xxmOg)d9i#~|V}fw+<4b`g%(^Vc+pxs3
zN`$y6Wiizb3Cqo-?N@WEoEzIgo~YOXb{i1T<vHbYO5GF9kte#hb&P(2#>)BSC>ZUt
z)zojjWe*<gib|rvUM{Yc+gcC~;Q=PnF^tr{RBFGaja4?mf6Gr|(=n{id-F-o<?9oB
zK(+%tr7dB*=BAr7uU50$mP~wJ@9VMZ>$;;u7Q1)c7wMomU0N!6>fT$!y^k>i5(G)b
zO)nCl=4XOzDhUaOw$oqgH@!Em)~sjf>s5B>NGBlYb4-rn*k{NjVY}-FjSFw|H+qSc
zMGP5v?{B&enKbTHp<^1w-Ire<?~Z%3&*bv^U@^Izfj?&rFW=vt6u73c=9`lR0?SEM
z=Q4SQz|T?aJp)kentf<mx$F*{_UjXNwW~+n$xkQlBhGxZk_p_-3G6D*kid@g-u>6;
zY|12{zWL<WuoO@MJ~EJadVKDdYtoc}#(YAr@#WSJ?)Xx056U_)r4DDJM6QXadiNQx
z5!rHShd<XFvlQE_rB6MQ62ld=@ABIIK->6y?&pJVY0x+A;;m1bd)ZA0;?~dO!x_tr
ztwsix-A|qqPhe#2Q?BRb<E`n6ExvEJ-!&9@8Nb{YHZw7loF>;i=wTYOIa(<UNqFgS
z<}+8Z%^ya8yCOSx%bV3=1YkZXdTl`mhmEIR*xE^{s1HusXfs`_3PrytHBF&Ddx%Kb
zwTZ#{dKxzp<e%%=jRwM40ze@|&8Kt37c`vcY!&4&%u#=Qq_}tKEJmexl(Gz3NCq}t
z6y04mj+XG{YQGm=Q%21v$>9mfQzV-ZFbuM@PBTND0&WR1$WmK;)3e^(_pzl}MXq96
zaidddtjQQ;xrNbZ_~UG(+WvUuev55`UB$<&BgaY)!`5sktHG;xKK-I<VS_RoI;IM*
zq|~{tb`@Go-ra1!Hu#|?)WMf;Q5^?$2iSMLR=^NAi3hgXw3A<rg+$o`N2ZG3(x(-$
zP_g1u^zS23-u4?U#kG?SU~YZiDNNgP1KMdgG$bmSjC)Y|x`#1W;%ghkv(hA~nm%8n
zu+fq0FVI_!Ho>|rQU#cbbm2)crv$4KWDdj*;JRUuTe;{&ZK-e7`fwb26E4^5qMW8U
zc_VrC>V$SG6iw4#Uj@-Cg&m6{3cJ1@Cg@iW7==BtY;a{niGIpwz*PE7bU^yJ39g&;
z(=Foz=ewTHRz|fbadu0cyDRh_D>@>{=b|q=<j&k)MOk<Q2pXi`jX$)B>4+dyl{;pt
zjS-TYY#LI5#kvQB5>iv>CdBK%w@8DSl<3a0aZ|4%7LI&q;~i$YE;}@)Qur_6OkAdZ
z7I4Z4Ql_M(9vd4*q1F0$OfS{wbQ`C*>Ecflbx$W=S6m-EW@z;7@&zC-z<3fx31H#v
zo|WO|#kR&MS>2rQ9_RL9cRqd;)4N4=6R^0RHJ~}H31s|+I)CvEy^;sDTdB7|Y21e%
zE^FVBo%*%?)e2>PotS)TYP+2ov*F0FMjyknoKv^%T&5x$XQKg+rQ!HSNbE5Evg9BZ
zx;gHVG$Ywyht2A{S}bBYxJi!^{TZ3CDwHPNQ^k}vQUZhun>7+bvdn4(Qfz#ghjMWC
zkgUIy3R}o<DxJzpiLaA2GPxFOVCv}A1G2XUy&@`zJt$pp+I!#GCd{{u5s$@%*>jP%
zEis9YAeM7W!Kk*M#@k&21qrX$CFq-<VS2N?hEKvggz}6<XzJ!0Hcv*&zLTCOo;f!|
z=C;}efGGdsa2yqBV9lL)`FNQq>4u}9k7BkIs;RV6R|DrLXHKkF;Y!&BGBVweG;_?u
z+EUDW*O*zQGiUh+mH?eYeN$|_@k;T2c&!q}G*-9SCifCCYp@XbR#A_mP-*ILcvRCT
zamBQb0ZKAY=j^EKQ5=njUys#=#RQ!)pO+{sUV!|zx8n|k+VLjswFeFlX72-W*Gm#t
zgA5GuK{)A5qF<Rp%GcgXbG_~Dfn_%d&Fm7HTiyG2u&zN&&Bf>MN)-=%;)KH>05zb$
zO4le2$JFF5PqjBZpBZ%Oy4$r-nsYy@d{Z*{enKU0o;K!d%L(@)!*Esy%$!eqhqu>_
zafyq1{n~%00D*p2bmRCqRlJYm_9xNNaDd&S?a1bLLo3R(AO~r&h@>Zbv20VyE_{&R
zy;k4deTY8pgL!%o^CuoXeu!Vf$A292%~ss7g#Ok=x~f66(?7?4nXzyD;qvCPRf3yn
zk;^^1%SE7c5+IbgH#A0sPx$rb*y}zwNV%5VCA4GxcHqL5v!BZ~+wV*l>;2|3cFtH^
zO(`S$*MG<zqWaP*?#=j;jq~{~or{(FAT0;JNs1OnN?-<}HgO%hx`wv(2VX8&qZo*4
zDNJ9v+i7*AW7693ivK9Qx_EDlV?6@jArlC}>LTtOW_Tw*&ZVt>R3ag;Sl1JG`(j}b
zV1PwYap(bl#`=jnu!Vg<gk_PiUdF|QBB#=!C!e75bn^4vN)_`Sjm#ETOWxM(kA}oq
z^>xygON-%@8KD3z&mDK$W2`@ou31KN*FVL*b#X6s|A57V3S6|VmLq1qI6M@LnQA_4
zS}WIC^L3V^j5r^i*#g&pSV672U9egr!eo^WS6ivwOZM;M`TI)tL7NiKU%k1>=r`32
z6BHe*w)wIQ9^`;<L_nPkwmAg+lUs~DKdv6;9OjgL5A)eI7bDyOCbLgA3_=A;=OKXJ
z2Pk1^wq58+$<2)onG&*~;Du0s9!1Y{^2Vipv0&mbe*uh3vhd<E7Q6#x(n>vMYH^Vt
zpYit&I(7RNvL`(^k~Z#-`8=aISf?=_HU3MSe!ojLXW2O?mo;9`lRZn4>9qG4AR~rI
zhffzSuZ*RfneH2C?=xunPA9qo>l+bexJUPp1|9pBZ<x(wyh1@J1}SdY-IA*qTE6yV
zN{#KC8~WyML;IQAe6Qr`O5wuY%lD!DLhSlAS@bM?VyjY|g&yK2AM;1m7vqolA6XGc
zRSvThtDP4n59tt-tbcyVdBu^+`VF2(urNWC;WZGm0sd5+=gwm2#A?_yn?xMQ#@;Ll
zc}ZB3b>(n1^%iwD{x&srAWUk-01Z|qwCi(oDD4aaN<;<PD_I?tii6?@z040(?y~tG
z2B$O)N(C#tPHE(~LQqR+HK+^vzV(ZfkZ@DJf*L)OuTa^_U@XlVv^>KqY}Z4vdtxQq
z#7)Fvxu=ec(}tTv2zN>-a<U+bI`}wh0%M?GFcn>+IOkx9bMBc@-Vwu`Tyi!_#qQf!
z*Q<|4wwZS!6_#?b%K=C0$o4#XGVB<?lmxW<HNwAM4Pg7A;f_Y1CV2q+@dD9OS!dx%
z*hLV&@&Jw<YnxQNHK19~C3*zC@)gJ&1k3ZG-q;V_SWq#*Eh&CT{o`%i@|rJ{(84&!
zd`j?sL2%b+&g~xohgc985u0blB>^e3Si5rir0dPTr1E9k38SbNJKmeaQK~E66x*XR
z6Q>GgPu>Q}EdrF>Vj&aF#=Y`NYD6s3@F}n0pdz}FQ*5$fvC;j(VjS<l$>C_a&p7Jl
zt``t%KlG}kBv>WD7G;NTGvX6+@ueH37BW6TFrMr`+UvhmnnTD@@;aOi8V4;MMeHew
z3tI!nw49l&d?Dp8+l@U;7st&b_}UnpD5s8^B!Gzdc3;U;E)b%9<dH<0+WN)T3V!(Y
zvG?jP5u7k9=dDTWb;%qX9@m=|HOQ~@`|*%u?4ZbWP3Z;OO9Gp=yitE1QFJri#ybLE
zT{$7Bz-P%EAz6P?9iae)2IdSMV4~RX*;g*NHtjlfb1Z1Wza**YEWh#JFq`O@Nn4zt
zv5r3Ac9e!_rRV`M6klMzdahoh`({x3Y@W+rPqmjEs!+sgnAjM0dE9PJ3zzO@m<?=?
znhbmVS^*wF_u)onDR{6^V=FeOXtB|?Z1MWJ1v%C5H5>=WR6x3zg|?!><&o?mpM9{D
zR>qc4$vWWqVX3dv6-o`YjHYQ?W1slr?qOPf$b~I?eJ2fS5;Lmrh}S95%;=<aI|eLY
zg<P|v&B%8R(zsG8G7fOWA>TgUea;YQ$aQyUI}H}can0+ZCX?Fwh4*Ip2x^n@WZBnX
zxD(jaI0>5jmFVu$7kpSc-B~`fwMLhX+B}H{wl%aTH}}fvpG@~De;^|ef>izx_T^&C
z%Vz+VtS7XjflrAl_S0@c@7KuwPHr+22IgK*h%%gT-<nkBd5zwA4>AA_8qZBsAjyFw
zLEh8A{TY}E?EQ0_?2eebf<tL<K*hir`H`dBpwo*~!#k3d?<oEA!<JVz?qWWL3j*XM
z$O=4jlx;mOUkpf*sYnOXQ!C5elCu0#4F9=SV?T!(tTpzV!9F8nopLG=Q=gxj2HqGz
zRCMt!067w7lNV)Oy8orCui;Ob=CiA=NJ-f|`Pi<6W~mBuKQ*uX01~=5rEFfPY6&Fu
zm@gA3u%~|bm<khyn1z0>NWO@>u$oP>>6XASY-?8YA74nJ8@RbQj>M8Yl(=Q&vSPzm
zFL}wEm65l`$AbI?hUA$dki#>hc<OYK?A5zAbia+>q1vHXBLR9(r3&y-wBYW@f4S0C
z;JNaSidX+N`~aen=ZNx)V%C3xLxE*-m_FvxzlJIxX8Pf}@$PSmKh_9Xtgu}Rzc0V|
zpy35l(t>xy{yQ8Fv}6M{8*cbR(LXsMJc8$d(r^5)7=JYQKUy2<UaOVN#DMK-1rm|d
z5<Wlwb)05DnareZC&U39-9Ndz-TB6`Ebl3RGA?_;_a8v@L`MF8MXOT3D?6Y=0H3{%
zN|7WQ5g_1b<0e4aErso<sQ^VOWs?*)RF9)f&HFc?m=24`kWtZlstja6Mc@x~XUSg&
z2bQ)0DZ&4MNA(cs<ed;n=bthSKA{ir$_wLQi$Cdf5VIKo{%dwr?}Pt7;{a#?O0)m0
zqXWoh-a|3d{LN+pc}EhI4@LaHBHKG)WAnU7n&ax<PG<qAAJXysdq2Q6pac}I6Rg7U
zx6@X@ICh0}{=Mhm9vhIeFTb4e_;05H{2<^!ZrR_0&;P}~|I70m2bc_ungB<M|0^84
zyGVd`(7l=aXK&4Tz)9BsRRkWv|4k8r=fp7YPu_<1%-=5F<s$c7=~>BBlc4_td_rS%

literal 0
HcmV?d00001

diff --git a/docs/user_guide/how_to_set_up_an_analysis.md b/docs/user_guide/how_to_set_up_an_analysis.md
index 6feb63786..93772ea86 100644
--- a/docs/user_guide/how_to_set_up_an_analysis.md
+++ b/docs/user_guide/how_to_set_up_an_analysis.md
@@ -146,7 +146,7 @@ h2i_model.create_xdsm(outfile="connections_xdsm")
 
 This creates a PDF named `connections_xdsm.pdf` in your current working directory.
 
-```{figure} figures/example_08_xdsm.pdf
+```{figure} figures/example_08_xdsm.png
 :width: 70%
 :align: center
 ```

From f24957f2b6b02c15d92550eed48d1f0121e68f4d Mon Sep 17 00:00:00 2001
From: Jared Thomas <jaredthomas68@gmail.com>
Date: Fri, 27 Mar 2026 11:02:09 -0600
Subject: [PATCH 08/10] minor comments update in code example

---
 docs/user_guide/how_to_set_up_an_analysis.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/user_guide/how_to_set_up_an_analysis.md b/docs/user_guide/how_to_set_up_an_analysis.md
index 93772ea86..157b211b7 100644
--- a/docs/user_guide/how_to_set_up_an_analysis.md
+++ b/docs/user_guide/how_to_set_up_an_analysis.md
@@ -173,8 +173,8 @@ h2i_model.setup()
 om.n2(
     h2i_model.prob,
     outfile="h2i_n2.html",
-    display_in_notebook=False,
-    show_browser=False,
+    display_in_notebook=False, # set to True to display in-line in a notebook
+    show_browser=False, # set to True to open in a browser at run time
 )
 ```
 

From 1ba941c587b5573b9891e988e93561f235a20102 Mon Sep 17 00:00:00 2001
From: Jared Thomas <jaredthomas68@gmail.com>
Date: Fri, 27 Mar 2026 11:54:41 -0600
Subject: [PATCH 09/10] remove xdsm call

---
 examples/08_wind_electrolyzer/run_wind_electrolyzer.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/examples/08_wind_electrolyzer/run_wind_electrolyzer.py b/examples/08_wind_electrolyzer/run_wind_electrolyzer.py
index fa354ea6f..0c5a03835 100644
--- a/examples/08_wind_electrolyzer/run_wind_electrolyzer.py
+++ b/examples/08_wind_electrolyzer/run_wind_electrolyzer.py
@@ -14,9 +14,6 @@
 # Create a GreenHEART model
 h2i_model = H2IntegrateModel(top_level_fpath)
 
-# Generate XDSM diagram
-h2i_model.create_xdsm()
-
 # Run the model
 h2i_model.run()
 

From 7f939ae5975013b0977ec5d57aa81108b6e7ccd3 Mon Sep 17 00:00:00 2001
From: John Jasa <johnjasa11@gmail.com>
Date: Fri, 27 Mar 2026 12:06:09 -0600
Subject: [PATCH 10/10] Updated XDSM explanation link

---
 docs/user_guide/how_to_set_up_an_analysis.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/user_guide/how_to_set_up_an_analysis.md b/docs/user_guide/how_to_set_up_an_analysis.md
index 157b211b7..b64d4c7e3 100644
--- a/docs/user_guide/how_to_set_up_an_analysis.md
+++ b/docs/user_guide/how_to_set_up_an_analysis.md
@@ -122,7 +122,10 @@ For more information on how to define and interpret technology interconnections,
 ```
 
 ## Visualizing the model structure
-There are two basic methods for visualizing the model structure of your H2Integrate system model. You can generate a simplified [XDSM diagram](https://mdolab.engin.umich.edu/wiki/xdsm-overview) showing the technologies and connections specified in your config file, or you can generate an interactive [N2 diagram](https://openmdao.org/newdocs/versions/latest/features/model_visualization/n2_details/n2_details.html) of the full OpenMDAO model. The XDSM diagram is primarily useful for publications and presentations. The N2 diagram is primarily useful for debugging. Details for generating XDSM and N2 diagrams of your H2Integrate model are given below.
+There are two basic methods for visualizing the model structure of your H2Integrate system model.
+You can generate a simplified [XDSM diagram](https://openmdao.github.io/PracticalMDO/Notebooks/ModelConstruction/understanding_xdsm_diagrams.html) showing the technologies and connections specified in your config file, or you can generate an interactive [N2 diagram](https://openmdao.org/newdocs/versions/latest/features/model_visualization/n2_details/n2_details.html) of the full OpenMDAO model.
+The XDSM diagram is primarily useful for publications and presentations.
+The N2 diagram is primarily useful for debugging. Details for generating XDSM and N2 diagrams of your H2Integrate model are given below.
 
 ### XDSM diagram (static and simplified)