WIP: Examples AGILE

Signed-off-by: Thomas Naughton <[email protected]>

examples/agile/index.rst

@@ -0,0 +1,48 @@
+.. _intersect:arch:examples:agile:
+
+Automation for Grid Interconnected-Laboratory Emulation
+=======================================================
+
+The :term:`AGILE` project (:numref:`intersect:arch:examples:agile:agile`)
+addresses the challenge of emulating and automating the emulation of the
+real-world energy system and power grid at the GRID-C laboratories. The
+emulation includes scalable power grid dynamic simulation in real-time
+edge computing resources, a small portion of the power grid represented
+in laboratories through digital twinning resources (and control nodes),
+and secure stable low latency data exchange between these resources. The
+automation includes mapping of real-world energy system and power grid
+to scalable power grid dynamic simulation and partitioning in different
+GRID-C laboratories.
+
+In the recent years, equipment, such as ESS, PV generation systems,
+inverters, fast EV chargers, electrical loads, transformers, among
+others, have been introduced in different GRID-C laboratories.
+Individual components, such as ESS or PV systems or EV chargers have
+been researched upon as a stand-alone system, without considering the
+interactions between multiple next-generation technology and/or power
+grid interactions. The latter is important to de-risk transfer of
+knowledge and technology to field. Developing the emulation of
+real-world energy system and power grid through this project will
+advance the capabilities at GRID-C and will be an enabler for it to
+become a one-of-its-kind self-driven automated smart laboratory in
+future.
+
+The :term:`Oak Ridge National Laboratory<ORNL>` project team consists of:
+
+- `Suman Debnath (Principal Investigator) <https://www.ornl.gov/staff-profile/suman-debnath>`_
+
+.. figure:: agile.png
+   :name: intersect:arch:examples:agile:agile
+   :align: center
+   :width: 800
+
+   The Automation for Grid Interconnected-Laboratory Emulation use case
+
+.. toctree::
+   :name: intersect:arch:examples:agile:architecture
+   :maxdepth: 1
+   :caption: Architecture
+
+   pat
+   sos
+   ms

examples/agile/ms.rst

@@ -0,0 +1,5 @@
+.. _intersect:arch:examples:agile:ms:
+
+Microservices Architecture
+--------------------------
+

examples/agile/pat.rst

@@ -0,0 +1,59 @@
+.. _intersect:arch:examples:agile:pat:
+
+Science Use Case Design Patterns
+--------------------------------
+
+The :term:`AGILE` science use case implements the Experiment Steering strategic
+pattern (:numref:`intersect:arch:examples:agile:pat:strategic`), as the
+experiment is the emulation of a real-world energy system and power grid
+that uses additional simulation at different granularities in a
+real-time feedback loop for steering the emulation. At the strategic
+pattern level of abstraction, the individual pattern components are as
+follows:
+
+-  The experiment plan describes the overarching interaction of :term:`PE` nodes
+   in the GRID-C laboratory performing the emulation of the US power
+   grid.
+
+-  The experiment controller is supervising and regulating the GRID-C :term:`PE`
+   nodes.
+
+-  The test performed in an experiment characterizes the emulated US
+   power grid.
+
+-  The experiment result is the power and current data gathered from the
+   GRID-C :term:`PE` nodes.
+
+.. figure:: pat/strategic.png
+   :name: intersect:arch:examples:agile:pat:strategic
+   :align: center
+
+   Experiment Steering strategic pattern for the :term:`AGILE` science use case
+
+The :term:`AGILE` science use case implements the Local Experiment Steering
+architectural pattern
+(:numref:`intersect:arch:examples:agile:pat:architectural`), as an ongoing
+emulation of a real-world energy system and power grid is guided by a
+local analysis of frequent periodic real-time experiment data in a
+simulation. At the architectural pattern level of abstraction, the
+individual pattern components are as follows:
+
+-  In addition to the properties identified by the Experiment Steering
+   strategic pattern, the local experiment controller supervises and
+   regulates the GRID-C :term:`PE` nodes in real time.
+
+-  The local analysis component is a separate NVIDIA DGX system that
+   runs the additional emulation/simulation at different granularities
+   with real-time feedback to the controller.
+
+Although different networked systems are used for control, analysis, and
+emulation, this science use case follows the Local Experiment Steering
+architectural pattern, as the control and data flow has real-time
+characteristics in the microsecond range.
+
+.. figure:: pat/architectural.png
+   :name: intersect:arch:examples:agile:pat:architectural
+   :align: center
+
+   Local Experiment Steering architectural pattern for the :term:`AGILE`
+   science use case

examples/agile/pat/strategic.drawio

@@ -0,0 +1,51 @@
+<mxfile host="app.diagrams.net" modified="2023-05-08T15:53:53.242Z" agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/113.0.0.0 Safari/537.36" etag="oBM86RuECsZNO3ce6pAx" version="21.2.9" type="device">
+  <diagram id="P3egCbBItE-vjyixLVVF" name="Page-1">
+    <mxGraphModel dx="2714" dy="1434" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" math="0" shadow="0">
+      <root>
+        <mxCell id="0" />
+        <mxCell id="1" parent="0" />
+        <mxCell id="8yW3HtKEOS8D6HbiddwS-1" value="Experiment&lt;br&gt;Plan" style="sketch=0;pointerEvents=1;shadow=0;dashed=0;html=1;strokeColor=none;fillColor=#505050;labelPosition=center;verticalLabelPosition=bottom;verticalAlign=top;outlineConnect=0;align=center;shape=mxgraph.office.concepts.document;" parent="1" vertex="1">
+          <mxGeometry x="180" y="199" width="30" height="40" as="geometry" />
+        </mxCell>
+        <mxCell id="8yW3HtKEOS8D6HbiddwS-2" value="Experiment&lt;br&gt;Controller" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;gradientColor=#ffd966;strokeColor=#d6b656;" parent="1" vertex="1">
+          <mxGeometry x="240" y="200" width="80" height="40" as="geometry" />
+        </mxCell>
+        <mxCell id="8yW3HtKEOS8D6HbiddwS-7" value="" style="endArrow=classic;html=1;rounded=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" parent="1" source="8yW3HtKEOS8D6HbiddwS-1" target="8yW3HtKEOS8D6HbiddwS-2" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="160" y="220" as="sourcePoint" />
+            <mxPoint x="430" y="310" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="8yW3HtKEOS8D6HbiddwS-9" value="" style="endArrow=classic;html=1;rounded=0;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" parent="1" source="8yW3HtKEOS8D6HbiddwS-2" target="8yW3HtKEOS8D6HbiddwS-4" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="380" y="360" as="sourcePoint" />
+            <mxPoint x="360" y="219" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="8yW3HtKEOS8D6HbiddwS-4" value="Test" style="ellipse;shape=cloud;whiteSpace=wrap;html=1;fillColor=#d5e8d4;gradientColor=#97d077;strokeColor=#82b366;" parent="1" vertex="1">
+          <mxGeometry x="350" y="200" width="80" height="40" as="geometry" />
+        </mxCell>
+        <mxCell id="8yW3HtKEOS8D6HbiddwS-11" value="Safety-/Progress-&lt;br&gt;Related Feedback" style="endArrow=classic;html=1;rounded=0;entryX=0.5;entryY=1;entryDx=0;entryDy=0;exitX=0.5;exitY=1;exitDx=0;exitDy=0;" parent="1" source="8yW3HtKEOS8D6HbiddwS-4" target="8yW3HtKEOS8D6HbiddwS-2" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="380" y="360" as="sourcePoint" />
+            <mxPoint x="430" y="310" as="targetPoint" />
+            <Array as="points">
+              <mxPoint x="390" y="270" />
+              <mxPoint x="280" y="270" />
+              <mxPoint x="280" y="260" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="Rb1cwAAZPAfeQyO3g_GR-1" value="Experiment&lt;br&gt;Result" style="sketch=0;pointerEvents=1;shadow=0;dashed=0;html=1;strokeColor=none;fillColor=#505050;labelPosition=center;verticalLabelPosition=bottom;verticalAlign=top;outlineConnect=0;align=center;shape=mxgraph.office.concepts.document;" parent="1" vertex="1">
+          <mxGeometry x="461" y="200" width="30" height="40" as="geometry" />
+        </mxCell>
+        <mxCell id="Rb1cwAAZPAfeQyO3g_GR-2" value="" style="endArrow=classic;html=1;rounded=0;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" parent="1" source="8yW3HtKEOS8D6HbiddwS-4" target="Rb1cwAAZPAfeQyO3g_GR-1" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="430" y="160" as="sourcePoint" />
+            <mxPoint x="470" y="350.67" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>

examples/agile/sos.rst

@@ -0,0 +1,53 @@
+.. _intersect:arch:examples:agile:sos:
+
+System-of-Systems Architecture
+------------------------------
+
+
+.. _intersect:arch:examples:agile:sos:physical:
+
+Physical View
+=============
+
+
+.. _intersect:arch:examples:agile:sos:logical:
+
+Logical View
+============
+
+
+.. _intersect:arch:examples:agile:sos:data:
+
+Data View
+=========
+
+
+.. _intersect:arch:examples:agile:sos:operational:
+
+Operational View
+================
+
+
+.. _intersect:arch:examples:agile:sos:user:
+
+User View
+=========
+
+
+.. _intersect:arch:examples:agile:sos:standards:
+
+Standards View
+==============
+
+
+.. _intersect:arch:examples:agile:sos:standards:internal:
+
+Internal Standards
+^^^^^^^^^^^^^^^^^^
+
+
+.. _intersect:arch:examples:agile:sos:standards:external:
+
+External Standards
+^^^^^^^^^^^^^^^^^^
+

examples/index.rst

@@ -34,3 +34,4 @@ use cases are addressed by the architecture, including how the
    :caption: Architecture Examples Catalog
 
    aam/index
+   agile/index