source: trunk/doc/expguierr.html @ 369

Last change on this file since 369 was 369, checked in by toby, 11 years ago

# on 2000/12/22 21:14:32, toby did:
expand descriptions
new sections for lock and disagl rename error

  • Property rcs:author set to toby
  • Property rcs:date set to 2000/12/22 21:14:32
  • Property rcs:lines set to +42 -11
  • Property rcs:rev set to 1.3
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 9.5 KB
Line 
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" 
10alt="Link to NIST Center for Neutron Research home page"
11ALIGN=RIGHT></A>
12<A HREF=http://www.nist.gov>
13<IMG SRC="http://www.ncnr.nist.gov/images/webidblue_2lineright.gif" 
14alt="Link to National Institute of Standards & Technology home page"
15ALIGN=LEFT></A>
16<CENTER>
17<A Href="http://www.ncnr.nist.gov/programs/crystallography/software/tclpkgs.html">
18<IMG SRC="tcltklogo100.gif" 
19alt="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>
29EXPGUI Informational, Warning and Error Messages
30</h1></center>
31This page contains additional information about various warning
32and error screens that may occur in EXPGUI as well as descriptions
33for a number of utility functions.
34
35<H2>Informational Messages</H2>
36<a name="Overwrite"></a>
37<h3>File has been modified...</h3> 
38<DL><DL>
39This message occurs when EXPGUI detects that the experiment file has
40been changed by another program. (EXPGUI only tracks the file
41modification date, so that the file could have been opened for writing,
42but no actual changes were made.) This can be normal behavior -- for example
43after a refinement cycle has been run,
44or this can signal a problem, such as two people
45or sessions trying to edit the same .EXP file.
46This warning is made because a choice must be made: to keep the version
47currently displayed in EXPGUI, or to use the new version
48written by the other program.
49On UNIX, this message can be avoided by setting the
50<a href="expguic.html#Autoupdate">Autoupdate EXP</a> flag
51to "on" causes .EXP files to be loaded automatically after GSAS
52programs are run, eliminating most occurrences where this message is
53displayed, but with the disadvantage that a bad refinement run can not
54be reversed easily.
55<UL>
56<LI>
57If you choose to keep the
58currently displayed version and make changes and then save the file, either
59by using the File/Save menu option or by running a GSAS program,
60the new version just written will be lost,
61if any changes are made in EXPGUI and are then saved.
62This can be useful -- to discard the
63results of a refinement that has gone awry --
64but in other cases may not be desirable.
65<LI>
66If you opt to load the new .EXP file, by pressing "Load new",
67the version currently displayed in
68the EXPGUI window will be lost. This is normally what you will want to do,
69but if you unsure, you can select "Continue with old", use File/Save As to
70save the version in EXPGUI and then use "EXPNAM" to load the new version,
71so they can be compared.
72</UL>
73If changes have been made to the experiment file in EXPGUI
74since it was last saved, and
75the file is changed by an external program, the message "you have made
76changes to this version" is added and a third button,
77"Save edited version", is shown. Under this circumstance, the usual action,
78pressing "Load new" could result in valuable changes being lost. Pressing
79"Save edited version" results brings you to the File/"Save as" menu,
80where the modified version of the experiment file in EXPGUI can be
81saved under a new name.
82<br clear=all>
83</DL></DL>
84
85<a name="lock"></a>
86<h3>Please wait while GSAS program finishes...</h3> 
87<DL><DL>
88A window labeled "<tt>Please wait while GSAS program finishes. In case a
89problem occurs, close the DOS box and press the "Continue" button</tt> 
90is created in Windows-9x while GSAS programs are run. As this window
91is created, a "lock" file (<tt>expgui.lck</tt>) is also created. When the
92DOS batch file running the GSAS program completes, this file is deleted.
93The EXPGUI process waits until the <tt>expgui.lck</tt> lock file
94is deleted. Should the DOS process crash before the file is deleted,
95the "Continue" button can be pressed. This causes
96EXPGUI to continue and deletes the lock file.
97<br clear=all>
98</DL></DL>
99
100<br clear=all>
101<a name="Inputtitle"></a>
102<h3>Input a value for the title</h3> 
103<DL><DL>
104A dialog with "Enter a value for the title for experiment..."  appears
105when a new experiment is created. Note that this title can be edited
106later on the
107<a href="expgui1.html">Least Squares Control Page</a>.
108</DL></DL>
109
110
111
112<br clear=all>
113<a name="ChooseCIF"></a>
114<h3>Choose CIF Block</h3> 
115<DL><DL>
116When coordinates/cell parameters are read from a CIF, all blocks in the file
117are read. If more than block containing coordinates is found, a message
118saying "More than one block in CIF contains coordinates. Select the block to use."
119One must then select one of these blocks from the list of blocks.
120The blocks with coordinates are listed, both numbered and with the
121block (data_) name. The "CIF Browser"
122button can be pressed to view the data names and their values for each block.
123</DL></DL>
124
125
126<br clear=all>
127<a name="open"></a>
128<h3>Open Experiment File</h3> 
129<DL><DL>
130The Open Experiment windows is displayed to select a
131experiment file to read or write, as well as a
132directory to use. When the message at the top reads
133"Select an experiment file to read" either an
134existing experiment file should be selected, or a new
135name may be typed in at the box at the bottom to enter
136a name manually. If the file is not found,
137you will be warned and given the option of
138creating a new experiment with that name.
139
140When the message at the top reads
141"Select an experiment file to create",
142typically after a "Save as" command,
143the directory may be changed, but typically
144a file name will be typed into the bottom box.
145If the file exists, you will be warned before the
146file is overwritten and you will have the option
147to enter a different file name.
148
149Note that the files in the list can be sorted
150alphabetically or can be sorted by the date the
151experiment file was last modified, according to
152the checkbuttons to the upper right.
153</DL></DL>
154
155<H2>Warning Messages</H2>
156
157<br clear=all>
158<a name="AbandonAtomConstraints"></a>
159<h3>Abandoning Constraint Editing</h3> 
160<DL><DL>
161If the "Cancel Changes" button is pressed when
162a profile or atom constraint is being edited or created, a message saying
163"Do you want to lose any changes made to this constraint?" is displayed, even
164if no changes have been made to the constraint. Changes are recorded only when the
165"Save" button is pressed.
166</DL></DL>
167
168
169<br clear=all>
170<a name="OpenErr"></a>
171<h3>File ... does not exist in ...</h3> 
172<DL><DL>
173When an attempt is made to open a file that does not
174already exists, for example when the EXPNAM command
175is used, this warning is displayed. The answer can be
176"Select other" or "Create", where "Select other" will
177return you to a file selection dialog and "Create"
178will create a new dialog with this name.
179</DL></DL>
180
181<br clear=all>
182<a name="OverwriteErr"></a>
183<a name="OverwriteCnv"></a>
184<h3>File ... already exists in ... OK to overwrite?</h3> 
185<DL><DL>
186When an attempt is made to using the File/"Save As"
187command to write the current experiment file
188with a new name, but
189a file with the newly specified name already exists,
190this message is displayed. Choose "Select other"
191to specify a different file name or "Overwrite"
192to use this name in which case the older file
193is replaced.
194<P>
195A similar warning will occur in UNIX when converting files.
196If the intended output file already exists,
197this message is displayed. Choose "Cancel"
198to specify a different file name or "Overwrite"
199to use this name in which case the older file
200is replaced.
201This message can be seen in Windows when converting files,
202for slightly different reasons. When files are converted, the
203converted file keeps the same name as the original version. However,
204th original file is renamed to XXXX.ord, where XXXX.YYY is the
205original file name. If a file named XXXX.ord already exists, this message
206is displayed.
207</DL></DL>
208
209<H2>Error Messages</H2>
210
211<br clear=all>
212<a name="NoPGPLOT"></a>
213<h3>Unable to find file GRFONT.DAT...</h3> 
214<DL><DL>
215The file <tt>grfont.dat</tt> is expected to be in the ...\gsas\fonts directory
216in DOS/Windows platforms and files <tt>grfont.dat</tt> and
217<tt>pgxwin_server</tt> are expected to be found in the .../gsas/pgl directory
218in UNIX. If these files cannot be found, GSAS will not be able to produce
219graphics in programs such as POWPLOT, RAWPLOT,...
220If GSAS and EXPGUI are correctly installed this error will not occur
221(see the installation notes for
222<A HREF="expgui_Win_readme.html">Windows</A>
223and
224<A HREF="expgui_Unix_readme.html">UNIX</A>.
225
226</DL></DL>
227
228<br clear=all>
229<a name="ConvNotFound"></a>
230<h3>Sorry, file ... not found in ...</h3> 
231<DL><DL>
232The specified input file was not found for conversion
233</DL></DL>
234
235<br clear=all>
236<a name="ConvSameName"></a>
237<h3>Sorry, filenames must differ</h3> 
238<DL><DL>
239For UNIX file conversions, the input and output file names
240must be different. You have specified the same name twice.
241</DL></DL>
242
243<br clear=all>
244<a name="NoRename"></a>
245<h3>Unable to rename <I>XXXXX</I>.LST</h3> 
246<DL><DL>
247This message is displayed if the GSAS .LST file could not
248be renamed prior to running DISAGL in a separate window.
249On Windows it appears that LSTVIEW can prevent EXPGUI
250from renaming the .LST file. Either exit LSTVIEW
251while running DISAGL or reset the DISAGL option
252DISAGL so that output goes to the .LST file.
253</DL></DL>
254
255<br clear=all>
256<a name=""></a>
257<h3></h3> 
258<DL><DL>
259</DL></DL>
260
261<hr>
262<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
263<TR><TH><A  Href="expgui.html">EXPGUI top</A> 
264</TH></TR></TABLE>
265
266<a href="http://www.ncnr.nist.gov/staff/toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>)
267<br>
268$Revision: 369 $ $Date: 2009-12-04 23:05:01 +0000 (Fri, 04 Dec 2009) $
269</body>
270</html>
Note: See TracBrowser for help on using the repository browser.