Examples
========

Runnable Python examples, organised by analysis type and by element.
Every script in the gallery runs on every docs build, so the demos
here are always in sync with the library.

.. grid:: 1 2 2 3
    :gutter: 3

    .. grid-item-card:: :octicon:`rocket;1.5em;sd-mr-1` Quickstart
        :link: gallery/quickstart/index
        :link-type: doc

        Two 60-second demos — a static solve and a modal solve.
        Start here.

    .. grid-item-card:: :octicon:`package;1.5em;sd-mr-1` Pre-processing
        :link: gallery/pre-processing/index
        :link-type: doc

        Loading CDBs, authoring pyvista meshes, stamping materials
        and boundary conditions.

    .. grid-item-card:: :octicon:`gear;1.5em;sd-mr-1` Analyses
        :link: gallery/analyses/index
        :link-type: doc

        Static, modal, transient, and cyclic-symmetry analyses
        against analytic baselines.

    .. grid-item-card:: :octicon:`graph;1.5em;sd-mr-1` Post-processing
        :link: gallery/post-processing/index
        :link-type: doc

        Strain recovery, mode shape plots, VTK / ParaView export.

    .. grid-item-card:: :octicon:`beaker;1.5em;sd-mr-1` Elements
        :link: gallery/elements/index
        :link-type: doc

        Living documentation for each registered element —
        companion to the per-element theory pages in the user guide.

    .. grid-item-card:: :octicon:`check-circle;1.5em;sd-mr-1` Verification
        :link: gallery/verification/index
        :link-type: doc

        Canonical FEA problems with closed-form solutions
        (Timoshenko, Rao, Irons, Hughes) — each example drives
        the :doc:`validation framework </reference/validation>`
        and renders the computed-vs-published comparison inline.

A **Comparisons** sub-gallery exists too — cross-solver benchmarks
(scikit-fem today, more backends on the roadmap) — but it only runs
on pushes to ``main`` so the build stays fast.  See it in the sidebar
when the rendered site is live.

.. toctree::
    :hidden:
    :maxdepth: 2

    gallery/quickstart/index
    gallery/pre-processing/index
    gallery/analyses/index
    gallery/post-processing/index
    gallery/elements/index
    gallery/verification/index

.. only:: full_gallery

    .. toctree::
        :hidden:
        :maxdepth: 1

        gallery/compare/index