source: trunk/doc/expguic.html

Last change on this file was 1225, checked in by toby, 8 years ago

update to latest, with Fourier & f'/f

  • Property svn:keywords set to Author Date Revision Id
  • Property svn:mime-type set to text/html
File size: 21.3 KB
Line 
1<html>
2<head>
3   <title>EXPGUI</title>
4   <meta name="keywords" content="crystallography, Rietveld, diffraction,
5   GSAS, EXPGUI">
6</HEAD>
7<style>
8A:link {text-decoration:none}
9A:vlink {text-decoration:none}
10</style>
11
12<BODY BGCOLOR="#FFFFFF"
13      topmargin="0" leftmargin="0" marginwidth="0" marginheight="0" 
14      text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff">
15
16<?
17   include("/var/www/include/navigation.inc");
18   include("/var/www/include/utility.inc");
19?>
20<blockquote><font face="arial, helvetica, sans-serif">
21
22<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
23<TR><TH><A  Href="expgui.html">EXPGUI top</A> 
24</TH><TH><A Href="liveplot.html">Next page<BR>(Utilities)</A>
25</TH><TH><A Href="expgui7.html">Previous page</A>
26</TH></TR></TABLE><BR CLEAR=ALL>
27
28<center><h1>
29<HR noshade width="75%" size="2" align="center">
30EXPGUI, Menu Contents
31<HR noshade width="75%" size="2" align="center">
32</h1></center>
33
34<h2>C. Menu Contents</h2>
35Note that the figures on this page are likely to be out of date with
36respect to the text. The text is updated more frequently. Also, note
37that not all menu options are available in Windows.
38
39<a name="1"></a>
40<H3>C.1 File Menu</H3>
41<BLOCKQUOTE>
42The options on the File menu as is the custom contains the commands
43for reading and writing experiment files, as well as starting
44and ending the program.
45<DL>
46<DT>Open<DD>
47        Select an existing GSAS experiment to be used. If a name is entered
48        that does not exists, it is possible to create a new
49        experiment file from scratch.
50<DT>expnam<DD>
51Equivalent to Open (included for historical reasons.)
52
53<DT>Save<DD>Saves modifications to the current experiment file to disk (shortcut Alt-S).
54<DT>Save As<DD>Saves modifications to the current experiment file to disk
55        under a new file name
56<DT>Reread .EXP file<DD>Reread the last saved version of the
57  experiment file from disk.
58<DT>Update GSAS/EXPGUI<DD>This queries the EXPGUI software repository
59  to see if any files in EXPGUI or GSAS has been updated. It then
60  offers the program user the option to update these files. The update
61  will fail if the user does not have permission to change the EXPGUI
62  or GSAS files. In this case, a system administrator may be needed.
63  <DT>revert<DD>Used to load an <a href="#archive">archived</A>
64    (backup) version of the current .EXP file.
65<DT>EraseHistory<DD>Deletes old history records to speed reading of the .EXP file.
66<DT>convert<DD>Convert a standard ASCII file to the direct access
67  format used by GSAS (and for UNIX, the reverse) -- this is not
68  likely to be needed, as GSAS now does most conversions automatically.
69<DT>exit<DD>Exit EXPGUI (shortcut Alt-X or ^C)
70</DL>
71<img SRC="m1.gif" BORDER=3 alt="EXPGUI Screen snapshot">
72</BLOCKQUOTE>
73
74<a name="2"></a>
75<h3>C.2 Options Menu</h3>
76<BLOCKQUOTE>
77This menu contains options that determine how EXPGUI runs.
78<a name="archive"></a>
79<DL>
80<DT>archive EXP<DD>
81  Toggles archiving of .EXP files. When on, files are
82        saved before they are overwritten by EXPGUI as a file
83        named <I>EXPNAM</I>.Oxx where xx is a pair of hexidecimal
84        digits (01, 02,..., 09, 0A,... OF, 10,... FF).
85        Each time that EXPGUI archives a file, note is placed in the .LST file
86        so that the saved file name can be associated with
87        the refinement stage. Turning this option off, prevents EXPGUI
88        from creating these <I>EXPNAM</I>.Oxx archive files, but
89        the will still be created by EXPEDT, GENLES,...
90<P>
91<DT>Use DISAGL Window<DD>When this option is set, results from DISAGL are
92         shown in a separate window. When it is not set, the results are
93        written in the .LST file. Note that on Windows, LSTVIEW can interfere
94        with putting output into the DISAGL window. The solution is to
95        close LSTVIEW before running DISAGL.
96
97<a name="Autoupdate"></a>
98<DT>Autoload EXP<DD>Normally EXPGUI prompts before rereading the EXP
99file when GENLES, POWPREF,... or other GSAS programs run
100If this option is set, the new file is automatically read without a prompt.
101The advantage of leaving this option off, is that
102you can opt to not load the
103revised .EXP file, which means that you reject the last set of changes.
104This is useful if
105GENLES blows up or you have done something wrong. The reason to 
106turning "autoload EXP" on is
107that there is one less thing to do when running GSAS programs.
108Note that it is still possible to reverse changes, if
109<a href="#archive">archive files</A>, but this may require more
110  effort. See the File/revert menu entry.
111<a name="execprompt"></a>
112<DT>Prompt after GSAS run<DD>
113<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
114By default, GSAS programs are run in a separate window
115and after the program completes, the window remains open until enter is
116pressed in the window. Turning the "Prompt after GSAS run" option off, causes
117the window to be closed immediately after the program completes, saving
118some effort but obliterating any error messages or other evidence of problems.
119
120<a name="Autoicon"></a>
121<DT>Iconify during GSAS<DD>
122If this option is turned on, the main EXPGUI window is shrunk to an icon
123(minimized) while GSAS programs are running and EXPGUI is suspended.
124The author prefers this mode, since there is no reason to have the
125screen cluttered with EXPGUI when it can't be used,
126but this is an option so that the mode can be turned off by those people
127who find this behavior annoying. It appears this option causes
128  problems on Windows 7.
129
130<a name="AutostartGRWND"></a>
131<DT>Autostart GRWND
132<DD>
133This option is available on Windows-95, -98 and -ME to deal with a operating
134system quirk that prevents the starting of the GRWND.EXE program,
135needed for graphics in GSAS programs such as POWPLOT, RAWPLOT, EXPEDT,...
136(this program is not needed for EXPGUI graphics, such as LIVEPLOT). It
137is not understood why this error happens or how to prevent it. One cure
138is to start this GRWND.EXE program before starting the GSAS program.
139If this option is selected, each time a GSAS program is started, a separate
140program TLIST.EXE is used to check if GRWND.EXE is running. If it is not,
141EXPGUI will start this program before starting the requested GSAS program.
142
143<a name="sortatoms"></a>
144<DT>Sort atoms by<DD>   Determines the order that atoms are displayed on the "Phase" pane
145        Atoms may be displayed sorted by number, atom type, site multiplity,
146        occupancy, or by x, y or z coordinate
147<P>
148Clicking on the heading above the atoms list cycles with the left
149mouse button cycles through the atom sort modes. Clicking with
150the right mouse button resets the atom sort mode to "number".
151
152<a name="sorthist"></a>
153<DT>Sort histograms by<DD>Determines the order that histograms are displayed on the
154        Histogram, Scaling and Profile panes
155
156        Histograms may be sorted by histogram number, histogram type,
157        original bank number, or diffraction angle/wavelength
158<DT><A href="expgui.html#multiplehistogram">Multiple hist. selection</A><DD>
159        When this mode is off, it is possible to modify parameters
160        and refinement flags for only a single histogram. For other settings,
161        it is possible to modify parameters and flags for groups of
162        histograms (see help for Mouse actions).
163
164        It does not make sense, however, to globally modify
165        instrument-related parameters and flags for different histogram types.
166        So global actions can be limited to a single class of histogram types
167        (e.g. TOF, CW Neutron,...), which allows these parameters to be set
168        for groups of similar histograms. Thus, if this mode is set to "All"
169        the Histogram and Profile panes are disabled.
170<DT>Override backspace<DD>This option is available in UNIX only, as there are different
171        ways that backspace can be implemented. When option is set
172        as "On," the backspace key is overridden to send a "delete"
173        character. If backspace does not work in a program such as
174        EXPEDT, change try the other setting for this option.
175
176<a name="setfont"></a>
177<DT>Set Screen Font
178<DD>
179This menu changes the fonts used in most sections of EXPGUI.
180Note that this setting can be saved with the
181SaveOptions menu option (below) so that EXPGUI automatically
182starts with the chosen font.
183
184<a name="exptoolout"></a>
185<DT>Show EXPTOOL output<DD>
186Normally EXPGUI does not show the output from EXPTOOL, when
187actions like adding atoms, phases or histograms is performed.
188If an error is detected, the output is shown. If
189there are problems with adding phases, atoms, histograms... and
190a window showing an error does not appear,
191this option should be set to "on" so the output from EXPTOOL is
192always shown.
193
194<DT>Save Options<DD>Save the current values for "Override backspace",
195        <a href="#sortatoms">"Sort atoms by"</a>,
196        <a href="#sorthist">"Sort histograms by"</a>,
197        <a href="#archive">"archive EXP"</a>,
198        <a href="#Autoupdate">"Autoload EXP"</a>,
199        <a href="#setfont">"Set Screen Font"</a>,
200        and
201        <a href="#Autoicon">"Iconify during GSAS"</a>
202       
203        in file ~/.gsas_config (or c:\gsas.config on Windows).
204<DT>Save Position<DD>Saves the current screen position of the EXPGUI
205  window as the starting point for future runs of EXPGUI in
206        in file ~/.gsas_config (or c:\gsas.config on Windows).
207
208<DT>liveplot_options<DD>Used to set options for
209<a HREF="liveplot.html#liveplot">LIVEPLOT</a>,
210for example, the histogram to be plotted
211<DT>Assign app to .EXP files<DD>(on Mac only) When selected, this
212  causes .EXP files to be linked (via the file resource fork) to the
213  EXPGUI applescript. This also causes the .EXP files to be displayed
214  with a GSAS icon.
215 
216</DL>
217<img SRC="m2.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
218</BLOCKQUOTE>
219
220<a name="3"></a>
221<h3>C.3 Powder Menu</h3>
222<BLOCKQUOTE>
223This menu contains links to GSAS programs used for powder diffraction
224analysis.
225<DL>
226<DT>expedt<DD>Run GSAS experiment editor (shortcut Alt-E)
227<DT>powpref<DD>Powder data preparation (shortcut Alt-P)
228<DT>genles<DD>Run GSAS experiment editor (shortcut Alt-G)
229<DT>powplot<DD>Display powder patterns
230<DT>rawplot<DD>Plot powder data
231<DT>fitspec<DD>Fit a TOF vanadium scattering spectrum
232<DT><a HREF="liveplot.html#bkgedit">bkgedit</a>
233<DD>Invokes the <a HREF="liveplot.html#bkgedit">BKGEDIT</a> program
234to fit a background function to a set of fixed background points.
235<DT><a HREF="excledt.html">excledt</a>
236<DD>Invokes the <a HREF="excledt.html">EXCLEDT</a> program
237to set the upper and lower limits for a histogram, as well as
238edit excluded regions.
239<DT>seqgsas<DD>Invokes the sequential GSAS refinement program to run
240  GENLES on a set of very similar data files.
241<DT>mustrplot<DD>Plot microstrain results
242<DT><a HREF="expgui.html#INSTEDIT">instedit</A><DD>Invokes the <a HREF="expgui.html#INSTEDIT">instedit</A>
243  to edit an instrument parameter file.
244<DT>New InstParm file<DD>Creates a new instrument parameter file using
245  <a HREF="expgui.html#INSTEDIT">instedit</A>.
246
247
248</DL>
249<img SRC="m3.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
250</BLOCKQUOTE>
251
252<a name="4"></a>
253<h3>C.4 Xtal (Single Crystal) Menu</h3>
254<BLOCKQUOTE>
255This menu contains links to GSAS programs used for
256single-rystal diffraction analysis.
257<DL>
258<DT>expedt<DD>Run GSAS experiment editor (shortcut Alt-E)
259<DT>genles<DD>Run GSAS experiment editor (shortcut Alt-G)
260<DT>scabs<DD>Single crystal absorption
261<DT>scmerge<DD>Sort and merge single crystal data
262<DT>sxtldata<DD>Prepare generic single crystal data
263</DL>
264<img SRC="m4.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
265</BLOCKQUOTE>
266
267<a name="5"></a>
268<h3>C.5 Graphics Menu</h3>
269<BLOCKQUOTE>
270This menu contains links to several GSAS and
271two non-GSAS (<a HREF="liveplot.html#liveplot">LIVEPLOT</a>,
272and widplt)
273programs used for graphical display of data and results.
274<DL>
275<DT>Fourier<DD>Provides an interface to set up computation of
276  Fourier maps and compute them using program Fourier.
277  Also see the <A HREF="#DRAWxtl">Export to DRAWxtl</A> interface,
278  which can be used to set up, compute, export and display Fourier
279  maps. Note that a Fourier map can be set up for only one phase
280  at a time.
281<DT>forsrh<DD>Search Fourier map for peaks
282<DT>forplot<DD>Display Fourier maps (set Fourier options in EXPEDT
283        and then compute with FOURIER
284<DT>polfplot<DD>Display polefigures
285<DT>powplot<DD>Display powder patterns
286<DT>ortep<DD>Draw crystal structure
287<DT>rawplot<DD>Plot powder data
288<DT>gsas2map<DD>Exports a Fourier map in formats used by other
289  programs (for example Fox and DRAWxtl).
290<DT><a HREF="liveplot.html#liveplot">liveplot</a>
291<DD>Invokes the <a HREF="liveplot.html#liveplot">LIVEPLOT</a> program
292to create a plot of powder data
293with zooming, automatic update and other nice features.
294<DT>vrstplot<DD>Create a VRML 3-D file for viewing with 3rd party software
295<DT>widplt<DD>Displays the FWHM as a function of Q, 2Theta,... for UVWXY values input or read from an EXP file
296<DT><a HREF="expgui.html#ABSPLT">absplt</A>
297<DD>The <a HREF="expgui.html#ABSPLT">absplt</A> program displays the
298  absorption/reflectivity correction curve for values used in a histogram.
299<DT>mustrplot<DD>Plot microstrain results
300<DT>seqplot<DD>Plot results from seqgsas
301</DL>
302<img SRC="m5.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
303</BLOCKQUOTE>
304
305<a name="6"></a>
306<h3>C.6 Results Menu</h3>
307<BLOCKQUOTE>
308This menu contains links to several GSAS and
309one non-GSAS (lstview)
310programs used for analysis of results.
311<DL>
312<DT>bijcalc<DD>Thermal parameter analysis
313<DT>disagl<DD>Distance/angle calculations
314<DT>disaglviewer<DD>Display results from distance/angle calculations
315  in a graphical browser.
316<DT>reflist<DD>List reflection data
317<DT>geometry<DD>Molecular geometry calculations
318<DT>hstdmp<DD>List powder histogram data
319<DT>istats<DD>HKL Intensity statistics
320<DT>rcalc<DD>Compute reflection resuduals
321<DT>composition<DD>Computes the chemical composition of a unit cell
322accounting for site multiplicies and occupancies
323<DT>lstview<DD>Create a box with scrollbars containing the current .LST file
324<DT>ramafit<DD>Fits torsion angle distributions, particularly in peptide
325chains, for use in restraints.
326<DT>seqplot<DD>Plot results from seqgsas
327</DL>
328<img SRC="m6.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
329</BLOCKQUOTE>
330
331<a name="7"></a>
332<h3>C.7 Calculations Menu</h3>
333<BLOCKQUOTE>
334This menu contains programs for useful crystallographic computations.
335<DL>
336<DT>cllchg<DD>Transform unit cell
337<DT>composition<DD>Computes the chemical composition of a unit cell
338accounting for site multiplicies and occupancies
339<DT>rducll<DD>Unit cell reduction
340<DT>spcgroup<DD>Space group symbol interpreter
341<DT>seqgsas<DD>Invokes the sequential GSAS refinement program to run
342  GENLES on a set of very similar data files.
343<DT>seqplot<DD>Plot results from seqgsas
344<DT>unimol<DD>Unique molecule assembler
345</DL>
346<img SRC="m7.gif" BORDER=3 alt="EXPGUI Screen snapshot">
347</BLOCKQUOTE>
348
349<a name="9"></a>
350<h3>C.8 Macro Menu
351<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
352</h3>
353<BLOCKQUOTE>
354The macro capability allows actions performed in EXPGUI to be captured into a
355file as a series of Tcl command.
356It is then possible to repeat the actions in a macro repeatedly
357by replaying the macro. Note that macro files can be edited and
358Tcl/Tk commands can be added to the macros to expand capabilities.
359As an example, this code
360<blockquote><TT><PRE>
361runAddHist Data.raw 11BM-12D.INS 1 1 T 59.9995
362runAddHist Data.raw 11BM-12D.INS 2 2 T 57.9995
363runAddHist Data.raw 11BM-12D.INS 3 3 T 55.9995
364runAddHist Data.raw 11BM-12D.INS 4 4 T 53.9995
365</PRE></TT></blockquote>
366can be modified to prompt for a file name and then use it in a macro:
367<blockquote><TT><PRE>
368set DataFile [tk_getOpenFile -defaultextension .raw]
369runAddHist $DataFile 11BM-12D.INS 1 1 T 59.9995
370runAddHist $DataFile 11BM-12D.INS 2 2 T 57.9995
371runAddHist $DataFile 11BM-12D.INS 3 3 T 55.9995
372runAddHist $DataFile 11BM-12D.INS 4 4 T 53.9995
373</blockquote></TT></DL>
374<DL>
375<DT>Record EXPGUI macro<DD>
376When this option is turned on, subsequent actions are recorded into the
377selected macro file.
378<DT>Add comment to macro<DD>
379If this option is selected, a window is opened where a string can be typed.
380This information is then entered at the current point within the macro file
381as a comment.
382<DT>Replay macro line-at-a-time<DD>
383When this option is used, a macro file is selected by the user; the
384contents of the macro file is displayed, and button can be pressed to execute
385each command in the macro file. By clicking on a line in a macro file, that line
386will be the next to be run, so that sections of the file can be skipped over
387or repeated. The macro can also be edited within the file viewer window.
388<DT>Replay macro all at once<DD>
389When this option is used, a macro file is selected by the user, and then
390all commands in the macro file are executed. A status window is opened that
391shows the number of refinement cycles, Chi<sup>2</sup> and the last sum of
392shifts and also allows macros to be aborted. Note that any GSAS run in progress
393will run to completion before the Abort is invoked.
394Note that <A href="#Autoupdate">Autoload EXP</A> is temporarily set to
395on and <A href="#execprompt">Prompt after GSAS run</A>
396is temporarily set to off, when this command is invoked, so that the macro
397runs without need for prompts.
398
399<DT>Show GSAS output in window<DD>
400When this option is selected, GSAS programs are run in a separate window
401that is created for each program run -- even during macro execution.
402When this option is deselected, output from GSAS programs is placed in a
403separate file
404(<I>XXXXXXXX</I>_mac.LST where <I>XXXXXXXX</I> is the experiment name)
405and LSTVIEW is opened to view the output from that .LST file.
406</DL>
407</BLOCKQUOTE>
408
409<a name="8"></a>
410<h3>C.9 Import/Export Menu</h3>
411<BLOCKQUOTE>
412This menu contains utilities for importing information into GSAS and
413exporting it to other programs.
414<DL>
415<DT>Coord Export<DD>This provides a series of routines that are used
416to write coordinates and possibly other information to files:<P>
417<DL>
418<DT>gsas2cif<DD>Prepares IUCr crystallographic information (CIF) file
419that documents the current refinement. The CIF contains the
420coordinates for all phases as well as the observed and computed
421diffraction patterns. The templates used by GSAS2CIF can be customized
422to provide a detailed description of the experimental measurements and
423results for use in documenting analysis for publication or
424deposition.
425<DT>coords-only CIF<DD>For export of intermediate results to another
426program, CIF can be a useful exchange format. This routine provides a
427CIF with the current coordinates from one phase and not much else.
428<a name="DRAWxtl"></a>
429<DT>export to DRAWxtl<DD>
430  <A HREF="http://www.lwfinger.net/drawxtl/">DRAWxtl</A>
431  is a very useful free program for display of structures and
432maps. This writes a .STR input file used in the DRAWxtl
433program and optionally launches DRAWxtl, if installed.
434While the control options offered by EXPGUI are relatively
435modest (display of polyhedra,
436selection for bonds to be drawn, display of Fourier contours),
437once the DRAWxtl program is launched, the full range of DRAWxtl
438options can be accessed from that program's GUI. When a Fourier map
439contour is included, the Fourier parameters are set, the map is
440computed (program fourier) and is converted to the format needed by
441DRAWxtl (program gsas2map) automatically.
442<DT>export to SHELX<DD>This writes coordinates for a selected phase in
443the .INS format used by SHELX and several other programs.
444<DT>export to PLATON<DD>This writes coordinates for a selected phase in
445the .SPF format used by PLATON
446<DT>export test format<DD>This demonstrates how a coordinate export
447routine can be added to EXPGUI. See the <A
448HREF="expgui_cfg.html#export">documentation on this</A> for further
449information.
450<DT>export to FOX<DD>This prepares a XML file with coordinates for use
451in the FOX program
452<DT>MSI .xtl<DD>Prepare a .XTL format file of atomic positions. This
453file is used in older Accelrys software such as Cerius and
454Insight-II. It may no longer be of value.
455</DL>
456
457<DT>CIF Export<DD>This provides a series of routines that are used
458to prepare CIF files:<P>
459<DL>
460<DT>gsas2cif<DD>Prepares IUCr crystallographic information (CIF) file
461that documents the current refinement. The CIF contains the
462coordinates for all phases as well as the observed and computed
463diffraction patterns. The templates used by GSAS2CIF can be customized
464to provide a detailed description of the experimental measurements and
465results for use in documenting analysis for publication or
466deposition.
467<DT>FillTemplate<DD>Used to edit the CIF template files used in GSAS2CIF
468<DT>CIFselect<DD>Used to select interatomic distances and angles to be
469included in the CIF created by GSAS2CIF.
470</DL>
471
472<DT>hklsort<DD>Prepare HKL tables
473<DT>pubtable<DD>Prepare atom parameter tables
474<DT>convert<DD>Convert a standard ASCII file to the direct access format used by GSAS (and for UNIX, the reverse)
475<DT>cad4rd<DD>Prepare CAD4 single crystal data
476<DT>dbwscnv<DD>Convert a powder diffraction data file from DBWS format
477<DT>x17bcnv<DD>Convert an energy dispersive diffractogram data file from NSLS X17b
478<DT>p3r3data<DD>Prepare Siemens/Brucker P3R3 single crystal data
479<DT>sxtldata<DD>Prepare generic single crystal data
480<DT>gsas2pdb<DD>
481Import (using GSAS2PDB & EXPEDT) and export coordinates (for
482macromolecular phases) to/from Protein Data Base files
483<DT>ref2asc<DD>
484Exports a GSAS reflection file to ASCII for use in non-GSAS programs
485<DT>ref2bin<DD>
486Imports an ASCII reflection file to the GSAS binary format
487<DT>gsas2map<DD>Exports a Fourier map in formats used by other
488  programs (for example Fox and DRAWxtl).
489</DL>
490<img SRC="m8.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
491</BLOCKQUOTE>
492
493<hr>
494<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
495<TR><TH><A  Href="expgui.html">EXPGUI top</A>
496</TH><TH><A Href="liveplot.html">Next page<BR>(Utilities)</A>
497</TH><TH><A Href="expgui7.html">Previous page</A>
498</TH></TR></TABLE>
499
500<P>
501<font size=-1><? lastmod(); ?> </font>
502<br>
503$Revision: 1225 $ $Date: 2012-11-08 19:42:25 +0000 (Thu, 08 Nov 2012) $
504</blockquote>
505</body>
506</html>
Note: See TracBrowser for help on using the repository browser.