Reference
=========

The reference section is the canonical place to look up **what
femorph-solver actually computes** — the FEM theory it implements,
the element kernels it ships, and the solver algorithms it uses.

This is orthogonal to the :doc:`user guide </user-guide/index>`:

* **User guide** — how to drive the solver to get a result.
* **Reference** — which equations, shape functions, integration
  rules, algorithms, and upstream papers those results are derived
  from.

Every entry here cross-links to the source-level
:ref:`References <references-by-kernel>` blocks in each kernel /
solver module.  The docstrings carry the full citations;
this section tells you which pages are load-bearing for a given
problem.

.. toctree::
    :maxdepth: 2

    theory/index
    elements/index
    solvers/index