fiasco Documentation
=====================

Welcome to the documentation for fiasco.
fiasco provides a Python interface to the `CHIANTI atomic database`_.
In addition to several high-level abstractions of the atomic data, fiasco also provides many common atomic physics calculations.
The package takes its name from the Italian word *fiasco*, or flask, `the typical style of bottle <https://en.wikipedia.org/wiki/Fiasco_(bottle)>`_ used to serve the *Chianti Classico* wine.
It is typically larger and rounder at the bottom and is covered by a straw basket.
In the same way, the `fiasco` package serves up the CHIANTI atomic database.

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

    .. grid-item-card:: Quick Start
        :link: fiasco-quick-start
        :link-type: ref
        :text-align: center

        :material-outlined:`accessibility_new;8em;sd-text-secondary`

        Short guide on installing and using fiasco

    .. grid-item-card:: Example gallery
        :link: generated/gallery
        :text-align: center

        :material-outlined:`palette;8em;sd-text-secondary`

        Examples including plots on accomplishing common tasks with fiasco

    .. grid-item-card:: How-to Guides
        :link: fiasco-how-to-guide
        :link-type: ref
        :text-align: center

        :material-outlined:`menu_book;8em;sd-text-secondary`

        Short guides on how to accomplish specific tasks with fiasco

    .. grid-item-card:: Reference
        :link: fiasco-reference
        :link-type: ref
        :text-align: center

        :material-outlined:`code;8em;sd-text-secondary`

        Technical description of the inputs, outputs, and behavior of each component of fiasco

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

  quick_start
  generated/gallery/index
  how_to_guides
  topic_guides/index
  reference/index

.. _CHIANTI atomic database: http://www.chiantidatabase.org/