ImageD11 is written and maintained by John Wright from ESRF and has an extensive manual available here https://pythonhosted.org/ImageD11/.

First of all, you will need Linux, either as a separate harddrive (with lots of memory space) or as a virtual machine on your Windows/Apple computer. In case you are not familiar with Linux, ask your administrator for help and maybe do an online crash course to learn basic navigation and so on.

Go to the ImageD11 homepage and click on the green button “clone or download”. Click on “Download ZIP”. After the download is finished, navigate to the “Downloads” folder and unpack the ZIP folder to a directory of your choice.

Open the Konsole and navigate to the unpacked ImageD11 directory. There should be a folder called “setup.py”. Type the following to the Konsole:

  python setup.py build

and after that:

  python setup.py install

If you get an error, there might be some of the additional libraries still missing. Check out the pages for the other software for more information. For example, Fabian requires many prerequisites. If the installation of ImageD11 doesn't seem to work, maybe try out another program first.

Open the program by going to the folder where the processed data is stored. Now open the program by typing the following to the Konsole:

  ImageD11_gui.py

When you try to open the program for the first time there is usually an error: “cannot find module FitAllB.conversion”. This error occurs due to a bug in FitAllB, which you have to fix manually. This is how to to it (AFTER you installed FitAllB, of course):

Go to the FitAllB directory and try to find the missing file conversion.py. It should be in a directory like this:

  ../FitAllB-master/FitAllB/

Look again at the error message in the Konsole and the lines above. Somewhere there you should find the path/directory where the Konsole expected to find FitAllB.conversion. Usually the directory is something like

  ../usr/lib64/python2.7/site-packages/

This means that FitAllB (including the file conversion.py) should be here but it is not (due to a bug in the installation process). And this is already the clue to solve the problem. Just copy the whole FitAllB folder to the Python site-packages folder. Use a code like this:

  cp -r ../FitAllB/ /usr/lib64/python2.7/site-packages/

or

  sudo cp -r ../FitAllB/ /usr/lib64/python2.7/site-packages/

The sudo is required if you get the error “permission denied” or similar. Note that you need to enter the root password (admin password or master password) in order to do the second case. Check if the copying worked.

Try to start the program again (see above).

The program should open. In ImageD11 go to Transformation, then Load filtered peaks and choose the .flt file you would like to see (You automatically should be in the right folder.).

Then go to Transformation and plot y/z. You should see a 2D diffraction image of all the spots which passed the threshold. From now on, we call this image diffraction plot. You should remember, which file you opened, because ImageD11 doesn't show this anywhere.

ImageD11 can show only one diffraction plot at once. If you want to compare two (or more) diffraction plots, you can either save the plots (as .png file) or open a new ImageD11 in a new tab of the Konsole.

After you loaded a file you should modify the parameters. For this, click on Transformation –> Edit parameters. You will see a window like this one. Enter all necessary parameters. Necessary are usually these ones:

• Cell parameters: cell_a, cell_b, cell_c in Angstrom; cell_alpha, cell_beta, cell_gamma in degrees
• Lattice type: P = primitive, F = face-centered, A = A-centered, …
• Distance = sample-detector distance in µm
• O-matrix (same as in the .inp file)
• Omegasign = rotation direction (1 = clockwise, -1 = counterclockwise)
• Tilt (only if you know there is tilt)
• Wavelength in Angstrom
• y_size, z_size: size of one pixel in y direction and z direction in µm
• y_center, z_center: pixel coordinates of the beam center (if your detector has 2048×2048 pixels the center is usually somewhere close to 1024×1024)

The values you enter are usually not 100% correct. When you plot the tth/eta plot you usually won't see totally straight vertical lines, especially not when you zoom in. So ImageD11 has an option for refinement implemented. To refine a parameter, you have to activate the Vary? box to the right of the parameter (of course, you can refine several parameters at once). Afterwards, close the window with Ok and go to Transformations –> Fit. The spots will move. Repeat clicking on Fit until most of the vertical lines are totally straight.

Some advice for your refinement

• If your spots sit on a sinus-shaped line of exactly one period, refine only y_center and z_center. This should already solve the problem.
• Don't refine too many parameters at once!
• Don't refine parameters you know for sure, such as the angle of the unit cell or the wavelength! (Especially don't refine strain, if this is a simulation without strain!)

Typical mistakes during parameter entering and refinement

• You entered a value in the wrong order of magnitude, for example: detector distance = 400 (instead of 400000 because you need to enter this value has to be entered in µm, not in mm)
• You entered a value in the wrong unit, for example: y_size = 1024 (instead of 200, because the software needs the individual pixel size of 200 µm, not the total amount of pixels in y direction)
• You refine too many parameters at once