Changes between Version 4 and Version 5 of InstallMacHardWay


Ignore:
Timestamp:
Apr 20, 2012 12:00:26 PM (10 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallMacHardWay

    v4 v5  
    11= Installing GSAS-II on Mac OS X =
    22
    3 Prerequisites: Before GSAS-II can be used on your computer, you must have two software packages installed, python and subversion. With 10.5 and 10.6, OS X comes with both installed, but alas, the supplied python versions do not include all the [PythonPackages required packages]. Note that at present GSAS-II is only distributed via subversion. If you work at an institution with a firewall that blocks downloading files from subversion (uncommon, but known), contact your networking support department or arrange to perform the download from another location.
     3Prerequisites: Before GSAS-II can be used on your computer, you must have python installed with a number of [PythonPackages required Python packages] (see below.) Further, we recommend using another software package, subversion, to download GSAS-II, but that is already present on most Macs.
     4
    45If you can help expand any of these instructions, discover new mechanisms for installing Python, or have problems getting this to work, please let [mailto:Brian.Toby@ANL.gov me know].
    56
    67=== Python ===
    78
    8 Python is a computer scripting language, which means that one must have the Python interpreter installed on your Mac 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 some software installation is required. Note the required !WxPython package runs only in 32-bit python.
     9Python is a computer scripting language, which means that one must have the Python interpreter installed on your Mac to run a Python program. Macs come with python installed, but not with all the [PythonPackages Python packages required by GSAS-II] that are not distributed within Python so some software installation is required. Note the required !WxPython package runs only in 32-bit python on Macs.
    910
    10 We do not have a lot of experience with options for loading the needed Python interpreter and packages on the Mac. The [http://www.enthought.com/products/epd.php EPD] package is what we use for code development. In theory, you might be able to load just the missing packages, but it is not clear how easy that is to do. Use of the Fink or !DarwinPorts versions of Python is probably not a good idea -- the GUI and graphics will be shown in X-windows; if this indeed does work, the performance will be poor. Note that at this time, GSAS-II does not support Python 3.0 or greater and Python 2.7 is recommended.
     11We use the [http://www.enthought.com/products/epd.php Enthought Python Distribution] (EPD) package for our code development (Argonne has a site license). There is also a free version of this package, called [http://www.enthought.com/products/epd_free.php EPDFree] that will run GSAS-II with addition of one small package (see below). Note that the versions of python supplied with OS X so far are pretty old, so adding the missing packages is probably not a good idea. Use of the Fink or !DarwinPorts versions of Python is also not the best choice -- the GUI and graphics will be shown in X-windows; if this indeed does work, the performance will be poor. Note that at this time, GSAS-II does not support Python 3.0 or greater and Python 2.7 is recommended.
    1112
    12  * [http://www.enthought.com/products/epd.php Enthought Python Distribution (EPD)] is a commercially licensed Python package that features differing levels of support. To install, download the .dmg file and click on it (if needed) to mount it. You will see the EPD.mpkg installer. Click on that to start the installation process. Note that admin privileges are required to load this package.
     13GSAS-II has only been run on Intel (i386) Macs running 10.5 (Leopard) and 10.6 (Snow Leopard). We expect no problems with 10.7 (Lion) or 10.8 (Mountain Lion). Getting GSAS-II to run on 10.4 or PPC Macs may be possible, but will likely require considerable work to build/install python packages and compilers and is not recommended except to the cognoscenti.
    1314
    14  * [http://www.activestate.com/activepython ActiveState ActivePython] This is also commercial licensed software. There is a free version with no support. We have not used this yet.
     15 * [http://www.enthought.com/products/epd.php Enthought Python Distribution (EPD)] is a commercially licensed Python package that features differing levels of support. It appears that academic users can obtain this for free at this link http://enthought.com/products/edudownload.php. It is usually distributed as an ~250Mb .dmg file that requires admin privs for installation (but note that at a version that can be installed without admin privs is here: http://www.enthought.com/repo/epd/installers/mac_local/). Installation from the .dmg is easy: click on the file to open it (that might happen automatically when you download it). In that new volume, you will see the EPD.mpkg installer. Click on that to start the installation process. Note that admin privileges are required to load this package. It works best to run this from the account where you will run GSAS-II and supply the name of the admin account when requested, as this will cause your login shell setup file to be updated so that directory {{{/Library/Frameworks/Python.framework/Versions/Current/bin}}} is in your path. (This is done by adding lines like this to file ~/.profile:
     16{{{
     17# Setting PATH for EPD-7.2-2
     18PATH="/Library/Frameworks/Python.framework/Versions/Current/bin:${PATH}"
     19export PATH
     20}}}
    1521
    16 It is probably possible to install the [http://www.enthought.com/products/epd_free.php EPDFree] package and then build the [http://pypi.python.org/pypi/PyOpenGL PyOpenGL] package from source code, but this has not yet been attempted.
     22 * We have done some testing with the freely distributed [http://www.enthought.com/products/epd_free.php EPDFree] package. This is a ~72Mb .dmg file that also requires admin privs to install. Follow the previous installation directions. [http://www.enthought.com/products/epd_free.php EPDFree] provides everything one needs to run GSAS-II except the interface needed for OpenGL graphics ([http://pypi.python.org/pypi/PyOpenGL PyOpenGL]) which can be added. GSAS-II will attempt to install this package for you.
     23
     24 * [http://www.activestate.com/activepython ActiveState ActivePython] This is also commercial licensed software. There is a free version with no support. We have not tried this yet.
    1725
    1826=== Subversion ===
    1927
    20 Subversion 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/). It is already installed in 10.5 (Leopard) and 10.6 (Snow Leopard) but not 10.4. Subversion likely can be found and downloaded for 10.4, but the latest EPD releases require 10.5 or later. While GSAS-II can probably be run on 10.4, this is probably a lot more work than one would like.
     28Subversion 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/). Macs with 10.5 (Leopard) and 10.6 (Snow Leopard) have this. As mentioned, while GSAS-II can probably be run on 10.4, this is probably a lot more work than one would like.
    2129
    2230=== Compiling Fortran Code ===
    2331
    24 GSAS-II requires a small number of Fortran routines that are incorporated as Python packages (.so 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.
     32You can probably skip this step: GSAS-II requires a small number of Fortran routines that are incorporated as Python packages (.so files). GSAS-II is distributed with these files compiled for Python 2.7 and Mac OS X 10.5 and 10.6+, but if you are using something that does not match this, you may need to compile the Fortran routines yourself using the !NumPy f2py routine and the compiler of your choice. Both G77 and GFortran have worked on the Mac.
    2533
    2634To 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 .so files. This is done by
     
    3442
    3543= Installation =
     44
     45We prefer that GSAS-II be installed using subversion so that it is easy to get updates (which are frequent). Fortunately, since 10.5, Macs come with subversion installed. This procedure loads GSAS-II using subversion:
     46
    3647
    3748 1.  Create a folder where you want to install GSAS-II.
     
    5162 5. This creates a GSASII.app file that can be used to start GSAS-II either by clicking on the app or by dragging a file onto the app. Note that the app file can be dragged to the doc, but it cannot be moved to another folder. Instead, create an alias and move the alias where desired.
    5263
     64 Note that GSAS-II can be updated by use of the bootstrap.py, which will download any newly created or updated program files.
     65
    5366=== Errors from GSASII.app ===
    5467