========
apstools
========

Library of Python tools for use with Bluesky at the APS.

The `apstools` package provides supplemental support for data acquisition using
the `Bluesky framework <https://blueskyproject.io>`__ at the `Advanced Photon
Source <https://www.aps.anl.gov/>`__.  The support consists of a thin Python
interface to `EPICS <https://epics-controls.org/>`__ hardware, records,
databases, and and other structures not already supported in `ophyd
<https://blueskyproject.io/ophyd>`__.

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

   install
   api/index
   applications/index
   examples/index
   changes
   license

.. icons: https://fonts.google.com/icons
.. grid:: 2

    .. grid-item-card:: :material-regular:`subscriptions;3em` :ref:`api_documentation`

      Enhance your bluesky use with these ophyd-style devices and other support.

    .. grid-item-card:: :material-regular:`install_desktop;3em` :ref:`install`

      How to install *apstools*.

    .. grid-item-card:: :material-regular:`alt_route;3em` :ref:`examples`

      Examples using the *apstools* package, many with Jupyter notebooks.

    .. grid-item-card:: :material-regular:`apps;3em` :ref:`applications`

      Command-line or GUI programs provided by *apstools*.

    .. grid-item-card:: :material-regular:`info;3em` :ref:`about`

      Links to source code, license ...

    .. grid-item-card:: :material-regular:`timeline;3em` :ref:`History <changes>`

      History of changes in *apstools*.


.. _about:

About
-----

:home: https://bcda-aps.github.io/apstools
:source: https://github.com/bcda-aps/apstools
:license: :ref:`license`
:full version: |release|
:published: |today|
:revisions: :ref:`History of code changes <changes>`
:index: :ref:`genindex`
:module: :ref:`modindex`
:search: :ref:`search`