Skip to main content

Core-Level Spectroscopy Simulations in Python

Project description

Crispy is a modern graphical user interface to calculate core-level spectra using the semi-empirical multiplet approaches implemented in Quanty. The interface provides a set of tools to generate input files, submit calculations, and plot the resulting spectra.

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 project downloads page. The installers bundle Python, the required dependencies, and Crispy. However, because for the moment they are only created when a new release is published, they might lack newly implemented features.

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. While Crispy works with both Python 2 and Python 3, you should install Python 3.5 or greater, as in previous versions some of the dependencies like PyQt5 cannot be easily installed using pip. On macOS and Windows you can install Python using the official installers. In particular for Windows you should install the 64-bit version of Python, and make sure that during the installation you select to add Python to system’s PATH. On Linux, Python and dependencies can be installed using the system’s package manager (apt, dnf, pacman, etc.).

Crispy depends on the following Python packages:

The dependencies will be automatically downloaded and installed when run the installation using pip:

pip install --upgrade --user crispy

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

crispy

If you are having problems running the previous command, it is probably due to not having your PATH environment variable set correctly. To find the path of the Crispy installation run:

pip show -f crispy

Just as in the case of using the package installers, this will install the latest release, and not the development version (see below). Also, please note that when you install Crispy using pip, external programs needed to run the calculations have to be installed and their path must be set in the interface (preferred way) or using the PATH environment variable.

Development Version

Using pip

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

pip install --upgrade --user https://github.com/mretegan/crispy/tarball/master

It is possible, although unlikely, that this version requires features that are not yet available with the pip installable version of silx. In this case you have to also install the development version of silx. This is not always a very simple task, especially on Windows, but there is extensive documentation on how to do it.

Running from Source

As an alternative to the pip installation above, you can download the source code from GitHub either as an archive or using git, and run Crispy without installing it:

git clone https://github.com/mretegan/crispy.git
cd crispy
python -m crispy

In this case the dependencies are not automatically installed and you will have to do it yourself:

pip install --user -r https://raw.githubusercontent.com/mretegan/crispy/master/requirements.txt

Usage

If you have used the installers, Crispy should be easy to find and launch. For the installation using pip or if you are running directly from the source folder, follow the instructions from the Installation section.

Citation

Crispy is a scientific software. If you use it for a scientific publication, please cite the following reference:

ZENODO

License

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
crispy-0.6.3.tar.gz (242.0 kB) Copy SHA256 hash SHA256 Source None Jun 11, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page