Changeset 919

Timestamp:

Dec 4, 2009 5:14:19 PM (14 years ago)

Author:

toby

Message:

# on 2008/04/15 17:31:53, toby did:
formatting
doc new Prompt after GSAS run option
doc macro capability

File:

• trunk/doc/expguic.html (modified) (14 diffs, 3 props)

trunk/doc/expguic.html

@@ -39 +39 @@
 <a name="1"></a>
 <H3>C.1 File Menu</H3>
-<DL><DL>
+<BLOCKQUOTE>
 The options on the File menu as is the custom contains the commands 
 for reading and writing experiment files, as well as starting 
@@ -60 +60 @@
 </DL>
 <img SRC="m1.gif" BORDER=3 alt="EXPGUI Screen snapshot">
-</DL></DL>
+</BLOCKQUOTE>
 
 <a name="2"></a>
 <h3>C.2 Options Menu</h3>
-<DL><DL>
+<BLOCKQUOTE>
 This menu contains options that determine how EXPGUI runs.
 <DL>
@@ -107 +107 @@
 who find this behavior annoying.
 
+<a name="execprompt"></a>
+<DT>Prompt after GSAS run<DD>
+<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
+By default, GSAS programs are run in a separate window 
+and after the program completes, the window remains open until enter is
+pressed in the window. Turning the "Prompt after GSAS run" option off, causes
+the window to be closed immediately after the program completes, saving 
+some effort but obliterating any error messages or other evidence of problems.
+
 <a name="AutostartGRWND"></a>
 <DT>Autostart GRWND
-<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
 <DD>
 This option is available on Windows-95, -98 and -ME to deal with a operating
@@ -126 +134 @@
         occupancy, or by x, y or z coordinate
 <P>
-<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
 Clicking on the heading above the atoms list cycles with the left
 mouse button cycles through the atom sort modes. Clicking with
@@ -157 +164 @@
 <a name="setfont"></a>
 <DT>Set Screen Font
-<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
 <DD>
 This menu changes the fonts used in most sections of EXPGUI. 
@@ -189 +195 @@
 </DL>
 <img SRC="m2.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
-</DL></DL>
+</BLOCKQUOTE>
 
 <a name="3"></a>
 <h3>C.3 Powder Menu</h3>
-<DL><DL>
+<BLOCKQUOTE>
 This menu contains links to GSAS programs used for powder diffraction
 analysis.
@@ -205 +211 @@
 <DT>tofnorm<DD>Normalize a TOF spectrum
 <DT><a HREF="liveplot.html#bkgedit">bkgedit</a>
-<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
 <DD>Invokes the <a HREF="liveplot.html#bkgedit">BKGEDIT</a> program
 to fit a background function to a set of fixed background points.
 <DT><a HREF="excledt.html">excledt</a>
-<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
 <DD>Invokes the <a HREF="excledt.html">EXCLEDT</a> program
 to set the upper and lower limits for a histogram, as well as
@@ -215 +219 @@
 </DL>
 <img SRC="m3.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
-</DL></DL>
+</BLOCKQUOTE>
 
 <a name="4"></a>
 <h3>C.4 Single Crystal Menu</h3>
-<DL><DL>
+<BLOCKQUOTE>
 This menu contains links to GSAS programs used for 
 single-rystal diffraction analysis.
@@ -230 +234 @@
 </DL>
 <img SRC="m4.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
-</DL></DL>
+</BLOCKQUOTE>
 
 <a name="5"></a>
 <h3>C.5 Graphics Menu</h3>
-<DL><DL>
+<BLOCKQUOTE>
 This menu contains links to several GSAS and 
 two non-GSAS (<a HREF="liveplot.html#liveplot">LIVEPLOT</a>,
@@ -256 +260 @@
 </DL>
 <img SRC="m5.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
-</DL></DL>
+</BLOCKQUOTE>
 
 <a name="6"></a>
 <h3>C.6 Results Menu</h3>
-<DL><DL>
+<BLOCKQUOTE>
 This menu contains links to several GSAS and 
 one non-GSAS (lstview)
@@ -279 +283 @@
 </DL>
 <img SRC="m6.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
-</DL></DL>
+</BLOCKQUOTE>
 
 <a name="7"></a>
 <h3>C.7 Calculations Menu</h3>
-<DL><DL>
+<BLOCKQUOTE>
 This menu contains programs for useful crystallographic computations.
 <DL>
@@ -293 +297 @@
 </DL>
 <img SRC="m7.gif" BORDER=3 alt="EXPGUI Screen snapshot">
-</DL></DL>
+</BLOCKQUOTE>
 
 <a name="8"></a>
 <h3>C.8 Import/Export Menu</h3>
-<DL><DL>
+<BLOCKQUOTE>
 This menu contains utilities for importing information into GSAS and
 exporting.
@@ -321 +325 @@
 </DL>
 <img SRC="m8.gif"  BORDER=3 alt="EXPGUI Screen snapshot">
-</DL></DL>
-
-
+</BLOCKQUOTE>
+
+<a name="9"></a>
+<h3>C.9 Macro Menu
+<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
+</h3>
+<BLOCKQUOTE>
+The macro capability allows actions performed in EXPGUI to be captured into a
+file as a series of Tcl command.
+It is then possible to repeat the actions in a macro repeatedly 
+by replaying the macro. Note that macro files can be edited and 
+Tcl/Tk commands can be added to the macros to expand capabilities. 
+As an example, this code
+<blockquote><TT><PRE>
+runAddHist Data.raw 11BM-12D.INS 1 1 T 59.9995
+runAddHist Data.raw 11BM-12D.INS 2 2 T 57.9995
+runAddHist Data.raw 11BM-12D.INS 3 3 T 55.9995
+runAddHist Data.raw 11BM-12D.INS 4 4 T 53.9995
+</PRE></TT></blockquote>
+can be modified to prompt for a file name and then use it in a macro:
+<blockquote><TT><PRE>
+set DataFile [tk_getOpenFile -defaultextension .raw]
+runAddHist $DataFile 11BM-12D.INS 1 1 T 59.9995
+runAddHist $DataFile 11BM-12D.INS 2 2 T 57.9995
+runAddHist $DataFile 11BM-12D.INS 3 3 T 55.9995
+runAddHist $DataFile 11BM-12D.INS 4 4 T 53.9995
+</blockquote></TT></DL>
+<DL>
+<DT>Record EXPGUI macro<DD>
+When this option is turned on, subsequent actions are recorded into the 
+selected macro file. 
+<DT>Add comment to macro<DD>
+If this option is selected, a window is opened where a string can be typed.
+This information is then entered at the current point within the macro file
+as a comment. 
+<DT>Replay macro line-at-a-time<DD>
+When this option is used, a macro file is selected by the user; the 
+contents of the macro file is displayed, and button can be pressed to execute 
+each command in the macro file. By clicking on a line in a macro file, that line
+will be the next to be run, so that sections of the file can be skipped over
+or repeated. The macro can also be edited within the file viewer window.
+<DT>Replay macro all at once<DD>
+When this option is used, a macro file is selected by the user, and then
+all commands in the macro file are executed. A status window is opened that 
+shows the number of refinement cycles, Chi<sup>2</sup> and the last sum of 
+shifts and also allows macros to be aborted. Note that any GSAS run in progress
+will run to completion before the Abort is invoked.
+Note that <A href="#Autoupdate">Autoload EXP</A> is temporarily set to 
+on and <A href="#execprompt">Prompt after GSAS run</A>
+is temporarily set to off, when this command is invoked, so that the macro 
+runs without need for prompts.
+
+<DT>Show GSAS output in window<DD>
+When this option is selected, GSAS programs are run in a separate window
+that is created for each program run -- even during macro execution. 
+When this option is deselected, output from GSAS programs is placed in a 
+separate file 
+(<I>XXXXXXXX</I>_mac.LST where <I>XXXXXXXX</I> is the experiment name) 
+and LSTVIEW is opened to view the output from that .LST file.
+</DL>
+</BLOCKQUOTE>
 <hr>
 <TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
@@ -331 +393 @@
 </TH></TR></TABLE>
 
-<P><font size=-1><A HREF="MAILTO:crystal@NIST.gov?subject=WWW page <?=$PHP_SELF?>">Comments, corrections or questions: crystal@NIST.gov</A></font><BR>
+<P>
 <font size=-1><? lastmod(); ?> </font>
 <br>