| 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 | In Unix another checkbox appears, offering the choice |
|---|
| 156 | to "Include Archived Files." When this is checked, files |
|---|
| 157 | named <xxxxxx>.EXP.nnn and <xxxxxx>.EXP.nnn.gz |
|---|
| 158 | (see the |
|---|
| 159 | <A href="expguic.html#archive">archive option</A>) |
|---|
| 160 | are included in the file box. These files can be directly loaded. |
|---|
| 161 | (Note the <A href="#LoadArchived">Load Archived File</A> discussion, below. |
|---|
| 162 | </DL></DL> |
|---|
| 163 | |
|---|
| 164 | <br clear=all> |
|---|
| 165 | <a name="LoadArchived"></a> |
|---|
| 166 | <h3>Load Archived File</h3> |
|---|
| 167 | <DL><DL> |
|---|
| 168 | When a archived experiment file is read, the "Load Archived File" |
|---|
| 169 | window is displayed to select the name to be used for the experiment. |
|---|
| 170 | There are two choices. One is to reuse existing name. |
|---|
| 171 | This will cause the archived experiment to overwrite the current version of |
|---|
| 172 | the experiment file. The other option is to save the experiment |
|---|
| 173 | under a new name. |
|---|
| 174 | </DL></DL> |
|---|
| 175 | |
|---|
| 176 | <a name="Warn"></a> |
|---|
| 177 | <H2>Warning Messages</H2> |
|---|
| 178 | |
|---|
| 179 | <br clear=all> |
|---|
| 180 | <a name="AbandonAtomConstraints"></a> |
|---|
| 181 | <h3>Abandoning Constraint Editing</h3> |
|---|
| 182 | <DL><DL> |
|---|
| 183 | If the "Cancel Changes" button is pressed when |
|---|
| 184 | a profile or atom constraint is being edited or created, a message saying |
|---|
| 185 | "Do you want to lose any changes made to this constraint?" is displayed, even |
|---|
| 186 | if no changes have been made to the constraint. Changes are recorded only when the |
|---|
| 187 | "Save" button is pressed. |
|---|
| 188 | </DL></DL> |
|---|
| 189 | |
|---|
| 190 | |
|---|
| 191 | <br clear=all> |
|---|
| 192 | <a name="OpenErr"></a> |
|---|
| 193 | <h3>File ... does not exist in ...</h3> |
|---|
| 194 | <DL><DL> |
|---|
| 195 | When an attempt is made to open a file that does not |
|---|
| 196 | already exists, for example when the EXPNAM command |
|---|
| 197 | is used, this warning is displayed. The answer can be |
|---|
| 198 | "Select other" or "Create", where "Select other" will |
|---|
| 199 | return you to a file selection dialog and "Create" |
|---|
| 200 | will create a new dialog with this name. |
|---|
| 201 | </DL></DL> |
|---|
| 202 | |
|---|
| 203 | <br clear=all> |
|---|
| 204 | <a name="OverwriteErr"></a> |
|---|
| 205 | <a name="OverwriteCnv"></a> |
|---|
| 206 | <h3>File ... already exists in ... OK to overwrite?</h3> |
|---|
| 207 | <DL><DL> |
|---|
| 208 | When an attempt is made to using the File/"Save As" |
|---|
| 209 | command to write the current experiment file |
|---|
| 210 | with a new name, but |
|---|
| 211 | a file with the newly specified name already exists, |
|---|
| 212 | this message is displayed. Choose "Select other" |
|---|
| 213 | to specify a different file name or "Overwrite" |
|---|
| 214 | to use this name in which case the older file |
|---|
| 215 | is replaced. |
|---|
| 216 | <P> |
|---|
| 217 | A similar warning will occur in UNIX when converting files. |
|---|
| 218 | If the intended output file already exists, |
|---|
| 219 | this message is displayed. Choose "Cancel" |
|---|
| 220 | to specify a different file name or "Overwrite" |
|---|
| 221 | to use this name in which case the older file |
|---|
| 222 | is replaced. |
|---|
| 223 | This message can be seen in Windows when converting files, |
|---|
| 224 | for slightly different reasons. When files are converted, the |
|---|
| 225 | converted file keeps the same name as the original version. However, |
|---|
| 226 | th original file is renamed to XXXX.ord, where XXXX.YYY is the |
|---|
| 227 | original file name. If a file named XXXX.ord already exists, this message |
|---|
| 228 | is displayed. |
|---|
| 229 | </DL></DL> |
|---|
| 230 | |
|---|
| 231 | <br clear=all> |
|---|
| 232 | <a name="NoValidHist"></a> |
|---|
| 233 | <h3>No histograms are ready to plot. Run GENLES and try again.</h3> |
|---|
| 234 | <DL><DL> |
|---|
| 235 | This happens when LIVEPLOT is run but no valid histograms are available |
|---|
| 236 | to plot. LIVEPLOT can plot histograms only when they have been processed by |
|---|
| 237 | both POWPREF and GENLES. |
|---|
| 238 | </DL></DL> |
|---|
| 239 | |
|---|
| 240 | <a name="Error"></a> |
|---|
| 241 | <H2>Error Messages</H2> |
|---|
| 242 | |
|---|
| 243 | <br clear=all> |
|---|
| 244 | <a name="NoPGPLOT"></a> |
|---|
| 245 | <h3>Unable to find file GRFONT.DAT...</h3> |
|---|
| 246 | <DL><DL> |
|---|
| 247 | The file <tt>grfont.dat</tt> is expected to be in the ...\gsas\fonts directory |
|---|
| 248 | in DOS/Windows platforms and files <tt>grfont.dat</tt> and |
|---|
| 249 | <tt>pgxwin_server</tt> are expected to be found in the .../gsas/pgl directory |
|---|
| 250 | in UNIX. If these files cannot be found, GSAS will not be able to produce |
|---|
| 251 | graphics in programs such as POWPLOT, RAWPLOT,... |
|---|
| 252 | If GSAS and EXPGUI are correctly installed this error will not occur |
|---|
| 253 | (see the installation notes for |
|---|
| 254 | <A HREF="expgui_Win_readme.html">Windows</A> |
|---|
| 255 | and |
|---|
| 256 | <A HREF="expgui_Unix_readme.html">UNIX</A>. |
|---|
| 257 | |
|---|
| 258 | </DL></DL> |
|---|
| 259 | |
|---|
| 260 | <br clear=all> |
|---|
| 261 | <a name="ConvNotFound"></a> |
|---|
| 262 | <h3>Sorry, file ... not found in ...</h3> |
|---|
| 263 | <DL><DL> |
|---|
| 264 | The specified input file was not found for conversion |
|---|
| 265 | </DL></DL> |
|---|
| 266 | |
|---|
| 267 | <br clear=all> |
|---|
| 268 | <a name="ConvSameName"></a> |
|---|
| 269 | <h3>Sorry, filenames must differ</h3> |
|---|
| 270 | <DL><DL> |
|---|
| 271 | For UNIX file conversions, the input and output file names |
|---|
| 272 | must be different. You have specified the same name twice. |
|---|
| 273 | </DL></DL> |
|---|
| 274 | |
|---|
| 275 | <br clear=all> |
|---|
| 276 | <a name="NoRename"></a> |
|---|
| 277 | <h3>Unable to rename <I>XXXXX</I>.LST</h3> |
|---|
| 278 | <DL><DL> |
|---|
| 279 | This message is displayed if the GSAS .LST file could not |
|---|
| 280 | be renamed prior to running DISAGL in a separate window. |
|---|
| 281 | On Windows it appears that LSTVIEW can prevent EXPGUI |
|---|
| 282 | from renaming the .LST file. Either exit LSTVIEW |
|---|
| 283 | while running DISAGL or reset the DISAGL option |
|---|
| 284 | DISAGL so that output goes to the .LST file. |
|---|
| 285 | </DL></DL> |
|---|
| 286 | |
|---|
| 287 | <br clear=all> |
|---|
| 288 | <a name=""></a> |
|---|
| 289 | <h3></h3> |
|---|
| 290 | <DL><DL> |
|---|
| 291 | </DL></DL> |
|---|
| 292 | |
|---|
| 293 | <hr> |
|---|
| 294 | <TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT> |
|---|
| 295 | <TR><TH><A Href="expgui.html">EXPGUI top</A> |
|---|
| 296 | </TH></TR></TABLE> |
|---|
| 297 | |
|---|
| 298 | <a href="http://www.ncnr.nist.gov/staff/toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>) |
|---|
| 299 | <br> |
|---|
| 300 | $Revision: 412 $ $Date: 2009-12-04 23:05:44 +0000 (Fri, 04 Dec 2009) $ |
|---|
| 301 | </body> |
|---|
| 302 | </html> |
|---|
