====== Multigrain data processing software ======

We rely heavily on software written for the [[https://sourceforge.net/projects/fable/|fable project]]. Fable is a collection of packages for multigrain crystallography. Some are still maintained, others have not been touched for 10 years. Recently, a new website was started: [[https://github.com/FABLE-3DXRD|FABLE-3DXRD]]. The idea is to recreate a group of active researcher with software packages that are actually maintained.

There is competition: [[https://github.com/joelvbernier|HEXRD]], written and maintained by J. Bernier in the United States. Joel is actively working on HEXRD so one should keep an eye on it.

===== Packages we use =====

If something is available on [[https://github.com/FABLE-3DXRD|FABLE-3DXRD]], you should get it from there. Otherwise, you can download it from [[https://sourceforge.net/projects/fable/|fable project]].

Here is a list of packages we use. When you click on the links below, you will get additional information on downloading and installing the software.
  * [[Software:TIMEleSS Viewer|TIMEleSS Viewer]] : to look at diffraction images, check orientation matrices, calculation of median / average / background images, and plotting harvested peaks
  * [[software:peaksearch|Peaksearch]]: look for peaks (part of ImageD11)
  * [[software:imaged11|ImageD11]]: experimental parameters refinement, peak assignment, can do grain indexing
  * [[software:grainspotter|GrainSpotter]]: grain indexing
  * [[software:fitallb|FitAllB]]: second stage refinement
  * [[software:polyxsim|PolyXSim]]: simulation of diffraction data
  * [[software:xfab|xfab]]: a python library with crystallographic computations 
  * [[software:TIMEleSSTools|Specific TIMEleSS tools]]: a collection of scripts from the TIMEleSS projects, for both pre- and post-processing
  * [[Software:MTeX|MTeX]] : to plot grain orientations

Details on each piece of software and when to use them can be seen in the [[processing:start|Multigrain data processing workflow]] page.

===== Minimal installation =====

Getting started with a Fable-3RDX software set can be hard. 

Here is a dedicated page on 
  * [[processing:minimal_software_intallation | Getting started with a python environement (recommended)]]
  * [[software:gettingStartedMax  | Getting started with Anaconda]]

===== Other unrelated but useful packages  =====


  * [[software:mtex|MTeX]]: texture analysis, plot of grain orientations
  * [[software:maud|MAUD]]: powder diffraction analysis
  * [[software:dioptas|Dioptas]]:  python-based program for on-the-fly data processing and exploration of two-dimensional X-ray diffraction area detector data, used on most of high pressure beamlines and by many other crystallography groups throughout the world.