wiki:SingleStepWindowsIllustrated

Version 26 (modified by toby, 22 months ago) (diff)

--

64-bit Windows: Installing GSAS-II with a single download

A single download installer can be used to install the latest version of GSAS-II. If the file downloaded file is moved to a computer not connected to the internet it will install a working, but slightly out-of-date GSAS-II version. Note that 64-bit Windows- or later is required. Click here to see this page without screen images?.

Download this .exe file (~0.4 Gb):

download of installer

Install Python

Run the downloaded file (gsas2full-*.exe). This can be done by pressing the "Run" button in the web browser if that is an option. You will likely see some sort of message protecting you from this "unknown and possibly malicious app".

Windows warning After clicking on "More Info"

Click on "More Info" and a "Run anyway" button is displayed, as above. Click on "Run anyway" and the installer will start:

Installer starting

  • This screen shows the version number of GSAS-II that is contained in the installer. Later this will be updated, if an internet connection is available. The installer suggests closing all applications. It is wise to save work in other applications, but closing them seems a bit excessive. You will need to pass through several windows by pressing "Next", selecting options as you go.
  • Pressing Next the 1st time brings you to the License Agreement window shows you the article we ask you to cite, as well as the use terms for Python and packages, as below. You must agree to continue. The License for use of GSAS-II is found in the source code for the package; for convenience the full text from this screen and the GSAS-II license are shown below.

License screen

  • We have only tested with install for "Just Me". Use of "All users" is probably not an ideal choice in any case, as likely only the installer would be able to save options and do updates.

Installation type screen

  • The Installation Location may need some attention. The default works for most people, but there have been problems reported with Python installations when the install location contains spaces and or non-ASCII characters. GSAS-II has been tested and appears to work fine in locations with spaces in the name (like C:\Users\Brian Toby\GSASII) but this has not been tested with other types of text. You may wish to install in C:\GSASII. Whatever location you supply must be a directory that does not already exist. Please make a note of where you install GSAS-II (use of right-click will allow you to copy the text.) This can be useful to recover from an incomplete installation.

Choose installl location

  • If you choose a location with spaces in the name you will get a warning. You can use the "Back" button to select a new installation location.

space warning

  • The Advanced Installation Options are not that important, but the suggestion is that you do not select either option. The default for the second option is usually to have the second option selected. This makes lets other packages make use of the version of Python you are installing for GSAS-II. This is not likely to cause any problems with GSAS-II, but if you are using Python for code development, you are suggested to install another copy of Python and work with that.

select install option After selection of option

  • At this point, click on the "Install" button and allow the installation of files to start. Expect the installation to speed along until the "Setting up package cache ..." message is displayed, and at that point things slow down and several minutes will be needed before much happens.

Installation of files

The last step will be to download the latest version of GSAS-II.

  • A "DOS' (cmd.exe) window will open, some tests are run and a desktop shortcut will be created to start GSAS-II. That shortcut can be copied or moved to other locations. Double-clicking on it will start GSAS-II.

No image "14.png" attached to SingleStepWindowsIllustrated

  • The last step will be to download the latest version of GSAS-II. You are at that point asked to enter a proxy address. Most people will leave that blank and hit return.

All done screen

Then click on "Next" and "Finish". to complete the installation.

desktop icon

Problems/comments

If the process completes properly, you will see a GSAS-II desktop shortcut; double-clicking on it will then start GSAS-II, opening two windows. If the process does not complete, see here

Note: A spurious error message saying "Failed to run post install script" will be displayed with older installers. Press "Ignore" as this does not actually represent a problem.

No image "G2InstallWarning.png" attached to SingleStepWindowsIllustrated

Feedback on installation instructions is welcomed. E-mail Brian dot Toby at ANL dot gov.

Licenses

GSAS-II Information & Anaconda license:

====================================================
This is a single-download installer for GSAS-II. It includes other
software such as subversion (svn, used to update GSAS-II), a Python 
interpreter and a number of Python packages required by GSAS-II. The
file you are running will install GSAS-II, Python, etc. and will then
run the bootstrap.py script to create shortcuts and will use svn to
update to the latest version of GSAS-II, if an internet connection is
available. Noet that the bootstrap.py script can be rerun manually to
obtain updates.

*** Note that while this installer can be rerun to install the software
in a new location, once these files are installed, they should not be
moved. ***

If you use GSAS-II in your research, please show your support by citing:
B.H. Toby & R.B. Von Dreele, J. Appl. Cryst. 46, 544-549 (2013)  
(also see Help/About)

See the GSAS-II source code for license information. Material
below is relevant to the Anaconda Python distribution, which is
freely provided by Continuum Analytics, Inc. 

====================================================
 Copyright (c) 2016, Continuum Analytics, Inc.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * Neither the name of Continuum Analytics, Inc. nor the
      names of its contributors may be used to endorse or promote products
      derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL CONTINUUM ANALYTICS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
THE POSSIBILITY OF SUCH DAMAGE.

GSAS-II License:

           General Structure Analysis System - II (GSAS-II)
                         OPEN SOURCE LICENSE

Copyright 2010, UChicago Argonne, LLC, Operator of Argonne National Laboratory 
All rights reserved.

GSAS-II may be used by anyone on a royalty-free basis. Use and
redistribution, with or without modification, are permitted provided
that the following conditions are met:

* Redistributions of source code must retain the above copyright
  notice, this list of conditions and the following disclaimer.
* Software changes, modifications, or derivative works should be noted
  with comments and the author and organization's name.
* Distribution of changed, modified or derivative works based on
  GSAS-II grants the GSAS-II copyright holder unrestricted permission
  to include any, or all, new and changed code in future GSAS-II
  releases.
* Redistributions that include binary forms must include all relevant
  source code and reproduce the above copyright notice, this list of
  conditions and the following disclaimers in the documentation and/or
  other materials provided with the distribution.
* Neither the names of UChicago Argonne, LLC or the Department of
  Energy nor the names of its contributors may be used to endorse or
  promote products derived from this software without specific prior
  written permission.
* The software and the end-user documentation included with the
  redistribution, if any, must include the following acknowledgment:
  "This product includes software produced by UChicago Argonne, LLC
  under Contract No. DE-AC02-06CH11357 with the Department of Energy."

*****************************************************************************
WARRANTY DISCLAIMER: THE SOFTWARE IS SUPPLIED "AS IS" WITHOUT WARRANTY
OF ANY KIND. THE COPYRIGHT HOLDERS, THEIR THIRD PARTY LICENSORS, THE
UNITED STATES, THE UNITED STATES DEPARTMENT OF ENERGY, AND THEIR
EMPLOYEES: (1) DISCLAIM ANY WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE, TITLE OR NON-INFRINGEMENT, (2) DO NOT ASSUME
ANY LEGAL LIABILITY OR RESPONSIBILITY FOR THE ACCURACY, COMPLETENESS,
OR USEFULNESS OF THE SOFTWARE, (3) DO NOT REPRESENT THAT USE OF THE
SOFTWARE WOULD NOT INFRINGE PRIVATELY OWNED RIGHTS, (4) DO NOT WARRANT
THAT THE SOFTWARE WILL FUNCTION UNINTERRUPTED, THAT IT IS ERROR-FREE
OR THAT ANY ERRORS WILL BE CORRECTED.

LIMITATION OF LIABILITY: IN NO EVENT WILL THE COPYRIGHT HOLDERS, THEIR
THIRD PARTY LICENSORS, THE UNITED STATES, THE UNITED STATES DEPARTMENT
OF ENERGY, OR THEIR EMPLOYEES: BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
CONSEQUENTIAL, SPECIAL OR PUNITIVE DAMAGES OF ANY KIND OR NATURE,
INCLUDING BUT NOT LIMITED TO LOSS OF PROFITS OR LOSS OF DATA, FOR ANY
REASON WHATSOEVER, WHETHER SUCH LIABILITY IS ASSERTED ON THE BASIS OF
CONTRACT, TORT (INCLUDING NEGLIGENCE OR STRICT LIABILITY), OR
OTHERWISE, EVEN IF ANY OF SAID PARTIES HAS BEEN WARNED OF THE
POSSIBILITY OF SUCH LOSS OR DAMAGES.
******************************************************************************

These links offer an older distributions that has worked for many people, if you have trouble with the previous:

Attachments (18)

Download all attachments as: .zip