better-rtplot 0.4.14__tar.gz → 0.4.16__tar.gz

{better_rtplot-0.4.14 → better_rtplot-0.4.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: better-rtplot
-Version: 0.4.14
+Version: 0.4.16
 Summary: 
 License: MIT
 Author: jmontp
@@ -67,6 +67,12 @@ Sender and server don't have to be on the same machine — see the
 No Python needed on the viewing machine. On Windows the binary opens
 a small Tk status window showing the listening URL.
 
+Set columns per row in your sender's layout with
+`PlotRow([Plot(names=["a"]), Plot(names=["b"])], columns=2)`.
+Start the server normally; each row can use a different column count.
+See the [multi-column example](examples/05_multi_column/) for typed and
+dict forms, including a layout with two, one, and three columns.
+
 **Client** — pip install in the env that runs your script:
 
 ```bash

{better_rtplot-0.4.14 → better_rtplot-0.4.16}/README.md

@@ -43,6 +43,12 @@ Sender and server don't have to be on the same machine — see the
 No Python needed on the viewing machine. On Windows the binary opens
 a small Tk status window showing the listening URL.
 
+Set columns per row in your sender's layout with
+`PlotRow([Plot(names=["a"]), Plot(names=["b"])], columns=2)`.
+Start the server normally; each row can use a different column count.
+See the [multi-column example](examples/05_multi_column/) for typed and
+dict forms, including a layout with two, one, and three columns.
+
 **Client** — pip install in the env that runs your script:
 
 ```bash

{better_rtplot-0.4.14 → better_rtplot-0.4.16}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "better-rtplot"
-version = "0.4.14"
+version = "0.4.16"
 description = ""
 authors = ["jmontp <jmontp@umich.edu>"]
 license = "MIT"

{better_rtplot-0.4.14 → better_rtplot-0.4.16}/rtplot/client.py

@@ -164,6 +164,28 @@ class Plot:
         })
 
 
+@dataclass
+class PlotRow:
+    """A group of plots with its own column count in the browser."""
+    plots: List[Union[Plot, dict]]
+    columns: int
+
+    def to_dict(self):
+        if isinstance(self.columns, bool) or not isinstance(self.columns, int) or self.columns < 1:
+            raise ValueError("PlotRow.columns must be a positive integer")
+        if not self.plots:
+            raise ValueError("PlotRow.plots must contain at least one plot")
+        plots = [
+            p.to_dict() if hasattr(p, "to_dict") else p
+            for p in self.plots
+        ]
+        if any(not isinstance(p, dict) or "names" not in p
+               or any(k in p for k in ("plots", "controls", "non_plot_labels"))
+               for p in plots):
+            raise ValueError("PlotRow can contain only plot descriptions")
+        return {"columns": self.columns, "plots": plots}
+
+
 @dataclass
 class Button:
     id: str
@@ -455,6 +477,7 @@ def initialize_plots(plot_descriptions=1, handshake_timeout=2.0):
         - list of str: one plot, one trace per name
         - list of list of str: one plot per sublist
         - list of dict: multiple plots, each with full styling
+        - PlotRow or {"plots": [...], "columns": N}: a row with N columns
     handshake_timeout:
         Max seconds to wait for the config_ack. On timeout we print a
         warning and return (so an old server without the handshake

{better_rtplot-0.4.14 → better_rtplot-0.4.16}/rtplot/server_browser.py

@@ -98,8 +98,17 @@ parser.add_argument(
 parser.add_argument(
     "-c",
     "--column",
-    help="Create new plots in separate columns instead of rows",
-    action="store_false",
+    dest="columns",
+    help="Shortcut for --columns 2",
+    action="store_const",
+    const=2,
+)
+
+parser.add_argument(
+    "--columns",
+    type=int,
+    metavar="N",
+    help="Arrange plots in N columns (default: 1)",
 )
 
 parser.add_argument(
@@ -180,7 +189,9 @@ parser.add_argument(
 
 args = parser.parse_args()
 
-NEW_SUBPLOT_IN_ROW = args.column
+PLOT_COLUMNS = args.columns if args.columns is not None else 1
+if PLOT_COLUMNS < 1:
+    parser.error("--columns must be at least 1")
 DEBUG_TEXT_ENABLED = args.debug
 SKIP_PLOT_DATAPOINTS = args.skip
 ADAPT_SKIP_PLOT_DATAPOINTS = args.adaptable
@@ -498,34 +509,53 @@ def save_persisted_tabs():
 # Config parsing (per tab) #
 ###############################
 
+def _expand_config(config):
+    """Flatten plots in wire order while retaining explicit row boundaries."""
+    plots, controls, layout = [], [], []
+    for key, entry in config.items():
+        if "non_plot_labels" in entry:
+            continue
+        if "plots" in entry:
+            columns = entry.get("columns")
+            children = entry["plots"]
+            if isinstance(columns, bool) or not isinstance(columns, int) or columns < 1:
+                raise ValueError("Plot row columns must be a positive integer")
+            if not isinstance(children, list) or not children:
+                raise ValueError("Plot row plots must be a non-empty list")
+            indices = []
+            for i, child in enumerate(children):
+                if (not isinstance(child, dict) or "names" not in child
+                        or any(k in child for k in ("plots", "controls", "non_plot_labels"))):
+                    raise ValueError("Plot rows can contain only plot descriptions")
+                indices.append(len(plots))
+                plots.append((f"{key}/{i}", child))
+            layout.append({"kind": "row", "columns": columns, "plots": indices})
+        elif "controls" in entry:
+            layout.append({"kind": "controls", "index": len(controls)})
+            controls.append(entry["controls"])
+        else:
+            layout.append({"kind": "plot", "index": len(plots)})
+            plots.append((key, entry))
+    return plots, controls, layout
+
+
 def parse_config(tab: Tab, json_config):
     """Translate a client plot config into the tab's buffer/trace metadata."""
     traces_per_plot = []
     trace_info = []
-    control_rows = []
     slider_values = {}
     text_values = {}
-    layout = []
+    plot_entries, control_rows, layout = _expand_config(json_config)
     num_datapoints_in_plot = DEFAULT_NUM_DATAPOINTS_IN_PLOT
 
-    plot_counter = 0
-    for plot_description in json_config.values():
-        # Legacy non_plot_labels rows — save-to-parquet is gone, but we
-        # accept the shape so old client scripts don't crash.
-        if "non_plot_labels" in plot_description:
-            continue
-
-        if "controls" in plot_description:
-            row = plot_description["controls"]
-            for element in row:
-                if element.get("type") in ("slider", "dial") and "value" in element:
-                    slider_values[element["id"]] = float(element["value"])
-                elif element.get("type") == "text_input":
-                    text_values[element["id"]] = str(element.get("value", ""))
-            layout.append({"kind": "controls", "index": len(control_rows)})
-            control_rows.append(row)
-            continue
+    for row in control_rows:
+        for element in row:
+            if element.get("type") in ("slider", "dial") and "value" in element:
+                slider_values[element["id"]] = float(element["value"])
+            elif element.get("type") == "text_input":
+                text_values[element["id"]] = str(element.get("value", ""))
 
+    for plot_counter, (_, plot_description) in enumerate(plot_entries):
         trace_names = plot_description["names"]
         traces_per_plot.append(len(trace_names))
 
@@ -535,9 +565,6 @@ def parse_config(tab: Tab, json_config):
         for name in trace_names:
             trace_info.append((name, plot_counter))
 
-        layout.append({"kind": "plot", "index": plot_counter})
-        plot_counter += 1
-
     tab.traces_per_plot = traces_per_plot
     tab.trace_labels = trace_info
     tab.control_rows = control_rows
@@ -578,11 +605,7 @@ def parse_config(tab: Tab, json_config):
 def build_config_message(tab: Tab, config_dict) -> dict:
     """Convert the client-supplied OrderedDict into a JSON-friendly message."""
     plots = []
-    for key, plot_description in config_dict.items():
-        if "non_plot_labels" in plot_description:
-            continue
-        if "controls" in plot_description:
-            continue
+    for key, plot_description in _expand_config(config_dict)[0]:
         plots.append(
             {
                 "key": key,
@@ -607,7 +630,8 @@ def build_config_message(tab: Tab, config_dict) -> dict:
         "slider_values": dict(tab.slider_values),
         "text_values": dict(tab.text_values),
         "display_values": dict(tab.display_values),
-        "row_layout": bool(NEW_SUBPLOT_IN_ROW),
+        "columns": PLOT_COLUMNS,
+        "row_layout": PLOT_COLUMNS == 1,
     }
 
 
@@ -1519,7 +1543,9 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
                font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; }
   #plots { display: flex; flex-direction: column; gap: 12px;
            max-width: 900px; margin: 0 auto; padding: 20px 16px; }
-  .plot-wrap { background: #fff; border: 1px solid #ddd; border-radius: 4px; padding: 8px; }
+  .plot-row { display: grid; grid-template-columns: repeat(var(--plot-columns, 1), minmax(320px, 1fr));
+              gap: 12px; min-width: 0; overflow-x: auto; }
+  .plot-wrap { background: #fff; border: 1px solid #ddd; border-radius: 4px; padding: 8px; min-width: 0; }
   .snap-footer { text-align: center; font-size: 12px; color: #999; padding: 8px 0 20px; }
   .snap-footer a { color: #2a5db0; text-decoration: none; }
   .snap-footer a:hover { text-decoration: underline; }
@@ -1539,6 +1565,17 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
 (function () {
   const SNAP = __SNAPSHOT_JSON__;
   const plotsDiv = document.getElementById('plots');
+  const layout = SNAP.layout || SNAP.plots.map((_, i) => ({kind: 'plot', index: i}));
+  const maxColumns = Math.max(1, ...layout.map(entry =>
+    entry.kind === 'row' ? entry.columns : (entry.kind === 'plot' ? SNAP.columns || 1 : 1)));
+  plotsDiv.style.maxWidth = `${900 * maxColumns}px`;
+  function newRow(columns) {
+    const row = document.createElement('div');
+    row.className = 'plot-row';
+    row.style.setProperty('--plot-columns', columns);
+    plotsDiv.appendChild(row);
+    return row;
+  }
   const COLOR_MAP = { r:'rgb(255,0,0)', g:'rgb(0,200,0)', b:'rgb(0,0,255)',
                       c:'rgb(0,200,200)', m:'rgb(200,0,200)',
                       y:'rgb(200,200,0)', k:'rgb(0,0,0)' };
@@ -1551,7 +1588,7 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
   }
   const plots = [];
   let traceOffset = 0;
-  SNAP.plots.forEach(function (pcfg) {
+  function buildPlot(pcfg, parent) {
     const xrange = SNAP.num_samples;
     const xs = new Float64Array(xrange);
     for (let i = 0; i < xrange; i++) xs[i] = i;
@@ -1571,14 +1608,14 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
     }
     const wrap = document.createElement('div');
     wrap.className = 'plot-wrap';
-    plotsDiv.appendChild(wrap);
+    parent.appendChild(wrap);
     const data = [xs];
     for (let t = 0; t < traceCount; t++) {
       const src = SNAP.trace_data[traceOffset + t];
       data.push(Float64Array.from(src));
     }
     const opts = {
-      width: Math.max(640, plotsDiv.clientWidth - 40),
+      width: Math.max(240, wrap.clientWidth - 16),
       height: 260,
       title: pcfg.title || '',
       scales: {
@@ -1591,9 +1628,23 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
       cursor: { drag: { x: true, y: false } },
     };
     const u = new uPlot(opts, data, wrap);
-    plots.push({ uplot: u, data: data, xs: xs, xrange: xrange,
+    plots.push({ uplot: u, wrap: wrap, data: data, xs: xs, xrange: xrange,
                  traceCount: traceCount, startIdx: traceOffset });
     traceOffset += traceCount;
+  }
+  let implicitRow = null;
+  layout.forEach(entry => {
+    if (entry.kind === 'plot') {
+      if (!implicitRow) implicitRow = newRow(SNAP.columns || 1);
+      buildPlot(SNAP.plots[entry.index], implicitRow);
+    } else if (entry.kind === 'row') {
+      implicitRow = null;
+      const row = newRow(entry.columns);
+      entry.plots.forEach(index => buildPlot(SNAP.plots[index], row));
+    } else {
+      // Snapshots omit controls, but retain the row break around them.
+      implicitRow = null;
+    }
   });
   renderMathInElement(plotsDiv, {
     delimiters: [
@@ -1625,7 +1676,7 @@ _SNAPSHOT_TEMPLATE = """<!doctype html>
   window.addEventListener('resize', function () {
     plots.forEach(function (p) {
       p.uplot.setSize({
-        width: Math.max(640, plotsDiv.clientWidth - 40),
+        width: Math.max(240, p.wrap.clientWidth - 16),
         height: 260,
       });
     });
@@ -1685,9 +1736,7 @@ def _build_snapshot_html(tab: Tab, animate: bool) -> str:
 
     plots = []
     cfg = tab.config_dict or OrderedDict()
-    for key, plot_description in cfg.items():
-        if "non_plot_labels" in plot_description or "controls" in plot_description:
-            continue
+    for key, plot_description in _expand_config(cfg)[0]:
         plots.append({
             "key": key,
             "names": plot_description.get("names", []),
@@ -1707,6 +1756,8 @@ def _build_snapshot_html(tab: Tab, animate: bool) -> str:
 
     payload = {
         "plots": plots,
+        "columns": PLOT_COLUMNS,
+        "layout": tab.layout,
         "num_samples": int(hi - lo),
         "trace_data": trace_data,
         "animate": bool(animate),

{better_rtplot-0.4.14 → better_rtplot-0.4.16}/rtplot/static/index.html

@@ -62,10 +62,9 @@
   #ws-status { font-size: calc(12px * var(--ui-scale)); color: #666; margin-left: auto; }
 
   /* -------- Plots + controls (existing) -------- */
-  #plots { display: flex; padding: 12px; gap: 12px; }
-  #plots.row { flex-direction: column; }
-  #plots.col { flex-direction: row; flex-wrap: wrap; }
-  .plot-wrap { background: #fff; border: 1px solid #ddd; border-radius: 4px; padding: 8px; flex: 1 1 auto; min-width: 320px; }
+  #plots { display: flex; flex-direction: column; padding: 12px; gap: 12px; }
+  .plot-row { display: grid; grid-template-columns: repeat(var(--plot-columns, 1), minmax(320px, 1fr)); gap: 12px; min-width: 0; overflow-x: auto; }
+  .plot-wrap { background: #fff; border: 1px solid #ddd; border-radius: 4px; padding: 8px; min-width: 0; }
   .plot-title { font-size: 13px; font-weight: 600; margin: 0 0 4px 4px; color: #333; }
   #empty-state { padding: 28px 32px; color: #888; font-size: calc(14px * var(--ui-scale)); font-style: italic; }
   /* Persistent banner the server raises when a client-supplied plot
@@ -823,7 +822,7 @@
         plotsDiv.appendChild(d);
       }
 
-      function buildOnePlot(pcfg, rowLayout, traceOffset) {
+      function buildOnePlot(pcfg, rowLayout, traceOffset, parent) {
         const xrange = pcfg.xrange || 200;
         const xs = new Float64Array(xrange);
         for (let i = 0; i < xrange; i++) xs[i] = i;
@@ -853,8 +852,12 @@
         const plotHeight = (Number.isFinite(heightMul) && heightMul > 0)
           ? Math.round(baseHeight * heightMul)
           : baseHeight;
+        const wrap = document.createElement('div');
+        wrap.className = 'plot-wrap';
+        parent.appendChild(wrap);
+
         const opts = {
-          width: Math.max(640, plotsDiv.clientWidth - 40),
+          width: Math.max(240, wrap.clientWidth - 16),
           height: plotHeight,
           title: pcfg.title || '',
           scales: {
@@ -870,10 +873,6 @@
           cursor: { drag: { x: false, y: false } },
         };
 
-        const wrap = document.createElement('div');
-        wrap.className = 'plot-wrap';
-        plotsDiv.appendChild(wrap);
-
         const buffers = [];
         for (let t = 0; t < traceCount; t++) {
           const buf = new Float32Array(xrange);
@@ -887,6 +886,7 @@
         const u = new uPlot(opts, initialData, wrap);
         plots.push({
           uplot: u,
+          wrap: wrap,
           xs: xs,
           traceCount: traceCount,
           startIdx: traceOffset,
@@ -899,8 +899,14 @@
 
       function buildPlots(cfg) {
         destroyPlots();
-        plotsDiv.classList.toggle('row', cfg.row_layout);
-        plotsDiv.classList.toggle('col', !cfg.row_layout);
+        const columns = Number(cfg.columns) || (cfg.row_layout === false ? 2 : 1);
+        function newRow(count) {
+          const row = document.createElement('div');
+          row.className = 'plot-row';
+          row.style.setProperty('--plot-columns', Math.max(1, Math.floor(count)));
+          plotsDiv.appendChild(row);
+          return row;
+        }
 
         const controls = cfg.controls || [];
         const layout = (cfg.layout && cfg.layout.length)
@@ -909,12 +915,21 @@
               .concat(controls.map((_, idx) => ({ kind: 'controls', index: idx })));
 
         let traceOffset = 0;
+        let implicitRow = null;
         layout.forEach(entry => {
           if (entry.kind === 'plot') {
             const pcfg = cfg.plots[entry.index];
             if (!pcfg) return;
-            traceOffset += buildOnePlot(pcfg, cfg.row_layout, traceOffset);
+            if (!implicitRow) implicitRow = newRow(columns);
+            traceOffset += buildOnePlot(pcfg, columns === 1, traceOffset, implicitRow);
+          } else if (entry.kind === 'row') {
+            implicitRow = null;
+            const row = newRow(entry.columns);
+            entry.plots.forEach(index => {
+              traceOffset += buildOnePlot(cfg.plots[index], entry.columns === 1, traceOffset, row);
+            });
           } else if (entry.kind === 'controls') {
+            implicitRow = null;
             const row = controls[entry.index];
             if (!row) return;
             plotsDiv.appendChild(buildControlRow(row));
@@ -1366,7 +1381,7 @@
       window.addEventListener('resize', () => {
         plots.forEach(p => {
           p.uplot.setSize({
-            width: Math.max(640, plotsDiv.clientWidth - 40),
+            width: Math.max(240, p.wrap.clientWidth - 16),
             height: p.height,
           });
         });