docs: adding plottly support to gallery examples

.github/workflows/doc-build.yml

@@ -177,6 +177,11 @@ jobs:
           sudo apt-get update
           sudo apt-get install -y poppler-utils
 
+      - name: Install ansys-sphinx-theme branch
+        shell: bash
+        run: |
+          pip install git+https://github.com/ansys/ansys-sphinx-theme.git@main
+
       - name: "Build documentation"
         shell: bash
         run: |

doc/changelog.d/2346.documentation.md

@@ -0,0 +1 @@
+docs: adding plottly support to gallery examples

doc/source/conf.py

@@ -9,11 +9,15 @@
 import ansys.tools.visualization_interface as viz_interface
 from ansys_sphinx_theme import ansys_favicon, get_version_match
 import numpy as np
+import plotly.io as pio
+from plotly.io._sg_scraper import plotly_sg_scraper
 import pyvista
 from sphinx.application import Sphinx
 from sphinx.util import logging
 from sphinx_gallery.sorting import FileNameSortKey
 
+pio.renderers.default = "sphinx_gallery"
+
 from ansys.mapdl import core as pymapdl
 from ansys.mapdl.core import __version__
 
@@ -273,7 +277,11 @@
     "backreferences_dir": None,
     # Modules for which function level galleries are created.  In
     "doc_module": "ansys-mapdl-core",
-    "image_scrapers": ("pyvista", "matplotlib"),
+    "image_scrapers": (
+        "pyvista",
+        "matplotlib",
+        plotly_sg_scraper,
+    ),
     "ignore_pattern": "flycheck*",
     "thumbnail_size": (350, 350),
     "remove_config_comments": True,
@@ -341,6 +349,8 @@
     "mapdl_commands/index": [],
 }
 
+html_js_files = ["https://cdn.plot.ly/plotly-3.0.1.min.js"]
+
 # -- Options for HTMLHelp output ---------------------------------------------
 
 # Output file base name for HTML help builder.

examples/00-mapdl-examples/2d_plate_with_a_hole.py

@@ -34,8 +34,8 @@
 """
 # sphinx_gallery_thumbnail_number = 3
 
-import matplotlib.pyplot as plt
 import numpy as np
+import plotly.graph_objects as go
 
 from ansys.mapdl.core import launch_mapdl
 
@@ -397,12 +397,24 @@ def compute_stress_con(ratio):
 # where ratio is (d/h)
 k_t_anl = 3 - 3.14 * ratios + 3.667 * ratios**2 - 1.527 * ratios**3
 
-plt.plot(ratios, k_t_anl, label=r"$K_t$ Analytical")
-plt.plot(ratios, k_t_exp, label=r"$K_t$ ANSYS")
-plt.legend()
-plt.xlabel("Ratio of Hole Diameter to Width of Plate")
-plt.ylabel("Stress Concentration")
-plt.show()
+
+# Create traces
+fig = go.Figure()
+fig.add_trace(
+    go.Scatter(x=ratios, y=k_t_anl, mode="lines", name=r"$K_t \text{ Analytical}$")
+)
+fig.add_trace(
+    go.Scatter(x=ratios, y=k_t_exp, mode="lines+markers", name=r"$K_t \text{ ANSYS}$")
+)
+
+fig.update_layout(
+    title="Analytical Comparison",
+    xaxis_title="Ratio of Hole Diameter to Width of Plate",
+    yaxis_title="Stress Concentration",
+)
+
+fig
+
 
 ###############################################################################
 # Stop mapdl

pyproject.toml

@@ -89,7 +89,7 @@ doc = [
     "nbformat==5.10.4",
     "numpydoc==1.8.0",
     "pandas==2.2.3",
-    "plotly==6.0.0",
+    "plotly==6.0.1",
     "pyiges[full]==0.3.1",
     "pypandoc==1.15",
     "pytest-sphinx==0.6.3",