| 1 | <html> |
|---|
| 2 | <head> |
|---|
| 3 | <META NAME="Author" CONTENT="Brian H. Toby"> |
|---|
| 4 | <title>EXPGUI</title> |
|---|
| 5 | </head> |
|---|
| 6 | <BODY BGCOLOR="#FFFFFF"> |
|---|
| 7 | |
|---|
| 8 | <A HREF=http://www.ncnr.nist.gov> |
|---|
| 9 | <IMG SRC="http://www.ncnr.nist.gov/images/ncnrtrans.gif" |
|---|
| 10 | alt="Link to NIST Center for Neutron Research home page" |
|---|
| 11 | ALIGN=RIGHT></A> |
|---|
| 12 | <A HREF=http://www.nist.gov> |
|---|
| 13 | <IMG SRC="http://www.ncnr.nist.gov/images/webidblue_2lineright.gif" |
|---|
| 14 | alt="Link to National Institute of Standards & Technology home page" |
|---|
| 15 | ALIGN=LEFT></A> |
|---|
| 16 | <CENTER> |
|---|
| 17 | <A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html"> |
|---|
| 18 | <IMG SRC="tcltklogo100.gif" |
|---|
| 19 | alt="Link to Tcl/Tk information"> |
|---|
| 20 | </CENTER></A> |
|---|
| 21 | <hr> |
|---|
| 22 | |
|---|
| 23 | <center><h1> |
|---|
| 24 | EXPGUI<BR> |
|---|
| 25 | A Graphical User Interface for |
|---|
| 26 | <A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html"> |
|---|
| 27 | GSAS</A> |
|---|
| 28 | </h1></center> |
|---|
| 29 | <P><P> |
|---|
| 30 | EXPGUI is a graphical interface for the |
|---|
| 31 | <A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html"> |
|---|
| 32 | GSAS</A> package. |
|---|
| 33 | It allows two types of actions: |
|---|
| 34 | the different |
|---|
| 35 | GSAS</A> |
|---|
| 36 | programs such as EXPEDT, GENLES, FOURIER,... |
|---|
| 37 | can be run from a menu or by pressing buttons, |
|---|
| 38 | and it can be used to directly modify the GSAS |
|---|
| 39 | experiment file without using EXPEDT. |
|---|
| 40 | This document describes the functions in EXPGUI. |
|---|
| 41 | Note that pictures on this page are not updated as frequently as the |
|---|
| 42 | text. |
|---|
| 43 | |
|---|
| 44 | <p> |
|---|
| 45 | GSAS programs are invoked either through use of the menu bar |
|---|
| 46 | <center><B> |
|---|
| 47 | <br>The menu bar. |
|---|
| 48 | <br><img SRC="menubar.gif" BORDER=3 > |
|---|
| 49 | </center></B> |
|---|
| 50 | or by "pressing" a button on the button bar. The button bar |
|---|
| 51 | simply provides an easy way to access commonly used |
|---|
| 52 | actions on the menu bar. Users can |
|---|
| 53 | <A HREF="expgui_cfg.html"> |
|---|
| 54 | configure the menu bar</A> to include their own preferred actions and, with |
|---|
| 55 | some knowledge of the program and Tcl/Tk, |
|---|
| 56 | add their own commands to the menu bar or button bar. |
|---|
| 57 | |
|---|
| 58 | <center><B> |
|---|
| 59 | <br>The button bar. |
|---|
| 60 | <br><img SRC="buttonbar.gif" BORDER=3 > |
|---|
| 61 | </center></B> |
|---|
| 62 | |
|---|
| 63 | <P> |
|---|
| 64 | Different sections of the .EXP file can be edited by selecting different |
|---|
| 65 | panels or pages from the tabbed list. |
|---|
| 66 | <center><B> |
|---|
| 67 | <br>The notebook panel tabs. |
|---|
| 68 | <br><img SRC="panebar1.gif" BORDER=3 > |
|---|
| 69 | </center></B> |
|---|
| 70 | <P> |
|---|
| 71 | This documentation will describe the different actions that |
|---|
| 72 | can be accomplished with the different panels and the |
|---|
| 73 | contents of the menus. Other documents contain: |
|---|
| 74 | <a name="installation"></A> |
|---|
| 75 | <A HREF="expgui_Win_readme.html"> |
|---|
| 76 | Installation notes for Windows</A>, |
|---|
| 77 | <A HREF="expgui_Unix_readme.html"> |
|---|
| 78 | Installation notes for UNIX</A> and |
|---|
| 79 | <A HREF="expgui_cfg.html"> |
|---|
| 80 | Customization notes</A>. |
|---|
| 81 | <hr> |
|---|
| 82 | |
|---|
| 83 | <h2>1. LS Controls panel</h2> |
|---|
| 84 | <DL><DL> |
|---|
| 85 | <p>The LS Controls panel shows information about the |
|---|
| 86 | current experiment, typically found in the EXPEDT "Least |
|---|
| 87 | Squares Controls" options. |
|---|
| 88 | <P> |
|---|
| 89 | Note that the order that histograms appear in this |
|---|
| 90 | panel is determined by the "Sort histograms by" option in |
|---|
| 91 | the Options Menu. |
|---|
| 92 | <img SRC="1.gif" align=TEXTTOP> |
|---|
| 93 | </DL></DL> |
|---|
| 94 | <P> |
|---|
| 95 | <h2>2. Phase panel</h2> |
|---|
| 96 | <DL><DL> |
|---|
| 97 | The phase panel is used to edit information |
|---|
| 98 | about the phase or phases found in the experiment |
|---|
| 99 | file. The cell and atomic damping and refinement |
|---|
| 100 | flags can be changed here. Note that if a |
|---|
| 101 | single atom is selected using the mouse, the information |
|---|
| 102 | for that atom can be edited. If a group of atoms is |
|---|
| 103 | selected |
|---|
| 104 | <A href="#mouseactions">(see Mouse Actions)</A> |
|---|
| 105 | the damping and refinement flags |
|---|
| 106 | for all the selected atom can be changed at one time. |
|---|
| 107 | <P> |
|---|
| 108 | If the EXPTOOL program |
|---|
| 109 | <A href="#installation">(see the installation instructions)</A> |
|---|
| 110 | is installed, buttons for adding phases and atoms will |
|---|
| 111 | appear on this panel, as seen below. If the |
|---|
| 112 | program is not properly installed, no errors occur, but the buttons |
|---|
| 113 | do not appear. |
|---|
| 114 | <P> |
|---|
| 115 | Note that the order that atoms appear in this panel is |
|---|
| 116 | determined by the "Sort Atoms by" option in the Options |
|---|
| 117 | Menu. |
|---|
| 118 | <img SRC="2.gif" align=TEXTTOP> |
|---|
| 119 | </DL></DL> |
|---|
| 120 | |
|---|
| 121 | <h2>3. Histogram panel</h2> |
|---|
| 122 | <DL><DL> |
|---|
| 123 | The histogram panel is used to edit background |
|---|
| 124 | and diffractometer constants for a histogram, as well as |
|---|
| 125 | set damping and refinement flags for these parameters. |
|---|
| 126 | <P> |
|---|
| 127 | If |
|---|
| 128 | <A href="#multiplehistogram"> |
|---|
| 129 | "Multiple Histogram Selection" mode</A> is set to "All", |
|---|
| 130 | this panel is disabled. For other settings of this mode, |
|---|
| 131 | groups of histograms can be selected and modified |
|---|
| 132 | collectively. |
|---|
| 133 | <P> |
|---|
| 134 | If the EXPTOOL program |
|---|
| 135 | <A href="#installation">(see the installation instructions)</A> |
|---|
| 136 | is installed, a button for adding histograms will |
|---|
| 137 | appear on the bottom right on this panel, as seen below. If the |
|---|
| 138 | program is not properly installed, no errors occur, but the button |
|---|
| 139 | does not appear. |
|---|
| 140 | <P> |
|---|
| 141 | Note that the order that histograms appear in this |
|---|
| 142 | panel is determined by the "Sort histograms by" option in |
|---|
| 143 | the Options Menu. |
|---|
| 144 | <img SRC="3.gif" align=TEXTTOP> |
|---|
| 145 | </DL></DL> |
|---|
| 146 | |
|---|
| 147 | <h2>4. Scaling panel</h2> |
|---|
| 148 | <DL><DL> |
|---|
| 149 | The Scaling panel is used to edit the scale factor for a |
|---|
| 150 | histogram as well as the phase fractions for each phase |
|---|
| 151 | present in that histogram. Damping and refinement flags |
|---|
| 152 | can also be set here. |
|---|
| 153 | <P> |
|---|
| 154 | If |
|---|
| 155 | <A href="#multiplehistogram"> |
|---|
| 156 | "Multiple Histogram Selection" mode</A> is set to |
|---|
| 157 | any value other than "Off," |
|---|
| 158 | groups of histograms can be selected and modified |
|---|
| 159 | collectively. |
|---|
| 160 | <P> |
|---|
| 161 | Note that the order that histograms appear in this |
|---|
| 162 | panel is determined by the "Sort histograms by" option in |
|---|
| 163 | the Options Menu. |
|---|
| 164 | <img SRC="4.gif" align=TEXTTOP> |
|---|
| 165 | </DL></DL> |
|---|
| 166 | |
|---|
| 167 | <h2>5. Profile panel</h2> |
|---|
| 168 | <DL><DL> |
|---|
| 169 | The Profile panel is used to edit the profile values for |
|---|
| 170 | each phase present in a histogram as well as set |
|---|
| 171 | the refinement flags and a damping value for each phase. |
|---|
| 172 | <P> |
|---|
| 173 | If |
|---|
| 174 | <A href="#multiplehistogram"> |
|---|
| 175 | "Multiple Histogram Selection" mode</A> is set to "All", |
|---|
| 176 | this panel is disabled. For other settings of this mode, |
|---|
| 177 | profile values and settings can be collectively |
|---|
| 178 | modified for groups of histograms. |
|---|
| 179 | <P> |
|---|
| 180 | Note that the order that histograms appear in this |
|---|
| 181 | panel is determined by the "Sort histograms by" option in |
|---|
| 182 | the Options Menu. |
|---|
| 183 | <img SRC="5.gif" align=TEXTTOP> |
|---|
| 184 | </DL></DL> |
|---|
| 185 | |
|---|
| 186 | <h2>6. Constraints panel</h2> |
|---|
| 187 | <DL><DL> |
|---|
| 188 | GSAS offers two types of restraints that can be included in a model. |
|---|
| 189 | So called "soft constraints" or "restraints" penalize the fit if |
|---|
| 190 | aspects of a model (for example, bond lengths) differ from selected values. |
|---|
| 191 | So called "hard constraints" reduce the actual number of |
|---|
| 192 | parameters in a model, |
|---|
| 193 | by grouping parameters so that a single shift (possibly scaled) is |
|---|
| 194 | applied to each parameter in the group. |
|---|
| 195 | The constraints panel is used to set these "hard constraints." |
|---|
| 196 | At this time the only constraints that can be set in EXPGUI are on atomic |
|---|
| 197 | parameters (others can be set in EXPEDT). |
|---|
| 198 | <P> |
|---|
| 199 | Note that these constraints are only applied to shifts, so that if two atoms |
|---|
| 200 | are constrained so that the shift on their occupancy is the same, but |
|---|
| 201 | the initial occupancies differ, the difference will be maintained as the |
|---|
| 202 | values refine. |
|---|
| 203 | <P> |
|---|
| 204 | <H4>Atom Constraints</H3> |
|---|
| 205 | The atom constraints editing page appears below. Note that constraints can |
|---|
| 206 | be listed sorted by constraint number, phase number, lowest atom number or |
|---|
| 207 | variable by clicking on the buttons at the top of the page. |
|---|
| 208 | <P> |
|---|
| 209 | To delete one or more constraints, click on the appropriate checkbuttons in the <B>Delete</B> column and the press the Delete button, below. |
|---|
| 210 | <img SRC="mc.gif" align=TEXTTOP> |
|---|
| 211 | Due to the way GSAS implements these constraints, a parameter can be included |
|---|
| 212 | in only one constraint. Should one or more parameters be constrained twice, |
|---|
| 213 | an error message is shown as shown below. |
|---|
| 214 | Note that the constraint number is displayed as red, for constraints that |
|---|
| 215 | have conflicts in the constraints editing page (see above.) |
|---|
| 216 | <img SRC="mcerr.gif" align=TEXTTOP> |
|---|
| 217 | <P> |
|---|
| 218 | <img SRC="mcedit.gif" align=LEFT> |
|---|
| 219 | <img SRC="mcvar.gif" align=RIGHT> |
|---|
| 220 | When the edit button for a constraint is pressed, the constraint is |
|---|
| 221 | opened for editing. Controls are available to select the phase, variable, |
|---|
| 222 | multiplier and atom(s). Note that for atom selection, use of the control key |
|---|
| 223 | and the left mouse button allow individual atoms to be selected or deselected. |
|---|
| 224 | Shift and the left mouse button allow ranges of atoms to be selected and the |
|---|
| 225 | right mouse button selects all atoms |
|---|
| 226 | <A href="#mouseactions">(see Mouse Actions)</A>. |
|---|
| 227 | <P> |
|---|
| 228 | Note that it is inappropriate |
|---|
| 229 | to constrain different types of parameters together, for example X and Uiso. |
|---|
| 230 | The left-most variable button is the "master" which |
|---|
| 231 | determines what variable are allowed in the |
|---|
| 232 | other variable buttons. |
|---|
| 233 | <P> |
|---|
| 234 | When the "New Constraint" button is pressed, a blank constraint editing |
|---|
| 235 | window is opened. Note that any variable to the right may then be selected, |
|---|
| 236 | including two special codes, Uxx and XYZU. XYZU creates four constraints, |
|---|
| 237 | requiring the shifts on x, y, z and Uiso to be the same for all the selected |
|---|
| 238 | atoms. Uxx does the same for the six anisotropic displacement parameters. |
|---|
| 239 | These special codes are valuable for atoms that share a site. |
|---|
| 240 | <P> |
|---|
| 241 | Note that only 100 parameters may be included in a constraint, |
|---|
| 242 | with one exception. When shifts for Uiso for all atoms in a phase |
|---|
| 243 | are constrained, this counts as a single parameter. If more than 100 |
|---|
| 244 | parameters are entered for a constraint, an error message is shown. |
|---|
| 245 | Up to 2000 atomic constraints may be entered. |
|---|
| 246 | EXPGUI does not warn if you exceed this limit. |
|---|
| 247 | </DL></DL> |
|---|
| 248 | |
|---|
| 249 | <a name="multiplehistogram"> |
|---|
| 250 | <h2>7. Multiple Histogram Selection</h2></a> |
|---|
| 251 | <DL><DL> |
|---|
| 252 | This mode allows parameters to be changed for groups of |
|---|
| 253 | histograms. |
|---|
| 254 | When the "Multiple Histogram Selection" mode is off, |
|---|
| 255 | it is possible to modify parameters |
|---|
| 256 | and refinement flags for only a single histogram, but |
|---|
| 257 | the other settings allow groups of histograms |
|---|
| 258 | to be selected and modified. |
|---|
| 259 | <A href="#mouseactions">(see Mouse Actions)</A>. |
|---|
| 260 | |
|---|
| 261 | It does not make sense, however, to globally modify |
|---|
| 262 | instrument-related parameters and flags for different |
|---|
| 263 | histogram types. |
|---|
| 264 | So global actions can be limited to a single class |
|---|
| 265 | of histogram types (e.g. TOF, CW Neutron,...), which |
|---|
| 266 | allows these parameters to be set for groups of |
|---|
| 267 | similar histograms. Thus, if this mode is set to "All" |
|---|
| 268 | the Histogram and Profile panels are disabled. |
|---|
| 269 | <P> |
|---|
| 270 | The setting for "Multiple Histogram Selection" mode is |
|---|
| 271 | selected using the "Multiple Hist. Selection" item on the |
|---|
| 272 | Options menu to create a submenu. Also on this submenu is an option |
|---|
| 273 | "Group Phases Together" that controls how EXPGUI treats phases having |
|---|
| 274 | the same profile type when multiple histograms are selected. If |
|---|
| 275 | the "Group Phases Together" option is on, then the refinement flags for |
|---|
| 276 | all phases with the same histogram types are grouped together, when possible. |
|---|
| 277 | If this option is off, phases are treated separately. |
|---|
| 278 | <p> |
|---|
| 279 | <a name="mouseactions"> |
|---|
| 280 | </DL></DL> |
|---|
| 281 | <h2>8. Mouse Actions</h2></a> |
|---|
| 282 | <DL><DL> |
|---|
| 283 | A range of atoms or (in multiple selection mode) histograms may be |
|---|
| 284 | selected by dragging (holding down) the left mouse button. It is also |
|---|
| 285 | possible to select a range by using the Shift key with the left mouse |
|---|
| 286 | button. To select or deselect individual entries, use the Control key |
|---|
| 287 | with the left mouse button. Pressing the right mouse button selects all |
|---|
| 288 | entries in a list. |
|---|
| 289 | </DL></DL> |
|---|
| 290 | |
|---|
| 291 | <h2>9. Menus</h2> |
|---|
| 292 | A description of the EXPGUI menus follows along with a very |
|---|
| 293 | brief description of the function of each menu option. |
|---|
| 294 | Note that an option may appear under more than one menu. |
|---|
| 295 | <H3>9.1 File Menu</H3> |
|---|
| 296 | <DL><DL> |
|---|
| 297 | The options on the File menu as is the custom contains the commands |
|---|
| 298 | for reading and writing experiment files, as well as starting |
|---|
| 299 | and ending the program. |
|---|
| 300 | <DL> |
|---|
| 301 | <DT>expnam<DD> |
|---|
| 302 | Select an existing GSAS experiment to be used. If a name is entered |
|---|
| 303 | that does not exists, it is possible to create a new |
|---|
| 304 | experiment file from scratch. |
|---|
| 305 | <DT>Save<DD>Saves modifications to the current experiment file to disk (shortcut Alt-S). |
|---|
| 306 | <DT>Save As<DD>Saves modifications to the current experiment file to disk |
|---|
| 307 | under a new file name |
|---|
| 308 | <DT>Reread .EXP file<DD>Reread the last saved version of the experiment file from disk. |
|---|
| 309 | <DT>EraseHistory<DD>Deletes old history records to speed reading of the .EXP file. |
|---|
| 310 | <DT>convert<DD>Convert a standard ASCII file to the direct access format used by GSAS (and for UNIX, the reverse) |
|---|
| 311 | <DT>exit<DD>Exit EXPGUI (shortcut Alt-X or ^C) |
|---|
| 312 | </DL> |
|---|
| 313 | <img SRC="m1.gif" BORDER=3 > |
|---|
| 314 | </DL></DL> |
|---|
| 315 | |
|---|
| 316 | <h3>9.2 Options Menu</h3> |
|---|
| 317 | <DL><DL> |
|---|
| 318 | This menu contains options that determine how EXPGUI runs. |
|---|
| 319 | <DL> |
|---|
| 320 | <DT>archive EXP<DD>Toggles archiving of .EXP files. When on, files are |
|---|
| 321 | saved prior to each save or run of expedt in a file named |
|---|
| 322 | [expnam].EXP.xxx.gz where xxx = 000, 001 (UNIX) |
|---|
| 323 | or in a file named [expnam].ZIP or [expnam].xxx (Windows) |
|---|
| 324 | <DT>Use DISAGL Window<DD>When this option is set, results from DISAGL are |
|---|
| 325 | shown in a separate window. When it is not set, the results are |
|---|
| 326 | written in the .LST file. |
|---|
| 327 | <DT>Sort atoms by<DD> Determines the order that atoms are displayed on the "Phase" page |
|---|
| 328 | Atoms may be displayed sorted by atom number, atom type, |
|---|
| 329 | or by x, y or z |
|---|
| 330 | |
|---|
| 331 | <DT>Sort histograms by<DD>Determines the order that histograms are displayed on the |
|---|
| 332 | Histogram, Scaling and Profile pages |
|---|
| 333 | |
|---|
| 334 | Histograms may be sorted by histogram number, histogram type, |
|---|
| 335 | original bank number, or diffraction angle/wavelength |
|---|
| 336 | <DT><A href="#multiplehistogram">Multiple hist. selection</A><DD> |
|---|
| 337 | When this mode is off, it is possible to modify parameters |
|---|
| 338 | and refinement flags for only a single histogram. For other settings, |
|---|
| 339 | it is possible to modify parameters and flags for groups of |
|---|
| 340 | histograms (see help for Mouse actions). |
|---|
| 341 | |
|---|
| 342 | It does not make sense, however, to globally modify |
|---|
| 343 | instrument-related parameters and flags for different histogram types. |
|---|
| 344 | So global actions can be limited to a single class of histogram types |
|---|
| 345 | (e.g. TOF, CW Neutron,...), which allows these parameters to be set |
|---|
| 346 | for groups of similar histograms. Thus, if this mode is set to "All" |
|---|
| 347 | the Histogram and Profile pages are disabled. |
|---|
| 348 | <DT>Override backspace<DD>This option is available in UNIX only, as there are different |
|---|
| 349 | ways that backspace can be implemented. When option is set |
|---|
| 350 | as "On," the backspace key is overridden to send a "delete" |
|---|
| 351 | character. If backspace does not work in a program such as |
|---|
| 352 | EXPEDT, change try the other setting for this option. |
|---|
| 353 | <DT>Autoupdate EXP<DD>Normally EXPGUI prompts before rereading the EXP |
|---|
| 354 | file when GENLES, POWPREF,... are run (this is so that one can change |
|---|
| 355 | the experiment file and rerun with the current input). If this option is |
|---|
| 356 | set, the new file is automatically read without a prompt. |
|---|
| 357 | This option is not available in Windows. |
|---|
| 358 | |
|---|
| 359 | <DT>SaveOptions<DD>Save the current values for "Override backspace", |
|---|
| 360 | "Sort atoms by", "Sort histograms by" and "archive EXP" |
|---|
| 361 | in file ~/.gsas_config (c:\.gsas_config on Windows). |
|---|
| 362 | <DT>liveplot_options<DD>Used to set options for liveplot, |
|---|
| 363 | for example, the histogram to be plotted |
|---|
| 364 | </DL> |
|---|
| 365 | <img SRC="m2.gif" BORDER=3> |
|---|
| 366 | </DL></DL> |
|---|
| 367 | |
|---|
| 368 | <h3>9.3 Powder Menu</h3> |
|---|
| 369 | <DL><DL> |
|---|
| 370 | This menu contains links to GSAS programs used for powder diffraction |
|---|
| 371 | analysis. |
|---|
| 372 | <DL> |
|---|
| 373 | <DT>expedt<DD>Run GSAS experiment editor (shortcut Alt-E) |
|---|
| 374 | <DT>powpref<DD>Powder data preparation (shortcut Alt-P) |
|---|
| 375 | <DT>genles<DD>Run GSAS experiment editor (shortcut Alt-G) |
|---|
| 376 | <DT>powplot<DD>Display powder patterns |
|---|
| 377 | <DT>rawplot<DD>Plot powder data |
|---|
| 378 | <DT>fitspec<DD>Fit a TOF vanadium scattering spectrum |
|---|
| 379 | <DT>tofnorm<DD>Normalize a TOF spectrum |
|---|
| 380 | </DL> |
|---|
| 381 | <img SRC="m3.gif" BORDER=3> |
|---|
| 382 | </DL></DL> |
|---|
| 383 | |
|---|
| 384 | <h3>9.4 Single Crystal Menu</h3> |
|---|
| 385 | <DL><DL> |
|---|
| 386 | This menu contains links to GSAS programs used for |
|---|
| 387 | single-rystal diffraction analysis. |
|---|
| 388 | <DL> |
|---|
| 389 | <DT>expedt<DD>Run GSAS experiment editor (shortcut Alt-E) |
|---|
| 390 | <DT>genles<DD>Run GSAS experiment editor (shortcut Alt-G) |
|---|
| 391 | <DT>scabs<DD>Single crystal absorption |
|---|
| 392 | <DT>scmerge<DD>Sort and merge single crystal data |
|---|
| 393 | <DT>sxtldata<DD>Prepare generic single crystal data |
|---|
| 394 | </DL> |
|---|
| 395 | <img SRC="m4.gif" BORDER=3> |
|---|
| 396 | </DL></DL> |
|---|
| 397 | |
|---|
| 398 | <h3>9.5 Graphics Menu</h3> |
|---|
| 399 | <DL><DL> |
|---|
| 400 | This menu contains links to several GSAS and |
|---|
| 401 | two non-GSAS (liveplot and widplt) |
|---|
| 402 | programs used for graphical display of data and results. |
|---|
| 403 | <DL> |
|---|
| 404 | <DT>forplot<DD>Display Fourier maps (set Fourier options in EXPEDT |
|---|
| 405 | and then compute with FOURIER |
|---|
| 406 | <DT>polfplot<DD>Display polefigures |
|---|
| 407 | <DT>powplot<DD>Display powder patterns |
|---|
| 408 | <DT>ortep<DD>Draw crystal structure |
|---|
| 409 | <DT>rawplot<DD>Plot powder data |
|---|
| 410 | <DT>fourier<DD>Generate Fourier map |
|---|
| 411 | <DT>forsrh<DD>Search Fourier map for peaks |
|---|
| 412 | <DT>liveplot<DD>Create a plot of powder data |
|---|
| 413 | with zooming, automatic update and other nice features. |
|---|
| 414 | <DT>vrstplot<DD>Create a VRML 3-D file for viewing with 3rd party software |
|---|
| 415 | <DT>widplt<DD>Displays the FWHM as a function of Q, 2Theta,... for UVWXY values input or read from an EXP file |
|---|
| 416 | </DL> |
|---|
| 417 | <img SRC="m5.gif" BORDER=3> |
|---|
| 418 | </DL></DL> |
|---|
| 419 | |
|---|
| 420 | <h3>9.6 Results Menu</h3> |
|---|
| 421 | <DL><DL> |
|---|
| 422 | This menu contains links to several GSAS and |
|---|
| 423 | one non-GSAS (lstview) |
|---|
| 424 | programs used for analysis of results. |
|---|
| 425 | <DL> |
|---|
| 426 | <DT>bijcalc<DD>Thermal parameter analysis |
|---|
| 427 | <DT>disagl<DD>Distance/angle calculations |
|---|
| 428 | <DT>reflist<DD>List reflection data |
|---|
| 429 | <DT>geometry<DD>Molecular geometry calculations |
|---|
| 430 | <DT>hstdmp<DD>List powder histogram data |
|---|
| 431 | <DT>istats<DD>HKL Intensity statistics |
|---|
| 432 | <DT>rcalc<DD>Compute reflection resuduals |
|---|
| 433 | <DT>composition<DD>Computes the chemical composition of a unit cell |
|---|
| 434 | accounting for site multiplicies and occupancies |
|---|
| 435 | <DT>lstview<DD>Create a box with scrollbars containing the current .LST file |
|---|
| 436 | </DL> |
|---|
| 437 | <img SRC="m6.gif" BORDER=3> |
|---|
| 438 | </DL></DL> |
|---|
| 439 | |
|---|
| 440 | <h3>9.7 Calculations Menu</h3> |
|---|
| 441 | <DL><DL> |
|---|
| 442 | This menu contains programs for useful crystallographic computations. |
|---|
| 443 | <DL> |
|---|
| 444 | <DT>cllchg<DD>Transform unit cell |
|---|
| 445 | <DT>fprime<DD>Compute f, f', f'' and mu/rho for an element for a range of x-ray wavelengths |
|---|
| 446 | <DT>rducll<DD>Unit cell reduction |
|---|
| 447 | <DT>spcgroup<DD>Space group symbol interpreter |
|---|
| 448 | <DT>unimol<DD>Unique molecule assembler |
|---|
| 449 | </DL> |
|---|
| 450 | <img SRC="m7.gif" BORDER=3> |
|---|
| 451 | </DL></DL> |
|---|
| 452 | |
|---|
| 453 | <h3>9.8 Import/Export Menu</h3> |
|---|
| 454 | <DL><DL> |
|---|
| 455 | This menu contains utilities for importing information into GSAS and |
|---|
| 456 | exporting. |
|---|
| 457 | <DL> |
|---|
| 458 | <DT>exp2xtl<DD>Prepare a .XTL format file of atomic positions. This |
|---|
| 459 | file is used in MSI software such as Cerius and InsightII. |
|---|
| 460 | <DT>gsas2cif<DD>Prepare IUCr crystallographic information (CIF) file |
|---|
| 461 | <DT>hklsort<DD>Prepare HKL tables |
|---|
| 462 | <DT>pubtable<DD>Prepare atom parameter tables |
|---|
| 463 | <DT>convert<DD>Convert a standard ASCII file to the direct access format used by GSAS (and for UNIX, the reverse) |
|---|
| 464 | <DT>cad4rd<DD>Prepare CAD4 single crystal data |
|---|
| 465 | <DT>dbwscnv<DD>Convert a powder diffraction data file from DBWS format |
|---|
| 466 | <DT>x17bcnv<DD>Convert an energy dispersive diffractogram data file from NSLS X17b |
|---|
| 467 | <DT>p3r3data<DD>Prepare Siemens/Brucker P3R3 single crystal data |
|---|
| 468 | <DT>sxtldata<DD>Prepare generic single crystal data |
|---|
| 469 | </DL> |
|---|
| 470 | <img SRC="m8.gif" BORDER=3> |
|---|
| 471 | </DL></DL> |
|---|
| 472 | |
|---|
| 473 | <h2>10. EXPGUI Utility Programs</h2></a> |
|---|
| 474 | <DL><DL> |
|---|
| 475 | <P><B>LSTVIEW</B> |
|---|
| 476 | |
|---|
| 477 | <P>lstview is used to browse through the GSAS output listing. It is |
|---|
| 478 | invoked by the "lstview" command in the GUI. |
|---|
| 479 | <CENTER><IMG SRC="textview.gif"></CENTER> |
|---|
| 480 | |
|---|
| 481 | |
|---|
| 482 | <P><B>LIVEPLOT</B> |
|---|
| 483 | |
|---|
| 484 | <P>liveplot shows the observed, calculated and difference plots for powder |
|---|
| 485 | refinements. The plot is updated as the refinement progresses. The mouse can |
|---|
| 486 | be used to zoom in on sections of the plot. |
|---|
| 487 | Liveplot uses the <A href="#blt">BLT</A> graphics package. |
|---|
| 488 | <CENTER><IMG SRC="liveplot.gif"></CENTER> |
|---|
| 489 | <IMG SRC="new.gif" HEIGHT=13 WIDTH=36> |
|---|
| 490 | LIVEPLOT can now be enhanced to superimpose peak locations for |
|---|
| 491 | input unit cells or peaks from JCPDS/ICDD entries. |
|---|
| 492 | See the <A HREF="expgui_cfg.html#liveplot"> |
|---|
| 493 | LIVEPLOT customization information</A> |
|---|
| 494 | or read file <tt>expgui_cfg.html</tt> in the <tt>gsas/tcl/doc</tt> directory. |
|---|
| 495 | <P> |
|---|
| 496 | LIVEPLOT gets the current diffraction information by running the TCLDUMP program, if installed, or |
|---|
| 497 | HSTDUMP otherwise. The TCLDUMP program has been optimized for use with LIVEPLOT and offers a number of extra |
|---|
| 498 | options that are not available when HSTDUMP is used: plots can be displayed in the native units (2Theta/TOF/KeV), or |
|---|
| 499 | in d-space or Q; fixed plus fitted background curves are shown in green; if reflection tickmarks are displayed, |
|---|
| 500 | reflection tickmarks can be displayed by holding the shift key while pressing the left mouse button. |
|---|
| 501 | See the installation instructions for installing TCLDUMP. |
|---|
| 502 | <P><B>WIDPLT</B> |
|---|
| 503 | |
|---|
| 504 | <P>WIDPLT can be used to plot the actual peak widths generated by the profile |
|---|
| 505 | parameters used in GSAS. |
|---|
| 506 | It is possible to define reference curves |
|---|
| 507 | that are loaded automatically. |
|---|
| 508 | WIDPLT uses the <A href="#blt">BLT</A> graphics package. |
|---|
| 509 | <CENTER><IMG SRC="widplt.gif"></CENTER> |
|---|
| 510 | <BR> |
|---|
| 511 | </DL></DL> |
|---|
| 512 | |
|---|
| 513 | <A name=blt> |
|---|
| 514 | <H2> |
|---|
| 515 | BLT</H2> |
|---|
| 516 | The BLT graphics package is used by the WIDPLT and LIVEPLOT routines. If the |
|---|
| 517 | package can not be loaded these routines, an error message, |
|---|
| 518 | "Error -- Unable to load the BLT package", will be displayed. A frequent |
|---|
| 519 | problem is the package is installed, but not configured so that common |
|---|
| 520 | support routines are loaded automatically. If this is the case, |
|---|
| 521 | a message, "BLT Setup Error: could not access a Blt_ routine...", |
|---|
| 522 | will be displayed. |
|---|
| 523 | Please see |
|---|
| 524 | <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html"> |
|---|
| 525 | http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html |
|---|
| 526 | </A> for more information on installation of BLT. |
|---|
| 527 | |
|---|
| 528 | <H2> |
|---|
| 529 | Acknowledgements</H2> |
|---|
| 530 | Praise to Larson and |
|---|
| 531 | <A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://lansce.lanl.gov/lujan/staff12/vondreele.htm"> |
|---|
| 532 | Von Dreele</A> for GSAS, <A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://www.scriptics.com/">Ousterhout</A> |
|---|
| 533 | for Tcl/Tk, |
|---|
| 534 | Przemek Klosowski</A> |
|---|
| 535 | for convincing me to learn Tcl/Tk |
|---|
| 536 | and Jonathan Wasserman for starting this project. |
|---|
| 537 | |
|---|
| 538 | <A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html"> |
|---|
| 539 | GSAS</A> |
|---|
| 540 | is written by Allen C. Larson and <A HREF="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=http://lansce.lanl.gov/lujan/staff12/vondreele.htm"> |
|---|
| 541 | Robert B. Von Dreele</A>, MS-H805, |
|---|
| 542 | Los Alamos National Laboratory, Los Alamos, NM 87545. Problems, questions |
|---|
| 543 | or kudos concerning GSAS should be sent to Robert B. Von Dreele at |
|---|
| 544 | <A HREF="MAILTO:vondreele@lanl.gov">vondreele@lanl.gov</A> |
|---|
| 545 | <P>GSAS is Copyright, 1984-1997, The Regents of the University of California. |
|---|
| 546 | The GSAS software was produced under a U.S. Government contract (W-7405-ENG-36) |
|---|
| 547 | by the Los Alamos National Laboratory, which is operated by the University |
|---|
| 548 | of California for the U.S. Department of Energy. The U.S. Government is |
|---|
| 549 | licensed to use, reproduce, and distribute this software. Permission is |
|---|
| 550 | granted to the public to copy and use this software without charge, provided |
|---|
| 551 | that this notice and any statement of authorship are reproduced on all |
|---|
| 552 | copies. Neither the Government nor the University makes any warranty, express |
|---|
| 553 | or implied, or assumes any liability or responsibility for the use of this |
|---|
| 554 | software. |
|---|
| 555 | <P>EXPGUI is written by Brian H. Toby of the NIST Center for Neutron Research, |
|---|
| 556 | <A HREF="MAILTO:Brian.Toby@NIST.GOV">Brian.Toby@NIST.GOV</A> |
|---|
| 557 | with help from Jonathan Wasserman. |
|---|
| 558 | |
|---|
| 559 | <P>EXPGUI is not subject to copyright. Have fun with it. |
|---|
| 560 | |
|---|
| 561 | <p>Neither the U.S. Government nor any author makes any warranty, |
|---|
| 562 | expressed or implied, or assumes any liability or responsibility |
|---|
| 563 | for the use of this information or the software described |
|---|
| 564 | here. Brand names cited here are used for |
|---|
| 565 | identification purposes and do not consitute an endorsement by NIST. |
|---|
| 566 | |
|---|
| 567 | <p><a href="http://www.ncnr.nist.gov/staff/toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>) |
|---|
| 568 | <br> |
|---|
| 569 | $Revision: 148 $ $Date: 2009-12-04 23:01:12 +0000 (Fri, 04 Dec 2009) $ |
|---|
| 570 | </body> |
|---|
| 571 | </html> |
|---|
