tensor-network-visualization 1.5.1__tar.gz → 1.5.3__tar.gz

{tensor_network_visualization-1.5.1/src/tensor_network_visualization.egg-info → tensor_network_visualization-1.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tensor-network-visualization
-Version: 1.5.1
+Version: 1.5.3
 Summary: Minimal Matplotlib visualizations for TensorKrowch, TensorNetwork, Quimb, TeNPy, and traced PyTorch/NumPy einsum tensor networks.
 Author: Alejandro Mata Ali
 License-Expression: MIT
@@ -96,6 +96,36 @@ python -m pip install tensor-network-visualization
 
 Base dependencies are only `numpy`, `matplotlib`, and `networkx`.
 
+## Documentation Map
+
+- Start here for installation and the public API overview.
+- Use [`docs/guide.md`](docs/guide.md) for workflow-oriented explanations.
+- Use [`docs/backends.md`](docs/backends.md) for backend-specific copy-paste examples.
+- Use [`examples/README.md`](examples/README.md) when you want to run the local demos from this repository.
+
+## Errors and Logging
+
+Public entry points now raise package-specific exceptions while remaining compatible with the
+built-in exception families they refine:
+
+- `VisualizationInputError`: unsupported or ambiguous network input.
+- `AxisConfigurationError`: incompatible `ax` / `view` combinations.
+- `UnsupportedEngineError`: unknown engine or backend name.
+- `TensorDataError`: unsupported or missing tensor data for `show_tensor_elements(...)`.
+- `MissingOptionalDependencyError`: missing optional backend dependency.
+
+All of them inherit from `TensorNetworkVizError`.
+
+The package logger name is `tensor_network_viz`. It installs a `logging.NullHandler()` by default,
+so importing the library does not change your application's logging configuration.
+
+```python
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+logging.getLogger("tensor_network_viz").setLevel(logging.DEBUG)
+```
+
 ### Optional extras
 
 | Need | Install |
@@ -127,8 +157,16 @@ python -m pip install -U pip
 python -m pip install "tensor-network-visualization[quimb]"
 ```
 
+Once the virtual environment is active, the `python ...` commands shown in the rest of this
+README work the same way on Windows and Linux.
+
 ## The API in One Minute
 
+`show_controls` and `show` are independent:
+
+- `show_controls=False` disables the embedded Matplotlib widgets and slider.
+- `show=False` skips automatic display and only returns `(fig, ax)`.
+
 ### `show_tensor_network`
 
 Use `show_tensor_network` for figure lifecycle:
@@ -150,7 +188,7 @@ show_tensor_network(
 - `view`: `"2d"` or `"3d"`. If omitted, it starts in `"2d"`.
 - `config`: all visual behavior lives here.
 - `ax`: render into an existing Matplotlib axis.
-- `show_controls`: if `False`, the figure is saved/rendered without the embedded control panel.
+- `show_controls`: if `False`, render a static figure without the embedded control panel.
 - `show`: if `False`, nothing is displayed automatically.
 
 ### `show_tensor_elements`
@@ -171,15 +209,23 @@ show_tensor_elements(
 
 When several tensors are present, the figure keeps one tensor active at a time and uses a slider
 to switch between them. The interactive controls are grouped: `basic` (`elements`, `magnitude`,
-`distribution`, `data`), `complex` (`real`, `imag`, `phase`), and `diagnostic` (`sign`,
-`signed_value`).
+`log_magnitude`, `distribution`, `data`), `complex` (`real`, `imag`, `phase`), and
+`diagnostic` (`sign`, `signed_value`, `sparsity`, `nan_inf`, `singular_values`, `eigen_real`,
+`eigen_imag`).
 
 - `data`: single tensor, iterable of tensors, supported backend-native tensor collections, or an
   `EinsumTrace` with live tensor values.
 - `engine`: optional backend override. If omitted, the library auto-detects it.
 - `config`: tensor-inspection behavior lives here.
+- `data` mode includes global stats, per-axis summaries, and top-k coordinates by magnitude.
+- `singular_values` renders the singular-value spectrum for the same matrixized tensor used by the
+  heatmap views and is hidden automatically when the active tensor contains `NaN` or `Inf`.
+- `eigen_real` and `eigen_imag` render the real and imaginary parts of the eigenvalues for the same
+  matrixized tensor, ordered by eigenvalue magnitude. They appear only when the active analysis
+  matrix is finite and square.
 - `ax`: render a single tensor into an existing Matplotlib axis.
-- `show_controls`: if `True`, add compact Matplotlib `group + mode` controls and, when needed, a tensor slider.
+- `show_controls`: if `True`, add compact Matplotlib `group + mode` controls and, when needed, a
+  tensor slider.
 - `show`: if `False`, nothing is displayed automatically.
 
 ### `PlotConfig`
@@ -190,11 +236,16 @@ Use `PlotConfig` for visual behavior:
 from tensor_network_viz import PlotConfig
 
 config = PlotConfig(
+    show_nodes=True,
     show_tensor_labels=True,
     show_index_labels=False,
     hover_labels=True,
     show_contraction_scheme=False,
+    contraction_scheme_cost_hover=False,
+    contraction_tensor_inspector=False,
     tensor_label_refinement="auto",
+    tensor_label_fontsize=None,
+    edge_label_fontsize=None,
 )
 ```
 
@@ -203,6 +254,7 @@ This is where you configure:
 - labels,
 - hover tooltips,
 - contraction-scheme overlays,
+- optional tensor/edge label font-size overrides,
 - styling,
 - layout iterations,
 - custom positions,
@@ -218,8 +270,19 @@ from tensor_network_viz import TensorElementsConfig
 
 config = TensorElementsConfig(
     mode="auto",
+    row_axes=None,
+    col_axes=None,
+    figsize=(7.2, 6.4),
     max_matrix_shape=(256, 256),
+    shared_color_scale=False,
+    robust_percentiles=(1.0, 99.0),
+    highlight_outliers=False,
+    outlier_zscore=3.5,
+    zero_threshold=1e-12,
+    log_magnitude_floor=1e-12,
     histogram_bins=40,
+    histogram_max_samples=100_000,
+    topk_count=8,
 )
 ```
 
@@ -228,10 +291,15 @@ This is where you configure:
 - the active inspection mode,
 - row/column axis grouping for rank > 2 tensors,
 - heatmap downsampling limits,
-- histogram sampling and bin count.
+- histogram sampling and bin count,
+- data-summary depth (`topk_count`),
+- heatmap/spectral reduction via `max_matrix_shape`,
+- optional robust/shared scaling and outlier overlays,
+- singular-value display floor and zero handling.
 
 If you want to start in a specific grouped view, pass `mode="real"`, `mode="imag"`,
-`mode="phase"`, `mode="sign"`, or `mode="signed_value"` directly in
+`mode="phase"`, `mode="log_magnitude"`, `mode="sparsity"`, `mode="nan_inf"`, `mode="sign"`,
+`mode="signed_value"`, `mode="singular_values"`, `mode="eigen_real"`, or `mode="eigen_imag"` directly in
 `TensorElementsConfig(...)`.
 
 ## Most Common Workflows
@@ -395,9 +463,8 @@ For fuller backend examples, see [docs/backends.md](docs/backends.md).
 | `show_tensor_labels` | Draw tensor names on nodes. |
 | `show_index_labels` | Draw index labels on bonds and dangling legs. |
 | `hover_labels` | Enable hover tooltips in interactive sessions. |
-| `show_contraction_scheme` | Draw contraction-step regions. |
-| `contraction_playback` | Start with playback controls enabled when controls are shown. |
-| `contraction_scheme_cost_hover` | Show cost tooltip on scheme regions. |
+| `show_contraction_scheme` | Enable the dynamic contraction slider with real node shape/color changes. |
+| `contraction_scheme_cost_hover` | Show contraction details in the slider panel. |
 | `tensor_label_refinement` | `"auto"`, `"always"`, or `"never"` for the expensive label-fit pass. |
 | `layout_iterations` | Force-layout effort. |
 | `positions` | Supply custom node coordinates. |
@@ -436,6 +503,7 @@ python examples/tensor_elements_demo.py
 | Hover tooltips do nothing | Use an interactive Matplotlib backend; hover is not useful for PNG-only runs. |
 | Big graphs are slow | Set `tensor_label_refinement="never"`, reduce `layout_iterations`, or pass `positions`. |
 | `Unsupported tensor network engine` | Install the matching extra or pass the correct backend object. |
+| `AxisConfigurationError` when passing `ax` | Use a 2D axis for `view="2d"`, a 3D axis for `view="3d"`, and only pass `ax` to `show_tensor_elements(...)` for a single tensor. |
 | `show_tensor_elements(...)` fails on TensorKrowch nodes | Materialize the node tensors first; shape-only nodes do not expose element values. |
 | `show_tensor_elements(...)` fails on manual `pair_tensor(...)` lists | Use an `EinsumTrace` with live tensors instead; manual trace steps only describe contractions. |
 | Blank / duplicate Jupyter figure | Assign `fig, ax = show_tensor_network(...)` instead of leaving the tuple as the last line. |
@@ -464,3 +532,12 @@ Run the project checks:
 ```powershell
 .\.venv\Scripts\python scripts\verify.py
 ```
+
+Useful slices:
+
+```powershell
+.\.venv\Scripts\python scripts\verify.py quality
+.\.venv\Scripts\python scripts\verify.py tests
+.\.venv\Scripts\python scripts\verify.py smoke
+.\.venv\Scripts\python scripts\verify.py package
+```

{tensor_network_visualization-1.5.1 → tensor_network_visualization-1.5.3}/README.md

@@ -45,6 +45,36 @@ python -m pip install tensor-network-visualization
 
 Base dependencies are only `numpy`, `matplotlib`, and `networkx`.
 
+## Documentation Map
+
+- Start here for installation and the public API overview.
+- Use [`docs/guide.md`](docs/guide.md) for workflow-oriented explanations.
+- Use [`docs/backends.md`](docs/backends.md) for backend-specific copy-paste examples.
+- Use [`examples/README.md`](examples/README.md) when you want to run the local demos from this repository.
+
+## Errors and Logging
+
+Public entry points now raise package-specific exceptions while remaining compatible with the
+built-in exception families they refine:
+
+- `VisualizationInputError`: unsupported or ambiguous network input.
+- `AxisConfigurationError`: incompatible `ax` / `view` combinations.
+- `UnsupportedEngineError`: unknown engine or backend name.
+- `TensorDataError`: unsupported or missing tensor data for `show_tensor_elements(...)`.
+- `MissingOptionalDependencyError`: missing optional backend dependency.
+
+All of them inherit from `TensorNetworkVizError`.
+
+The package logger name is `tensor_network_viz`. It installs a `logging.NullHandler()` by default,
+so importing the library does not change your application's logging configuration.
+
+```python
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+logging.getLogger("tensor_network_viz").setLevel(logging.DEBUG)
+```
+
 ### Optional extras
 
 | Need | Install |
@@ -76,8 +106,16 @@ python -m pip install -U pip
 python -m pip install "tensor-network-visualization[quimb]"
 ```
 
+Once the virtual environment is active, the `python ...` commands shown in the rest of this
+README work the same way on Windows and Linux.
+
 ## The API in One Minute
 
+`show_controls` and `show` are independent:
+
+- `show_controls=False` disables the embedded Matplotlib widgets and slider.
+- `show=False` skips automatic display and only returns `(fig, ax)`.
+
 ### `show_tensor_network`
 
 Use `show_tensor_network` for figure lifecycle:
@@ -99,7 +137,7 @@ show_tensor_network(
 - `view`: `"2d"` or `"3d"`. If omitted, it starts in `"2d"`.
 - `config`: all visual behavior lives here.
 - `ax`: render into an existing Matplotlib axis.
-- `show_controls`: if `False`, the figure is saved/rendered without the embedded control panel.
+- `show_controls`: if `False`, render a static figure without the embedded control panel.
 - `show`: if `False`, nothing is displayed automatically.
 
 ### `show_tensor_elements`
@@ -120,15 +158,23 @@ show_tensor_elements(
 
 When several tensors are present, the figure keeps one tensor active at a time and uses a slider
 to switch between them. The interactive controls are grouped: `basic` (`elements`, `magnitude`,
-`distribution`, `data`), `complex` (`real`, `imag`, `phase`), and `diagnostic` (`sign`,
-`signed_value`).
+`log_magnitude`, `distribution`, `data`), `complex` (`real`, `imag`, `phase`), and
+`diagnostic` (`sign`, `signed_value`, `sparsity`, `nan_inf`, `singular_values`, `eigen_real`,
+`eigen_imag`).
 
 - `data`: single tensor, iterable of tensors, supported backend-native tensor collections, or an
   `EinsumTrace` with live tensor values.
 - `engine`: optional backend override. If omitted, the library auto-detects it.
 - `config`: tensor-inspection behavior lives here.
+- `data` mode includes global stats, per-axis summaries, and top-k coordinates by magnitude.
+- `singular_values` renders the singular-value spectrum for the same matrixized tensor used by the
+  heatmap views and is hidden automatically when the active tensor contains `NaN` or `Inf`.
+- `eigen_real` and `eigen_imag` render the real and imaginary parts of the eigenvalues for the same
+  matrixized tensor, ordered by eigenvalue magnitude. They appear only when the active analysis
+  matrix is finite and square.
 - `ax`: render a single tensor into an existing Matplotlib axis.
-- `show_controls`: if `True`, add compact Matplotlib `group + mode` controls and, when needed, a tensor slider.
+- `show_controls`: if `True`, add compact Matplotlib `group + mode` controls and, when needed, a
+  tensor slider.
 - `show`: if `False`, nothing is displayed automatically.
 
 ### `PlotConfig`
@@ -139,11 +185,16 @@ Use `PlotConfig` for visual behavior:
 from tensor_network_viz import PlotConfig
 
 config = PlotConfig(
+    show_nodes=True,
     show_tensor_labels=True,
     show_index_labels=False,
     hover_labels=True,
     show_contraction_scheme=False,
+    contraction_scheme_cost_hover=False,
+    contraction_tensor_inspector=False,
     tensor_label_refinement="auto",
+    tensor_label_fontsize=None,
+    edge_label_fontsize=None,
 )
 ```
 
@@ -152,6 +203,7 @@ This is where you configure:
 - labels,
 - hover tooltips,
 - contraction-scheme overlays,
+- optional tensor/edge label font-size overrides,
 - styling,
 - layout iterations,
 - custom positions,
@@ -167,8 +219,19 @@ from tensor_network_viz import TensorElementsConfig
 
 config = TensorElementsConfig(
     mode="auto",
+    row_axes=None,
+    col_axes=None,
+    figsize=(7.2, 6.4),
     max_matrix_shape=(256, 256),
+    shared_color_scale=False,
+    robust_percentiles=(1.0, 99.0),
+    highlight_outliers=False,
+    outlier_zscore=3.5,
+    zero_threshold=1e-12,
+    log_magnitude_floor=1e-12,
     histogram_bins=40,
+    histogram_max_samples=100_000,
+    topk_count=8,
 )
 ```
 
@@ -177,10 +240,15 @@ This is where you configure:
 - the active inspection mode,
 - row/column axis grouping for rank > 2 tensors,
 - heatmap downsampling limits,
-- histogram sampling and bin count.
+- histogram sampling and bin count,
+- data-summary depth (`topk_count`),
+- heatmap/spectral reduction via `max_matrix_shape`,
+- optional robust/shared scaling and outlier overlays,
+- singular-value display floor and zero handling.
 
 If you want to start in a specific grouped view, pass `mode="real"`, `mode="imag"`,
-`mode="phase"`, `mode="sign"`, or `mode="signed_value"` directly in
+`mode="phase"`, `mode="log_magnitude"`, `mode="sparsity"`, `mode="nan_inf"`, `mode="sign"`,
+`mode="signed_value"`, `mode="singular_values"`, `mode="eigen_real"`, or `mode="eigen_imag"` directly in
 `TensorElementsConfig(...)`.
 
 ## Most Common Workflows
@@ -344,9 +412,8 @@ For fuller backend examples, see [docs/backends.md](docs/backends.md).
 | `show_tensor_labels` | Draw tensor names on nodes. |
 | `show_index_labels` | Draw index labels on bonds and dangling legs. |
 | `hover_labels` | Enable hover tooltips in interactive sessions. |
-| `show_contraction_scheme` | Draw contraction-step regions. |
-| `contraction_playback` | Start with playback controls enabled when controls are shown. |
-| `contraction_scheme_cost_hover` | Show cost tooltip on scheme regions. |
+| `show_contraction_scheme` | Enable the dynamic contraction slider with real node shape/color changes. |
+| `contraction_scheme_cost_hover` | Show contraction details in the slider panel. |
 | `tensor_label_refinement` | `"auto"`, `"always"`, or `"never"` for the expensive label-fit pass. |
 | `layout_iterations` | Force-layout effort. |
 | `positions` | Supply custom node coordinates. |
@@ -385,6 +452,7 @@ python examples/tensor_elements_demo.py
 | Hover tooltips do nothing | Use an interactive Matplotlib backend; hover is not useful for PNG-only runs. |
 | Big graphs are slow | Set `tensor_label_refinement="never"`, reduce `layout_iterations`, or pass `positions`. |
 | `Unsupported tensor network engine` | Install the matching extra or pass the correct backend object. |
+| `AxisConfigurationError` when passing `ax` | Use a 2D axis for `view="2d"`, a 3D axis for `view="3d"`, and only pass `ax` to `show_tensor_elements(...)` for a single tensor. |
 | `show_tensor_elements(...)` fails on TensorKrowch nodes | Materialize the node tensors first; shape-only nodes do not expose element values. |
 | `show_tensor_elements(...)` fails on manual `pair_tensor(...)` lists | Use an `EinsumTrace` with live tensors instead; manual trace steps only describe contractions. |
 | Blank / duplicate Jupyter figure | Assign `fig, ax = show_tensor_network(...)` instead of leaving the tuple as the last line. |
@@ -413,3 +481,12 @@ Run the project checks:
 ```powershell
 .\.venv\Scripts\python scripts\verify.py
 ```
+
+Useful slices:
+
+```powershell
+.\.venv\Scripts\python scripts\verify.py quality
+.\.venv\Scripts\python scripts\verify.py tests
+.\.venv\Scripts\python scripts\verify.py smoke
+.\.venv\Scripts\python scripts\verify.py package
+```

{tensor_network_visualization-1.5.1 → tensor_network_visualization-1.5.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tensor-network-visualization"
-version = "1.5.1"
+version = "1.5.3"
 description = "Minimal Matplotlib visualizations for TensorKrowch, TensorNetwork, Quimb, TeNPy, and traced PyTorch/NumPy einsum tensor networks."
 authors = [{ name = "Alejandro Mata Ali" }]
 readme = "README.md"
@@ -60,8 +60,12 @@ tensor_network_viz = ["py.typed"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-addopts = "-p no:cacheprovider"
+addopts = "-p no:cacheprovider -m \"not perf\""
 pythonpath = ["src"]
+markers = [
+    "perf: runtime-sensitive regression checks and throughput guards",
+    "smoke: lightweight render smoke checks",
+]
 
 [tool.ruff]
 line-length = 100
@@ -77,6 +81,4 @@ select = ["E", "F", "I", "B", "UP", "C4", "SIM", "RUF100"]
 "examples/**/*.py" = ["E402"]
 # Repo-root bench helpers insert ``src`` on sys.path before third-party imports.
 "scripts/**/*.py" = ["E402"]
-# Draw/layout splits mirror the old monolith: submodule star-import of tuning constants.
-"src/tensor_network_viz/_core/draw/*.py" = ["F403", "F405"]
 "src/tensor_network_viz/_core/layout/body.py" = ["F403", "F405"]

{tensor_network_visualization-1.5.1 → tensor_network_visualization-1.5.3/src/tensor_network_visualization.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tensor-network-visualization
-Version: 1.5.1
+Version: 1.5.3
 Summary: Minimal Matplotlib visualizations for TensorKrowch, TensorNetwork, Quimb, TeNPy, and traced PyTorch/NumPy einsum tensor networks.
 Author: Alejandro Mata Ali
 License-Expression: MIT
@@ -96,6 +96,36 @@ python -m pip install tensor-network-visualization
 
 Base dependencies are only `numpy`, `matplotlib`, and `networkx`.
 
+## Documentation Map
+
+- Start here for installation and the public API overview.
+- Use [`docs/guide.md`](docs/guide.md) for workflow-oriented explanations.
+- Use [`docs/backends.md`](docs/backends.md) for backend-specific copy-paste examples.
+- Use [`examples/README.md`](examples/README.md) when you want to run the local demos from this repository.
+
+## Errors and Logging
+
+Public entry points now raise package-specific exceptions while remaining compatible with the
+built-in exception families they refine:
+
+- `VisualizationInputError`: unsupported or ambiguous network input.
+- `AxisConfigurationError`: incompatible `ax` / `view` combinations.
+- `UnsupportedEngineError`: unknown engine or backend name.
+- `TensorDataError`: unsupported or missing tensor data for `show_tensor_elements(...)`.
+- `MissingOptionalDependencyError`: missing optional backend dependency.
+
+All of them inherit from `TensorNetworkVizError`.
+
+The package logger name is `tensor_network_viz`. It installs a `logging.NullHandler()` by default,
+so importing the library does not change your application's logging configuration.
+
+```python
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+logging.getLogger("tensor_network_viz").setLevel(logging.DEBUG)
+```
+
 ### Optional extras
 
 | Need | Install |
@@ -127,8 +157,16 @@ python -m pip install -U pip
 python -m pip install "tensor-network-visualization[quimb]"
 ```
 
+Once the virtual environment is active, the `python ...` commands shown in the rest of this
+README work the same way on Windows and Linux.
+
 ## The API in One Minute
 
+`show_controls` and `show` are independent:
+
+- `show_controls=False` disables the embedded Matplotlib widgets and slider.
+- `show=False` skips automatic display and only returns `(fig, ax)`.
+
 ### `show_tensor_network`
 
 Use `show_tensor_network` for figure lifecycle:
@@ -150,7 +188,7 @@ show_tensor_network(
 - `view`: `"2d"` or `"3d"`. If omitted, it starts in `"2d"`.
 - `config`: all visual behavior lives here.
 - `ax`: render into an existing Matplotlib axis.
-- `show_controls`: if `False`, the figure is saved/rendered without the embedded control panel.
+- `show_controls`: if `False`, render a static figure without the embedded control panel.
 - `show`: if `False`, nothing is displayed automatically.
 
 ### `show_tensor_elements`
@@ -171,15 +209,23 @@ show_tensor_elements(
 
 When several tensors are present, the figure keeps one tensor active at a time and uses a slider
 to switch between them. The interactive controls are grouped: `basic` (`elements`, `magnitude`,
-`distribution`, `data`), `complex` (`real`, `imag`, `phase`), and `diagnostic` (`sign`,
-`signed_value`).
+`log_magnitude`, `distribution`, `data`), `complex` (`real`, `imag`, `phase`), and
+`diagnostic` (`sign`, `signed_value`, `sparsity`, `nan_inf`, `singular_values`, `eigen_real`,
+`eigen_imag`).
 
 - `data`: single tensor, iterable of tensors, supported backend-native tensor collections, or an
   `EinsumTrace` with live tensor values.
 - `engine`: optional backend override. If omitted, the library auto-detects it.
 - `config`: tensor-inspection behavior lives here.
+- `data` mode includes global stats, per-axis summaries, and top-k coordinates by magnitude.
+- `singular_values` renders the singular-value spectrum for the same matrixized tensor used by the
+  heatmap views and is hidden automatically when the active tensor contains `NaN` or `Inf`.
+- `eigen_real` and `eigen_imag` render the real and imaginary parts of the eigenvalues for the same
+  matrixized tensor, ordered by eigenvalue magnitude. They appear only when the active analysis
+  matrix is finite and square.
 - `ax`: render a single tensor into an existing Matplotlib axis.
-- `show_controls`: if `True`, add compact Matplotlib `group + mode` controls and, when needed, a tensor slider.
+- `show_controls`: if `True`, add compact Matplotlib `group + mode` controls and, when needed, a
+  tensor slider.
 - `show`: if `False`, nothing is displayed automatically.
 
 ### `PlotConfig`
@@ -190,11 +236,16 @@ Use `PlotConfig` for visual behavior:
 from tensor_network_viz import PlotConfig
 
 config = PlotConfig(
+    show_nodes=True,
     show_tensor_labels=True,
     show_index_labels=False,
     hover_labels=True,
     show_contraction_scheme=False,
+    contraction_scheme_cost_hover=False,
+    contraction_tensor_inspector=False,
     tensor_label_refinement="auto",
+    tensor_label_fontsize=None,
+    edge_label_fontsize=None,
 )
 ```
 
@@ -203,6 +254,7 @@ This is where you configure:
 - labels,
 - hover tooltips,
 - contraction-scheme overlays,
+- optional tensor/edge label font-size overrides,
 - styling,
 - layout iterations,
 - custom positions,
@@ -218,8 +270,19 @@ from tensor_network_viz import TensorElementsConfig
 
 config = TensorElementsConfig(
     mode="auto",
+    row_axes=None,
+    col_axes=None,
+    figsize=(7.2, 6.4),
     max_matrix_shape=(256, 256),
+    shared_color_scale=False,
+    robust_percentiles=(1.0, 99.0),
+    highlight_outliers=False,
+    outlier_zscore=3.5,
+    zero_threshold=1e-12,
+    log_magnitude_floor=1e-12,
     histogram_bins=40,
+    histogram_max_samples=100_000,
+    topk_count=8,
 )
 ```
 
@@ -228,10 +291,15 @@ This is where you configure:
 - the active inspection mode,
 - row/column axis grouping for rank > 2 tensors,
 - heatmap downsampling limits,
-- histogram sampling and bin count.
+- histogram sampling and bin count,
+- data-summary depth (`topk_count`),
+- heatmap/spectral reduction via `max_matrix_shape`,
+- optional robust/shared scaling and outlier overlays,
+- singular-value display floor and zero handling.
 
 If you want to start in a specific grouped view, pass `mode="real"`, `mode="imag"`,
-`mode="phase"`, `mode="sign"`, or `mode="signed_value"` directly in
+`mode="phase"`, `mode="log_magnitude"`, `mode="sparsity"`, `mode="nan_inf"`, `mode="sign"`,
+`mode="signed_value"`, `mode="singular_values"`, `mode="eigen_real"`, or `mode="eigen_imag"` directly in
 `TensorElementsConfig(...)`.
 
 ## Most Common Workflows
@@ -395,9 +463,8 @@ For fuller backend examples, see [docs/backends.md](docs/backends.md).
 | `show_tensor_labels` | Draw tensor names on nodes. |
 | `show_index_labels` | Draw index labels on bonds and dangling legs. |
 | `hover_labels` | Enable hover tooltips in interactive sessions. |
-| `show_contraction_scheme` | Draw contraction-step regions. |
-| `contraction_playback` | Start with playback controls enabled when controls are shown. |
-| `contraction_scheme_cost_hover` | Show cost tooltip on scheme regions. |
+| `show_contraction_scheme` | Enable the dynamic contraction slider with real node shape/color changes. |
+| `contraction_scheme_cost_hover` | Show contraction details in the slider panel. |
 | `tensor_label_refinement` | `"auto"`, `"always"`, or `"never"` for the expensive label-fit pass. |
 | `layout_iterations` | Force-layout effort. |
 | `positions` | Supply custom node coordinates. |
@@ -436,6 +503,7 @@ python examples/tensor_elements_demo.py
 | Hover tooltips do nothing | Use an interactive Matplotlib backend; hover is not useful for PNG-only runs. |
 | Big graphs are slow | Set `tensor_label_refinement="never"`, reduce `layout_iterations`, or pass `positions`. |
 | `Unsupported tensor network engine` | Install the matching extra or pass the correct backend object. |
+| `AxisConfigurationError` when passing `ax` | Use a 2D axis for `view="2d"`, a 3D axis for `view="3d"`, and only pass `ax` to `show_tensor_elements(...)` for a single tensor. |
 | `show_tensor_elements(...)` fails on TensorKrowch nodes | Materialize the node tensors first; shape-only nodes do not expose element values. |
 | `show_tensor_elements(...)` fails on manual `pair_tensor(...)` lists | Use an `EinsumTrace` with live tensors instead; manual trace steps only describe contractions. |
 | Blank / duplicate Jupyter figure | Assign `fig, ax = show_tensor_network(...)` instead of leaving the tuple as the last line. |
@@ -464,3 +532,12 @@ Run the project checks:
 ```powershell
 .\.venv\Scripts\python scripts\verify.py
 ```
+
+Useful slices:
+
+```powershell
+.\.venv\Scripts\python scripts\verify.py quality
+.\.venv\Scripts\python scripts\verify.py tests
+.\.venv\Scripts\python scripts\verify.py smoke
+.\.venv\Scripts\python scripts\verify.py package
+```

{tensor_network_visualization-1.5.1 → tensor_network_visualization-1.5.3}/src/tensor_network_visualization.egg-info/SOURCES.txt

@@ -7,15 +7,24 @@ src/tensor_network_visualization.egg-info/dependency_links.txt
 src/tensor_network_visualization.egg-info/requires.txt
 src/tensor_network_visualization.egg-info/top_level.txt
 src/tensor_network_viz/__init__.py
+src/tensor_network_viz/_contraction_viewer_style.py
+src/tensor_network_viz/_contraction_viewer_ui.py
 src/tensor_network_viz/_engine_specs.py
+src/tensor_network_viz/_input_inspection.py
+src/tensor_network_viz/_interactive_scene.py
+src/tensor_network_viz/_logging.py
+src/tensor_network_viz/_matplotlib_state.py
 src/tensor_network_viz/_registry.py
+src/tensor_network_viz/_tensor_elements_controller.py
 src/tensor_network_viz/_tensor_elements_data.py
 src/tensor_network_viz/_tensor_elements_payloads.py
+src/tensor_network_viz/_tensor_elements_rendering.py
 src/tensor_network_viz/_tensor_elements_support.py
 src/tensor_network_viz/_typing.py
 src/tensor_network_viz/_ui_utils.py
 src/tensor_network_viz/config.py
 src/tensor_network_viz/contraction_viewer.py
+src/tensor_network_viz/exceptions.py
 src/tensor_network_viz/interactive_viewer.py
 src/tensor_network_viz/py.typed
 src/tensor_network_viz/tensor_elements.py
@@ -45,6 +54,7 @@ src/tensor_network_viz/_core/draw/edges.py
 src/tensor_network_viz/_core/draw/fonts_and_scale.py
 src/tensor_network_viz/_core/draw/graph_pipeline.py
 src/tensor_network_viz/_core/draw/hover.py
+src/tensor_network_viz/_core/draw/label_descriptors.py
 src/tensor_network_viz/_core/draw/labels_misc.py
 src/tensor_network_viz/_core/draw/pick_distance.py
 src/tensor_network_viz/_core/draw/plotter.py
@@ -63,6 +73,14 @@ src/tensor_network_viz/_core/layout/geometry.py
 src/tensor_network_viz/_core/layout/parameters.py
 src/tensor_network_viz/_core/layout/positions.py
 src/tensor_network_viz/_core/layout/types.py
+src/tensor_network_viz/_interaction/__init__.py
+src/tensor_network_viz/_interaction/bridge.py
+src/tensor_network_viz/_interaction/controller.py
+src/tensor_network_viz/_interaction/controls.py
+src/tensor_network_viz/_interaction/scheme.py
+src/tensor_network_viz/_interaction/state.py
+src/tensor_network_viz/_interaction/tensor_inspector.py
+src/tensor_network_viz/_interaction/views.py
 src/tensor_network_viz/einsum_module/__init__.py
 src/tensor_network_viz/einsum_module/_backend.py
 src/tensor_network_viz/einsum_module/_equation.py
@@ -80,6 +98,7 @@ src/tensor_network_viz/tenpy/explicit.py
 src/tensor_network_viz/tenpy/graph.py
 src/tensor_network_viz/tenpy/renderer.py
 src/tensor_network_viz/tensorkrowch/__init__.py
+src/tensor_network_viz/tensorkrowch/_history.py
 src/tensor_network_viz/tensorkrowch/graph.py
 src/tensor_network_viz/tensorkrowch/renderer.py
 src/tensor_network_viz/tensornetwork/__init__.py
@@ -89,6 +108,7 @@ tests/test_ci_workflow.py
 tests/test_contraction_cost.py
 tests/test_contraction_groups_once.py
 tests/test_contraction_scheme.py
+tests/test_contraction_scheme_api.py
 tests/test_contraction_viewer.py
 tests/test_demo_cli_scheme.py
 tests/test_draw_performance.py
@@ -104,10 +124,13 @@ tests/test_graph_cache.py
 tests/test_integration_einsum.py
 tests/test_integration_tensorkrowch.py
 tests/test_integration_tensornetwork.py
+tests/test_interaction_controls.py
+tests/test_interaction_state.py
 tests/test_label_draw_metrics_perf.py
 tests/test_label_format.py
 tests/test_layout_core.py
 tests/test_lazy_imports.py
+tests/test_logging_and_exceptions.py
 tests/test_node_degrees_perf.py
 tests/test_packaging_metadata.py
 tests/test_plotting.py