Metadata-Version: 2.4
Name: crispy
Version: 2026.0
Summary: Core-Level Spectroscopy Simulations in Python
Author-email: Marius Retegan <marius.retegan@esrf.fr>
License: MIT
Project-URL: Changelog, https://github.com/mretegan/crispy/blob/main/CHANGELOG.rst
Project-URL: Documentation, https://crispy.esrf.fr
Project-URL: Downloads, https://github.com/mretegan/crispy/releases
Project-URL: Homepage, https://github.com/mretegan/crispy
Project-URL: Source, https://github.com/mretegan/crispy
Project-URL: Tracker, https://github.com/mretegan/crispy/issues
Keywords: gui,science,simulation,spectroscopy,synchrotron
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE.rst
Requires-Dist: h5py
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: packaging
Requires-Dist: pyside6
Requires-Dist: qtawesome
Requires-Dist: ruamel.yaml
Requires-Dist: silx[full_no_qt]
Requires-Dist: xraydb
Provides-Extra: dev
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-qt; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Provides-Extra: doc
Requires-Dist: cffconvert; extra == "doc"
Requires-Dist: sphinx; extra == "doc"
Requires-Dist: pydata-sphinx-theme; extra == "doc"
Provides-Extra: notebook
Requires-Dist: jupyter; extra == "notebook"
Requires-Dist: ipympl; extra == "notebook"
Provides-Extra: bundle
Requires-Dist: build; extra == "bundle"
Requires-Dist: pyinstaller; extra == "bundle"
Requires-Dist: pyinstaller-hooks-contrib; extra == "bundle"
Requires-Dist: twine; extra == "bundle"
Dynamic: license-file

Crispy is a modern graphical user interface to calculate core-level spectra
using the semi-empirical multiplet approaches implemented in `Quanty
<http://quanty.org>`_. The application provides tools to generate input files,
submit calculations, and plot the resulting spectra.

|release| |downloads| |DOI| |license|

.. |downloads| image:: https://img.shields.io/github/downloads/mretegan/crispy/total.svg
    :target: https://github.com/mretegan/crispy/releases

.. |release| image::  https://img.shields.io/github/release/mretegan/crispy.svg
    :target: https://github.com/mretegan/crispy/releases

.. |DOI| image:: https://zenodo.org/badge/doi/10.5281/zenodo.1008184.svg
    :target: https://dx.doi.org/10.5281/zenodo.1008184

.. |license| image:: https://img.shields.io/github/license/mretegan/crispy.svg
    :target: https://github.com/mretegan/crispy/blob/master/LICENSE.txt

.. first-marker

.. image:: https://raw.githubusercontent.com/mretegan/crispy/main/doc/assets/main_window.png

.. second-marker

Installation
============

Latest Release
--------------

**Using the Package Installers**

The easiest way to install Crispy on Windows and macOS operating systems is to
use the installers provided on the `downloads page
<https://crispy.esrf.fr/en/latest/downloads.html>`_ of the project.

**Using pip**

Pip is the package manager for Python, and before you can use it to install
Crispy, you have to make sure that you have a working Python distribution. On
macOS and Windows, you can install Python using the `official installers
<https://www.python.org/downloads>`_. In particular, for Windows, you should
install the 64-bit version of Python and make sure that you select to add
Python to the system PATH during the installation.

.. code:: sh

    python3 -m pip install crispy

After the installation finishes, you should be able to start the program from
the command line:

.. code:: sh

    crispy

If you have problems running the previous command, it is probably due to not
having your PATH environment variable set correctly.

.. code:: sh

    export PATH=$HOME/.local/bin:$PATH


Development Version
-------------------

**Using pip**

Assuming that you have a working Python distribution (version 3.10 or greater),
you can easily install the development version of Crispy using pip:

.. code:: sh

    python3 -m pip install https://github.com/mretegan/crispy/tarball/main

To update the development version of Crispy, you can use the following command:

.. code:: sh

    python3 -m pip install --ignore-installed https://github.com/mretegan/crispy/tarball/main

.. third-marker

Usage
=====

.. fourth-marker

Crispy should be easy to find and launch if you have used the installers. For
the installation using pip follow the instructions from the **Installation**
section.

.. fifth-marker

Citation
========
Crispy is a scientific software. If you use it for a scientific publication,
please cite the following reference (change the version number if required)::

    @software{retegan_crispy,
      author  = {Retegan, Marius},
      title   = {Crispy},
      version = {2026.0},
      year    = {2026},
      doi     = {10.5281/zenodo.1008184},
      url     = {https://crispy.esrf.fr},
    }

.. sixth-marker

License
=======
The source code of Crispy is licensed under the MIT license.
