fix: example rendering

.github/workflows/ci_cd.yml

@@ -14,7 +14,7 @@ on:
 env:
   DPF_PORT: 21002
   DPF_START_SERVER: False
-  MAIN_PYTHON_VERSION: '3.10'
+  MAIN_PYTHON_VERSION: '3.12'
   MAPDL_PACKAGE: ghcr.io/ansys/mapdl
   MAPDL_IMAGE_VERSION_DOCS_BUILD: v24.2-ubuntu
   ON_CI: True
@@ -151,6 +151,9 @@ jobs:
 
       - name: "Run Ansys documentation building action"
         uses: ansys/actions/doc-build@v8
+        env:
+          LIBGL_ALWAYS_SOFTWARE: 1
+          PYANSYS_VISUALIZER_HTML_BACKEND: true
         with:
           requires-xvfb: true
           python-version: ${{ env.MAIN_PYTHON_VERSION }}

doc/source/common_jupyter_execute.py

@@ -24,7 +24,8 @@
 pyvista.global_theme.axes.show = True
 pyvista.global_theme.show_scalar_bar = True
 pyvista.global_theme.return_cpos = False
+pyvista.global_theme.trame.server_proxy_enabled = True
 
-pyvista.set_jupyter_backend("trame")
+pyvista.set_jupyter_backend("html")
 
 mytheme = pyvista.global_theme

doc/source/conf.py

@@ -27,13 +27,11 @@
 html_theme = "ansys_sphinx_theme"
 html_short_title = html_title = "PyMAPDL Examples"
 
-# Ensure that offscreen rendering is used for docs generation
-pyvista.OFF_SCREEN = True
 
 # necessary when building the sphinx gallery
-pyvista.BUILDING_GALLERY = True
 pymapdl.BUILDING_GALLERY = True
-os.environ["PYVISTA_BUILDING_GALLERY"] = "true"
+pyvista.BUILDING_GALLERY = True
+pyvista.OFF_SCREEN = True
 
 # specify the location of your github repo
 html_theme_options = {

doc/source/index.rst

@@ -20,7 +20,7 @@ Summary of the exposed Verification Manual Examples
 
 .. include:: ./verif-manual/index.rst
    :start-line: 8
-   :end-line: 416
+   :end-line: 417
 
 
 .. === TECHNOLOGY SHOWCASES ===

doc/source/technology_showcase_examples/techdemo-1/ex_01-tecbrakesqueal.rst

@@ -221,7 +221,7 @@ Start this example by launching MAPDL and loading the model.
    from ansys.mapdl.core.examples.downloads import download_vtk_rotor, download_tech_demo_data
 
    rotor = pyvista.read(download_vtk_rotor())
-   rotor.plot(color='w', show_edges=True)
+   rotor.plot(color='w', show_edges=True, theme=mytheme)
 
 
 1.4. Material properties
@@ -347,7 +347,7 @@ The following input shows the solution steps involved in this method:
    :hide-code:
 
    rotor1 = pyvista.read(download_tech_demo_data('td-1', 'rotor_linear_step21_unorm.vtk' ))
-   rotor1.plot(scalars='values', cmap='jet', show_edges=True)
+   rotor1.plot(scalars='values', cmap='jet', show_edges=True, theme=mytheme)
 
 
 **Figure 1.3: Mode Shape for Unstable Mode (Mode 21).**
@@ -504,7 +504,7 @@ The following inputs show the solution steps involved with this method:
    :hide-code:
 
    rotor2_21 = pyvista.read(download_tech_demo_data('td-1', 'rotor_partial_step21_unorm.vtk' ))
-   rotor2_21.plot(scalars='values', cmap='jet', show_edges=True)
+   rotor2_21.plot(scalars='values', cmap='jet', show_edges=True, theme=mytheme)
 
 
 **Figure 1.5: Mode Shape for Unstable Mode (Mode 21).**
@@ -516,7 +516,7 @@ Obtained from the  `1.6.1. Linear Non-prestressed Modal Analysis`_ .
    :hide-code:
 
    rotor2_22 = pyvista.read(download_tech_demo_data('td-1', 'rotor_partial_step22_unorm.vtk' ))
-   rotor2_22.plot(scalars='values', cmap='jet', show_edges=True)
+   rotor2_22.plot(scalars='values', cmap='jet', show_edges=True, theme=mytheme)
 
 
 **Figure 1.6: Mode Shape for Unstable Mode (Mode 21).**
@@ -662,7 +662,7 @@ Following is the process for solving a brake-squeal problem using this method:
    :hide-code:
 
    rotor3_21 = pyvista.read(download_tech_demo_data('td-1', 'rotor_non_linear_step21_unorm.vtk' )) 
-   rotor3_21.plot(scalars='values', cmap='jet', show_edges=True)
+   rotor3_21.plot(scalars='values', cmap='jet', show_edges=True, theme=mytheme)
 
 
 
@@ -674,7 +674,7 @@ Following is the process for solving a brake-squeal problem using this method:
    :hide-code:
 
    rotor3_22 = pyvista.read(download_tech_demo_data('td-1', 'rotor_non_linear_step22_unorm.vtk' )) 
-   rotor3_22.plot(scalars='values', cmap='jet', show_edges=True)
+   rotor3_22.plot(scalars='values', cmap='jet', show_edges=True, theme=mytheme)
 
 
 
@@ -699,7 +699,7 @@ produce a squealing noise.
    :hide-code:
 
    rotor3_21 = pyvista.read(download_tech_demo_data('td-1', 'rotor_linear_step21_unorm.vtk' ))
-   rotor3_21.plot(scalars='values', cmap='jet', show_edges=True)
+   rotor3_21.plot(scalars='values', cmap='jet', show_edges=True, theme=mytheme)
 
 
 **Figure 1.9: Mode Shape for Unstable Mode (Mode 21).**
@@ -712,7 +712,7 @@ Obtained from the  `1.6.1. Linear Non-prestressed Modal Analysis`_ .
 
    rotor3_22 = pyvista.read(download_tech_demo_data('td-1', 'rotor_linear_step22_unorm.vtk' ))
    rotor3_22['values'] = rotor3_22['values']*100
-   rotor3_22.plot(scalars='values', cmap='jet', show_edges=True)
+   rotor3_22.plot(scalars='values', cmap='jet', show_edges=True, theme=mytheme)
 
 
 **Figure 1.10: Mode Shape for Unstable Mode (Mode 22).**

doc/source/technology_showcase_examples/techdemo-20/ex_20-tecPCB.rst

@@ -2070,7 +2070,7 @@ It is recommended to use `DPF Post <dpf_post_docs_>`_.
     total_def = core.operators.math.norm_fc(displacements)
     total_def_container = total_def.outputs.fields_container()
     mesh = model.metadata.meshed_region
-    mesh.plot(total_def_container.get_field_by_time_id(1))
+    mesh.plot(total_def_container.get_field_by_time_id(1), theme=mytheme)
 
 
 

doc/source/technology_showcase_examples/techdemo-25/ex_25-tecstent.rst

@@ -373,7 +373,7 @@ This section illustrates the use of PyDPF-Core to post-process the results.
 
    file = "./source/technology_showcase_examples/techdemo-25/data/mesh.vtk"
    mesh_file = pyvista.read(file)
-   pl = pyvista.Plotter()
+   pl = pyvista.Plotter(theme=mytheme)
    pl.add_mesh(mesh_file, cmap='jet', show_scalar_bar=False, show_edges=True)
    pl.add_text("Mesh of the model", color='w')
    pl.show()
@@ -395,7 +395,7 @@ This section illustrates the use of PyDPF-Core to post-process the results.
    file = "./source/technology_showcase_examples/techdemo-25/data/u.vtk"
    u_file = pyvista.read(file)
    u_file = u_file.warp_by_scalar('U')
-   pl = pyvista.Plotter(notebook=True)
+   pl = pyvista.Plotter(theme=mytheme, notebook=True)
    pl.add_mesh(u_file, scalars = 'U', show_scalar_bar=True, scalar_bar_args={'title':'Displacements'}, cmap='jet')
    pl.add_text("Displacements of the model", color='w')
    pl.show()
@@ -423,7 +423,7 @@ This section illustrates the use of PyDPF-Core to post-process the results.
    file = "./source/technology_showcase_examples/techdemo-25/data/s_VM.vtk"
    s_VM_file = pyvista.read(file)
    s_VM_file = s_VM_file.warp_by_scalar('S_VM')
-   pl = pyvista.Plotter(notebook=True)
+   pl = pyvista.Plotter(theme=mytheme, notebook=True)
    pl.add_mesh(s_VM_file, scalars = "S_VM", show_scalar_bar=True, scalar_bar_args={'title':'Von Mises Stress'}, cmap='jet')
    pl.add_text("Von Mises Stress", color='w')
    pl.show()
@@ -475,7 +475,7 @@ This section illustrates the use of PyDPF-Core to post-process the results.
    file = "./source/technology_showcase_examples/techdemo-25/data/mesh_sco.vtk"
    mesh_sco_file = pyvista.read(file)
 
-   pl = pyvista.Plotter(shape=(1, 2))
+   pl = pyvista.Plotter(theme=mytheme, shape=(1, 2))
    pl.subplot(0, 0)
    pl.add_mesh(mesh_file, cmap="jet", show_scalar_bar=False, show_edges=True)
    pl.add_text("Mesh of the model", color='w')
@@ -502,7 +502,14 @@ This section illustrates the use of PyDPF-Core to post-process the results.
    u_stent_mesh.point_data['U_STENT'] = data
    u_stent_mesh = mesh_sco_file.point_data_to_cell_data()
    u_stent_mesh.title = 'Displacements of the stent'
-   u_stent_mesh.plot(scalars='U_STENT', show_scalar_bar=True, scalar_bar_args={'title':'Displacements'}, cmap='jet', text='Displacements of the stent')
+   u_stent_mesh.plot(
+      scalars='U_STENT',
+      show_scalar_bar=True,
+      scalar_bar_args={'title':'Displacements'},
+      cmap='jet',
+      text='Displacements of the stent',
+      theme=mytheme,
+   )
 
 
 25.6. Exit MAPDL