Changes between Version 12 and Version 13 of InstallMacHardWay


Ignore:
Timestamp:
Jul 7, 2013 10:51:27 AM (8 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallMacHardWay

    v12 v13  
    33Prerequisite: Before GSAS-II can be used on your computer, you must have Python installed with a number of [PythonPackages required Python packages] (see below.) You must also have the subversion (svn) package installed, which is standard on all Macs prior to Mountain Lion (10.8).
    44
    5 GSAS-II has been tested by us on Intel (i386) Macs running 10.5 (Leopard), 10.6 (Snow Leopard) and 10.7 (Lion). We have heard from people running with 10.8 (Mountain Lion) but have not tested this ourselves. Getting GSAS-II to run on 10.4 or PPC (G4/G5) Macs is likely possible, but will require considerable work since you would need to build python and its packages from source code and compile the GSAS-II Fortran code; this is not recommended except to the cognoscenti.
     5GSAS-II has been tested by us on Intel (i386) Macs running 10.5 (Leopard), 10.6 (Snow Leopard) and 10.7 (Lion). We have heard from people running with 10.8 (Mountain Lion) but have not tested this ourselves yet. Getting GSAS-II to run on Macs running 10.4 or with a PPC (G4/G5) processor is likely possible, but will require considerable work since you would need to build python and its packages from source code and compile the GSAS-II Fortran code; this is not recommended except to the cognoscenti.
    66
    77=== Quick Install Instructions ===
    88
    9 1.   Install EPDfree, download [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the EPDfree 32-bit Mac installer] from web page https://www.enthought.com/repo/free/. This requires administrator privileges. Note that GSAS-II requires a 32-bit version of Python.
     91.   Install 32-bit Canopy Express from [https://www.enthought.com/store/ the Enthought web page]; (For the older 32-bit EPDfree, download [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the EPDfree 32-bit Mac installer] from web page https://www.enthought.com/repo/free/.) EPDfree requires administrator privileges to install; not sure about Canopy Express.
    1010
    11112. (For 10.7 or earlier, skip this step.) Install Subversion, if running Mountain Lion (OS X 10.8) using http://www.wandisco.com/get/?f=subversion-binaries/1.7/Subversion-1.7.7_10.8.x.pkg or see below for distributions from Apple.
     
    2121Python is a computer scripting language, which means that one must have the Python interpreter installed on your Mac to run a Python program. Macs do come with python installed, but not with all the [PythonPackages Python packages required by GSAS-II], so some Python software installation is required. '''Note that GSAS-II requires 32-bit Python''' because the !WxPython package, at present does not run in 64-bit on the Mac.
    2222
    23 We use the [http://www.enthought.com/products/epd.php Enthought Python Distribution] (EPD) package for our code development (Argonne has a site license). EPD is being replaced by a newer product, Canopy, which we have not tested. We have done some testing with 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 seem 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 rather than in Mac style. Note that at this time, Python 2.7 is recommended for GSAS-II; older versions of Python (particularly 2.5 or earlier) may not work. GSAS-II does not yet support Python 3.0+.
     23We use the [http://www.enthought.com/products/epd.php Enthought Python Distribution] (EPD) package for our code development (Argonne has a site license) and have done a bit of testing with the newer product, Enthought Canopy. The free versions of these packages will run GSAS-II, with addition of one small package that is self-installed (see below). While OS X does come with installed versions of python, they are pretty old and do not contain all the packages GSAS-II needs, 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 rather than in Mac style. Note that at this time, Python 2.7 is recommended for GSAS-II; version 2.6 of Python might work, 2.5 or earlier will not. GSAS-II does not yet support Python 3.0+.
    2424
    25  * The freely distributed [http://www.enthought.com/products/epd_free.php Enthought EPDfree Python package] 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 when first started. Note that Enthought has replaced EPDfree with !CanopyExpress; we have not tested that. To get EPDfree, download [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the EPDfree 32-bit Mac installer] from web page https://www.enthought.com/repo/free/. This is a ~72Mb .dmg file that requires admin privs to install. 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_free.mpkg installer. Click on that to start the installation process. It works best to run this from the account where you will run GSAS-II and supply the name of the admin account and its password 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:
     25 * The freely distributed [http://www.enthought.com/products/epd_free.php Enthought Canopy Express Python package] provides everything one needs to run GSAS-II, except the interface needed for OpenGL graphics ([http://pypi.python.org/pypi/PyOpenGL PyOpenGL]) which is distributed with GSAS-II; GSAS-II will attempt to install this package for you when first started. The subscription versions of Canopy do contain this package and also work fine. To get Canopy Express, use the "Get Canopy Express" button on http://www.enthought.com/products/epd_free.php (or use [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the older EPDfree 32-bit Mac installer] from web page https://www.enthought.com/repo/free/). This is a ~72Mb .dmg file that requires admin privs to install. 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_free.mpkg installer. Click on that to start the installation process. It works best to run this from the account where you will run GSAS-II and supply the name of the admin account and its password 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:
    2626{{{
    2727# Setting PATH for EPD-7.2-2
     
    2929export PATH
    3030}}}
    31 
    32  * [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 a version that can be installed without admin privs is here: http://www.enthought.com/repo/epd/installers/mac_local/). Follow the above instructions to install from the .dmg file or type {{{bash epd-7.7-2-macos-i386.sh}}} and follow prompts to install locally.
    3331
    3432 * [http://www.activestate.com/activepython ActiveState ActivePython] is a possible alternative to EPD. This is also commercial licensed software, where there is a free version with no support. We have not tried this yet. If it works for you, please let us know.
     
    4038=== Compiling Fortran Code ===
    4139
    42 Please skip this step, unless you have an older computer running OS X 10.4 or a PPC (G4, etc.) CPU.
     40Please skip this step, unless you have an older computer running OS X 10.4 or a PPC (G4, etc.) CPU or are not using Python 2.7.
    4341
    44 GSAS-II requires a small number of Fortran routines that are incorporated as Python packages (.so files). If you use Python 2.7 and ac OS X 10.5 and 10.6+, GSAS-II should run with distributed files. If you are using less common, 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.
     42GSAS-II requires a small number of Fortran routines that are incorporated as Python packages (.so files). If you use Python 2.7 and OS X 10.5 and 10.6+, GSAS-II should run with distributed files. If you are using less common options, 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.
    4543
    4644To 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
     
    7169 4. Run the bootstrap.py file by double-clicking on it or using the command {{{python bootstrap.py}}}
    7270
    73  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.
     71 5. This creates a GSAS-II.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.
    7472
    7573Note that GSAS-II can be updated at any time by reusing the {{{bootstrap.py}}} file. This will download any newly created and modify any updated program files.
    7674
    77 === Errors from GSASII.app ===
     75=== Updated GSAS-II.app ===
    7876
    79 The error messages from the GSASII.app are placed in a file named GSASIIerrors in the user's home directory
     77As of GSAS-II version 983 (July 7, 2013), a new app builder is used. This causes the name of the program to be listed as GSAS-II in the Mac menus and has better drag and drop support. If you downloaded the [https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt bootstrap.py] before, update this or else run the new !makeMacApp.py file manually (be sure to use the Python needed for GSAS-II).
    8078
    8179----