| 1 | <html> |
|---|
| 2 | <head> |
|---|
| 3 | <META NAME="Author" CONTENT="Brian H. Toby"> |
|---|
| 4 | <title>EXPGUI Messages</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> |
|---|
| 22 | <hr> |
|---|
| 23 | |
|---|
| 24 | <TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT> |
|---|
| 25 | <TR><TH><A Href="expgui.html">EXPGUI top</A> |
|---|
| 26 | </TH></TR></TABLE><BR CLEAR=ALL> |
|---|
| 27 | |
|---|
| 28 | <center><h1> |
|---|
| 29 | EXPGUI Informational, Warning and Error Messages |
|---|
| 30 | </h1></center> |
|---|
| 31 | This page contains additional information about various warning |
|---|
| 32 | and error screens that may occur in EXPGUI as well as descriptions |
|---|
| 33 | for a number of utility functions. |
|---|
| 34 | |
|---|
| 35 | <a name="Info"></a> |
|---|
| 36 | <H2>Informational Messages</H2> |
|---|
| 37 | <a name="Overwrite"></a> |
|---|
| 38 | <h3>File has been modified...</h3> |
|---|
| 39 | <DL><DL> |
|---|
| 40 | This message occurs when EXPGUI detects that the experiment file has |
|---|
| 41 | been changed by another program. (EXPGUI only tracks the file |
|---|
| 42 | modification date, so that the file could have been opened for writing, |
|---|
| 43 | but no actual changes were made.) This can be normal behavior -- for example |
|---|
| 44 | after a refinement cycle has been run, |
|---|
| 45 | or this can signal a problem, such as two people |
|---|
| 46 | or sessions trying to edit the same .EXP file. |
|---|
| 47 | This warning is made because a choice must be made: to keep the version |
|---|
| 48 | currently displayed in EXPGUI, or to use the new version |
|---|
| 49 | written by the other program. |
|---|
| 50 | On UNIX, this message can be avoided by setting the |
|---|
| 51 | <a href="expguic.html#Autoupdate">Autoupdate EXP</a> flag |
|---|
| 52 | to "on" causes .EXP files to be loaded automatically after GSAS |
|---|
| 53 | programs are run, eliminating most occurrences where this message is |
|---|
| 54 | displayed, but with the disadvantage that a bad refinement run can not |
|---|
| 55 | be reversed easily. |
|---|
| 56 | <UL> |
|---|
| 57 | <LI> |
|---|
| 58 | If you choose to keep the |
|---|
| 59 | currently displayed version and make changes and then save the file, either |
|---|
| 60 | by using the File/Save menu option or by running a GSAS program, |
|---|
| 61 | the new version just written will be lost, |
|---|
| 62 | if any changes are made in EXPGUI and are then saved. |
|---|
| 63 | This can be useful -- to discard the |
|---|
| 64 | results of a refinement that has gone awry -- |
|---|
| 65 | but in other cases may not be desirable. |
|---|
| 66 | <LI> |
|---|
| 67 | If you opt to load the new .EXP file, by pressing "Load new", |
|---|
| 68 | the version currently displayed in |
|---|
| 69 | the EXPGUI window will be lost. This is normally what you will want to do, |
|---|
| 70 | but if you unsure, you can select "Continue with old", use File/Save As to |
|---|
| 71 | save the version in EXPGUI and then use "EXPNAM" to load the new version, |
|---|
| 72 | so they can be compared. |
|---|
| 73 | </UL> |
|---|
| 74 | If changes have been made to the experiment file in EXPGUI |
|---|
| 75 | since it was last saved, and |
|---|
| 76 | the file is changed by an external program, the message "you have made |
|---|
| 77 | changes to this version" is added and a third button, |
|---|
| 78 | "Save edited version", is shown. Under this circumstance, the usual action, |
|---|
| 79 | pressing "Load new" could result in valuable changes being lost. Pressing |
|---|
| 80 | "Save edited version" results brings you to the File/"Save as" menu, |
|---|
| 81 | where the modified version of the experiment file in EXPGUI can be |
|---|
| 82 | saved under a new name. |
|---|
| 83 | <br clear=all> |
|---|
| 84 | </DL></DL> |
|---|
| 85 | |
|---|
| 86 | <a name="lock"></a> |
|---|
| 87 | <h3>Please wait while GSAS program finishes...</h3> |
|---|
| 88 | <DL><DL> |
|---|
| 89 | A window labeled "<tt>Please wait while GSAS program finishes." |
|---|
| 90 | If a problem occurs, close the DOS box and press the "Continue" button</tt> |
|---|
| 91 | is created in Windows-9x while GSAS programs are run. As this window |
|---|
| 92 | is created, a "lock" file (<tt>expgui.lck</tt>) is also created. When the |
|---|
| 93 | DOS batch file running the GSAS program completes, this file is deleted. |
|---|
| 94 | The EXPGUI process waits until the <tt>expgui.lck</tt> lock file |
|---|
| 95 | is deleted. Should the DOS process crash before the file is deleted, |
|---|
| 96 | the "Continue" button can be pressed. This causes |
|---|
| 97 | EXPGUI to continue and deletes the lock file. |
|---|
| 98 | <br clear=all> |
|---|
| 99 | </DL></DL> |
|---|
| 100 | |
|---|
| 101 | <br clear=all> |
|---|
| 102 | <a name="Inputtitle"></a> |
|---|
| 103 | <h3>Input a value for the title</h3> |
|---|
| 104 | <DL><DL> |
|---|
| 105 | A dialog with "Enter a value for the title for experiment..." appears |
|---|
| 106 | when a new experiment is created. Note that this title can be edited |
|---|
| 107 | later on the |
|---|
| 108 | <a href="expgui1.html">Least Squares Control Page</a>. |
|---|
| 109 | </DL></DL> |
|---|
| 110 | |
|---|
| 111 | |
|---|
| 112 | |
|---|
| 113 | <br clear=all> |
|---|
| 114 | <a name="ChooseCIF"></a> |
|---|
| 115 | <h3>Choose CIF Block</h3> |
|---|
| 116 | <DL><DL> |
|---|
| 117 | When coordinates/cell parameters are read from a CIF, all blocks in the file |
|---|
| 118 | are read. If more than block containing coordinates is found, a message |
|---|
| 119 | saying "More than one block in CIF contains coordinates. Select the block to use." |
|---|
| 120 | One must then select one of these blocks from the list of blocks. |
|---|
| 121 | The blocks with coordinates are listed, both numbered and with the |
|---|
| 122 | block (data_) name. The "CIF Browser" |
|---|
| 123 | button can be pressed to view the data names and their values for each block. |
|---|
| 124 | </DL></DL> |
|---|
| 125 | |
|---|
| 126 | |
|---|
| 127 | <br clear=all> |
|---|
| 128 | <a name="open"></a> |
|---|
| 129 | <h3>Open Experiment File</h3> |
|---|
| 130 | <DL><DL> |
|---|
| 131 | The Open Experiment windows is displayed to select a |
|---|
| 132 | experiment file to read or write, as well as a |
|---|
| 133 | directory to use. When the message at the top reads |
|---|
| 134 | "Select an experiment file to read" either an |
|---|
| 135 | existing experiment file should be selected, or a new |
|---|
| 136 | name may be typed in at the box at the bottom to enter |
|---|
| 137 | a name manually. If the file is not found, |
|---|
| 138 | you will be warned and given the option of |
|---|
| 139 | creating a new experiment with that name. |
|---|
| 140 | |
|---|
| 141 | When the message at the top reads |
|---|
| 142 | "Select an experiment file to create", |
|---|
| 143 | typically after a "Save as" command, |
|---|
| 144 | the directory may be changed, but typically |
|---|
| 145 | a file name will be typed into the bottom box. |
|---|
| 146 | If the file exists, you will be warned before the |
|---|
| 147 | file is overwritten and you will have the option |
|---|
| 148 | to enter a different file name. |
|---|
| 149 | <P> |
|---|
| 150 | Note that the files in the list can be sorted |
|---|
| 151 | alphabetically or can be sorted by the date the |
|---|
| 152 | experiment file was last modified, according to |
|---|
| 153 | the checkbuttons to the upper right. |
|---|
| 154 | <P> |
|---|
| 155 | The "Include Archived Files" checkbox allows archive files |
|---|
| 156 | named <xxxxxx>.Onn to be read |
|---|
| 157 | (see the |
|---|
| 158 | <A href="expguic.html#archive">archive option</A>). |
|---|
| 159 | See the <A href="#LoadArchived">Load Archived File</A>, below, for |
|---|
| 160 | further discussion. |
|---|
| 161 | </DL></DL> |
|---|
| 162 | |
|---|
| 163 | <br clear=all> |
|---|
| 164 | <a name="LoadArchived"></a> |
|---|
| 165 | <h3>Load Archived File</h3> |
|---|
| 166 | <DL><DL> |
|---|
| 167 | When a archived experiment file is read, the "Load Archived File" |
|---|
| 168 | window is displayed to select the name to be used for the experiment. |
|---|
| 169 | There are two choices. One is to reuse existing name. |
|---|
| 170 | This will cause the current version of the experiment file to be |
|---|
| 171 | archived so that it is not lost. The selected [older] archived |
|---|
| 172 | version will then be read and will be saved as the latest version of the |
|---|
| 173 | experiment file. |
|---|
| 174 | The other option is to save the experiment |
|---|
| 175 | under a new name. |
|---|
| 176 | </DL></DL> |
|---|
| 177 | |
|---|
| 178 | <br clear=all> |
|---|
| 179 | <a name="ExcludeRegion"></a> |
|---|
| 180 | <h3>Exclude Data...<BR>Delete Region...</h3> |
|---|
| 181 | <DL><DL> |
|---|
| 182 | This message is shown before adding or deleting an excluded region using |
|---|
| 183 | <a href="excledt.html">EXCLEDT</a> to confirm an action. |
|---|
| 184 | See the <a href="excledt.html#AddRegion">discussion on Adding Regions</a> |
|---|
| 185 | in EXCLEDT. |
|---|
| 186 | Note that this |
|---|
| 187 | confirmation message can be eliminated if desired, (see the |
|---|
| 188 | EXCLEDT Options menu item <a href="excledt.html#prompt">Prompt on add/del</a>.) |
|---|
| 189 | <br clear=all> |
|---|
| 190 | </DL></DL> |
|---|
| 191 | |
|---|
| 192 | <br clear=all> |
|---|
| 193 | <a name="ProcessRegions"></a> |
|---|
| 194 | <h3>The upper (lower) limit has changed...<BR>The excluded regions have changed...</h3> |
|---|
| 195 | <DL><DL> |
|---|
| 196 | This message is shown |
|---|
| 197 | if the upper data limit is raised (or d-min ls lowered) so that |
|---|
| 198 | <a href="excledt.html">EXCLEDT</a> can display the data that have been added. |
|---|
| 199 | It is also shown when |
|---|
| 200 | <a href="excledt.html">EXCLEDT</a> exits so that the new data limits |
|---|
| 201 | can be processed. GENLES will not run properly until POWPREF is run. |
|---|
| 202 | </DL></DL> |
|---|
| 203 | |
|---|
| 204 | <br clear=all> |
|---|
| 205 | <a name="RegionTooBig"></a> |
|---|
| 206 | <h3>The upper (lower) data point...</h3> |
|---|
| 207 | <DL><DL> |
|---|
| 208 | This message is shown when the upper data limit (lower d-min limit) |
|---|
| 209 | well outside the range of data. |
|---|
| 210 | It is probably best to accept this suggestion. See the |
|---|
| 211 | <a href="excledt.html#LimitTooHigh">discussion on data limits</a> |
|---|
| 212 | in the EXCLEDT web page for more information. |
|---|
| 213 | </DL></DL> |
|---|
| 214 | |
|---|
| 215 | <br clear=all> |
|---|
| 216 | <a name="ProcessUse"></a> |
|---|
| 217 | <h3>You have changed histogram flags...</h3> |
|---|
| 218 | <DL><DL> |
|---|
| 219 | This message is shown |
|---|
| 220 | after changing histogram flags so that a different set of histograms |
|---|
| 221 | will be included or excluded in a refinement. |
|---|
| 222 | GENLES will not run properly until POWPREF is run. |
|---|
| 223 | </DL></DL> |
|---|
| 224 | |
|---|
| 225 | <a name="Warn"></a> |
|---|
| 226 | <H2>Warning Messages</H2> |
|---|
| 227 | |
|---|
| 228 | <br clear=all> |
|---|
| 229 | <a name="AbandonAtomConstraints"></a> |
|---|
| 230 | <h3>Abandoning Constraint Editing</h3> |
|---|
| 231 | <DL><DL> |
|---|
| 232 | If the "Cancel Changes" button is pressed when |
|---|
| 233 | a profile or atom constraint is being edited or created, a message saying |
|---|
| 234 | "Do you want to lose any changes made to this constraint?" is displayed, even |
|---|
| 235 | if no changes have been made to the constraint. Changes are recorded only when the |
|---|
| 236 | "Save" button is pressed. |
|---|
| 237 | </DL></DL> |
|---|
| 238 | |
|---|
| 239 | |
|---|
| 240 | <br clear=all> |
|---|
| 241 | <a name="OpenErr"></a> |
|---|
| 242 | <h3>File ... does not exist in ...</h3> |
|---|
| 243 | <DL><DL> |
|---|
| 244 | When an attempt is made to open a file that does not |
|---|
| 245 | already exists, for example when the EXPNAM command |
|---|
| 246 | is used, this warning is displayed. The answer can be |
|---|
| 247 | "Select other" or "Create", where "Select other" will |
|---|
| 248 | return you to a file selection dialog and "Create" |
|---|
| 249 | will create a new dialog with this name. |
|---|
| 250 | </DL></DL> |
|---|
| 251 | |
|---|
| 252 | <br clear=all> |
|---|
| 253 | <a name="OverwriteErr"></a> |
|---|
| 254 | <a name="OverwriteCnv"></a> |
|---|
| 255 | <h3>File ... already exists in ... OK to overwrite?</h3> |
|---|
| 256 | <DL><DL> |
|---|
| 257 | When an attempt is made to using the File/"Save As" |
|---|
| 258 | command to write the current experiment file |
|---|
| 259 | with a new name, but |
|---|
| 260 | a file with the newly specified name already exists, |
|---|
| 261 | this message is displayed. Choose "Select other" |
|---|
| 262 | to specify a different file name or "Overwrite" |
|---|
| 263 | to use this name in which case the older file |
|---|
| 264 | is replaced. |
|---|
| 265 | <P> |
|---|
| 266 | A similar warning will occur in UNIX when converting files. |
|---|
| 267 | If the intended output file already exists, |
|---|
| 268 | this message is displayed. Choose "Cancel" |
|---|
| 269 | to specify a different file name or "Overwrite" |
|---|
| 270 | to use this name in which case the older file |
|---|
| 271 | is replaced. |
|---|
| 272 | This message can be seen in Windows when converting files, |
|---|
| 273 | for slightly different reasons. When files are converted, the |
|---|
| 274 | converted file keeps the same name as the original version. However, |
|---|
| 275 | th original file is renamed to XXXX.ord, where XXXX.YYY is the |
|---|
| 276 | original file name. If a file named XXXX.ord already exists, this message |
|---|
| 277 | is displayed. |
|---|
| 278 | </DL></DL> |
|---|
| 279 | |
|---|
| 280 | <br clear=all> |
|---|
| 281 | <a name="NoValidHist"></a> |
|---|
| 282 | <h3>No histograms are ready to plot. Run GENLES and try again.</h3> |
|---|
| 283 | <DL><DL> |
|---|
| 284 | This happens when LIVEPLOT is run but no valid histograms are available |
|---|
| 285 | to plot. LIVEPLOT can plot histograms only when they have been processed by |
|---|
| 286 | both POWPREF and GENLES. |
|---|
| 287 | </DL></DL> |
|---|
| 288 | |
|---|
| 289 | <a name="Error"></a> |
|---|
| 290 | <H2>Error Messages</H2> |
|---|
| 291 | |
|---|
| 292 | <br clear=all> |
|---|
| 293 | <a name="NoPGPLOT"></a> |
|---|
| 294 | <h3>Unable to find file GRFONT.DAT...</h3> |
|---|
| 295 | <DL><DL> |
|---|
| 296 | The file <tt>grfont.dat</tt> is expected to be in the ...\gsas\fonts directory |
|---|
| 297 | in DOS/Windows platforms and files <tt>grfont.dat</tt> and |
|---|
| 298 | <tt>pgxwin_server</tt> are expected to be found in the .../gsas/pgl directory |
|---|
| 299 | in UNIX. If these files cannot be found, GSAS will not be able to produce |
|---|
| 300 | graphics in programs such as POWPLOT, RAWPLOT,... |
|---|
| 301 | If GSAS and EXPGUI are correctly installed this error will not occur |
|---|
| 302 | (see the installation notes for |
|---|
| 303 | <A HREF="expgui_Win_readme.html">Windows</A> |
|---|
| 304 | and |
|---|
| 305 | <A HREF="expgui_Unix_readme.html">UNIX</A>. |
|---|
| 306 | |
|---|
| 307 | </DL></DL> |
|---|
| 308 | |
|---|
| 309 | <br clear=all> |
|---|
| 310 | <a name="ConvNotFound"></a> |
|---|
| 311 | <h3>Sorry, file ... not found in ...</h3> |
|---|
| 312 | <DL><DL> |
|---|
| 313 | The specified input file was not found for conversion |
|---|
| 314 | </DL></DL> |
|---|
| 315 | |
|---|
| 316 | <br clear=all> |
|---|
| 317 | <a name="ConvSameName"></a> |
|---|
| 318 | <h3>Sorry, filenames must differ</h3> |
|---|
| 319 | <DL><DL> |
|---|
| 320 | For UNIX file conversions, the input and output file names |
|---|
| 321 | must be different. You have specified the same name twice. |
|---|
| 322 | </DL></DL> |
|---|
| 323 | |
|---|
| 324 | <br clear=all> |
|---|
| 325 | <a name="NoRename"></a> |
|---|
| 326 | <h3>Unable to rename <I>XXXXX</I>.LST</h3> |
|---|
| 327 | <DL><DL> |
|---|
| 328 | This message is displayed if the GSAS .LST file could not |
|---|
| 329 | be renamed prior to running DISAGL in a separate window. |
|---|
| 330 | On Windows it appears that LSTVIEW can prevent EXPGUI |
|---|
| 331 | from renaming the .LST file. Either exit LSTVIEW |
|---|
| 332 | while running DISAGL or reset the DISAGL option |
|---|
| 333 | DISAGL so that output goes to the .LST file. |
|---|
| 334 | </DL></DL> |
|---|
| 335 | |
|---|
| 336 | <br clear=all> |
|---|
| 337 | <a name="OldEXPTOOL"></a> |
|---|
| 338 | <h3>You must upgrade the EXPTOOL program...</h3> |
|---|
| 339 | <DL><DL> |
|---|
| 340 | The original version of the EXPTOOL program used within |
|---|
| 341 | EXPGUI to add histograms does not work with dummy histograms. |
|---|
| 342 | Versions of GSAS distributed prior to October 2001 do not contain this updated |
|---|
| 343 | routine. A more recent version of the EXPTOOL program can |
|---|
| 344 | be downloaded from |
|---|
| 345 | <A Href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/"> |
|---|
| 346 | ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_win/</A>, |
|---|
| 347 | <A Href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/"> |
|---|
| 348 | ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_linux/</A> or |
|---|
| 349 | <A Href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/"> |
|---|
| 350 | ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/exe_sgi/</A>. |
|---|
| 351 | Alternately, EXPEDT can be used to add dummy histograms. |
|---|
| 352 | </DL></DL> |
|---|
| 353 | |
|---|
| 354 | <br clear=all> |
|---|
| 355 | <a name=""></a> |
|---|
| 356 | <h3></h3> |
|---|
| 357 | <DL><DL> |
|---|
| 358 | </DL></DL> |
|---|
| 359 | |
|---|
| 360 | <hr> |
|---|
| 361 | <TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT> |
|---|
| 362 | <TR><TH><A Href="expgui.html">EXPGUI top</A> |
|---|
| 363 | </TH></TR></TABLE> |
|---|
| 364 | |
|---|
| 365 | <a href="http://www.ncnr.nist.gov/staff/toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>) |
|---|
| 366 | <br> |
|---|
| 367 | $Revision: 463 $ $Date: 2009-12-04 23:06:35 +0000 (Fri, 04 Dec 2009) $ |
|---|
| 368 | </body> |
|---|
| 369 | </html> |
|---|
