Getting started
===============

This section gets you from a fresh Python environment to a rendered
mode shape.  Pick the page that matches what you need.

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

    .. grid-item-card:: Overview
        :link: overview
        :link-type: doc

        What femorph-solver is, what it isn't, and where the MAPDL-compatibility
        layer stops.

    .. grid-item-card:: Installation
        :link: installation
        :link-type: doc

        ``pip`` / ``uv`` instructions, optional extras for CHOLMOD / PARDISO
        / UMFPACK backends, and the MAPDL interop extra.

    .. grid-item-card:: Quickstart
        :link: quickstart
        :link-type: doc

        One script: read a CDB, solve for the first 10 modes, plot.

    .. grid-item-card:: MAPDL interop
        :link: mapdl-interop
        :link-type: doc

        What reads and writes, KEYOPT parity, known gaps.

    .. grid-item-card:: Roadmap
        :link: roadmap
        :link-type: doc

        What's done, what's in progress, what's planned —
        capabilities, analyses, interop, verification, docs.

    .. grid-item-card:: Known limitations
        :link: known-limitations
        :link-type: doc

        Honest list of what femorph-solver does *not* do today
        and what produces silent-wrong-answer failure modes.

    .. grid-item-card:: FAQ
        :link: faq
        :link-type: doc

        Frequently asked questions distilled from the issue
        tracker — install gotchas, modal-solve quirks,
        cross-solver discrepancies, performance tuning.

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

    overview
    installation
    quickstart
    mapdl-interop
    roadmap
    known-limitations
    faq