add plot meshes container in plotting_meshes.rst tutorial

Author: luisaFelixSalles

doc/source/user_guide/tutorials/plot/plotting_meshes.rst

@@ -5,8 +5,11 @@ Plotting meshes
 ===============
 
 .. |MeshedRegion| replace:: :class:`MeshedRegion <ansys.dpf.core.meshed_region.MeshedRegion>`
+.. |MeshesContainer| replace:: :class:`MeshesContainer <ansys.dpf.core.meshes_container.MeshesContainer>`,
 .. |Model| replace:: :class:`Model <ansys.dpf.core.model.Model>`
 .. |plot| replace:: :func:`plot()<ansys.dpf.core.model.Model.plot>`
+.. |plotMesh| replace:: :func:`plot()<ansys.dpf.core.meshed_region.MeshedRegion.plot>`
+.. |plotMeshes| replace:: :func:`plot()<ansys.dpf.core.meshes_container.MeshesContainer.plot>`
 .. |DpfPlotter| replace:: :class:`DpfPlotter<ansys.dpf.core.plotter.DpfPlotter>`
 .. |add_mesh| replace:: :func:`add_mesh()<ansys.dpf.core.plotter.DpfPlotter.add_mesh>`
 .. |show_figure| replace:: :func:`show_figure()<ansys.dpf.core.plotter.DpfPlotter.show_figure>`
@@ -22,8 +25,11 @@ of a model.
 Define the mesh
 ---------------
 
-The mesh object in DPF is a |MeshedRegion|. In this tutorial we will download
-a pontoon simulation result file available in our `Examples` package:
+The mesh object in DPF is a |MeshedRegion|. You can plot a |MeshedRegion| or a
+|MeshesContainer|, that is a collection of |MeshedRegion|.
+
+In this tutorial we will download a pontoon simulation result file available in
+our `Examples` package:
 
 .. code-block:: python
 
@@ -37,6 +43,7 @@ Here, we use the |MeshedRegion| associated with the DPF |Model| object.
 However, you can obtain your |MeshedRegion| by other methods. For more
 information see the tutorials section : :ref:`ref_tutorials_mesh`.
 
+
 To plot the mesh you have three different methods:
 
     1)  :ref:`method_plot_mesh_1`
@@ -102,17 +109,24 @@ the plot you can use additional PyVista arguments (available at:
 
 .. _method_plot_mesh_2:
 
-Plot the |MeshedRegion| with the |plot| method
-----------------------------------------------
+Plot the |MeshedRegion| or the |MeshesContainer| with the |plotMesh| method
+---------------------------------------------------------------------------
+
+|MeshedRegion|
+^^^^^^^^^^^^^^
 
 This second approach demands a |MeshedRegion| object. Thus, we extract
-it from our |Model| object . Then, in the same way of the first approach,
-you just have to use the |plot| method.
+it from our |Model| object.
 
 .. code-block:: python
 
     # Extract the mesh
     my_meshed_region = my_model.metadata.meshed_region
+
+Just like in the first approach, use the |plotMesh| method.
+
+.. code-block:: python
+
     # Use the plot() method to plot the mesh
     my_meshed_region.plot()
 
@@ -125,14 +139,43 @@ you just have to use the |plot| method.
     my_meshed_region.plot()
 
 As, the meshed region is generated from the model’s metadata,
-the plot generated here is identical to the plot generated by the ":ref:`method_plot_mesh_1`" approach.
+the plot generated here is identical to the plot generated by
+the ":ref:`method_plot_mesh_1`" approach.
 
 The default plotter settings display the mesh with edges, lighting
 and axis widget enabled. Nevertheless, as we use the
 `PyVista <https://github.com/pyvista/pyvista>`_ library to create
 the plot you can use additional PyVista arguments (available at:
 :func:`pyvista.plot`), just like in ":ref:`method_plot_mesh_1`"
 
+|MeshesContainer|
+^^^^^^^^^^^^^^^^^
+
+There are different ways to obtain a |MeshesContainer|.
+
+Here we get a |MeshesContainer| by using the :class:`meshes_provider <ansys.dpf.core.operators.mesh.meshes_provider.meshes_provider>`
+operator.
+
+.. code-block:: python
+
+    # Get the meshes container
+    my_meshes = ops.mesh.mesh_provider(data_sources=dpf.DataSources(pontoon_file)).eval()
+
+Just like in the first approach, use the |plotMeshes| method.
+
+.. code-block:: python
+
+    # Use the plot() method to plot the mesh
+    my_meshes.plot()
+
+.. rst-class:: sphx-glr-script-out
+
+ .. jupyter-execute::
+    :hide-code:
+
+    my_meshes = ops.mesh.mesh_provider(data_sources=dpf.DataSources(pontoon_file)).eval()
+    my_meshes.plot()
+
 .. _method_plot_mesh_3:
 
 Plot the |MeshedRegion| with the |DpfPlotter| class
@@ -174,4 +217,5 @@ object and |add_mesh| method
 (available at: :func:`pyvista.plot`).
 
 You can also plot results data on its supporting mesh. For a detailed demonstration
-check: :ref:`ref_plotting_data_on_the_mesh`
+check: :ref:`ref_plotting_data_on_the_mesh`
+