Detailed description of CrysTBox diffractGUI Window
The application window consists of one figure and several panels. The figure allows the user to see the input image and grahical visualization of the resuts. Surrounding panels provide control of the analysis, allow settings of the most important parameters and list the results.
A detailed description of the graphical user interface follows.
Input image panel
This panel contains basic information about the input image such as the image name, resolution and sample material corresponding to the depicted pattern.
- The image resolution can be set manually here.
- Material can be chosen from this pop-up menu. You can pick one from listed materials or you can select a file describing your own material (file specification). Material does not need to be chosen prior to the analysis, it can be chaged during the procedure.
- Shows the input image.
This panel allows you to launch the analysis procedure and to control its individual steps if needed. The analysis can be launched by single click on the button
- This button launches all the steps of the analysis at once. Prior to launching the analysis, some basic settings can be done using
Speedand Spot sizepop-up menus Speed
- This pop-up menu allows you to speed-up the beam detection and lattice fitting, which are normally the most timeconsuming steps. Fast mode, however, is recommended for the less tricky images. This settings applies on the blob detection only. It does not apply on disk detection using the Hough transform.
- Here you can give the tool a hint whether to focus on smaller spots, larger spots or disks. In case of diffraction pattern consisting of textured disks (such as CBED) value
Disks (CBED)shall be set. Detect ITEM scale
- Detection of a scalebar burnt into the image by ITEM acquisition software is launched by this button. The result can be found next to the button. If the detection is successfull, bar length should be stated together with the length stated in the scalebar - for example "Label: "10 1/nm", Length: 158 px".
- This button starts the detection of diffraction spots or disks in the image.
- Method used for the detection of diffraction spots or disks can be set here. The spots can be detected using blob detection methods (all entries containing "Gaussian" or "Hessian"), while the disks should be detected using Hough transform.
Detected disk sizes
- Sizes of the spots to detect can be specified here for the blob detection methods.
Get N candidates
- Picks N strongest detections for further processing. Number of the selected candidates can be changed using
Num. of candidates. Num. of candidates
- This filed states number of the strongest detected spots/disks, which should serve for fitting a regular recirpocal lattice using RANSAC algorithm. Number of finally accepted candidates does not need to be equal to the number specified by the user. It can be lower (if there is isufficient number of detections) or higher (if there is more than one candidate with detection score equal to the score of the N-th candidate).
Analysed spot size
- The algorithm can analyse only a specific subset of the detected disks (
Detected disk sizes). Here you can specify sizes of the spots from which the N strongest candidates are chosen. Ransac - fit lattice
- RANSAC algorithm fits a regular reciprocal lattice to the set of strongest detected spots or disks.
Num. of iterations
- Number of RANSAC iterations.
- Several "basic" vectors are localized in the regular lattice found by RANSAC algorithm. The details about the vectors can be seen in
D-sapcingpanel. If the vectors are not centered correctly on the transmitted beam, you can center them manually using menu Image / Set primary beam. If there is more than one lattice found by RANSAC, the vectors are localized in the lattice specified using Latticepop-up menu. Lattice
- If there are multiple lattices in the image and RANSAC is set to detect them (
Settings / RANSAC / RANSAC Multimodel settings), you can select the lattice to be processed. Find zone axis
- After this button is pressed, the algorithm tries to map the theoretical d-spacings and interplanar angles to the experimental ones measured in the image. If it succeeds, the results are shown in the
Zone axispanel. Max. plane index
- This field sets a maximal plane index (in Miller indices) of the theoretical planes, whose d-spacings and interplanar angles are compared to the experimental values in order to identify the "basic" vectors (see
Choose vectors)and determine the zone axis.
This panel shows the details about the lattice vectors measured in the image using
The final results of the analysis are shown here. If there exist some valid assignment of the measured d-spacings to the theoretical ones, the details of such assignment are stated here. On the left hand side, there is a visualization of the assignment. The blue vertical lines on the bottom of the plot represent the theoretical d-spacings specific fo the material chosen using
- Typically, there are many possible assignments and therefore many possible zone axes, because the measured d-spacing may correspond to many crystallographically equivalent planes. Sometimes, it may also happen, that the experimental d-spacing can be paired with more than one theoretical d-spacing. Possible assignments (and corresponding zone axes) are listed in this pop-up menu. Only several best-scored zone axes are available here. Maximum number of enlisted zone axes can be set using
Settings / Max. number of resulting solutions. Cal. coef.
- This value allows for an adjustment of camera calibration inaccuracies. Measured d-spacing values are multiplied by this coefficient prior to the comparison with the theoretical d-spacings.
- This table states the details of the chosen assignment - the plane indices corresponding to the experimentaly measured vectors found using
Choose vectorsbutton. Zone axis
- Chosen zone axis.
- Checks, whether all pairs of four "basic" vectors agree on resulting zone axis. If the chosen assignment fufills this constraint, "OK" appears.
- Checks, whether vector additions of all pairs of four "basic" vectors agree with Miller indices of corresponding spots. If the chosen assignment fufills this constraint, "OK" appears.
Total angular dist.
- Sum of squares of angular distances between the four measured "basic" vectors and their theoretical counterparts. The lower number, the better. Values may differ from image to image, from material to material, however numbers higher than ten usually indicate a problem.
- This number equals to the standard deviation of differences between the measured and theoretical d-spacing values. The lower numbers the better. Values may differ from material to material, from zone axis to zone axis, however reasonable values are thousnadths or hunderedths.