Changes between Version 18 and Version 19 of InstallWindows


Ignore:
Timestamp:
May 26, 2015 6:07:25 PM (7 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallWindows

    v18 v19  
    66=== Quick Install Instructions ===
    77
    8 For 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].
     8There are at least three different distributions of Python that can be used with GSAS-II. [WinAnacondaInstall Quick Install with Continuum Anaconda] or [WinCanopyInstall Quick Install with Enthought Canopy]. There are also older instructions using [WinOldInstall the Enthought EPDfree package].
    99
    10  1.   To install EPDfree, 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.)
    11 
    12  2.  Download file GSASIIsvn.zip file from URL https://subversion.xray.aps.anl.gov/pyGSAS/install/GSASIIsvn.zip.
    13 
    14  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.
    15 
    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.
    17 
    18  5. Use the GSASII.BAT file to start GSAS-II. The [ZipInstall Installation Instructions] explain how to create a shortcut for this.
     10== Installation Details for the Curious ==
    1911
    2012=== Python ===
    2113
    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 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.
     14Python 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 have been using the full [http://www.enthought.com/products/epd.php EPD] distribution but also do some testing with the Canopy and Anaconda distributions. Note that GSAS-II is being developed with version 2.x of Python (2.7.6 as this is written). It has not been tested with version 3.x of Python since we lack a dist for this.
    2315
    24  * [http://www.enthought.com/products/epd.php Enthought Python Distribution (EPD)] is a commercially licensed Python package that features differing levels of support it is being replaced by a newer product called Canopy. 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.)
     16 In addition to the Python dists referenced in the [#QuickInstallInstructions quick install instructions] above, there are others for Windows we have not tested:
    2517
    26  * The [http://www.enthought.com/products/epd_free.php free Enthought Python Distribution (EPDFree)] has been replaced by !CanopyExpress. Both are lightweight versions of the full Canopy/EPD packages, and do not come with support. We have not tested !CanopyExpress yet and recommend that you 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/. It contains all the packages needed for GSAS-II except[http://pypi.python.org/pypi/PyOpenGL PyOpenGL] -- which gets installed automatically by GSAS-II. To install EPDFree, download the .msi file from URL http://www.enthought.com/products/epd_free.php and click on it to invoke the windows installer. (See note above with regard to administrator privileges.) After installing EPDFree, you can invoke GSAS-II and it will install PyOpenGL from the file PyOpenGL-3.0.2a5.zip that is included with GSAS-II. (Alternatively, you can obtain PyOpenGL from [http://pypi.python.org/packages/any/P/PyOpenGL/PyOpenGL-3.0.1.win32.exe#md5=513cc194af65af4c5a640cf9a1bd8462 here]. Run the !PyOpenGL3.0.1.win32.exe file. If you have more than one version of Python on your computer, make sure it installs OpenGL into the EPDFree version.) If you try !CanopyExpress, please let us know if it works for you.
     18 * [http://www.pythonxy.com/ Python(x,y)] is a free Windows (and Linux) Python distribution. It focuses on supporting the Qt GUI package while GSAS-II requires wxPython, but this distribution does offer wx and all the other packages that GSAS-II requires, as far as we are aware. Note that when you install, you will either need to select to install all packages or else perform a customized installation to ensure that the [PythonPackages Python packages required by GSAS-II] are installed. To install, download the .exe file, run it and read the instructions.
    2719
    28  * [http://www.pythonxy.com/ Python(x,y)] is a free Windows (and Linux) Python distribution. It focuses on supporting the Qt GUI package while GSAS-II requires Wx, but this distribution does offer Wx and all the other packages that GSAS-II requires, as far as we are aware. Note that when you install, you will either need to select to install all packages or else perform a customized installation to ensure that the [PythonPackages Python packages required by GSAS-II] are installed. To install, download the .exe file, run it and read the instructions.
    29 
    30  * [http://www.activestate.com/activepython ActiveState ActivePython] This is commercial licensed software that includes a free version with no support. !ActiveState is well respected in the scripting community , but we have not tried this yet.
     20 * [http://www.activestate.com/activepython ActiveState ActivePython] This is commercial licensed software that includes a free version with no support. !ActiveState is well respected in the scripting community, but we have not tried this yet.
    3121
    3222=== Subversion ===
     
    4232'''''or (not recommended)'''''
    4333
    44 **Note that the URL below is not working at present** please request a .zip file if needed
    45 
    4634 * If you are unable to access the subversion server for some reason and must use a conventional download (note that in all the cases so far where people have been seemed to be blocked have turned out to be fixed through addition of a proxy server), you can download a snapshot of the current version of GSAS-II using this URL:
    4735
     
    5442=== Compiling Fortran Code ===
    5543
    56 '''''Normally you will not need to compile anything.''''' The GSAS-II distribution contains compiled .pyd (library modules) needed by a 32-bit Python version 2.7 interpreter for Windows in the ```binwin2.7``` directory. However, if you are working with an unusual python interpreter or are doing GSAS-II development, compilation instructions can be [CompilingWindows found here].
     44'''''Normally you will not need to compile anything.''''' The GSAS-II distribution contains compiled .pyd (library modules) needed by a 32-bit or a 64-bit Python version 2.7 interpreter for Windows. However, if you are working with an unusual python interpreter or are doing GSAS-II development, compilation instructions can be [CompilingWindows found here].
    5745