| Version 7 (modified by toby, 3 years ago) (diff) |
|---|
Installing GSAS-II on Windows the Hard Way
Overview: Installing GSAS-II requires three things: installing a Python distribution, a download package (subversion) and the actual GSAS-II code.
Use these instructions if you are using a version of Windows older than Windows-7 or want to install Python yourself.
Python
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 Python packages required by GSAS-II that are not distributed within the standard Python distribution, so not just any version of the Python interpreter will do for GSAS-II unless compatible versions of the required packages are available.
- We find that the Anaconda Python distribution is the most easy option. While GSAS-II will work with the legacy Python 2.7 version, we are recommending use of Python 3.7 and NumPy 1.15 (for a list of supported combinations of OS, Python and NumPy, see this directory (where names are of form <OS>_<bits>_p<PYver>_n<NPver>). If you use something else, you will need to compile your own binaries.
- Here are instructions for manually configuring with Continuum Anaconda
- Or use the conda command to install GSAS-II with these instructions.
- Enthought Canopy is a Python distribution from a company that has done quite a bit of work in Python and made that available to the community. We have not done any testing with this for a while, but have done so in the past and expect it to work fine.
- These instructions are dated but describe how to install with Enthought Canopy.
- 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.
- Windows XP: Here are some notes on installing on very old Windows computers (XP or Vista)
Subversion & GSAS-II Sources
Subversion is a software version tracking system that allows you to download and update the GSAS-II software directly from the APS subversion server (https://subversion.xray.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:
- If you are using the Anaconda Python distribution, then subversion is available as a conda package. Use command
conda install svn
to install it
- 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 these installation instructions. If you do this, be sure to install the optional command line tools, otherwise you will need to manually update GSAS-II with the TortoiseSVN extensions to the file browser (not from the GSAS-II help/update menu command.)
or (not recommended)
- Installing from distributions: See these sites for downloading svn as compiled binaries for windows https://sourceforge.net/projects/win32svn/ or https://subversion.apache.org/packages.html#windows. Parent web pages will give instructions for compiling from sources (for the brave).
or (really not recommended)
- 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:
https://subversion.xray.aps.anl.gov/trac/pyGSAS/changeset/Head/trunk?old_path=%2F&format=zip.
This will supply all the GSAS-II files in a zip archive. The contents of this archive can be moved to the location where GSAS-II will be installed.
We discourage use of this because you will need to repeat the entire download every time you want to upgrade; GSAS-II is updated often (sometimes daily!).
Compiling Fortran Code
Normally you will not need to compile anything. The GSAS-II distribution contains compiled .pyd (library modules) needed by a number of 32-bit and 64-bit configurations, but these files must match both the Python and Numpy major release number, so when installing your own versions there is a pretty good chance we will not have what you need pre-built. If you are working with an unsupported combination, compilation instructions can be found here.
