Context Navigation

Changes between Version 7 and Version 8 of WinAnacondaInstall

Timestamp:: Jun 3, 2017 5:10:02 PM (6 years ago)
Author:: toby
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

WinAnacondaInstall

-                      v7
+                      v8
 = Installing GSAS-II on Windows with Anaconda =
 You will need to know if you are running 32- or 64-bit Windows (click here [http://windows.microsoft.com/en-us/windows7/find-out-32-or-64-bit if you are not sure]).
+You will need to know if you are running 32- or 64-bit Windows (click here [http://windows.microsoft.com/en-us/windows7/find-out-32-or-64-bit if you are not sure]). Note that if you have 64-bit windows, you will likely find it easier to use [https://subversion.xray.aps.anl.gov/trac/pyGSAS/wiki/SingleStepWindowsNew this installer.]
 . Download the Anaconda package from [https://store.continuum.io/cshop/anaconda/ Continuum Analytics, Inc. download page]. (There is no cost for this, but an e-mail address is required.) Select the "32-bit — Python 2.7 — Graphical Installer" if on 32-bit Windows. For 64-bit Windows, either version can be used, but we recommend the "Windows 64-bit Python 2.7 Graphical Installer" as that will handle much larger refinement projects.
+. Download the appropriate 64- or 32-bit Anaconda package from [https://store.continuum.io/cshop/anaconda/ Continuum Analytics, Inc. download page]. '''Important: make sure to use the Python 2.7 installer and to select the appropriate version, 32- or 64-bit, for your computer.''' (There is no cost for this, but Continuum will ask for your e-mail address.)
  You will download a file such as "Anaconda-2.x.x-Windows-x86.exe" (32-bit) or "Anaconda-2.2.0-Windows-x86_64.exe (64-bit). Click on that file to run the installer. You will be given the option to install for just yourself or for all users. Either option works, but if only one account is in use on your computer, "Just Me" is a bit easier. The default install location is fine, but is OK to change. With the advanced options, it will be much easier to use the defaults, to add Anaconda to your path, and to register Anaconda as the default Python.
+ You will download a file such as "Anaconda2-x.x.x-Windows-x86.exe" (32-bit) or "Anaconda2-x.x.x-Windows-x86_64.exe (64-bit). (If you downloaded Anaconda3-... you have downloaded the wrong file.) If needed, click on the file you downloaded to run the installer. The following steps are then needed:
+. Once Anaconda is installed, in the "All Programs"/Anaconda menu, select "Anaconda Command Prompt" and then type command:
+    a. Accept the copyright (end-user) agreement
+    a. Install for "Just me" (there have been occasional problems reported with "All users")
+    c. Make a note of the installation location
+    d. Suggestion: leave "Add Anaconda to your path" and "Register Anaconda" unchecked, unless you plan to develop your own Python code.
+    c.   It then takes a few minutes to install Python.
+    d. Once the software is installed, it is OK to un-check the boxes on the final "Thank you" screen.
+. Once Anaconda is installed, in the Windows Apps or "All Programs" menu, find the Anaconda2 menu and select "Anaconda Command Prompt" menu item. This will open a cmd (DOS) window. In that window type the following commands:
     `conda install wxpython`
  because by default this package is not included. Press return and the package is loaded and installed [attachment:CondaUpdate.png see screen image].
+    `conda install svn`
 . Download file https://subversion.xray.aps.anl.gov/pyGSAS/install/GSASIIproxy.zip. Click on this file in Windows Explorer ([attachment:DownloadedFile.png see screen image]), you should see a single folder named GSASII ([attachment:ZipContents.png see screen image]). Drag this file anywhere you want to install GSAS-II (your desktop, your Documents folder, the D: drive,...)
+    `conda install pyopengl`
+. You then need to execute the `bootstrap.py` file. This can be done a few different ways. The easiest is to click on the `bootstrap.bat` file (N.B. by default, no extension is shown for this). (If you did not add Python to your path in step 1 above, you will need to edit `bootstrap.bat` to include the full path to `python.exe`.) Alternately, you can also use a command something like:
+ After each command you will need to type "y" at the "Proceed?" prompt.
+. Create a directory for GSAS-II and download the install script
+ In the Anaconda Command Prompt cmd (DOS) window, type the following command:
+   `mkdir GSASII`
+ Download the install script from this link: https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt
+    Use your web browser to save this file into the GSASII directory you created above.
+ Run this file inside Python with this command:
+   `python GSASII\bootstrap.py`
+ This will cause a questions to be asked about a web proxy [#Proxyaddress see below]. Most people will not need a proxy, so the usual response is to simply press Return
     `python \Users\<me>\Desktop\GSASII\bootstrap.py`
 …
  This script will check to see that the Python packages needed to run GSAS-II are installed and that the subversion program needed to install and update from the Internet (included in the .zip file) is present. It then asks for a proxy address ([attachment:BootstrapStart.png see screen image]).
- **Proxy address**: For most people, pressing return to use the default (no proxy) works fine, but for some sites a proxy address such as `proxyout.securesite.gov:7070` is needed. If you are not able to get the GSAS-II download to work, you probably need a proxy. Check with your network/computer administrators; anyone competent should know if a proxy is in use. Supply the address (`proxyout.securesite.gov`) on the first line and the port number (`7070`) on the second.
+Note that many seemingly nasty warning messages appear when !PyOpenGl is installed. This is not a problem, provided the installation and script complete normally.
+After the script completes, a file named `RunGSASII.bat` is created with the locations of GSAS-II and Python hardcoded. You should have a shortcut to start GSAS-II on your desktop linked to that .bat file ([attachment:G2icon.png see screen image]). GSAS-II project files (with extension .gpx) will appear with the same icon and clicking on them will open them in GSAS-II.
+. The `bootstrap.py` file runs a script called `makeBat.py` to create the `RunGSASII.bat` and the desktop shortcut. This script can be rerun manually using a command such as
+After the script completes, a file named `RunGSASII.bat` is created with the locations of GSAS-II and Python hardcoded. You should have a shortcut to start GSAS-II on your desktop linked to that .bat file ([attachment:G2icon.png see screen image]). GSAS-II project files (with extension .gpx) will appear with the same icon and clicking on them will open them in GSAS-II. If Python or GSAS-II are ever moved to new locations, or if these programs will be installed on a centralized server and a shortcut is needed for each machine, this script can be rerun using a command such as
     `python \Users\<me>\Desktop\GSASII\makeBat.py`
  to create new versions. This may be needed if Python or GSAS-II are moved to new locations, or if these programs will be installed on a centralized server and a shortcut is needed for each machine.
+to create new versions.
 Note that the bootstrap.py (or bootstrap.bat) file can be rerun without problems. If there are any updates to GSAS-II they will be downloaded, but only any new files will be downloaded and the script should complete very quickly.
+=== Proxy address ===
+For most people, pressing return to use the default (no proxy) works fine, but for some sites a proxy address such as `proxyout.securesite.gov:7070` is needed. If you are not able to get the GSAS-II download to work, you probably need a proxy. Check with your network/computer administrators; anyone competent should know if a proxy is in use. Supply the address (`proxyout.securesite.gov`) on the first line and the port number (`7070`) on the second.