| 1 | <html> |
|---|
| 2 | <head> |
|---|
| 3 | <META NAME="Author" CONTENT="Brian H. Toby"> |
|---|
| 4 | <title>EXPGUI -- LIVEPLOT/BKGEDIT</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 | <br clear=all><hr> |
|---|
| 22 | |
|---|
| 23 | <TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT> |
|---|
| 24 | <TR><TH><A Href="expgui.html">EXPGUI top</A> |
|---|
| 25 | </TH></TR></TABLE><BR CLEAR=ALL> |
|---|
| 26 | |
|---|
| 27 | <center><h1> |
|---|
| 28 | LIVEPLOT and BKGEDIT |
|---|
| 29 | </h1></center> |
|---|
| 30 | This page documents the LIVEPLOT and BKGEDIT utility programs |
|---|
| 31 | in the EXPGUI package. |
|---|
| 32 | LIVEPLOT and BKGEDIT are actually the same program, but perform |
|---|
| 33 | different functions, depending on how they are invoked. |
|---|
| 34 | LIVEPLOT is used to display the quality of the diffraction fit, while |
|---|
| 35 | BKGEDIT is used to fit a background function to fixed background points |
|---|
| 36 | that have been input by the user. |
|---|
| 37 | <P> |
|---|
| 38 | Both LIVEPLOT and BKGEDIT get the current diffraction information |
|---|
| 39 | by running the TCLDUMP program, if installed, or |
|---|
| 40 | HSTDUMP otherwise. The TCLDUMP program has been optimized for use |
|---|
| 41 | with LIVEPLOT and offers a number of extra |
|---|
| 42 | options that are not available when HSTDUMP is used. Since TCLDUMP has been |
|---|
| 43 | included in GSAS since April of 2000, it is assumed that this is now the case. |
|---|
| 44 | |
|---|
| 45 | <a name="liveplot"></a> |
|---|
| 46 | <H3>LIVEPLOT</H3> |
|---|
| 47 | LIVEPLOT is started by pressing the LIVEPLOT button on the toolbar |
|---|
| 48 | or via the Graphs/liveplot menu item. |
|---|
| 49 | <P> |
|---|
| 50 | Some of the features available in LIVEPLOT are: |
|---|
| 51 | <UL> |
|---|
| 52 | <LI>The plot is updated automatically after each refinement run |
|---|
| 53 | <LI>The plot can be zoomed, by clicking on the corners of the |
|---|
| 54 | area to be magnified. |
|---|
| 55 | <LI> |
|---|
| 56 | The units used for plotting histograms can be selected. Choices are: |
|---|
| 57 | native units (2Theta/TOF/KeV); d-space (A) or Q (A<sup>-1</sup>) |
|---|
| 58 | <LI> |
|---|
| 59 | The background (fixed plus fitted) can be plotted or can be subtracted. |
|---|
| 60 | <LI> |
|---|
| 61 | Reflection tickmarks can be displayed in a variety of formats |
|---|
| 62 | <LI> |
|---|
| 63 | LIVEPLOT can be coupled to the LOGIC or CMPR programs, so that |
|---|
| 64 | peak positions from an ICDD entry or for an arbitrary unit cell and |
|---|
| 65 | spacegroup can be shown superimposed on the "Rietveld plot." |
|---|
| 66 | <LI> |
|---|
| 67 | <IMG SRC="note.gif" alt="Note!"> |
|---|
| 68 | Reflection indices (<I>hkl</I> values) can be shown for tickmarks |
|---|
| 69 | <LI> |
|---|
| 70 | <IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!"> |
|---|
| 71 | The cumulative chi<sup>2</sup> function can be plotted. |
|---|
| 72 | </UL> |
|---|
| 73 | |
|---|
| 74 | <a name="bkgedit"></a> |
|---|
| 75 | <H3>BKGEDIT</H3> |
|---|
| 76 | <IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!"> |
|---|
| 77 | For most refinements, it is possible to simply select a background |
|---|
| 78 | function (I find that the type 1 function, |
|---|
| 79 | shifted Chebyschev polynomials, work well) |
|---|
| 80 | and then refine, adding terms until a good fit is obtained. |
|---|
| 81 | On occasion, poor initial fits are obtained in this manner. This is |
|---|
| 82 | most common in cases where large numbers of peaks are poorly fit. Since |
|---|
| 83 | significant sections of the data are not well fit, the refinement results in |
|---|
| 84 | an unreasonable background function, because this yields better agreement |
|---|
| 85 | with the observed data. |
|---|
| 86 | In these cases, |
|---|
| 87 | it may be best to fix the background to follow a "reasonable" curve in the |
|---|
| 88 | initial stages and then refine the background in the final stages of |
|---|
| 89 | refinement, when a good model has been obtained. |
|---|
| 90 | <P> |
|---|
| 91 | The BKGEDIT program, as shown below, is used to input a set a background |
|---|
| 92 | points via the mouse. The points are then used to determine a type 1 |
|---|
| 93 | (Chebyschev) background function that fits the input background points. These |
|---|
| 94 | terms can then be saved in the experiment file creating a background that |
|---|
| 95 | is good enough for the initial stages of refinement and that can be |
|---|
| 96 | refined once the model is adequate for the task. |
|---|
| 97 | <P> |
|---|
| 98 | <IMG SRC="b1.gif" align=TEXTOP alt="BKGEDIT screen image"> |
|---|
| 99 | <H4>Steps in fitting a background function</H4> |
|---|
| 100 | The BKGEDIT program is started from |
|---|
| 101 | via the Powder/bkgedit menu item or by pressing the |
|---|
| 102 | "Fit Background Graphically" button on the |
|---|
| 103 | <A href="expgui3.html#EditBackground">"Edit Background"</A> |
|---|
| 104 | dialog box (invoked from the "Edit Background" button on the |
|---|
| 105 | <A href="expgui3.html">Histogram pane</A>.) |
|---|
| 106 | toolbar |
|---|
| 107 | or |
|---|
| 108 | <OL> |
|---|
| 109 | <LI><a href="#zoom">Zoom in</a> on the lower intensity section of the |
|---|
| 110 | plot, so that the background is clearly discernible. In some cases, the |
|---|
| 111 | data will need to be handled in sections. |
|---|
| 112 | <LI>Press the "Add" button to add background points. |
|---|
| 113 | Note the cursor changes from cross-hairs to an arrow, |
|---|
| 114 | when the "Add" button is pressed. |
|---|
| 115 | <LI>Move the mouse to the first location |
|---|
| 116 | where a background point will be added and click with the left |
|---|
| 117 | mouse button. A magenta triangle will appear at the location. |
|---|
| 118 | Points can be added in any order. It is best to make sure that the fixed points |
|---|
| 119 | are placed over the entire range of the data, e.g. near the maximum and minimum |
|---|
| 120 | data points in TOF, 2theta, etc. |
|---|
| 121 | <DL><DL> |
|---|
| 122 | Note that it is advisable to place many background points in areas where |
|---|
| 123 | the background varies greatly. |
|---|
| 124 | </DL></DL> |
|---|
| 125 | As background points are entered, they are saved in a file named |
|---|
| 126 | <I>EXPNAM</I><tt>.bkg</tt><I>N</I>, where |
|---|
| 127 | <I>EXPNAM</I> is the experiment name and <I>N</I> is the histogram number. |
|---|
| 128 | If BKGEDIT is restarted at some later time, these points are reread. |
|---|
| 129 | <LI>If any points are placed in incorrect positions, they can be deleted by |
|---|
| 130 | pressing the "Delete" button. The mouse cursor changes to a circle. When |
|---|
| 131 | the mouse left clicked, the fixed background point closest to the mouse |
|---|
| 132 | position (which may be outside the zoom range) is deleted. |
|---|
| 133 | <LI>Background points can also be edited by entering numbers into the |
|---|
| 134 | "Background points" area. |
|---|
| 135 | <LI>After enough background points have been entered, the |
|---|
| 136 | "Start Fit" button turns from gray to black. When pressed, the Chebyschev |
|---|
| 137 | polynomial is fitted and the resulting curve is shown as a blue dashed line. |
|---|
| 138 | <DL><DL> |
|---|
| 139 | It is suggested that you start with relatively few |
|---|
| 140 | terms and add terms and background points as needed. |
|---|
| 141 | Note that the maximum number of Chebyschev terms increases as |
|---|
| 142 | more background points are entered. |
|---|
| 143 | </DL></DL> |
|---|
| 144 | The "Improve Fit" button is black when the fit did not |
|---|
| 145 | converge or the number of terms has been changed. "Improve Fit" causes the |
|---|
| 146 | fit to be refined starting from the previous values. |
|---|
| 147 | <LI>Editing the Chebyschev terms is possible. The curve is reevaluated as |
|---|
| 148 | changes are made. |
|---|
| 149 | <LI>Once a good background function is determined, it can be saved in the |
|---|
| 150 | experiment file by pressing the "Save in EXP file & Exit" button. This will |
|---|
| 151 | set the background type to 1, and save the Chebyschev terms. |
|---|
| 152 | It will also turn off |
|---|
| 153 | the background refinement flag for the appropriate histogram so that the |
|---|
| 154 | terms are not refined inadvertently. |
|---|
| 155 | </OL> |
|---|
| 156 | |
|---|
| 157 | <P> |
|---|
| 158 | Note that POWPREF must be run at least once before BKGEDIT can be used, |
|---|
| 159 | however, use of |
|---|
| 160 | GENLES before BKGEDIT is optional. If the data range is changed, for example |
|---|
| 161 | by excluding a section of the data at the lower end, or changing tmax (dmin), |
|---|
| 162 | the Chebyschev polynomial terms must change to generate the same |
|---|
| 163 | background values, so both POWPREF and BKGEDIT should be rerun to |
|---|
| 164 | regenerate the Chebyschev terms. |
|---|
| 165 | |
|---|
| 166 | <H4>Why not use fixed background points?</H4> |
|---|
| 167 | I personally feel that |
|---|
| 168 | a refined background function is preferrable to use of a fixed model, |
|---|
| 169 | if at all possible. |
|---|
| 170 | One reason for this is that Rietveld refinements usually achieve better fits |
|---|
| 171 | when the background is optimized. A second reason refining the background |
|---|
| 172 | provides a |
|---|
| 173 | feel for the interaction between background values and displacement |
|---|
| 174 | (thermal) parameters. |
|---|
| 175 | Usually, background and displacement parameters are fairly independent, but |
|---|
| 176 | for some materials, where the high Q (high 2theta) portion of the pattern |
|---|
| 177 | has many completely overlapped peaks, it is impossible to uniquely |
|---|
| 178 | determine where the |
|---|
| 179 | background should be placed, either by refinement or by manual placement. |
|---|
| 180 | Under these circumstances, the background should be refined with the |
|---|
| 181 | displacement parameters fixed at an appropriate value for the material. The |
|---|
| 182 | background should then be fixed for all future refinements |
|---|
| 183 | and the displacement parameters can then be refined. <I>Of course this |
|---|
| 184 | means you have predjudiced the refinement to result in the expected |
|---|
| 185 | average displacement parameter and this </I><B>must</B><I> be noted |
|---|
| 186 | any publication. However, if this is necessary, the data simply do not |
|---|
| 187 | contain sufficient information to independently determine |
|---|
| 188 | background and displacement parameters. Use of fixed background points |
|---|
| 189 | would not demonstrate this and would lead the researcher to a false |
|---|
| 190 | sense of security (or fear, if the values are unreasonable) |
|---|
| 191 | that the displacement parameters actually mean something.</I> |
|---|
| 192 | <P> |
|---|
| 193 | If you still want to use fixed background points, despite this tirade, |
|---|
| 194 | be sure to set the estimated |
|---|
| 195 | error on those points to be 0.0. Use of non-zero estimated errors, can |
|---|
| 196 | result in artificially lowered R-factors and chi-squared values. |
|---|
| 197 | In one test, I was able to lower the R<sub>wp</sub> and |
|---|
| 198 | reduced chi<sup>2</sup> values, |
|---|
| 199 | from the correct values of 0.042 and 3.0, respectively, to misleading |
|---|
| 200 | values of 0.036 and 0.8, |
|---|
| 201 | respectively. [As expected, the R(F<sup>2</sup>) stayed constant at 0.045; |
|---|
| 202 | FYI, refining the background caused R(F<sup>2</sup>) to drop to 0.036.] |
|---|
| 203 | <P> |
|---|
| 204 | If the background is so truly irregular that only use of fixed background |
|---|
| 205 | points will do, |
|---|
| 206 | BKGEDIT can be used to generate these fixed background points. |
|---|
| 207 | The file used by BKGEDIT to save these points, |
|---|
| 208 | <I>EXPNAM</I><tt>.bkg</tt><I>N</I>, |
|---|
| 209 | can be read into EXPEDT by typing "@R" at the initial prompt |
|---|
| 210 | in EXPEDT: |
|---|
| 211 | <PRE> |
|---|
| 212 | Is this the file you wish to use? (<?>,D,K,Q,R,Y) ><u>@r</u> |
|---|
| 213 | </PRE> |
|---|
| 214 | prompt and then supplying the name of the file, in response to the next prompt: |
|---|
| 215 | <PRE> |
|---|
| 216 | Enter the name of your macro file: <u>GARNET.bkg1</u> |
|---|
| 217 | </PRE> |
|---|
| 218 | And this will enter the background points entered into BKGEDIT as GSAS |
|---|
| 219 | fixed background points. If you do this you do not want to fit and enter |
|---|
| 220 | Note that you are allowed to use both fixed and a refined background together, |
|---|
| 221 | though this is seldom done. |
|---|
| 222 | |
|---|
| 223 | <hr><h2>LIVEPLOT/BKGEDIT Features</h2> |
|---|
| 224 | <a name="zoom"></a> |
|---|
| 225 | <B>Plot zooming</B> |
|---|
| 226 | When the left (usual) mouse button is pressed, this defines one corner |
|---|
| 227 | of a region to be magnified, as is shown to the right. |
|---|
| 228 | If the mouse is then moved, the diagonal |
|---|
| 229 | corner of this magnification region is defined. When the left mouse button |
|---|
| 230 | is pressed a second time, the selected section of the plot is magnified to |
|---|
| 231 | fill the entire plot. |
|---|
| 232 | <P> |
|---|
| 233 | Zoom settings are saved. |
|---|
| 234 | If the right mouse button is pressed, the previous zoom setting is used, |
|---|
| 235 | so that the left mouse button is used to "zoom in" and the right mouse |
|---|
| 236 | button is used to "zoom out." |
|---|
| 237 | |
|---|
| 238 | <P> |
|---|
| 239 | <h2>Features in LIVEPLOT only</h2> |
|---|
| 240 | <img SRC="lz.gif" BORDER=3 align=RIGHT alt="EXPGUI Screen snapshot"> |
|---|
| 241 | <B>The cumulative chi<sup>2</sup></B> |
|---|
| 242 | function was first suggested by |
|---|
| 243 | Bill David as a way to see which reflections have the greatest influence on |
|---|
| 244 | chi<sup>2</sup> [W.I.F. David, <I>Accuracy in Powder Diffraction-III</I>, 2001]. |
|---|
| 245 | It is defined for point j as |
|---|
| 246 | <IMG SRC="cchi2.gif" alt="equation for cumulative chi2 function" ALIGN=TOP> |
|---|
| 247 | where y<sub>obs,i</sub> and y<sub>calc,i</sub> are the observed and computed |
|---|
| 248 | data points and sigma<sub>i</sub> is the expected error. Thus, the statistically |
|---|
| 249 | expected value for |
|---|
| 250 | [(y<sub>obs,i</sub>-y<sub>calc,i</sub>)/sigma<sub>i</sub>]<sup>2</sup> is 1 |
|---|
| 251 | and this function should rise in a smooth line if all points are fitted as |
|---|
| 252 | statistically expected. |
|---|
| 253 | <P> |
|---|
| 254 | In the plot to the right, the cumulative chi<sup>2</sup> function is shown in |
|---|
| 255 | purple. Note that first peak is not well fit, but the low angle "shoulder" is |
|---|
| 256 | as important as the peak misfitting, with respect to the chi<sup>2</sup>. |
|---|
| 257 | <br clear=all> |
|---|
| 258 | <P> |
|---|
| 259 | <img SRC="lind.gif" BORDER=3 align=RIGHT alt="EXPGUI Screen snapshot"> |
|---|
| 260 | <B>Reflection indices</B> |
|---|
| 261 | are be displayed by pressing "H" or "h" while the |
|---|
| 262 | mouse is near a reflection (holding the shift key while |
|---|
| 263 | pressing the left mouse button also works). The indices are shown |
|---|
| 264 | on the screen for phases with tickmarks (as shown to the right). |
|---|
| 265 | Indices are listed in the "Separate window for <I>hkl</I> labels" |
|---|
| 266 | (as seen below) for all phases, regardless of the tickmark settings. |
|---|
| 267 | Displayed indices will remain on the screen for a preset time and |
|---|
| 268 | then will be deleted, unless the labeling options are changed. |
|---|
| 269 | <img SRC="lind1.gif" align=LEFT alt="EXPGUI Screen snapshot"> |
|---|
| 270 | <P> |
|---|
| 271 | <br clear=all> |
|---|
| 272 | |
|---|
| 273 | <hr><h2>LIVEPLOT/BKGEDIT Menu Contents</h2> |
|---|
| 274 | A few of these options are omitted from BKGEDIT. |
|---|
| 275 | <DL><DL> |
|---|
| 276 | <img SRC="lm1.gif" align=RIGHT alt="EXPGUI Screen snapshot"> |
|---|
| 277 | <H3>File Menu</H3> |
|---|
| 278 | <DT>Tickmarks |
|---|
| 279 | <DD>Checkbuttons are provided for each phase to determine if tick marks |
|---|
| 280 | are shown. See the Options/"Configure Tickmarks"menu item for information |
|---|
| 281 | on tickmarks |
|---|
| 282 | <DT>Histogram |
|---|
| 283 | <DD>This allows a histogram to be selected to be loaded |
|---|
| 284 | <DT>Update Plot |
|---|
| 285 | <DD>The causes LIVEPLOT to read read the current histogram again from |
|---|
| 286 | the datafile |
|---|
| 287 | <DT>Make PostScript |
|---|
| 288 | <DD>Creates a low quality PostScript file containing the LIVEPLOT |
|---|
| 289 | output. See the Options/"Set PS output" button for where the file is created. |
|---|
| 290 | <DT>Quit |
|---|
| 291 | <DD>Exits BKGEDIT/LIVEPLOT. |
|---|
| 292 | </DL></DL> |
|---|
| 293 | <br clear=all> |
|---|
| 294 | <img SRC="lm2.gif" align=RIGHT alt="EXPGUI Screen snapshot"> |
|---|
| 295 | <H3>Options Menu</H3> |
|---|
| 296 | <DL><DL> |
|---|
| 297 | <DT>Configure Tickmarks |
|---|
| 298 | <DD>Tickmarks can be placed automatically, similar to their |
|---|
| 299 | placement in POWPLOT or can be drawn one height to another. The default |
|---|
| 300 | is for lines to be draw from "-Inf" to "Inf", which creates lines from the |
|---|
| 301 | bottom to the top of the plot. The options for each phase allow the line to be changed between solid and dashed, color of the line can be specified and |
|---|
| 302 | the vertical placement of the tickmarks can be specified. The "show" flag, |
|---|
| 303 | set in the File/Tickmarks menu can also be changed here. |
|---|
| 304 | <DT>Obs Symbol (Symbol Type) |
|---|
| 305 | <DD>This brings up a menu where the symbol type and size for the |
|---|
| 306 | observed data points (and for BKGEDIT, the fixed background points) |
|---|
| 307 | can be selected. |
|---|
| 308 | <DT>Symbol Color |
|---|
| 309 | <DD>The colors for all the displayed lines and symbols can be changed here. |
|---|
| 310 | <DT>X units |
|---|
| 311 | <DD>The x units can be selected here. The choices are |
|---|
| 312 | "as collected" (2Theta/TOF/KeV), d-space (A) or Q (A<sup>-1</sup>) |
|---|
| 313 | <DT>Y units |
|---|
| 314 | <DD>The intensity values can be normalized by the incident spectrum |
|---|
| 315 | (for energy dispersive methods). |
|---|
| 316 | <DT>HKL labeling |
|---|
| 317 | <DD>This brings up a menu that selects how long <I>hkl</I> values are shown |
|---|
| 318 | before they are erased (0 means that they are not erased), the size of the |
|---|
| 319 | labels and the width around the mouse that is searched for matching |
|---|
| 320 | reflections. If requested using the "Separate window for <I>hkl</I> labels" |
|---|
| 321 | option, labels are also show in a separate window. |
|---|
| 322 | <DT>Subtract background |
|---|
| 323 | <DD>The background is always shown, even when subtracted |
|---|
| 324 | <DT>Include legend |
|---|
| 325 | <DD>The legend is the optional box in the upper left that defines the |
|---|
| 326 | plot entries |
|---|
| 327 | <DT>Set PS output |
|---|
| 328 | <DD>For UNIX this allows the file to be sent directly to a printer |
|---|
| 329 | or can be saved in a file. For Windows, a file must be written. |
|---|
| 330 | <DT>Set screen font |
|---|
| 331 | <DD>This option is used to control the font used for menus, graphics and |
|---|
| 332 | other aspects of windows. |
|---|
| 333 | <DT>Raise on update |
|---|
| 334 | <DD>This causes the plot to be placed on top of other windows, if partially |
|---|
| 335 | obscured, when the plot is updated. At this time, this option does not |
|---|
| 336 | work in Windows-NT and -2000. |
|---|
| 337 | <DT>Cumulative Chi2 |
|---|
| 338 | <DD>The causes the Cumulative chi<sup>2</sup> function to be defined |
|---|
| 339 | (see below). |
|---|
| 340 | <DT>Save Options |
|---|
| 341 | <DD>Causes many of the options set in this menu to be saved in the <TT>.gsas_config</TT> file. |
|---|
| 342 | </DL></DL> |
|---|
| 343 | <br clear=all> |
|---|
| 344 | |
|---|
| 345 | <P> |
|---|
| 346 | <hr><H2>Customization of LIVEPLOT & BKGEDIT</H2><A NAME="customize"></A> |
|---|
| 347 | The <TT>localconfig</TT> and <TT>.gsas_config</TT> files are read, if present. |
|---|
| 348 | The following variables control how LIVEPLOT, and in most cases BKGEDIT, |
|---|
| 349 | function and can be |
|---|
| 350 | customized by changing their values in the |
|---|
| 351 | <TT>localconfig</TT> and <TT>.gsas_config</TT> files. |
|---|
| 352 | Note that some of these options are relevant only if the tcldump program is |
|---|
| 353 | present. |
|---|
| 354 | <DL><DL> |
|---|
| 355 | <DT><TT>peakinfo(flag<i>n</i>)</TT><DD> |
|---|
| 356 | These variables define if peak positions will be shown |
|---|
| 357 | for reflections in phase "<i>n</i>". Reflections will be shown if |
|---|
| 358 | the value is non-zero. |
|---|
| 359 | |
|---|
| 360 | <DT><TT>peakinfo(color<i>n</i>)</TT><DD> |
|---|
| 361 | These variables define the default colors for |
|---|
| 362 | reflections in phase "<i>n</i>" |
|---|
| 363 | |
|---|
| 364 | <DT><TT>peakinfo(dashes<i>n</i>)</TT><DD> |
|---|
| 365 | These variables define if peaks will be dashed for |
|---|
| 366 | reflections in phase "<i>n</i>" (UNIX only). Lines will be dashed if |
|---|
| 367 | the value is non-zero. |
|---|
| 368 | |
|---|
| 369 | <DT><TT>peakinfo(min<i>n</i>) and peakinfo(max<i>n</i>)</TT><DD> |
|---|
| 370 | These variables dictate the placement vertical position for reflection |
|---|
| 371 | markers, when manually placed (see expgui(autotick), below). To draw |
|---|
| 372 | to the edge of the screen, use -Inf and Inf. |
|---|
| 373 | </DL></DL> |
|---|
| 374 | |
|---|
| 375 | The following variables are written to <tt>.gsas_config</tt> when |
|---|
| 376 | "Save Options" is used. These variables are all set from the GUI and therefore |
|---|
| 377 | do not need to be edited manually. |
|---|
| 378 | |
|---|
| 379 | <DL><DL> |
|---|
| 380 | <DT><TT>graph(printout)</TT><DD> |
|---|
| 381 | This is set to 1 if PostScript files |
|---|
| 382 | will be printed and 0 if they will be written to disk (for Windows all |
|---|
| 383 | files should be written to disk). |
|---|
| 384 | |
|---|
| 385 | <DT><TT>graph(outname)</TT><DD> |
|---|
| 386 | This is the default for the file name used |
|---|
| 387 | when PostScript files will be written to disk. |
|---|
| 388 | |
|---|
| 389 | <DT><TT>graph(outcmd)</TT><DD> |
|---|
| 390 | This is the default for the command used |
|---|
| 391 | to print PostScript files (Unix only). |
|---|
| 392 | |
|---|
| 393 | <DT><TT>graph(legend)</TT><DD> |
|---|
| 394 | Sets the default value for display of the legend in LIVEPLOT and WIDPLT. |
|---|
| 395 | |
|---|
| 396 | <DT><TT>graph(autoraise)</TT><DD> |
|---|
| 397 | This option shows up in the options menu item as "Raise on update." |
|---|
| 398 | When set to non-zero, the LIVEPLOT window is raised |
|---|
| 399 | (placed on top of any other overlapping) windows |
|---|
| 400 | each time it is updated. |
|---|
| 401 | This option does not seem to work in Windows-NT, but this may depend on |
|---|
| 402 | the version of Tcl/Tk. |
|---|
| 403 | |
|---|
| 404 | <DT><TT>peakinfo(obssym)</TT><DD> |
|---|
| 405 | Symbol for observed data points. Valid choices are square, circle, diamond, |
|---|
| 406 | plus, cross, splus and scross. |
|---|
| 407 | |
|---|
| 408 | <DT><TT>peakinfo(obssize)</TT><DD> |
|---|
| 409 | Size for the symbol for observed data points. A value of 1 corresponds to about 1/8 inch |
|---|
| 410 | (about 3 mm). |
|---|
| 411 | |
|---|
| 412 | <DT><TT>expgui(pixelregion)</TT><DD> |
|---|
| 413 | When hkl values are loaded (using tcldump) and reflections are labeled, reflections |
|---|
| 414 | can be labeled using a Shift-Left-Mouse click. All labeled reflections within expgui(pixelregion) |
|---|
| 415 | pixels of the mouse position are assumed to be overlapped and are labeled. |
|---|
| 416 | |
|---|
| 417 | <DT><TT>expgui(fadetime)</TT><DD> |
|---|
| 418 | The time in seconds before reflection labels are removed. A value of zero means that reflections |
|---|
| 419 | must be deleted manually (Shift-Right-Mouse). |
|---|
| 420 | |
|---|
| 421 | <DT><TT>expgui(lblfontsize)</TT><DD> |
|---|
| 422 | A size for reflections labels in pixels. |
|---|
| 423 | |
|---|
| 424 | <DT><TT>expgui(hklbox)</TT><DD> |
|---|
| 425 | If this variable is non-zero, reflection indices are shown in a box. |
|---|
| 426 | |
|---|
| 427 | <DT><TT>expgui(autotick)</TT><DD> |
|---|
| 428 | If this variable is non-zero, reflection markers positions are |
|---|
| 429 | set automatically. |
|---|
| 430 | </DL></DL> |
|---|
| 431 | <P> |
|---|
| 432 | <hr><H2>Installation details/External Programs</H2> |
|---|
| 433 | <B>Using TCLDUMP with LIVEPLOT.</B> |
|---|
| 434 | LIVEPLOT works with the standard GSAS program HSTDMP, but it works faster and is more |
|---|
| 435 | powerful when used with the TCLDUMP program. |
|---|
| 436 | Note that as of the April 2000 releases, GSAS is now distributed with TCLDUMP |
|---|
| 437 | included. For older versions of GSAS, note the |
|---|
| 438 | instructions for downloading this file can in the installation notes for |
|---|
| 439 | <A HREF="expgui_Win_readme.html"> |
|---|
| 440 | Windows</A> and |
|---|
| 441 | <A HREF="expgui_Unix_readme.html"> |
|---|
| 442 | UNIX</A>. |
|---|
| 443 | <P> |
|---|
| 444 | |
|---|
| 445 | <B>Combining CMPR and LIVEPLOT.</B> |
|---|
| 446 | If you have <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/cmpr.html">CMPR</A> |
|---|
| 447 | installed on your computer, you can use superimpose on the GSAS results |
|---|
| 448 | the peaks for an arbitrary unit cell. If desired, space group extinctions |
|---|
| 449 | can even be shown. |
|---|
| 450 | This is pretty neat! To enable this feature, you must have a version |
|---|
| 451 | of CMPR downloaded after 4 May 1998 |
|---|
| 452 | <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/cmpr.html"> |
|---|
| 453 | (see the CMPR installation instructions.)</A> |
|---|
| 454 | <UL><LI> |
|---|
| 455 | For UNIX, create a link from in the EXPGUI |
|---|
| 456 | directory to file cellgen.tcl in the CMPR directory. For example: |
|---|
| 457 | <PRE> |
|---|
| 458 | ln -s /usr/local/cmpr/cellgen.tcl /usr/local/gsas/expgui/cellgen.tcl |
|---|
| 459 | </PRE> |
|---|
| 460 | <LI>For Windows, copy all the .tcl and .exe files from the CMPR directory |
|---|
| 461 | into the EXPGUI directory. |
|---|
| 462 | </UL> |
|---|
| 463 | <P> |
|---|
| 464 | |
|---|
| 465 | <B>Combining LOGIC and LIVEPLOT.</B> |
|---|
| 466 | If you have <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/logic.html">LOGIC</A> |
|---|
| 467 | installed on your computer, you can superimpose peaks |
|---|
| 468 | for a entry from the ICDD/JCPDS database on a pattern in LIVEPLOT. |
|---|
| 469 | This is also pretty neat! |
|---|
| 470 | To enable this feature, you must have |
|---|
| 471 | a version of LOGIC downloaded after 4 May 1998 |
|---|
| 472 | <A HREF="http://www.ncnr.nist.gov/programs/crystallography/software/logic.html"> |
|---|
| 473 | (see the LOGIC installation instructions.)</A> |
|---|
| 474 | <UL><LI> |
|---|
| 475 | For UNIX, create a link from in the GSAS GUI |
|---|
| 476 | directory to file icddcmd.tcl in the LOGIC directory. For example: |
|---|
| 477 | <PRE> |
|---|
| 478 | ln -s /usr/local/powdersuite/icddcmd.tcl /usr/local/gsas/expgui/icddcmd.tcl |
|---|
| 479 | </PRE> |
|---|
| 480 | <LI>For Windows, copy all the LOGIC files into the EXPGUI directory. |
|---|
| 481 | </UL> |
|---|
| 482 | <hr> |
|---|
| 483 | <TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT> |
|---|
| 484 | <TR><TH><A Href="expgui.html">EXPGUI top</A> |
|---|
| 485 | </TH></TR></TABLE> |
|---|
| 486 | |
|---|
| 487 | <a href="http://www.ncnr.nist.gov/staff/toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>) |
|---|
| 488 | <br> |
|---|
| 489 | $Revision: 433 $ $Date: 2009-12-04 23:06:05 +0000 (Fri, 04 Dec 2009) $ |
|---|
| 490 | </body> |
|---|
| 491 | </html> |
|---|
