The G-Vector 3D Plot is available either as an editor or as a view. You can set the preferences in Window -> Preferences -> GrainSpotter -> Run to have either or both of these be opened after GrainSpotter is run. By default neither is opened. The 3D Plot actually requires two input files to be most useful. The base file is an ImageD11 .gve file. If you also specify a GrainSpotter .log file, then you get information not only about all the possible g-vectors in the .gve file, but also about how GrainSpotter has assigned them to grains. The primary differences between the editor and the view are as follows:

You can also choose to open the .gve file with another editor, say the Text Editor, by right-clicking on the file in the Navigator. Fable remembers the choice, so if you previously opened it with the Text Editor, then it will continue to open it with that editor when you double click until you explicitly choose another editor by right clicking.

The Gve File Editor should notice if the file is changed externally to Fable or internally by running GrainSpotter again and then prompt you to use the new version or not. The Text Editor page may use the new version automatically, however.

For .gve files which are in Fable projects and hence appear in the Navigator, the editors open when Fable is closed should be displayed again when Fable is restarted.

The Editor consists of two pages, a 3D Plot, and the actual Text in the file.

In the event you would like to modify the file contents, you can do that in the Text page. If you type Ctrl-S or use File -> Save or "Save As" while that page is active, then it will save your changes. You can also open the File with the Text Editor, rather than the Gve File Editor and the behavior is then like editing any other text file. If you have multiple editors open on a file, they should all notice if it is saved in one of them and also if it is changed outside of Fable.

3D Plot

The 3D Plot page shows dots representing the g-vectors in reciprocal space. If no .log file is chosen, these are all of the g-vectors in the .gve file. If there is a .log file, then you can selectively view all of the g-vectors, all of the grains, and/or a single grain. The figure below shows all of the g-vectors and all of the grains. The g-vectors in the .gve file are shown in white, and the ones associated with grains via the .log file are shown in green. The Y axis is red; the Y axis is green; and the Z axis is blue. You can change the point size of the dots for better visibility.

You can drag and drop a .log file to the "Log file" text box, and in the view you can drag and drop the .gve file as well.

The plot is an Open GL 3D plot that can be rotated, zoomed, and panned. There is a context menu with a "Graphics Help" option that shows the various mouse operations that do this (shown below the following figure). You can also set the offsets and rotations manually in the text boxes to the right of the plot.

GrainSpotter 3D PLot Plot Page

Graphics Operations

GrainSpotter 3D Plot Help

Text

The Text page shows the .gve file as text and operates like the Text Editor. If the .gve file is saved, it is saved from the embedded Text Editor on this page.

GrainSpotter 3D Plot Text Page

The context menu shown is the context menu for the Text Editor. You can find other options by clicking or right-clicking in the margins.

3D View

Below is a picture of the 3D Plot View showing one grain.

GrainSpotter 3D View

File Contents

Description

Scattering vectors computed by the Transformation module using ImageD11. The first line of the file contains the unit cell parameters and lattice centering (one of P,A,B,C,I,F).

The wavelength and wedge angle are expected on the next lines (needed to compute ideal two theta, omega, and azimuth angles for computed orientations).

A list of computed d* values and expected h,k,l values for the unit cell follow. Note that d* is 1/d-spacing in Angstroms.

The actual scattering vectors follow.

  1. xr x-component of scattering vector (along the beam) with all angles at zero (units 1/)
  2. yr y-component of scattering vector (toward the door) with all angles at zero (units 1/)
  3. zr z-component of scattering vector (roughly up) with all angles at zero (units 1/)
  4. xc spatially corrected peak x-position on detector (units: pixels)
  5. yc spatially corrected peak y-position on detector (units: pixels)
  6. ds 1/d-spacing - modulus of scattering vector - ds = \frac{\lambda}{ 2 \sin \theta}
  7. phi azimuthal angle. Apologies for the typo, it should say eta.
  8. omega Rotation angle of scan
More information is available here on the Fable Vikki.

Example

Here is an example of an g-vector file.
4.049750 4.049750 4.049750 90.000000 90.000000 90.000000 F
# wavelength = 0.153636
# wedge = 0.000000
# ds h k l
0.427693 -1 1 1
0.427693 -1 1 -1
0.427693 1 -1 1
0.427693 1 -1 -1
0.427693 -1 -1 -1
//
1.209699 -2 4 2
1.209699 -2 -2 4
# xr yr zr xc yc ds eta omega
-1.064488 0.487933 -0.303576 393.350339 967.555462 1.209699 255.401608 -59.865730 0
-0.647861 0.323941 0.382165 659.957013 791.719538 0.818970 297.876500 -59.355276 1
-0.694335 0.422749 -0.099470 473.489709 826.087974 0.818970 263.009860 -55.030765 2
0.277708 -0.258757 -0.586271 285.515284 366.081243 0.698420 147.207272 -52.688612 3
0.601890 -0.616322 -0.690907 242.754491 178.278465 1.104299 128.896483 -50.564083 4
//