Changeset 364
- Timestamp:
- Dec 4, 2009 5:04:56 PM (11 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/doc/expgui.html
- Property rcs:date changed from 2000/10/18 00:11:17 to 2000/12/22 21:14:32
- Property rcs:lines changed from +94 -17 to +136 -48
- Property rcs:rev changed from 1.15 to 1.16
r329 r364 41 41 GSAS package such as EXPEDT, GENLES, FOURIER... 42 42 These programs can be run from a menu or in many cases by pressing buttons. 43 43 EXPGUI is written using the 44 <A href="#tcltk">Tcl/Tk</A> scripting language. 44 45 <P> 45 46 This documentation describes the different actions that … … 67 68 <DL><DL> 68 69 When an experiment (.EXP) file is read, a copy is made in local 69 computer memory. The values in memory can then be edited 70 by selecting different 71 panes ("pages" or "panels") from the tabbed list, where 72 each pane is reserved for a different section of the .EXP file. 73 The changes values are written back out to the .EXP file when the 74 "File/Save" or "File/Save as" <A Href="expguic.html#1">menu bar options</A> 75 are used. The .EXP file is also automatically written before running any GSAS 76 programs, such as GENLES or EXPEDT. 77 70 computer memory. In most cases, values are changed in this 71 "in memory" copy of the experiment file 72 as this information is changed by the user on the screen. 73 <img SRC="rederror.gif" align=LEFT BORDER=3 alt="EXPGUI Screen snapshot"> 74 <IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!"> 75 If there is an error in the typed value, (for example if "1..0" is typed, or 76 "1.5" is typed where an integer is expected), these values are 77 not saved. In this case, the text is turned red, to indicate 78 that an error is present, as shown in the figure to the left, where "90.000x" 79 has been entered for alpha. 80 The edited version of the experiment file is written back out to 81 disk when the "File/Save" or "File/Save as" 82 <A Href="expguic.html#1">menu bar options</A> 83 are used. The File/Save operation is done automatically before any GSAS 84 programs, such as GENLES or EXPEDT, are run. 85 <P> 86 87 Since the GSAS experiment file is quite complex, 88 values are grouped together by function, approximately 89 following the outline of the EXPEDT program. 90 Each set of values is given a 91 "tabbed pane" on a window that has the appearance of a notebook (see below). 78 92 <center><B> 79 93 <br>The notebook pane tabs. 80 94 <br><img SRC="panebar1.gif" BORDER=3 alt="EXPGUI Screen snapshot"> 81 95 </center></B> 82 More information about each pane can be found using the links below. 96 In some cases, where values are 97 too numerious or complex to fit onto the notebook pane, one or more buttons 98 may be present on a pane that will create a separate window, 99 where the associated values can be modified. 100 These values are not recorded in the 101 "in memory" copy of the experiment file unless the "Save" button on this window 102 is pressed. If "Cancel" is pressed, no changes are made. 103 Each notebook pane is listed below with a link to the web page documenting 104 that pane. 83 105 84 106 <A Href="expgui1.html"> … … 97 119 <h3>A.7 Preferential Orientation Pane</h3> 98 120 </A> 99 <P>100 <img SRC="rederror.gif" align=LEFT BORDER=3 alt="EXPGUI Screen snapshot">101 <IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">102 Values changed in the entry boxes in these panes are103 immediately transferred to the "in memory" copy of the .EXP file, unless104 there is an error in the typed value, (for example if "1..0" is typed, or105 "1.5" is typed where an integer is expected.) When a value is invalid, it is106 not saved. In this case, the text is turned red, to indicate107 that an error is present, as shown in the figure to the left, where "90.000x"108 has been entered for alpha.109 121 <br clear=all> 110 122 </DL></DL> … … 179 191 </center></B> 180 192 193 <h3>Invoking of GSAS programs</h3> 194 When GSAS programs are invoked, in most cases EXPGUI is suspended while 195 the GSAS program is run in a terminal (or DOS) window. When the terminal 196 window is closed, EXPGUI is restarted. If desired (see the 197 <A Href="expguic.html#Autoicon"> 198 "Iconify during GSAS"</A> 199 option) while this occurs, EXPGUI can be made into an icon 200 to save screen space. 201 <P> 202 <img src="powpref4a.gif" align=left> 203 Once the GSAS program has finished, if the program has modified 204 the .EXP file, 205 <a Href="expguierr.html#Overwrite"> 206 "File has been modified..."</a>message box 207 similar to the one to the left is displayed (also see the more complete 208 discussion on the <a Href="expguierr.html#Overwrite">messages page</A>. 209 Note that this message can be avoided if the 210 <A Href="expguic.html#Autoupdate"> 211 "Autoload EXP"</A> 212 option is used. 213 <BR clear=all> 214 <P> 215 Note that in both Windows-95 and Windows-NT, a file named <tt>EXPGUI.LCK</tt> 216 is created while the GSAS program runs. The presence of this file is used 217 to suspend the LIVEPLOT program, since LIVEPLOT has sometimes crashed 218 when run at the same time as GENLES (no such problem has been seen in Unix). 219 This file is deleted when the GSAS program completes. 220 <P> 221 <img src="lock.gif" align=left> 222 In Windows-9x, the <a Href="expgui_Win_readme.html#Winexec">Winexec</a> 223 package is used to execute a command that creates a DOS window. 224 The GSAS programs are then run by a batch file in this DOS window. 225 Due to limitations in Tcl/Tk & Windows, the DOS window runs independently 226 of EXPGUI, so the lock file (<tt>EXPGUI.LCK</tt>) is also used to suspend 227 EXPGUI. While EXPGUI is waiting, the 228 <a Href="expguierr.html#lock"> 229 Please wait... 230 </a> 231 window shown to the left is displayed. When the GSAS program completes, the 232 lock file is deleted, the window automatically disappears and EXPGUI resumes. 233 Should a problem arise where the file is not deleted, EXPGUI can be resumed by 234 pressing the "Continue" button. 235 236 <BR clear=all> 237 <h3>GSAS menus</h3> 238 181 239 A description of the EXPGUI menus follows. Use the links to obtain 182 240 more information, including a very … … 255 313 256 314 <br clear=all> 257 <H3> LSTVIEW</H3>315 <H3>D.1 LSTVIEW</H3> 258 316 259 317 <DL><DL> … … 264 322 265 323 <br clear=all> 266 <H3> LIVEPLOT</H3>324 <H3>D.2 LIVEPLOT</H3> 267 325 <DL><DL> 268 326 liveplot shows the observed, calculated and difference plots for powder … … 289 347 290 348 <br clear=all> 291 <H3> WIDPLT</H3>349 <H3>D.3 WIDPLT</H3> 292 350 <DL><DL> 293 351 WIDPLT can be used to plot the actual peak widths generated by the profile … … 301 359 <br clear=all> 302 360 <a name="ConvertUnix"></a> 303 <h3>Unix File Conversions</h3> 304 <DL><DL> 305 In UNIX, GSAS data, experiment and instrument parameter files are expected to 361 <h3>D.4 File Conversions</h3> 362 <DL><DL> 363 <B>In UNIX</B>, 364 GSAS data, experiment and instrument parameter files are expected to 306 365 have a format with exactly 80 characters per line and no line 307 366 separators (no carriage returns or linefeeds). Files in this format … … 315 374 direct access for use in GSAS or to convert direct access files to 316 375 sequential, for use in standard UNIX programs, such as editors or e-mail. 317 </DL></DL> 318 319 <br clear=all> 376 <P> 320 377 <a name="ConvertWin"></a> 321 <h3>Windows File Conversions</h3> 322 <DL><DL> 323 In Windows, GSAS data, experiment and instrument parameter files are 378 <B>In Windows</B>, GSAS data, experiment and instrument parameter files are 324 379 expected to have a format with exactly 80 characters per line followed 325 380 by a carriage returns and a linefeed (82 characters total per line). … … 333 388 <br clear=all> 334 389 <a name="Composition"></a> 335 <h3> Compute Composition</h3>390 <h3>D.5 Compute Composition</h3> 336 391 <DL><DL> 337 392 The composition box shows the unit cell and asymmetric unit composition … … 342 397 <br clear=all> 343 398 <a name="ExportMSI"></a> 344 <h3> Export coordinates in MSI .xtl format</h3>399 <h3>D.6 Export coordinates in MSI .xtl format</h3> 345 400 <DL><DL> 346 401 The Export/exp2xtl routine writes a .xtl file, as is used in Insight-II and … … 353 408 <br clear=all> 354 409 <a name="DeleteHistoryRecords"></a> 355 <h3>D elete History Records</h3>410 <h3>D.7 Delete History Records</h3> 356 411 <DL><DL> 357 412 Every time a GSAS program (including EXPGUI) is run, an entry is added to … … 370 425 </DL></DL> 371 426 427 <A name=tcltk> 428 <H2> 429 <A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html"> 430 Tcl/Tk</A></H2> 431 The 432 <A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html"> 433 Tcl/Tk program</A> is a platform-independent scripting language that is 434 used to implement most of EXPGUI. This software is available for free 435 and must be loaded in order to use EXPGUI. See the 436 installation notes for 437 <A HREF="expgui_Win_readme.html">Windows</A>, 438 and for 439 <A HREF="expgui_Unix_readme.html">UNIX</A> for information on how to do this. 440 While learning Tcl/Tk is a great thing to do, it is not a requirement 441 for using or installing EXPGUI. 442 443 <A name=winexec> 444 <H3> 445 WINEXEC</H3> 446 <UL> 447 The WINEXEC package is needed under Windows-95 and its offspring 448 (-98 and -ME). See the <A HREF="expgui_Win_readme.html">Windows installation 449 notes</A> for more details. 450 </UL> 451 372 452 <A name=blt> 373 <H2> 374 BLT</H2> 453 <H3> 454 BLT</H3> 455 <UL> 375 456 The BLT graphics package is used by the WIDPLT and LIVEPLOT routines. If the 376 package can not be loaded these routines, an error message,377 "Error -- Unable to load the BLT package", will be displayed. A frequent378 p roblem is the package is installed, but not configured so that common379 support routines are loaded automatically. If this is the case,380 a message, "BLT Setup Error: could not access a Blt_ routine...", 381 will be displayed. 382 Pleasesee457 package can not be found these routines, an error message, 458 "Error -- Unable to load the BLT package", will be displayed. It is also 459 possible for the package to be installed, but not configured properly. 460 If this is the case, a message, 461 "BLT Setup Error: could not access a Blt_ routine...", will be displayed. 462 This is most common in UNIX and is discussed further in the 463 <A HREF="expgui_Unix_readme.html">UNIX installation notes</A>. Also see 383 464 <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html"> 384 465 http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html 385 466 </A> for more information on installation of BLT. 467 </UL> 386 468 387 469 <H2> … … 394 476 for convincing me to learn Tcl/Tk 395 477 and Jonathan Wasserman for helping get this project started. 396 Large sections of the Preferred Orientation GUI were written by 397 Pamela Whitfield of the NRC (Canada). 478 Thanks also to 479 Pamela Whitfield of the NRC (Canada) for writing large 480 sections of the 481 <A Href="expgui7.html">Preferential Orientation Pane</A> 482 and the 483 <A Href="expgui6.html">Profile Constraints pane</A> 484 code. 398 485 <P> 399 486 <A Href="http://www.ncnr.nist.gov/programs/crystallography/software/gsas.html"> … … 420 507 software. 421 508 422 <P>EXPGUI is not subject to copyright. Have fun with it. Modify it. Write 509 <P>The author of EXPGUI is a U.S. Government employee which means that 510 EXPGUI is not subject to copyright. Have fun with it. Modify it. Please write 423 511 new sections and make them available to the rest of the world. 424 512 … … 426 514 expressed or implied, or assumes any liability or responsibility 427 515 for the use of this information or the software described 428 here. Brand names cited here are used for516 here. Brand names cited herein are used for 429 517 identification purposes and do not consitute an endorsement by NIST. 430 518
Note: See TracChangeset
for help on using the changeset viewer.