source: trunk/doc/expguierr.html @ 343

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

# on 2000/10/18 00:11:17, toby did:
move utilites
organize

  • Property rcs:author set to toby
  • Property rcs:date set to 2000/10/18 00:11:17
  • Property rcs:lines set to +110 -70
  • Property rcs:rev set to 1.2
  • Property rcs:state set to Exp
  • Property svn:keywords set to Author Date Revision Id
File size: 8.4 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 occurances 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. This can be useful to discard the
61results of a refinement that has gone awry but in other cases can be a setback.
62<LI>
63If you opt to load the new .EXP file, by pressing "Load new",
64the version currently displayed in
65the EXPGUI window will be lost. This is normally what you will want to do,
66but if you unsure, you can select "Continue with old", use File/Save As to
67save the version in EXPGUI and then use "EXPNAM" to load the new version,
68so they can be compared.
69</UL>
70If unsaved changes have been made to the experiment file in EXPGUI, and
71the file us changed by an external program, the message "you have made
72changes to this version" is added and a third button,
73"Save edited version", is shown. Under this circumstance, the usual action,
74pressing "Load new" could result in desired changes being lost. Pressing
75"Save edited version" results brings you to the File/"Save as" menu,
76where the modified version of the experiment file in EXPGUI can be
77saved under a new name.
78<br clear=all>
79</DL></DL>
80
81<br clear=all>
82<a name="Inputtitle"></a>
83<h3>Input a value for the title</h3> 
84<DL><DL>
85A dialog with "Enter a value for the title for experiment..."  appears
86when a new experiment is created. Note that this title can be edited
87later on the
88<a href="expgui1.html">Least Squares Control Page</a>.
89</DL></DL>
90
91
92
93<br clear=all>
94<a name="ChooseCIF"></a>
95<h3>Choose CIF Block</h3> 
96<DL><DL>
97When coordinates/cell parameters are read from a CIF, all blocks in the file
98are read. If more than block containing coordinates is found, a message
99saying "More than one block in CIF contains coordinates. Select the block to use."
100One must then select one of these blocks from the list of blocks.
101The blocks with coordinates are listed, both numbered and with the
102block (data_) name. The "CIF Browser"
103button can be pressed to view the data names and their values for each block.
104</DL></DL>
105
106
107<br clear=all>
108<a name="open"></a>
109<h3>Open Experiment File</h3> 
110<DL><DL>
111The Open Experiment windows is displayed to select a
112experiment file to read or write, as well as a
113directory to use. When the message at the top reads
114"Select an experiment file to read" either an
115existing experiment file should be selected, or a new
116name may be typed in at the box at the bottom to enter
117a name manually. If the file is not found,
118you will be warned and given the option of
119creating a new experiment with that name.
120
121When the message at the top reads
122"Select an experiment file to create",
123typically after a "Save as" command,
124the directory may be changed, but typically
125a file name will be typed into the bottom box.
126If the file exists, you will be warned before the
127file is overwritten and you will have the option
128to enter a different file name.
129
130Note that the files in the list can be sorted
131alphabetically or can be sorted by the date the
132experiment file was last modified, according to
133the checkbuttons to the upper right.
134</DL></DL>
135
136<H2>Warning Messages</H2>
137
138<br clear=all>
139<a name="AbandonAtomConstraints"></a>
140<h3>Abandoning Constraint Editing</h3> 
141<DL><DL>
142If the "Cancel Changes" button is pressed when
143a profile or atom contraint is being edited or created, a message saying
144"Do you want to lose any changes made to this constraint?" is displayed, even
145if no changes have been made to the constraint. Changes are recorded only when the
146"Save" button is pressed.
147</DL></DL>
148
149
150<br clear=all>
151<a name="OpenErr"></a>
152<h3>File ... does not exist in ...</h3> 
153<DL><DL>
154When an attempt is made to open a file that does not
155already exists, for example when the EXPNAM command
156is used, this warning is displayed. The answer can be
157"Select other" or "Create", where "Select other" will
158return you to a file selection dialog and "Create"
159will create a new dialog with this name.
160</DL></DL>
161
162<br clear=all>
163<a name="OverwriteErr"></a>
164<a name="OverwriteCnv"></a>
165<h3>File ... already exists in ... OK to overwrite?</h3> 
166<DL><DL>
167When an attempt is made to using the File/"Save As"
168command to write the current experiment file
169with a new name, but
170a file with the newly specified name already exists,
171this message is displayed. Choose "Select other"
172to specify a different file name or "Overwrite"
173to use this name in which case the older file
174is replaced.
175<P>
176A similar warning will occur in UNIX when converting files.
177If the intended output filealready exists,
178this message is displayed. Choose "Cancel"
179to specify a different file name or "Overwrite"
180to use this name in which case the older file
181is replaced.
182This message can be seen in Windows when converting files,
183for slightly different reasons. When files are converted, the
184converted file keeps the same name as the original version. However,
185th original file is renamed to XXXX.ord, where XXXX.YYY is the
186original file name. If a file named XXXX.ord already exists, this message
187is displayed.
188</DL></DL>
189
190<H2>Error Messages</H2>
191
192<br clear=all>
193<a name="NoPGPLOT"></a>
194<h3>Unable to find file GRFONT.DAT...</h3> 
195<DL><DL>
196The file <tt>grfont.dat</tt> is expected to be in the ...\gsas\fonts directory
197in DOS/Windows platforms and files <tt>grfont.dat</tt> and
198<tt>pgxwin_server</tt> are expected to be found in the .../gsas/pgl directory
199in UNIX. If these files cannot be found, GSAS will not be able to produce
200graphics in programs such as POWPLOT, RAWPLOT,...
201If GSAS and EXPGUI are correctly installed this error will not occur
202(see the installation notes for
203<A HREF="expgui_Win_readme.html">Windows</A>
204and
205<A HREF="expgui_Unix_readme.html">UNIX</A>.
206
207</DL></DL>
208
209<br clear=all>
210<a name="ConvNotFound"></a>
211<h3>Sorry, file ... not found in ...</h3> 
212<DL><DL>
213The specifed input file was not found for conversion
214</DL></DL>
215
216<br clear=all>
217<a name="ConvSameName"></a>
218<h3>Sorry, filenames must differ</h3> 
219<DL><DL>
220For UNIX file conversions, the input and output file names
221must be different. You have specifed the same name twice.
222</DL></DL>
223
224<br clear=all>
225<a name=""></a>
226<h3></h3> 
227<DL><DL>
228</DL></DL>
229
230<hr>
231<TABLE BORDER BGCOLOR="#FFFF40" ALIGN=RIGHT>
232<TR><TH><A  Href="expgui.html">EXPGUI top</A> 
233</TH></TR></TABLE>
234
235<a href="http://www.ncnr.nist.gov/staff/toby/">Brian Toby</a> (<a href="mailto:brian.toby@nist.gov">Brian.Toby@NIST.GOV</a>)
236<br>
237$Revision: 343 $ $Date: 2009-12-04 23:04:28 +0000 (Fri, 04 Dec 2009) $
238</body>
239</html>
Note: See TracBrowser for help on using the repository browser.