Changes between Version 15 and Version 16 of InstallWindows


Ignore:
Timestamp:
May 6, 2013 1:05:28 PM (9 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallWindows

    v15 v16  
    11= Installing GSAS-II on Windows =
    22
    3 Overview: Installing GSAS-II requires three separate steps. One must install a Python package which will interpret the GSAS-II package and one must also install the subversion package which is used to download and update the GSAS-II files from the server at Argonne. Once that is done, one can install and then run the GSAS-II system. To make matters even more complex, there are several choices on how each step can be performed, with different advantages. The Quick Install Instructions, below, choose the simplest options. Feedback on installation instructions is welcomed by 
     3Overview: Installing GSAS-II requires three separate steps. One must install a Python package which will interpret the GSAS-II code that we distribute and to self-update one must also install the subversion package which is used to download and update the GSAS-II files from the server at Argonne. Once that is done, one can install and then run the GSAS-II system. To make matters even more complex, there are several choices on how each step can be performed, with different advantages. The Quick Install Instructions, below, choose the simplest options. Feedback on installation instructions is welcomed by 
    44[mailto:Brian.Toby@ANL.gov clicking here].
    55
    66=== Quick Install Instructions ===
    77
    8 For this, you will install the [http://www.enthought.com/products/epd_free.php Free Enthought Python Distribution (EPD Free)]. This is a 32-bit, light-weight version of the full EPD package, described in the [#Python Python section], below. Also, you will use the mini-svn/bootstrap kit, which contains a pared-down version of the subversion program and a batch file that installs GSAS-II from the APS subversion server. Detailed instructions on use of kit are found here: [ZipInstall Installation Instructions].
     8For this, you will install the free Enthought (EPDfree) Python Distribution. Note that Enthought has replaced EPDfree with a new free product !CanopyExpress. This may also work, but we have not yet tested it. We use a more complete version of EPD for development, described in the [#Python Python section], below. Also, you will use the mini-svn/bootstrap kit, which contains a pared-down version of the subversion program and a batch file that installs GSAS-II from the APS subversion server. Detailed instructions on use of kit are found here: [ZipInstall Installation Instructions].
    99
    10  1.   To install EPD Free, download the .msi file from URL http://www.enthought.com/products/epd_free.php and click on it to invoke the windows installer. (See notes below about how to install without administrator privileges.)
     10 1.   To install EPD Free, download [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-win-x86.msi the EPDfree 32-bit Windows .msi file] from web page https://www.enthought.com/repo/free/. Click on it to invoke the windows installer. (See notes below about how to install without administrator privileges.)
    1111
    1212 2.  Download file GSASIIsvn.zip file from URL https://subversion.xray.aps.anl.gov/pyGSAS/install/GSASIIsvn.zip.
     
    1414 3. Open the downloaded GSASIIsvn.zip in the Windows Explorer -- you should see a single folder named GSAS-II. Drag this folder to where you would like to install the GSAS-II software.
    1515
    16  4. Run the bootstrap.bat file to install the GSAS-II software. This will ask questions about proxy server (most users can select the default) and install the GSAS-II files in the location where the batch file is located. (See the [ZipInstall Installation Instructions] for more details.) Note that this batch file can be rerun at anytime to obtain the latest updates for GSAS-II. This .BAT file will start GSAS-II. The first time GSAS-II is run with EPD Free, there will be a delay in starting as GSAS-II installs the PyOpenGL module that is not provided by EPD Free.
     16 4. Run the bootstrap.bat file to install the GSAS-II software. This will ask questions about proxy server (most users can use the default here) and install the GSAS-II files in the location where the batch file is located. (See the [ZipInstall Installation Instructions] for more details.) Note that this batch file can be rerun at anytime to obtain the latest updates for GSAS-II. This .BAT file will start GSAS-II. The first time GSAS-II is run with EPDfree, there will be a delay in starting as GSAS-II installs the PyOpenGL module that is not provided by EPD Free.
    1717
    1818 5. Use the GSASII.BAT file to start GSAS-II. The [ZipInstall Installation Instructions] explain how to create a shortcut for this.
     
    2020=== Python ===
    2121
    22 Python is a computer scripting language, which means that one must have the Python interpreter installed on your computer to run a Python program. However, there are several [PythonPackages Python packages required by GSAS-II] that are not distributed within Python, so not just any distribution of the Python interpreter will do. For development, we use [http://www.enthought.com/products/epd.php EPD], but expect that several other distributed packages will do fine. Python and all the required packages are open source, so you could, in theory, download the source code for each one and compile them yourself. Most Windows users are likely to prefer to use binary distributions and will prefer using a single download that provides everything they need. For that, select and download one of the packages below and follow directions provided on that site for installation. Note that GSAS-II is being developed with version 2.x of Python (2.7.2 as of December 2011) and has not progressed to version 3.x of Python. This is in part because not all the packages required by GSAS-II are fully supported on Python 3.x on all platforms.
     22Python is a computer scripting language, which means that one must have the Python interpreter installed on your computer to run a Python program. However, there are several [PythonPackages Python packages required by GSAS-II] that are not distributed within the standard Python distribution, so not just any package of the Python interpreter will do for GSAS-II. For development, we use the full [http://www.enthought.com/products/epd.php EPD] distribution and will probably switch to the full Canopy product. There are a number of distributed packages will do likely fine, but have not been tested by us. Python and all the required packages are open source, so you could, in theory, download the source code for each one and compile them yourself. Most Windows users are likely to prefer to use binary distributions and will prefer using a single download that provides everything they need. For that, select and download one of the packages below and follow directions provided on that site for installation. Note that GSAS-II is being developed with version 2.x of Python (2.7.2 as of December 2011) and has not progressed to version 3.x of Python. This is in part because not all the packages required by GSAS-II are fully supported on Python 3.x on all platforms.
    2323
    2424 * [http://www.enthought.com/products/epd.php Enthought Python Distribution (EPD)] is a commercially licensed Python package that features differing levels of support. Academic users may request a free license at http://www.enthought.com/products/edudownload.php. To install, download the .msi file and click on it to invoke the windows installer. While GSAS-II will run in both 64- and 32-bit python, we are using 32-bit for most development work and encourage use of that. Note that this package can be installed without administrator privileges if you install it for only for use by the current user; you may have to choose an install location that you own (a subdirectory of My Documents, for example.)