feat(plots): interactive plot dialog, manual layouts, and styled presets

examples/basics/state_feedback/gui/parameters.py

@@ -1,9 +1,14 @@
 import numpy as np
 import control as ct
 
-A = np.array([[0.95, 0.1], [0, 0.98]])
-B = np.array([[1], [1]])
-C = np.array([[1., 0.]])
+# 3-state coupled dynamics to generate richer state trajectories for plotting.
+A = np.array([
+    [0.95, 0.10, 0.00],
+    [0.00, 0.97, 0.08],
+    [0.00, 0.00, 0.93],
+])
+B = np.array([[1.0], [0.7], [0.4]])
+C = np.array([[1.0, 0.0, 0.0]])
 
-K = ct.place(A, B, [0.9, 0.91])
-G = np.linalg.inv(C @ np.linalg.inv(np.eye(2) - A + B @ K) @ B)
+K = ct.place(A, B, [0.86, 0.88, 0.90])
+G = np.linalg.inv(C @ np.linalg.inv(np.eye(3) - A + B @ K) @ B)

examples/basics/state_feedback/gui/project.yaml

@@ -16,9 +16,20 @@ simulation:
     - system.outputs.y
   plots:
     - title: Ref vs Output
+      mode: overlay
       signals: [step.outputs.out, system.outputs.y]
     - title: Command
+      mode: overlay
       signals: [controller.outputs.u]
+    - title: Full closed-loop (components)
+      mode: split_components
+      signals: [step.outputs.out, system.outputs.y, controller.outputs.u, system.outputs.x]
+    - title: Tracking and states
+      mode: split_signals
+      signals: [step.outputs.out, system.outputs.y, system.outputs.x]
+    - title: States only
+      mode: split_components
+      signals: [system.outputs.x]
 
 diagram:
   blocks:

pySimBlocks/core/config.py

@@ -92,12 +92,36 @@ class PlotConfig:
 
     def validate(self) -> None:
         """Verify that each plot descriptor has the required fields.
-
+
+        Classic plots require ``signals``. Manual layout presets use
+        ``layout: manual`` with a ``panels`` list instead.
+
         Raises:
-            ValueError: If a plot descriptor is missing ``"signals"`` or
-                if ``"signals"`` is not a list.
+            ValueError: If a plot descriptor is invalid.
         """
         for i, plot in enumerate(self.plots):
+            layout = str(plot.get("layout", "")).strip().lower()
+            if layout == "manual":
+                panels = plot.get("panels")
+                if not isinstance(panels, list) or not panels:
+                    raise ValueError(
+                        f"Plot #{i} (layout: manual) must define a non-empty 'panels' list"
+                    )
+                for j, panel in enumerate(panels):
+                    if not isinstance(panel, dict):
+                        raise ValueError(
+                            f"Plot #{i} panel #{j} must be a mapping"
+                        )
+                    selection = panel.get("selection")
+                    if isinstance(selection, dict) and selection:
+                        continue
+                    signals = panel.get("signals")
+                    if isinstance(signals, list) and signals:
+                        continue
+                    raise ValueError(
+                        f"Plot #{i} panel #{j} must define 'selection' or 'signals'"
+                    )
+                continue
             if "signals" not in plot:
                 raise ValueError(
                     f"Plot #{i} is missing required field 'signals'"