Version 6 (modified by toby, 12 years ago) (diff)


Calibration of an area detector in GSAS-II

In this demo, data collected with a GE(?) area detector, intentionally tilted at 45 degrees, are used. Note that menu entries are listed as Help/About? GSAS-II, which refers to the name of the menu (here "Help") and the name of the entry in the menu (here "About GSAS-II").

Step 1: download the data file from one of these links or

Step 2: start GSAS-II in the directory where you have placed that file. This is done in different ways depending on your OS and how GSAS-II is installed.

apsvisit24d:demo1 toby$ python ~/software/work/GSASII/
Available python module versions for GSASII:
python:      2.7.1
matplotlib:  1.0.1
numpy:       1.5.1
scipy:       0.9.0rc2
OpenGL:      3.0.1
Max threads  1

You should see two windows, both empty. One is labeled GSASII Plots, the other GSAS-II data tree. On Linux and Windows a menu bar appears on the latter window; on a Mac the menu is in the system menu bar location (usually at the screen top).

Step 3: read in the data file.

Use the Data/Read? image data menu item (view). Select the La_hex_+45deg-00015.tif data file and press Open.

At this point the data tree window will have several entries (view); the plot window shows a faint image (view) and a new window is opened to edit the image controls (view).

Step 4: Edit image parameters

Note that, alas, very few image formats allow for storage of important metadata about the image, so this information needs to be added manually. In this case set the wavelength to 0.10798. It is also helpful to change the display of the image so that it is easier to see the diffraction rings. Lowering the maximum intensity to 10,000 to 20,000 counts will help (note that this can be done by moving the slider, or by typing a value in the box and then clicking on another control). You may also wish to select another color scheme using the color bar selector.

Alternately, the view of the image can be enhanced by displaying it on a logarithmic scale. Click on the window and press the upper or lowercase "L" key to toggle logarithmic plotting, or use the keypress selector button at the lower left of this window.

Step 5: Calibrate


Set the material used as a sample in the box labeled Calibrant


Use the Image Operations/Calibrate? menu item (note this menu is on the Image Controls window or for the Mac, the Image Controls window must be active to place this into the system menu bar). At this point the status line on the bottom of the Image Controls window changes with a prompt to select points for calibration. (view).


Use the left mouse button to click on at least four locations on the innermost ring. As each point is defined a red "+" is added to the plot (view).

To remove a point added in error click on that point with the right mouse button [on the Mac, if you have a single-button mouse, hold the Command (⌘) key down and click].


When done, press the right mouse button well away from any points that have been added [on the Mac, if you have a single-button mouse, hold the Control key down and click].

The calibration is then performed. First the rings are located and an ellipse is optimized for each ring. The indexed rings are shown in blue and center of each ellipse is noted with a blue "+" (view). The derived calibration results are shown in the Image Controls window. (view).

To see the actual points selected by the program, click on the "show ring picks?" check button (view). When this is done, it becomes clear that the points selected for the outermost ring are scattered between that and the next ring. This can be repaired by using the Image Operations/Clear? Calibration menu item, lowering the area the program uses for searching for points by changing the "pixel search range" to 10 and then repeating the calibration steps (selecting points again on the first ring and then using the right mouse button) (view). This produces very slightly better calibration constants (view).

Attachments (15)

Download all attachments as: .zip