.. _sphx_glr_auto_examples_howto_plot:

Plotting the data
=================

The following jupyter notebooks provide some examples of how to use ogstools to
create all different kinds of plots.



.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="To demonstrate the creation of an animated plot we use a component transport example from the ogs benchmark gallery (https://www.opengeosys.org/docs/benchmarks/hydro-component/elder/).">

.. only:: html

  .. image:: /auto_examples/howto_plot/images/thumb/sphx_glr_plot_animation_thumb.gif
    :alt:

  :ref:`sphx_glr_auto_examples_howto_plot_plot_animation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">How to create Animations</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="By default, filled contour plots try to retain the true mesh proportions. If the meshes aspect ratio lies outside of predefined limits (setup.min_ax_aspect, setup.max_ax_aspect) the axes get compressed to stay inside the given limits. The following examples shall illustrate this behaviour.">

.. only:: html

  .. image:: /auto_examples/howto_plot/images/thumb/sphx_glr_plot_aspect_ratios_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_howto_plot_plot_aspect_ratios.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Aspect ratios</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="To demonstrate the creation of filled contour plots we load a 2D THM meshseries example. In the plot.setup we can provide a dictionary to map names to material ids. Other plot configurations are also available, see: :pyogstools.plot.plot_setup.PlotSetup. Some of these options are also available as keyword arguments in the function call. Please see :pyogstools.plot.contourplots.contourf for more information.">

.. only:: html

  .. image:: /auto_examples/howto_plot/images/thumb/sphx_glr_plot_contourf_2d_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_howto_plot_plot_contourf_2d.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Visualizing 2D model data</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="For visualizing 3D data it might make sense to plot multiple views / slices. To create them we use pyvista as it provides all the necessary functionality. If we want to plot multiple meshes, they have to be in a 2D numpy array. The shape of this array determines the number of rows and columns in our plot. First, let&#x27;s load 3D example data from pyvista and plot the only available data: &quot;facies&quot; with a native pyvista plot.">

.. only:: html

  .. image:: /auto_examples/howto_plot/images/thumb/sphx_glr_plot_contourf_3d_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_howto_plot_plot_contourf_3d.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Visualizing 3D model data</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example we plot the data values on observation points over all timesteps. Since requested observation points don&#x27;t necessarily coincide with actual nodes of the mesh different interpolation options are available. See :pyogstools.meshlib.mesh_series.MeshSeries.probe for more details. Here we use a component transport example from the ogs benchmark gallery (https://www.opengeosys.org/docs/benchmarks/hydro-component/elder/).">

.. only:: html

  .. image:: /auto_examples/howto_plot/images/thumb/sphx_glr_plot_observation_points_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_howto_plot_plot_observation_points.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">How to plot data at observation points</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example we show how to create filled contourplots on a figure with subplots having shared axes.">

.. only:: html

  .. image:: /auto_examples/howto_plot/images/thumb/sphx_glr_plot_shared_axes_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_howto_plot_plot_shared_axes.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Shared axes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example we show how to create a filled contourplot of transient data over a sampling line. For this purpose we use a component transport example from the ogs benchmark gallery (https://www.opengeosys.org/docs/benchmarks/hydro-component/elder/).">

.. only:: html

  .. image:: /auto_examples/howto_plot/images/thumb/sphx_glr_plot_timeslice_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_howto_plot_plot_timeslice.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">How to Create Time Slices</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This tutorial covers plotting meshseries data using user defined matplotlib objects for figure and / or axes. This is useful if different plotting functions ogstools are to be used on different subplots within the same figure.">

.. only:: html

  .. image:: /auto_examples/howto_plot/images/thumb/sphx_glr_plot_with_custom_fig_ax_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_howto_plot_plot_with_custom_fig_ax.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plotting different process variables on already existing Matplotlib figures / axes</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/howto_plot/plot_animation
   /auto_examples/howto_plot/plot_aspect_ratios
   /auto_examples/howto_plot/plot_contourf_2d
   /auto_examples/howto_plot/plot_contourf_3d
   /auto_examples/howto_plot/plot_observation_points
   /auto_examples/howto_plot/plot_shared_axes
   /auto_examples/howto_plot/plot_timeslice
   /auto_examples/howto_plot/plot_with_custom_fig_ax