| 1 | <HTML> |
|---|
| 2 | <HEAD> |
|---|
| 3 | <title>GSAS Notes</title> |
|---|
| 4 | <meta name="keywords" content="crystallography, Rietveld, diffraction, |
|---|
| 5 | GSAS, EXPGUI"> |
|---|
| 6 | </HEAD> |
|---|
| 7 | |
|---|
| 8 | <BODY BGCOLOR="#FFFFFF" |
|---|
| 9 | topmargin="0" leftmargin="0" marginwidth="0" marginheight="0" |
|---|
| 10 | text="#000000" link="#0033ff" vlink="#0033ff" alink="#0033ff"> |
|---|
| 11 | |
|---|
| 12 | <blockquote><font face="arial, helvetica, sans-serif"> |
|---|
| 13 | <CENTER> |
|---|
| 14 | <HR noshade width="75%" size="2" align="center"> |
|---|
| 15 | <H1> |
|---|
| 16 | GSAS/EXPGUI Self-Installer for Windows</H1> |
|---|
| 17 | <HR noshade width="75%" size="2" align="center"> |
|---|
| 18 | </CENTER> |
|---|
| 19 | |
|---|
| 20 | <TABLE BORDER BGCOLOR="#FFFF40" ALIGN=CENTER><TR><TH> |
|---|
| 21 | <B>Please note:</B> |
|---|
| 22 | A new mechanism for installing GSAS & EXPGUI is now recommended. See |
|---|
| 23 | <A HREF="https://subversion.xor.aps.anl.gov/trac/EXPGUI/wiki/InstallWindows"> |
|---|
| 24 | this link</a>. If this method is used, EXPGUI or a batch file can |
|---|
| 25 | be used to update GSAS & EXPGUI quickly and easily. |
|---|
| 26 | The installer described below will be updated for the foreseeable |
|---|
| 27 | future, but likely with less frequency. |
|---|
| 28 | </TH> |
|---|
| 29 | </TR></TABLE><BR CLEAR=ALL> |
|---|
| 30 | |
|---|
| 31 | |
|---|
| 32 | <P>A self-installing version of |
|---|
| 33 | <a href="http://www.ncnr.nist.gov/xtal/software/gsas.html">GSAS (General Structure Analysis System)</a> |
|---|
| 34 | and |
|---|
| 35 | <a href="https://subversion.xor.aps.anl.gov/EXPGUI/trunk/doc/expgui.html">EXPGUI</a> |
|---|
| 36 | is available. This program uncompresses itself, copies the required files |
|---|
| 37 | (including the Tcl/Tk files used in EXPGUI) |
|---|
| 38 | to a selected directory and either modifies the <TT>AUTOEXEC.BAT</TT> file |
|---|
| 39 | and/or creates the appropriate registry entries needed to run GSAS, |
|---|
| 40 | optionally with EXPGUI. This web page documents the screens displayed by the |
|---|
| 41 | self-installer. |
|---|
| 42 | <P> |
|---|
| 43 | The self-installer can be downloaded as file gsas+expgui.exe from |
|---|
| 44 | <a href="http://11bm.xor.aps.anl.gov/downloads/gsas/windows/">Argonne</a> |
|---|
| 45 | (http://11bm.xor.aps.anl.gov/downloads/gsas/windows/) |
|---|
| 46 | or |
|---|
| 47 | <a href="http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/"> |
|---|
| 48 | CCP14 </A> |
|---|
| 49 | (http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/gsas/public/gsas/windows/ |
|---|
| 50 | <P> |
|---|
| 51 | <B>Mailing List.</B> |
|---|
| 52 | If you would like to get news about about new features |
|---|
| 53 | & bug fixes in EXPGUI, as well as have input into develop goals |
|---|
| 54 | please join the EXPGUI mailing list at |
|---|
| 55 | <a href="http://www.aps.anl.gov/mailman/listinfo/expgui"> |
|---|
| 56 | http://www.aps.anl.gov/mailman/listinfo/expgui</a>. |
|---|
| 57 | |
|---|
| 58 | <P><B>Previous GSAS/EXPGUI versions.</B> |
|---|
| 59 | If you already have GSAS & EXPGUI loaded on your computer, |
|---|
| 60 | with this installer, you can simply run the new gsas+expgui.exe file. You |
|---|
| 61 | will get a message reminding you are upgrading and you will not be |
|---|
| 62 | offered a choice of where to install -- files will be placed in the same |
|---|
| 63 | directory as before. |
|---|
| 64 | <P> |
|---|
| 65 | If you previously installed using the gsaskit.exe file, you can probably |
|---|
| 66 | do fine if you ignore the old version and follow the directions below. However, |
|---|
| 67 | it is perhaps safer to either delete these files from your computer, or else |
|---|
| 68 | move them into a new directory (like c:\oldgsas or c:\1999gsas) so there is |
|---|
| 69 | no possibility that you will access any of the old programs by accident. |
|---|
| 70 | Also, in Windows-95, -95 and -ME, remove previous references to GSAS from |
|---|
| 71 | your AUTOEXEC.BAT file |
|---|
| 72 | (<a href="#AUTOEXEC">see notes about <tt>AUTOEXEC.BAT</tt></a> |
|---|
| 73 | and <a href="#oldTcl">old Tcl/Tk files</a> following this paragraph.) |
|---|
| 74 | Note that it is possible to run multiple versions of GSAS using EXPGUI |
|---|
| 75 | (by setting up shortcuts to the different copies of the expgui files |
|---|
| 76 | in the different locations), but PC-GSAS will run the first version of the GSAS |
|---|
| 77 | programs found in the path, and thus will run only the most recently |
|---|
| 78 | installed version. |
|---|
| 79 | |
|---|
| 80 | <P><a name="AUTOEXEC"></a><B>Previous <tt>AUTOEXEC.BAT</tt> modifications.</B> |
|---|
| 81 | Note that if you are using Windows-95, -98 or -ME, and had older versions |
|---|
| 82 | of GSAS installed, |
|---|
| 83 | you have references to GSAS in your <tt>AUTOEXEC.BAT</tt> file. |
|---|
| 84 | You should edit this file in |
|---|
| 85 | NOTEPAD (or SYSEDIT) to remove the references in your PATH definition. |
|---|
| 86 | You do not need to define the GSAS environment variable anymore, unless |
|---|
| 87 | you are using Windows-95, -98 or -ME and install the software in a |
|---|
| 88 | location other than c:\GSAS. |
|---|
| 89 | <P><a name="oldTcl"></a><B>Previous Tcl/Tk versions</B>. |
|---|
| 90 | The previous instructions for EXPGUI recommended installing the Tcl/Tk programs |
|---|
| 91 | in a directory <tt>C:\TCL</TT> or <tt>C:\TCL823</tt>. These files are |
|---|
| 92 | no longer needed by this version of EXPGUI, as the self-installer now places |
|---|
| 93 | these files in the GSAS directory. Thus, the |
|---|
| 94 | old <tt>C:\TCL</TT> or <tt>C:\TCL823</tt> directories can be deleted to save |
|---|
| 95 | disk space. |
|---|
| 96 | <P> |
|---|
| 97 | <HR noshade width="50%" size="2" align="center"> |
|---|
| 98 | |
|---|
| 99 | <P> |
|---|
| 100 | <img src="s1.gif" alt="setup in progress window" ALIGN=LEFT> |
|---|
| 101 | After downloading the program, start it either from the Run entry in the |
|---|
| 102 | Start menu, or by double-clicking on the icon for the downloaded file. The |
|---|
| 103 | "Setup in progress..." screen will appear for the minute or two |
|---|
| 104 | (perhaps as much as fifteen minutes on a very slow computer) while |
|---|
| 105 | the file uncompresses itself. This step has failed on some computers |
|---|
| 106 | with previous versions of the self-installer. If you get an error message, please sent it to <A HREF="MAILTO:Brian.Toby@ANL.GOV">me</a>. |
|---|
| 107 | <BR clear=all><P> |
|---|
| 108 | <HR noshade width="50%" size="2" align="center"><P> |
|---|
| 109 | <img src="s2.gif" alt="Installer Intro screen" ALIGN=RIGHT> |
|---|
| 110 | The first screen shows the program version. |
|---|
| 111 | |
|---|
| 112 | <BR clear=all><P> |
|---|
| 113 | <HR noshade width="50%" size="2" align="center"><P> |
|---|
| 114 | <img src="s3.gif" alt="Installer Copyright Intro screen" ALIGN=RIGHT> |
|---|
| 115 | The copyright information is shown, so that all the lawyers can be happy. |
|---|
| 116 | <BR clear=all><P> |
|---|
| 117 | <HR noshade width="50%" size="2" align="center"><P> |
|---|
| 118 | <img src="s4.gif" alt="Screen to select default .EXP association" ALIGN=RIGHT> |
|---|
| 119 | On this screen and the next you actually get to make some choices! |
|---|
| 120 | You can decide what |
|---|
| 121 | shortcuts will be provided for accessing EXPGUI and various GSAS programs. |
|---|
| 122 | The options are explained immediately below. |
|---|
| 123 | |
|---|
| 124 | <DL><DT><img src="s11.gif" alt="Example of .EXP associations"><DD> |
|---|
| 125 | If ".EXP association" is selected on the next screen, |
|---|
| 126 | registry entries are created so that if |
|---|
| 127 | one <I>right-clicks</I> on a .EXP file, a set of choices are offered for |
|---|
| 128 | acting on the file, as shown above. |
|---|
| 129 | For example, selecting EXPEDT from the pop-up menu, |
|---|
| 130 | invokes the EXPEDT program to edit options in the file. |
|---|
| 131 | Double-clicking (with the right mouse button) invokes the |
|---|
| 132 | default action. The choices on the current screen, allow the |
|---|
| 133 | selection of the |
|---|
| 134 | which program will be invoked upon a double-click. |
|---|
| 135 | </DL> |
|---|
| 136 | <BR clear=all><P> |
|---|
| 137 | <img src="s4a.gif" alt="Screen to select shortcut options" ALIGN=RIGHT> |
|---|
| 138 | |
|---|
| 139 | <DL> |
|---|
| 140 | <DT><img src="s9.gif" alt="Example of Desktop icons"><DD> |
|---|
| 141 | If desktop icons are selected, these two icons are placed on your desktop, |
|---|
| 142 | as above. |
|---|
| 143 | Clicking on them will start EXPGUI and PC-GSAS. Note that the default |
|---|
| 144 | directory for these shortcuts will be MyWork in the directory selected |
|---|
| 145 | for GSAS installation (typically C:\GSAS\MyWork). This can be changed by |
|---|
| 146 | editing the shortcut properties. |
|---|
| 147 | <P><P> |
|---|
| 148 | <DT><img src="s10.gif" alt="Example of Start menu entries"><DD> |
|---|
| 149 | If the "Start menu" option is selected, a "GSAS + EXPGUI" menu folder |
|---|
| 150 | is placed in your Start menu, with two items, to start EXPGUI and PC-GSAS. |
|---|
| 151 | See above. The default directory is set as described for the |
|---|
| 152 | desktop shortcuts. This can also be changed by right-clicking on the |
|---|
| 153 | start menu to open it and then setting the properties for the |
|---|
| 154 | menu entries. |
|---|
| 155 | </DL> |
|---|
| 156 | <P><P> |
|---|
| 157 | The last option, if selected, causes the files described in the training |
|---|
| 158 | section of the GSAS manual (for example, the Nickel and Garnet data files) |
|---|
| 159 | to be placed in the GSAS work directory (typically C:\GSAS\MyWork). This |
|---|
| 160 | makes it a bit easier to follow the examples given in the manual or |
|---|
| 161 | on the EXPGUI tutorial web pages. |
|---|
| 162 | <BR clear=all><P> |
|---|
| 163 | <HR noshade width="50%" size="2" align="center"><P> |
|---|
| 164 | <img src="s5.gif" alt="Screen to select install folder" ALIGN=RIGHT> |
|---|
| 165 | In this screen you select where the software will be installed. The default, |
|---|
| 166 | <tt>C:\GSAS</tt> is a good choice. You can use another drive, such as |
|---|
| 167 | <tt>G:\GSAS</tt> or |
|---|
| 168 | another directory, such as <tt>C:\SHAREDFILES\GSAS</tt>, but there have been problems |
|---|
| 169 | noted by people trying to directories with spaces in them, such as |
|---|
| 170 | <tt>C:\Program Files\GSAS</tt>, |
|---|
| 171 | so it is suggested that you do your own debugging |
|---|
| 172 | if you do this. Note that it is acceptable to use a directory on another |
|---|
| 173 | computer (such as a file server) but the directory must be mapped as a drive |
|---|
| 174 | (<I>e.g.</I> <tt>S:\GSAS</tt>, not <tt>\\server\GSAS</tt>). |
|---|
| 175 | Note that all files installed by the program are placed in this directory |
|---|
| 176 | or subdirectories below. No files are placed in windows system directories, |
|---|
| 177 | other than registry information that allows the program to be uninstalled |
|---|
| 178 | from the control panel. |
|---|
| 179 | |
|---|
| 180 | <BR clear=all><P> |
|---|
| 181 | <HR noshade width="50%" size="2" align="center"><P> |
|---|
| 182 | <img src="s6.gif" alt="Screen to confirm options" ALIGN=RIGHT> |
|---|
| 183 | This screen summarizes the input you have supplied. Use the "Back" button |
|---|
| 184 | to change any selections. Note that at this time, the GSAS work directory |
|---|
| 185 | is set automatically from the location where the software will be installed. |
|---|
| 186 | |
|---|
| 187 | <BR clear=all><P> |
|---|
| 188 | <HR noshade width="50%" size="2" align="center"><P> |
|---|
| 189 | <img src="s7.gif" alt="Please wait screen" ALIGN=LEFT> |
|---|
| 190 | This screen is displayed as the files are copied to the selected locations. |
|---|
| 191 | |
|---|
| 192 | <BR clear=all> |
|---|
| 193 | <P> |
|---|
| 194 | After all installation steps have been completed, the screen that says |
|---|
| 195 | "Setup complete" is shown. After pressing "Finish" all is done. |
|---|
| 196 | A reboot is no longer |
|---|
| 197 | performed. |
|---|
| 198 | |
|---|
| 199 | <BR clear=all><P> |
|---|
| 200 | <HR noshade width="75%" size="2" align="center"><P> |
|---|
| 201 | Please note that unexpected behavior in Windows seems to be the rule |
|---|
| 202 | rather than the exception, so report problems to: |
|---|
| 203 | <A HREF="MAILTO:Brian.Toby@ANL.GOV">tell Brian Toby</a>. |
|---|
| 204 | Corrections are far less likely without your feedback. |
|---|
| 205 | |
|---|
| 206 | <P> |
|---|
| 207 | <font size=-1><? lastmod(); ?></font> |
|---|
| 208 | <BR>$Revision: 1.10 $ $Date: 2007/01/25 22:44:45 $ |
|---|
| 209 | </font></blockquote> |
|---|
| 210 | |
|---|
| 211 | </BODY> |
|---|
| 212 | </HTML> |
|---|
| 213 | |
|---|
