Merge branch 'dev' into Pytest-Setup

Author: mariobehling

.agents/context/backend.md

@@ -14,7 +14,7 @@
 ## Coding Rules
 
 - Follow PEP 8, format with `black py` (v23.1.0), 80-char lines
-- Python >= 3.8 compatibility
+- Python >= 3.12 compatibility
 - Use `@pytorch_wrap` on all `Visdom` methods
 - Use `warn_once()` for deprecation warnings
 

.github/actions/prepare/action.yml

@@ -12,7 +12,7 @@ inputs:
   python-version:
     description: 'Python version to use'
     required: false
-    default: '3.10'
+    default: '3.12'
 
 runs:
   using: "composite"

.github/workflows/deploy-docs.yml

@@ -52,4 +52,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128

.github/workflows/process-changes.yml

@@ -154,7 +154,7 @@ jobs:
     needs: install-and-build
     strategy:
       matrix:
-        python: ['3.10', '3.11', '3.12']
+        python: ['3.12', '3.13']
     steps:
       - name: "Checkout Repository"
         uses: actions/checkout@v7.0.0

AGENTS.md

@@ -4,7 +4,7 @@
 # AGENTS instructions
 
 Visdom: Python client + Tornado server + React frontend for live data visualization.
-Version `0.2.4` · Python >= 3.8 · Apache 2.0
+Version `0.2.4` · Python >= 3.12 · Apache 2.0
 
 ## Setup
 

README.md

@@ -287,6 +287,7 @@ The following API is currently supported:
 - [`vis.line`](#visline)     : line plots
 - [`vis.stem`](#visstem)     : stem plots
 - [`vis.heatmap`](#visheatmap)  : heatmap plots
+- [`vis.confusion_matrix`](#visconfusion_matrix)  : confusion matrix plots
 - [`vis.bar`](#visbar)  : bar graphs
 - [`vis.histogram`](#vishistogram) : histograms
 - [`vis.histogram2d`](#vishistogram2d) : 2D histograms (density maps)
@@ -297,6 +298,7 @@ The following API is currently supported:
 - [`vis.contour`](#viscontour)  : contour plots
 - [`vis.quiver`](#visquiver)   : quiver plots
 - [`vis.mesh`](#vismesh)     : mesh plots
+- [`vis.sankey`](#vissankey)   : sankey (flow) diagrams
 - [`vis.dual_axis_lines`](#visdual_axis_lines)     : double y axis line plots
 - [`vis.graph`](#visgraph)    : network graphs
 
@@ -578,6 +580,32 @@ The following `opts` are supported:
 - `opts.layoutopts` : `dict` of any additional options that the graph backend accepts for a layout. For example `layoutopts = {'plotly': {'legend': {'x':0, 'y':0}}}`.
 - `opts.nancolor`   : color for plotting `NaN`s. If this is `None`, `NaN`s will be plotted as transparent. (`string`; default = `None`)
 
+#### vis.confusion_matrix
+This function draws a confusion matrix for classification evaluation.
+
+It accepts either:
+- raw label vectors via `y_true` and `y_pred`, or
+- a precomputed confusion matrix via `cm`.
+
+Optional normalization can be applied with the `normalize` parameter:
+- `'true'`: normalize by row (actual class)
+- `'pred'`: normalize by column (predicted class)
+- `'all'`: normalize by total count
+
+An existing confusion matrix window can be modified with the `update` parameter:
+- `'replace'`: redraw the whole matrix in the window given by `win`
+- `'remove'`: delete the window given by `win`
+
+The following `opts` are supported:
+
+- `opts.title`       : plot title (`string`; default = `Confusion Matrix`)
+- `opts.xlabel`      : x-axis label (`string`; default = `Predicted`)
+- `opts.ylabel`      : y-axis label (`string`; default = `Actual`)
+- `opts.colormap`    : Plotly colorscale (`string`; default = `Blues`)
+- `opts.showCounts`  : show raw counts in cells (`bool`; default = `True`)
+- `opts.showPercent` : show percentages in cells (`bool`; default = `True` when normalized, `False` otherwise)
+- `opts.layoutopts`  : `dict` of any additional options that the graph backend accepts for a layout.
+
 #### vis.bar
 This function draws a regular, stacked, or grouped bar plot. It takes as
 input an `N` or `NxM` tensor `X` that specifies the height of each of the
@@ -696,6 +724,27 @@ The following `opts` are supported:
 - `opts.opacity`: opacity of polygons (`number` between 0 and 1)
 - `opts.layoutopts`  : `dict` of any additional options that the graph backend accepts for a layout. For example `layoutopts = {'plotly': {'legend': {'x':0, 'y':0}}}`.
 
+#### vis.sankey
+This function draws a Sankey (flow) diagram. Flows are defined by three
+equal-length arrays:
+
+- `source`: source node index of each link (`N` array of ints)
+- `target`: target node index of each link (`N` array of ints)
+- `value` : magnitude of each link (`N` array of non-negative numbers)
+
+`labels` is an optional list of node names. If omitted, nodes are referenced
+by their index alone.
+
+The following `opts` are supported:
+
+- `opts.labels`     : list of node labels (alternative to the `labels` arg)
+- `opts.pad`        : node padding in px (`number`; default = 15)
+- `opts.thickness`  : node thickness in px (`number`; default = 20)
+- `opts.orientation`: `'h'` (default) or `'v'`
+- `opts.nodecolor`  : node color(s) (`string` or list of strings)
+- `opts.linkcolor`  : link color(s) (`string` or list of strings)
+- `opts.layoutopts` : `dict` of any additional options that the graph backend accepts for a layout.
+
 #### vis.dual_axis_lines
 This function will create a line plot using plotly with different Y-Axis.
 

cypress/integration/pane.js

@@ -14,12 +14,14 @@ const basic_examples = [
   ['Violin Plot', 'plot_violin_basic'],
   // ["Mesh Plot", "plot_special_mesh"], // disabled due to webgl
   ['Graph Plot', 'plot_special_graph'],
+  ['Sankey Plot', 'plot_special_sankey'],
   ['Matplotlib Plot', 'misc_plot_matplot'],
   ['Latex Plot', 'misc_plot_latex'],
   ['Video Pane', 'misc_video_tensor'],
   // ["Audio Pane", "misc_audio_basic"], // bug: disabled due to inconsistent resize
   ['Properties Pane', 'properties_basic'],
   ['HTML Table', 'html_table'],
+  ['Confusion Matrix', 'plot_confusion_matrix_basic'],
 ];
 
 basic_examples.forEach((setting) => {

cypress/integration/screenshots.js

@@ -20,6 +20,7 @@ const maxDiffPixels = {
   misc_video_tensor: 5000,
   misc_video_download: 5000,
   misc_audio_basic: 5000,
+  misc_plot_latex: 3000,
 };
 
 const compare_thresholds = {
@@ -40,7 +41,7 @@ const compare_thresholds = {
   plot_bar_stacked: 200,
   plot_bar_nonstacked: 200,
   plot_special_boxplot: 200,
-  misc_plot_latex: 50,
+  misc_plot_latex: 3000,
   misc_plot_latex_update: 200,
 };
 

cypress/support/commands.js

@@ -112,4 +112,17 @@ Cypress.Commands.add('waitForPlotRender', () => {
 
 Cypress.Commands.add('waitForMathJax', () => {
   cy.wait(2000);
+  cy.window().then((win) => {
+    return new Cypress.Promise((resolve) => {
+      if (win.MathJax && win.MathJax.Hub) {
+        win.MathJax.Hub.Queue(() => resolve());
+      } else {
+        resolve();
+      }
+    });
+  });
+  cy.document().then((doc) => {
+    return cy.wrap(doc.fonts.ready, { timeout: 10000 });
+  });
+  cy.wait(2000);
 });

example/components/plot_bar.py

@@ -42,8 +42,12 @@ def plot_bar_histogram(viz, env, args):
 # 2D histogram (density)
 def plot_bar_histogram2d(viz, env, args):
     title = args[0] if len(args) > 0 else None
-    hist2d_x = np.concatenate([np.random.randn(10000) - 1.5, np.random.randn(10000) + 1.5])
-    hist2d_y = np.concatenate([np.random.randn(10000) - 1.5, np.random.randn(10000) + 1.5])
+    hist2d_x = np.concatenate(
+        [np.random.randn(10000) - 1.5, np.random.randn(10000) + 1.5]
+    )
+    hist2d_y = np.concatenate(
+        [np.random.randn(10000) - 1.5, np.random.randn(10000) + 1.5]
+    )
     viz.histogram2d(
         X=hist2d_x,
         Y=hist2d_y,