chore: graphics target (#2196)

* chore: graphics target

* fix: review suggestions

Author: moe-ad

.github/workflows/examples.yml

@@ -101,7 +101,7 @@ jobs:
       - name: "Install package wheel"
         shell: bash
         run: |
-          pip install dist/${{ steps.wheel.outputs.wheel_name }}[plotting]
+          pip install dist/${{ steps.wheel.outputs.wheel_name }}[graphics]
 
       - name: "Install DPF"
         id: set-server-path

.github/workflows/examples_docker.yml

@@ -97,7 +97,7 @@ jobs:
       - name: "Install package wheel"
         shell: bash
         run: |
-          pip install dist/${{ steps.wheel.outputs.wheel_name }}[plotting]
+          pip install dist/${{ steps.wheel.outputs.wheel_name }}[graphics]
 
       - name: "Install DPF"
         id: set-server-path

.github/workflows/pydpf-post.yml

@@ -98,7 +98,7 @@ jobs:
       - name: "Install ansys-dpf-core wheel"
         shell: bash
         run: |
-          pip install dist/${{ steps.wheel.outputs.wheel_name }}[plotting]
+          pip install dist/${{ steps.wheel.outputs.wheel_name }}[graphics]
 
       - name: "Install DPF"
         id: set-server-path

.github/workflows/test_docker.yml

@@ -79,7 +79,7 @@ jobs:
       - name: "Install package wheel"
         shell: bash
         run: |
-          pip install dist/${{ steps.wheel.outputs.wheel_name }}[plotting]
+          pip install dist/${{ steps.wheel.outputs.wheel_name }}[graphics]
 
       - name: "Install DPF"
         id: set-server-path

README.md

@@ -88,7 +88,7 @@ PyDPF-Core plotting capabilities require `PyVista <https://pyvista.org/>`_ to be
 To install PyDPF-Core with its optional plotting functionalities, use this command:
 
 ```con
-   pip install ansys-dpf-core[plotting]
+   pip install ansys-dpf-core[graphics]
 ```
 
 For more information on PyDPF-Core plotting capabilities, see [Plot](https://dpf.docs.pyansys.com/version/stable/user_guide/plotting.html) in the PyDPF-Core documentation.

doc/source/getting_started/install.rst

@@ -21,7 +21,13 @@ To install PyDPF-Core with its optional plotting functionalities, run this comma
 
 .. code::
 
-   pip install ansys-dpf-core[plotting]
+   pip install ansys-dpf-core[graphics]
+
+.. warning::
+
+   ``pip install ansys-dpf-core[plotting]`` is equivalent to the previous command, however, the "plotting" target
+   only remains valid for legacy reasons and will soon be deprecated. Users are encouraged to use the "graphics"
+   target instead.
 
 For more information about PyDPF-Core plotting capabilities, see :ref:`user_guide_plotting`.
 

pyproject.toml

@@ -38,6 +38,17 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+graphics = [
+    # 2D chart plotting
+    "matplotlib>=3.2",
+    # 3D plotting
+    "pyvista>=0.32.0",
+    "vtk!=9.4.0",
+    # Animations
+    "imageio < 2.28.1",
+    "imageio-ffmpeg",
+]
+
 plotting = [
     # 2D chart plotting
     "matplotlib>=3.2",

tox.ini

@@ -210,7 +210,7 @@ skip_install =
     clean: True
 
 extras =
-    html: plotting
+    html: graphics
 
 deps =
     clean: