Add plane object to plotter

Describe the feature you would like to be added.

I would like to have an add_planes method in the pyvista.Plotter object to add pyvista.Plane objects to the plotter.

I was able to use the add_planes_widget, but I only want the plane itself and not the entire widget.

Links to VTK Documentation, Examples, or Class Definitions.

NA

Pseudocode or Screenshots

import pyvista as pv
pl = pv.Plotter()
plane = pv.Plane(center, normal)
pl.add_planes(plane)
pl.show()

[MatthewFlamm]

My opinion is that we should not add these functions. It would be never ending. I would prefer to only have these helper functions that help cut through the mess that is the function signature of add_mesh. For example, add_points forces the user to select one style that renders points.

https://docs.pyvista.org/api/plotting/_autosummary/pyvista.Plotter.add_points.html

add_plane would have no such benefit that I can see, but I’m open to hear if there are benefits here. A pv.Plane object is just a normal DataSet.

However, this issue highlights that we could do a better job in the documentation to describe the difference between add_points and add_mesh, i.e. add_points is a helper and only a thin wrapper around add_mesh. This also applies to the other wrappers.

[tkoyama010]

@AlejandroFernandezLuces Good point. My only concern is that the number of methods will grow indefinitely. For example, for Shere, we would need add_sphere. We need to add methods to use each object under geometoric_objects.py at least.