.. _sphx_glr_tutorials_export_data:

.. _ref_tutorials_export_data:

===========
Export data
===========

Data in DPF can be exported to universal file formats, such as VTK, HDF5, and TXT files.
You can use it to generate TH-plots, screenshots, and animations or to create custom result
plots using the `numpy <https://numpy.org/>`_ and `matplotlib <https://matplotlib.org/>`_ packages.

These tutorials explain how to export data from your manipulations with PyDPF-Core.

VTK Export
**********

Learn how to export data to [VTK formats](https://docs.vtk.org/en/latest/vtk_file_formats/index.html). VTK (Visualization Toolkit) is a widely used open-source software system for 3D computer graphics, image processing, and visualization. DPF's VTK export capabilities allow you to save your simulation results in VTK file formats, such as VTU (VTK Unstructured Grid), which can be easily visualized and analyzed using popular tools like ParaView and VisIt.

.. grid:: 1 1 3 3
    :gutter: 2
    :padding: 2
    :margin: 2

    .. grid-item-card:: Translate result files to VTU
       :link: ref_tutorials_export_data_migrate_to_vtu
       :link-type: ref
       :text-align: center

       Use the ``migrate_to_vtu`` operator to quickly export entire simulation
       result files to VTU format for visualization in ParaView.

    .. grid-item-card:: Export DPF objects to VTU
       :link: ref_tutorials_export_data_vtu_export
       :link-type: ref
       :text-align: center

       Use the ``vtu_export`` operator to export processed DPF data objects
       (meshes and fields) directly to VTU format with fine-grained control.

    .. grid-item-card:: Convert DPF data to PyVista objects
       :link: ref_tutorials_export_data_vtk_helper
       :link-type: ref
       :text-align: center

       Convert DPF meshes, fields, and property fields to PyVista
       ``UnstructuredGrid`` objects for in-memory manipulation and custom
       visualization.

Other Export Formats
********************

.. note::

    .. grid-item-card:: HDF5 export
       :text-align: center
       :class-card: sd-bg-light
       :class-header: sd-bg-light sd-text-dark
       :class-footer: sd-bg-light sd-text-dark

       Export data to HDF5 format for efficient storage and processing.

       +++
       Coming soon

.. Hide the thumbnails grid (auto-generated by sphinx-gallery)
.. raw:: html

   <style>.sphx-glr-thumbnails { display: none; }</style>




.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Translate simulation result files to VTU format using the migrate_to_vtu operator for visualization in VTK-compatible tools like ParaView.">

.. only:: html

  .. image:: /tutorials/export_data/images/thumb/sphx_glr_migrate_to_vtu_thumb.png
    :alt:

  :doc:`/tutorials/export_data/migrate_to_vtu`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Translate Result Files to VTU Format</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Export DPF data objects (mesh and fields) directly to VTU format using the vtu_export operator for fine-grained control over what gets exported.">

.. only:: html

  .. image:: /tutorials/export_data/images/thumb/sphx_glr_vtu_export_thumb.png
    :alt:

  :doc:`/tutorials/export_data/vtu_export`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Export DPF Objects to VTU</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Convert DPF meshes and fields to PyVista UnstructuredGrid objects for in-memory manipulation and custom visualization.">

.. only:: html

  .. image:: /tutorials/export_data/images/thumb/sphx_glr_vtk_helper_thumb.png
    :alt:

  :doc:`/tutorials/export_data/vtk_helper`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Convert DPF data to PyVista objects</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /tutorials/export_data/migrate_to_vtu
   /tutorials/export_data/vtu_export
   /tutorials/export_data/vtk_helper