User Tools

Site Tools


software:imaged11

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
software:imaged11 [2019/05/28 09:30]
matthias [Basic instructions]
software:imaged11 [2019/11/28 13:35] (current)
smerkel
Line 44: Line 44:
 ===== Basic instructions ===== ===== Basic instructions =====
  
-The program usually opens as a long tool bar. Use your mouse to extend the window to a square shaped window. In the tool bar go to //Transformation//, then //Load filtered peaks// and choose the .flt file you would like to see. You should remember which file you opened because this is not shown anywhere. Don't worry if nothing seems to happen+The program usually opens as a long tool bar. Use your mouse to extend the window to a square shaped window. In the tool bar go to ''​Transformation''​, then ''​Load filtered peaks'' ​and choose the //.flt// file you would like to see. You should remember which file you opened because this is not shown anywhere. Don't worry if nothing seems to happen ​when opening something.
- +
-==== Entering parameters ==== +
-...+
  
 ==== Visualization in 2D ==== ==== Visualization in 2D ====
-There are two basic plotting options in //​ImageD11//:​ The standard view of a diffraction image and the cake view.+There are two basic plotting options in //​ImageD11//:​ 
 +  * The standard view of a diffraction image 
 +  * The cake view 
 +Note that //​ImageD11//​ can show only one plot at once. If you want to compare two (or more) plots, you can either save the plots (as .png file) or open a new //​ImageD11//​ window in a new tab of the command line.  
 + 
 +To switch between the two plot types, you can simply erase the current plot with ''​Clear''​ and plot the other one. Note that ''​Clear''​ only erases the plot, not the data!  
 + 
 +You can zoom in the plots with your mouse (left click). Unzoom with right click.
  
 === 2D diffraction image === === 2D diffraction image ===
-Click //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//+Click ''​Transformation'' ​and ''​plot y/z''​. You should see a 2D diffraction image of all the spots which passed the threshold.
  
-//​ImageD11//​ can show only one //​diffraction ​plot// at onceIf 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 command line.+=== Cake image === 
 +Click ''​Transformation''​ and ''​plot tth/eta''​The cake view of all spots which passed ​the threshold appears.
  
 ==== Editing parameters ==== ==== Editing parameters ====
 +
 +=== Entering parameters ===
 {{ software:​imaged11_parameters.png?​300|Screenshot of the parameter window}} {{ software:​imaged11_parameters.png?​300|Screenshot of the parameter window}}
-After you loaded a file you should modify the parameters. For this, click on //Transformation// --> //Edit parameters//. You will see a window like the one to the right. Enter all necessary parameters. Necessary are usually these ones: +After you loaded a file you should modify the parameters. For this, click on ''​Transformation''​ and ''​Edit parameters''​. You will see a window like the one to the right. 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 +  ​* **Cell parameters**: cell_a, cell_b, cell_c in Angstrom; cell_alpha, cell_beta, cell_gamma in degrees ​(typically taken from [[software:​maud|Maud]] refinement) 
-  * Lattice type: P = primitive, F = face-centered,​ A = A-centered, ... +  ​* **Lattice type**: P = primitive, F = face-centered,​ A = A-centered, ... 
-  * Distance = sample-detector distance in µm +  ​* **Distance** = sample-detector distance in µm (typically taken from [[software:​maud|Maud]] refinement) 
-  * O-matrix (same as in the //.inp// file+  ​* **O-matrix** (check the [[dac_experiments:​geometry|concept of the O-matrix]] if you are not sure
-  * Omegasign = rotation direction (1 = clockwise, -1 = counterclockwise) +  ​* **Omegasign** = rotation direction (1 = clockwise, -1 = counterclockwise) 
-  * Tilt (only if you know there is tilt) +  ​* **Tilt**: Be careful with this one: Tilt in ImageD11 ​is sometimes not the same as tilt in other software! (usually keep 0 and refine later
-  * Wavelength in Angstrom +  ​* **Wavelength** in Angstrom 
-  * y_size, z_size: size of one pixel in y direction and z direction in µm +  ​* **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 2048x2048 pixels ​the center ​is usually somewhere close to 1024x1024)+  ​* **y_center****z_center**: pixel coordinates of the beam center (usually taken from [[software:​dioptas|Dioptas calibration]]:​ ''​y_center = Dioptas Center X''​ and ''​z_center = 2048 - Dioptas Center Y''​) 
 +  * Supplementary parameter **cell_sg**. You can also provide ​your material space group. This has to be done manually with a text editor and can not be done using the Graphical User Interface. If the space group is provided, ImageD11 will use xfab for generate unique hkls. 
 + 
 +=== Typical mistakes during parameter entering === 
 +  * You entered a value in the wrong order of magnitude, for example: ''​detector distance''​ = ''​400''​ (instead of ''​400000''​ because 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) 
 + 
 +=== Saving parameters === 
 +You can also store parameter lists with ''​Transformation''​ and ''​Save parameters''​. Note that during storage you sometimes have to add the extension //.par// manually. To recall the list, click ''​Transformation''​ and ''​Load parameters''​. 
 + 
 +=== Refinement of parameters === 
 +The values you enter by hand are usually not 100% correct. This is because //​ImageD11//​ calculates or labels certain parameters different than other software does. 
  
-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.+When you plot the cake view (''​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 ''​Transformation''​ and ''​Fit''​. The spots will move a bit. Repeat clicking on ''​Fit'' ​until most of the vertical lines are totally straight.
  
-Some advice for your refinement +**Some advice for your refinement** 
-  * If your spots sit on sinus-shaped ​line of exactly one period, refine only y_center and z_center. This should already solve the problem.+  * Don't refine when you have a zoomed view. Always refine when you are fully unzoomed. 
 +  * If your spots sit on sinus-shaped ​lines 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 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!)   * 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!)
-  * When you see that your refinement gets worse and worse, you should enter your values again and start your refinement from the beginning.+  * When you see that your refinement gets worse and worse, you should enter your starting ​values again and start your refinement from the beginning.
  
-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 
software/imaged11.1559035819.txt.gz · Last modified: 2019/05/28 09:30 by matthias