Skip to content

ImageD11 is a python code for identifying individual grains in spotty area detector X-ray diffraction images.

License

Notifications You must be signed in to change notification settings

FABLE-3DXRD/ImageD11

Folders and files

NameName
Last commit message
Last commit date

Latest commit

2a457f7 · Oct 19, 2023
Apr 8, 2021
Jun 29, 2023
Oct 19, 2023
Nov 14, 2017
Jan 10, 2022
Oct 19, 2023
Feb 23, 2023
Apr 21, 2023
Oct 2, 2023
Feb 18, 2019
Apr 7, 2021
Apr 3, 2019
Jun 17, 2022
Mar 22, 2005
Apr 22, 2021
Oct 1, 2021
Apr 8, 2021
Apr 7, 2017
Aug 29, 2019
Aug 29, 2019
May 24, 2023
Feb 23, 2023
Sep 12, 2023
Apr 3, 2019
Sep 26, 2017

Repository files navigation

ImageD11 is a python code for identifying individual grains in spotty area detector X-ray diffraction images.

Version 1.9.8, Jon Wright, wright@esrf.fr

This is the source code for ImageD11. Probably you wanted a compiled version.

If your pip is up-to-date, you can try to install it like this (numpy is needed to compile):

 python -m pip install --upgrade pip setuptools
 python -m pip install numpy
 python -m pip install ImageD11

To get all the possible dependencies too, you can try: python -m pip install ImageD11[full]

Some (dated) documentation is here: https://imaged11.readthedocs.io/

If you are at ESRF on an old linux computer you can try "module load fable".

To use from git, try this:

  • Download and install python 3.7+, perhaps from www.python.org but probably from conda.
  • Preload binary packages from conda (or your system package manager): numpy, scipy, matplotlib, h5py, pillow, pycifrw, xfab, pyqt, pillow, silx[full] etc
  • pip install git+https://github.com/FABLE-3DXRD/ImageD11.git

If you want to work with the sources then you can try like this:

$ python -m pip install --upgrade pip
$ git clone https://github.com/FABLE-3DXRD/ImageD11.git && cd ImageD11
$ python -m pip install --editable .

If you want multiple binaries in your home (on recent pythons) you can do and get the compiled code for each platform in .so files that are labelled by platform. This is potentially useful for a heterogenous cluster (like at ESRF):

  # on ppc64le:
  python3 -m pip install dist/ImageD11-1.9.8-cp38-cp38-linux_ppc64le.whl --user --ignore-installed
  # on x86_64:
  python3 -m pip install dist/ImageD11-1.9.8-cp38-cp38-linux_x86_64.whl --user --ignore-installed
  # etc
  # ~/.local/lib/python3.8/site-packages/ImageD11 % ls *.so
  _cImageD11.cpython-38-powerpc64le-linux-gnu.so  _cImageD11.cpython-38-x86_64-linux-gnu.so

After it is installed, you should find a script ImageD11_gui.py, somewhere in your path.

Until 2017 this code was mostly developed on sourceforge at http://sourceforge.net/projects/fable/

It is now developed at http://github.com/FABLE-3DXRD/ImageD11

Bug reports are always welcome!

Good luck!

CI Status

Windows: Build status

Linux: CircleCI

Macos + Linux Build Status