LoginHelp/GuideAbout TracPreferences

WikiTimelineRoadmapBrowse SourceView TicketsSearch

wiki:InstallWindows
Start PageIndexHistory
Last modified 22 months ago
Installing GSAS-II on Windows
Overview: Installing GSAS-II requires three separate steps. One must install a P
ython package which will interpret the GSAS-II code that we distribute and to se
lf-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 adv
antages. The Quick Install Instructions, below, choose the simplest options. Fee
dback on installation instructions is welcomed by clicking here.
Quick Install Instructions
For this, you will install the free Enthought (EPDfree) Python Distribution. Not
e that Enthought has replaced EPDfree with a new free product CanopyExpress. Thi
s may also work, but we have not yet tested it. We use a more complete version o
f EPD for development, described in the Python section, below. Also, you will us
e the mini-svn/bootstrap kit, which contains a pared-down version of the subvers
ion program and a batch file that installs GSAS-II from the APS subversion serve
r. Detailed instructions on use of kit are found here: Installation Instructions
.
To install EPDfree, download ?the EPDfree 32-bit Windows .msi file from web page
?https://www.enthought.com/repo/free/. Click on it to invoke the windows instal
ler. (See notes below about how to install without administrator privileges.)
Download file GSASIIsvn.zip file from URL ?https://subversion.xray.aps.anl.gov/p
yGSAS/install/GSASIIsvn.zip.
Open the downloaded GSASIIsvn.zip in the Windows Explorer -- you should see a si
ngle folder named GSAS-II. Drag this folder to where you would like to install t
he GSAS-II software.
Run the bootstrap.bat file to install the GSAS-II software. This will ask questi
ons about proxy server (most users can use the default here) and install the GSA
S-II files in the location where the batch file is located. (See the Installatio
n Instructions for more details.) Note that this batch file can be rerun at anyt
ime 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 a
s GSAS-II installs the PyOpenGL module that is not provided by EPD Free.
Use the GSASII.BAT file to start GSAS-II. The Installation Instructions explain
how to create a shortcut for this.
Python
Python is a computer scripting language, which means that one must have the Pyth
on interpreter installed on your computer to run a Python program. However, ther
e are several Python packages required by GSAS-II that are not distributed withi
n the standard Python distribution, so not just any package of the Python interp
reter will do for GSAS-II. For development, we use the full ?EPD distribution an
d will probably switch to the full Canopy product. There are a number of distrib
uted packages will do likely fine, but have not been tested by us. Python and al
l the required packages are open source, so you could, in theory, download the s
ource 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 t
hat provides everything they need. For that, select and download one of the pack
ages below and follow directions provided on that site for installation. Note th
at GSAS-II is being developed with version 2.x of Python (2.7.2 as of December 2

011) and has not progressed to version 3.x of Python. This is in part because no
t all the packages required by GSAS-II are fully supported on Python 3.x on all
platforms.
?Enthought Python Distribution (EPD) is a commercially licensed Python package t
hat 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.enthoug
ht.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-b
it python, we are using 32-bit for most development work and encourage use of th
at. 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 i
nstall location that you own (a subdirectory of My Documents, for example.)
The ?free Enthought Python Distribution (EPDFree) has been replaced by CanopyExp
ress. 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 d
ownload ?the EPDfree 32-bit Windows .msi file from web page ?https://www.enthoug
ht.com/repo/free/. It contains all the packages needed for GSAS-II except?PyOpen
GL -- which gets installed automatically by GSAS-II. To install EPDFree, downloa
d the .msi file from URL ?http://www.enthought.com/products/epd_free.php and cli
ck on it to invoke the windows installer. (See note above with regard to adminis
trator 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 GSASII. (Alternatively, you can obtain PyOpenGL from ?here. Run the !PyOpenGL3.0.1.w
in32.exe file. If you have more than one version of Python on your computer, mak
e sure it installs OpenGL into the EPDFree version.) If you try CanopyExpress, p
lease let us know if it works for you.
?Python(x,y) is a free Windows (and Linux) Python distribution. It focuses on su
pporting the Qt GUI package while GSAS-II requires Wx, but this distribution doe
s offer Wx and all the other packages that GSAS-II requires, as far as we are aw
are. Note that when you install, you will either need to select to install all p
ackages or else perform a customized installation to ensure that the Python pack
ages required by GSAS-II are installed. To install, download the .exe file, run
it and read the instructions.
?ActiveState ActivePython This is commercial licensed software that includes a f
ree version with no support. ActiveState is well respected in the scripting comm
unity , but we have not tried this yet.
Subversion
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://s
ubversion.xray.aps.anl.gov/pyGSAS/trunk/). You can install a variety of differen
t versions of this software, but the two we recommend for Windows are these:
?TortoiseSVN incorporates Subversion capabilities into Windows. See the download
s directory and be sure to install the version (64-bit or 32-bit) appropriate fo
r your version of Windows -- this must match the OS or it will not run. Once Tor
toiseSVN is installed, follow these installation instructions
or
mini-svn kit: A 2.5 Mb zip file has been prepared that contains a minimal SVN pa
ckage, along with a batch file for installing GSAS-II from the APS subversion se
rver. Use these Installation Instructions to use this kit.
or (not recommended)
Note that the URL below is not working at present please request a .zip file if
needed
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 se

rver), 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 ar
chive 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 ev
ery 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 contain
s compiled .pyd (library modules) needed by a 32-bit Python version 2.7 interpre
ter for Windows in the binwin2.7 directory. However, if you are working with an
unusual python interpreter or are doing GSAS-II development, compilation instruc
tions can be found here.
Download in other formats:
Plain Text
Trac PoweredPowered by Trac 0.12.5
By Edgewall Software.Visit the Trac open source project at
http://trac.edgewall.org/