.. _sphx_glr_api_gallery_classical_visualizers:

Visualizers
-----------

Side-by-side physical-space/phase-space animation, and interactive
(draggable/zoomable) Plotly figures for the SO(3) momentum sphere and
a precessing orbit.


.. 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="The three animation helpers in physicskit.classical.visualizers.animations and physicskit.classical.visualizers.modal_analysis, applied to three already-familiar conservative systems, each paired with a live diagnostic of its own governing physics: a double pendulum (~physicskit.classical.systems.lagrangian.DoublePendulum, governed by its Euler-Lagrange equations of motion) shown with its physical rods next to a growing (\theta_1, \dot\theta_1) phase trace; a precessing Kepler orbit (~physicskit.classical.systems.newtonian.KeplerSystem, whose post-Newtonian term c_\mathrm{pn}/r^3 in V(r) drives the precession) shown with its orbital path next to a growing energy trace; and a non-linear lattice chain (~physicskit.classical.systems.chains.FPUTChain) shown via its live modal-energy bar chart E_k(t).">

.. only:: html

  .. image:: /api/gallery/classical/visualizers/images/thumb/sphx_glr_plot_01_side_by_side_animation_thumb.gif
    :alt:

  :doc:`/api/gallery/classical/visualizers/plot_01_side_by_side_animation`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">SideBySideAnimator: physical space + phase/energy diagnostics, live</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Unlike the static Matplotlib plots elsewhere in physicskit.classical.visualizers, these are draggable/zoomable in a live Python session or a browser -- useful for directly inspecting how close a rigid-body trajectory passes to the unstable intermediate-axis pole, or for zooming into a precessing orbit&#x27;s perihelion. The two systems are governed by the equations already introduced elsewhere in the gallery: EulerTop&#x27;s torque-free Euler equations, I_i\dot\omega_i = (I_j - I_k)\,\omega_j\omega_k (cyclic in i,j,k) for the body-frame angular velocity (see /api/gallery/classical/rotations/plot_01_dzhanibekov), and KeplerSystem&#x27;s separable Hamiltonian H = |p|^2/(2\mu) + V(r) with the post-Newtonian perturbation c_\mathrm{pn}/r^3 in V(r) that drives the perihelion precession (see /api/gallery/classical/newtonian/plot_02_kepler_precession).">

.. only:: html

  .. image:: /api/gallery/classical/visualizers/images/thumb/sphx_glr_plot_02_interactive_plotly_thumb.png
    :alt:

  :doc:`/api/gallery/classical/visualizers/plot_02_interactive_plotly`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Interactive Plotly visualizers: SO(3) momentum sphere and orbit</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /api/gallery/classical/visualizers/plot_01_side_by_side_animation
   /api/gallery/classical/visualizers/plot_02_interactive_plotly