feat: support viz interface

[moe-ad]

Closes #2841.

Summary of changes

• To prevent direct coupling between the plotter that has to be implemented and viz-interface's plotter backends, we had to propose a couple of backend agnostic customization APIs in the viz-interface. For more context regarding that, see:
  • Backend-agnostic APIs for customization ansys-tools-visualization-interface#448
  • feat: Add customization APIs ansys-tools-visualization-interface#465
  • feat: more customization APIs ansys-tools-visualization-interface#466
  • fix: labels visibility issue ansys-tools-visualization-interface#474
• A _VisualizationInterfacePlotter class has been added. Since viz's PlotlyBackend doesn't support volumetric meshes like the PyVistaBackend does, we are plugging pydpf-core's plotter to only the latter.
• We still can't deprecate the now legacy _PyVistaPlotter yet, since other classes like Plotter and Animator depends on it. Once those are gradually phased out via separate PRs in the future, we will eventually be able to deprecate _PyVistaPlotter.
• Because of the previous point, the plotter factory has been parametrized with a plotter_type argument that can be one of PlotterBackend.VISUALIZATION_INTERFACE, PlotterBackend.PYVISTA, and PlotterBackend.AUTO. The behavior is as follows:
  • PlotterBackend.AUTO is the default. This will select the new plotter or the legacy plotter depending on which one is available in the user's environment. This guarantees that plotting scripts won't automatically start breaking if users update pydpf-core without updating it's plotting dependencies.
  • PlotterBackend.PYVISTA will select the legacy plotter and PlotterBackend.VISUALIZATION_INTERFACE will select the new plotter.

@PProfizi and @jorgepiloto, this is now ready for review.

Note

We will address switching to the viz-interface as the default backend in a separate PR. It requires making sure all tests pass and that might require a bit more work.

[codecov]

Codecov Report

❌ Patch coverage is 13.40580% with 239 lines in your changes missing coverage. Please review.
✅ Project coverage is 82.63%. Comparing base (03a7a7c) to head (8ad1baf).
⚠️ Report is 99 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2881      +/-   ##
==========================================
- Coverage   84.38%   82.63%   -1.76%     
==========================================
  Files          92       92              
  Lines       10948    11218     +270     
==========================================
+ Hits         9239     9270      +31     
- Misses       1709     1948     +239     

[github-actions]

The documentation for this pull request will be available at https://dpf.docs.pyansys.com/pull/2881. Please allow some time for the documentation to be deployed.

[github-actions]

This PR has been closed. Documentation for this pull request will shortly be removed from its former deployment address.

[github-actions]

This PR has been closed. Documentation for this pull request will shortly be removed from its former deployment address.