pydidas (the Python DIffraction Data Analysis Suite) is a toolkit for the analysis of diffraction datasets, both live at beamlines and offline for in-depth analysis.
Pydidas includes a graphical user interface and a command line interface to embed its functionality in other projects or scripts.
Pydidas relies on Qt for the user interface and for internal communication.
Some widgets are extensions of silx widgets.
The (azimuthal/radial) integration uses the pyFAI
engine for fast azimuthal integration. Both pyFAI and silx are developed at
the ESRF.
- Please check the citation file CITATION.cff
- Pydidas has also been issued with a global DOI for citations: 10.5281/zenodo.7568610
Pydidas should be installed in a clean environment to allow pydidas to fix the required dependency versions. This environment should be used exclusively for pydidas and no further packages should be installed.
Pydidas requires a Python version >= 3.11.
Environments can be managed using any environment manager (e.g. venv, conda/mamba). Due to dependency management issues, pydidas does not support pre-configured conda/mamba environments any more but relies exclusively on pip for the dependency management.
Pip will install all dependencies together with the pydidas package. There is no need to prepare the environment further.
You will require a pydidas wheel file to install it using pip. If you have not downloaded a build wheel file, you need to prepare one prior to installation.
Wheels for pydidas are available on the pydidas releases webpage. To install a downloaded wheel, activate your chosen environment and use the following command:
python -m pip install <path_to_pydidas_wheel_file.whl>
Download the pydidas source code or clone the git repository and navigate to the folder with the project metadata files (like this README.rst). Then, install the package and any missing dependencies:
python -m pip install .
Note that pip might need to build a wheel from pydidas first which will take some time. If you want to build the wheel manually, for example to keep it for later use, simply use the following commands (again, in the pydidas folder)::
python -m build
This will create a tarball and a wheel file in the dist subdirectory.
Note: You will need to install the build and setuptools packages manually in your chosen environment if you want to build pydidas from source.
The documentation is included with the distribution, but only in form of the source to keep the distribution small. It will be compiled automatically the first time pydidas is imported in python. This will take some time (about 30 seconds, depending on the system) and a notification will be displayed.
The compiled documentation can be found in the
lib/site-packages/pydidas/sphinx/html folder and the index.html file is the
global start page.
A pydidas-documentation entrypoint is available to open the documentation in the
system's default browser.
The graphical user interface also has a menu entry to open the help in a web browser.
The pydidas documentation is also available online through github-pages: https://hereon-gems.github.io/pydidas/
For the full citation information of pydidas, please see the CITATION.cff file.
Pydidas can also be cited by its global DOI on zenodo: 10.5281/zenodo.7568610
The pydidas source code is released under the GNU General Public License
Version 3.
The documentation is licensed under the Creative Commons Attribution 4.0
International Public License (CC-BY-4.0).
Images and logos are licensed under Creative Commons Attribution-NoDerivatives
4.0 International Public License (CC-BY-ND-4.0).
Insignificant files (e.g. changelog) are released under the CC0 1.0 Universal
Public Domain Dedication (CC0-1.0).