:orphan:

Post-processing
===============

Recipes for what to do with a ``ModalResult`` / ``StaticResult`` /
``TransientResult`` once the solver returns: recover strain, plot mode
shapes, export to VTK for ParaView.


.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Once you&#x27;ve got a ModalResult / StaticResult, sending it downstream to ParaView / VisIt / any VTK-aware tool is a one-liner. femorph_solver.io wraps the pyvista writers so you don&#x27;t have to hand-roll the point-data scatter.">

.. only:: html

  .. image:: /gallery/post-processing/images/thumb/sphx_glr_example_vtk_export_thumb.png
    :alt:

  :doc:`/gallery/post-processing/example_vtk_export`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Exporting results to VTK / ParaView</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A recipe for rendering the lowest few modes of a structure as a grid of sub-plots.  The key ingredients are femorph_solver.io.modal_result_to_grid (which scatters every mode onto the mesh as a pyvista point-data array) and pyvista.DataSet.warp_by_vector (which deforms the mesh by the mode shape scaled to a fixed fraction of the bounding box).">

.. only:: html

  .. image:: /gallery/post-processing/images/thumb/sphx_glr_example_mode_shape_plot_thumb.png
    :alt:

  :doc:`/gallery/post-processing/example_mode_shape_plot`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plotting mode shapes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Solve a HEX8 flat plate under uniaxial tension and recover the full 6-component elastic-strain tensor on the mesh with femorph_solver.result.StaticResult.elastic_strain — element-nodal strain averaged onto every grid point.">

.. only:: html

  .. image:: /gallery/post-processing/images/thumb/sphx_glr_example_strain_recovery_thumb.png
    :alt:

  :doc:`/gallery/post-processing/example_strain_recovery`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">HEX8 — elastic-strain post-processing</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A mode shape \phi_{i} is the spatial pattern of a structure&#x27;s i-th free-vibration response.  When the structure is excited at the corresponding natural frequency f_{i}, every point moves in phase with amplitude proportional to \phi_{i} and time profile">

.. only:: html

  .. image:: /gallery/post-processing/images/thumb/sphx_glr_example_mode_shape_animation_thumb.png
    :alt:

  :doc:`/gallery/post-processing/example_mode_shape_animation`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Mode-shape animation — cantilever bending modes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="For base-excitation analysis (seismic, shock, hard-mounted random vibration), the modal participation factor \Gamma_{i} and effective modal mass M_{\mathrm{eff},i} of each mode tell you which modes will respond when the structure is shaken in a given direction — and which can safely be ignored.  Together they answer the practical engineering question:">

.. only:: html

  .. image:: /gallery/post-processing/images/thumb/sphx_glr_example_modal_participation_thumb.png
    :alt:

  :doc:`/gallery/post-processing/example_modal_participation`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Modal participation factors + effective modal mass</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Every linear static solve produces two displacement fields: the (N,) solved-for displacement at the free DOFs, and the (N,) ``reaction`` field nonzero only at the constrained DOFs — the force the supports must carry to hold the prescribed boundary displacements.  Sum the reactions and you reconstruct the support loads engineers actually need: bolt loads, weld loads, foundation reactions.">

.. only:: html

  .. image:: /gallery/post-processing/images/thumb/sphx_glr_example_reaction_forces_thumb.png
    :alt:

  :doc:`/gallery/post-processing/example_reaction_forces`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Reaction forces — global equilibrium and root moment from a tip load</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Stress is the most-asked-for derived quantity in linear FEA, and the recovery from a displacement solution is where most of the &quot;why is my stress field wrong&quot; questions actually live.  This example walks through the recovery pipeline on a problem with a clean closed-form reference — the Lamé thick cylinder under internal pressure (Timoshenko &amp; Goodier 1970 §33) — so every intermediate quantity has an analytical value to compare against.">

.. only:: html

  .. image:: /gallery/post-processing/images/thumb/sphx_glr_example_nodal_stress_recovery_thumb.png
    :alt:

  :doc:`/gallery/post-processing/example_nodal_stress_recovery`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Nodal stress recovery + invariants — Lamé thick-walled cylinder</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Where example_nodal_stress_recovery answered how big the stress is, this example answers which way it points.  The Cauchy stress tensor \sigma_{ij} at every node has three orthogonal principal directions along which there is no shear, with the corresponding principal stresses \sigma_{1} \ge \sigma_{2} \ge \sigma_{3} along those axes.  Tracing those eigenvectors over a domain gives the stress-trajectory picture beloved by mechanical designers (Timoshenko &amp; Goodier 1970 §1.7) — the visualisation that shows where the load actually flows.">

.. only:: html

  .. image:: /gallery/post-processing/images/thumb/sphx_glr_example_principal_stress_thumb.png
    :alt:

  :doc:`/gallery/post-processing/example_principal_stress`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Principal stresses + principal directions on a thick cylinder</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /gallery/post-processing/example_vtk_export
   /gallery/post-processing/example_mode_shape_plot
   /gallery/post-processing/example_strain_recovery
   /gallery/post-processing/example_mode_shape_animation
   /gallery/post-processing/example_modal_participation
   /gallery/post-processing/example_reaction_forces
   /gallery/post-processing/example_nodal_stress_recovery
   /gallery/post-processing/example_principal_stress


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download all examples in Python source code: post-processing_python.zip </gallery/post-processing/post-processing_python.zip>`

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download all examples in Jupyter notebooks: post-processing_jupyter.zip </gallery/post-processing/post-processing_jupyter.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_