User guide
==========

The User Guide is the conceptual tour of femorph-solver,
organised the way an engineer thinks about an analysis: pick
the analysis type, then drill into the BCs / loads / result
quantities that go with it.

Cross-cutting fundamentals (geometry, BCs, materials, result
objects, visualisation) live under the :doc:`pre-processing/index`
and :doc:`post-processing/index` sections and feed every
analysis-type chapter.  Solver-engineer topics (backend
selection, threading, performance tuning) live under
:doc:`solving/index`.

By analysis type
----------------

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

    .. grid-item-card:: :octicon:`grabber;1.5em;sd-mr-1` Linear static
        :link: analyses/linear-static
        :link-type: doc

        :math:`\mathbf{K}\, \mathbf{u} = \mathbf{f}` — the
        workhorse static solve for design-by-analysis.

    .. grid-item-card:: :octicon:`pulse;1.5em;sd-mr-1` Modal
        :link: analyses/modal
        :link-type: doc

        Natural frequencies and mode shapes via shift-invert
        Lanczos.

    .. grid-item-card:: :octicon:`graph;1.5em;sd-mr-1` Harmonic
        :link: analyses/harmonic
        :link-type: doc

        Steady-state forced-response sweep across a
        frequency band.

    .. grid-item-card:: :octicon:`hourglass;1.5em;sd-mr-1` Transient
        :link: analyses/transient
        :link-type: doc

        Newmark-β time-history response to time-varying
        loads.

    .. grid-item-card:: :octicon:`infinity;1.5em;sd-mr-1` Cyclic-symmetry
        :link: analyses/cyclic-symmetry
        :link-type: doc

        Sector-only modal on N-fold rotationally-symmetric
        structures.

    .. grid-item-card:: :octicon:`alert;1.5em;sd-mr-1` Buckling (planned)
        :link: analyses/buckling
        :link-type: doc

        Linear bifurcation buckling — roadmap; workarounds
        today documented on the page.

Cross-cutting topics
--------------------

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

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

        Geometry, materials, real constants, BCs.  Cross-cuts
        every analysis type.

    .. grid-item-card:: :octicon:`cpu;1.5em;sd-mr-1` Solving (backends)
        :link: solving/index
        :link-type: doc

        Solver backends, threading, performance, OOC limits.
        Independent of analysis type.

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

        Result objects, strain / stress recovery, pyvista
        visualisation, VTK export.

Foundations
-----------

- :doc:`three-phases` — the build-solve-inspect narrative
  every FEA workflow follows.
- :doc:`mapdl-compatibility` — what carries over from a
  MAPDL deck, where the boundaries are.

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

    three-phases
    analyses/index
    pre-processing/index
    solving/index
    post-processing/index
    mapdl-compatibility

.. only:: full_gallery

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

        comparisons