Changes between Version 9 and Version 10 of InstallWindows


Ignore:
Timestamp:
Jul 3, 2012 1:38:07 PM (9 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallWindows

    v9 v10  
    66=== Python ===
    77
    8 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 a number of [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 the other distribution options described here 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.
     8Python 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.
    99
    10  * [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. Note that this package can be installed without administrator privileges -- I think -- if you install it for only your own use. You may have to choose an install location that you own (a subdirectory of My Documents, for example.)
     10 * [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.)
    1111
    12  * [http://www.enthought.com/products/epd_free.php Free Enthought Python Distribution (EPDFree)] is a light-weight and non-supported version of the EPD package, above. It contains all the packages needed for GSAS-II excluding [http://pypi.python.org/pypi/PyOpenGL PyOpenGL]. To install, 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 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.
     12 * [http://www.enthought.com/products/epd_free.php Free Enthought Python Distribution (EPDFree)] is a 32-bit, light-weight version of the EPD package, above, which does not have commercial support. It contains all the packages needed for GSAS-II excluding [http://pypi.python.org/pypi/PyOpenGL PyOpenGL] -- which gets installed automatically. 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.)
    1313
    1414 * [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.
    1515
    16  * [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.
     16 * [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.
    1717
    1818=== Subversion ===
     
    2020Subversion is a software version tracking system that allows you to download and update the GSAS-II software from the APS subversion server (https://subversion.xor.aps.anl.gov/pyGSAS/trunk/). You can install a variety of different versions of this software, but the two we recommend for Windows are these:
    2121
    22  * [http://tortoisesvn.net/ TortoiseSVN] incorporates Subversion capabilities into Windows. See the downloads directory and be sure to install the version (64-bit or 32-bit) appropriate for your version of Windows. Once TortoiseSVN is installed, follow [TortoiseInstall these installation instructions]
     22 * [http://tortoisesvn.net/ TortoiseSVN] incorporates Subversion capabilities into Windows. See the downloads directory and be sure to install the version (64-bit or 32-bit) appropriate for your version of Windows -- this must match the OS or it will not run. Once TortoiseSVN is installed, follow [TortoiseInstall these installation instructions]
     23
     24'''''or'''''
    2325
    2426 * mini-svn kit: A 2.5 Mb zip file has been prepared that contains a minimal SVN package, along with a batch file for installing GSAS-II from the APS subversion server. Use these [ZipInstall Installation Instructions] to use this kit.
     
    2628=== Compiling Fortran Code ===
    2729
    28 GSAS-II requires a small number of Fortran routines that are incorporated as Python packages (.pyd files). GSAS-II is distributed with these files compiled for a number of python versions, but if you are using something that does not match what we distribute, you may need to compile the Fortran routines yourself using the !NumPy f2py routine and the compiler of your choice. Both G77 (32-bit Python only) and GFortran have been successful on the platforms we have tried.
     30'''''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].
    2931
    30 To help with compiling the programs, use the python scons routine inside the GSASII\fsource directory. If you are lucky, this routine will find the needed compiler and python program, set all options correctly for you and run all steps needed to prepare the .pyd files. This is done by
    31  (1) running {{{cmd.exe}}} to open a "DOS" window,
    32 
    33  (2) use the volume name (when not C:) and the {{{cd}}} command to set your working directory to {{{...\GSASII\fsource}}} and
    34 
    35  (3) simply typing "{{{scons}}}" in the window. There will be a very large volume of output on the console; it should say "scons: done building targets." at the very end if successful.
    36 
    37 If you need to change any options, type "{{{scons help}}}" to see a list of the possible command-line arguments and the values for the options. For testing, help can be used with command-line options to see how they will change the variables.