Changes between Version 23 and Version 24 of InstallMacHardWay


Ignore:
Timestamp:
Oct 25, 2018 11:24:43 PM (3 years ago)
Author:
toby
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallMacHardWay

    v23 v24  
    11= Installing GSAS-II on Mac OS X =
    22
    3 **Try this First:** A new single-step installer has been developed for GSAS-II on Macs. Please try this first [MacSingleStepInstaller using the instructions here] and report any problems (or success).
     3GSAS-II has been tested by us on Intel (i386) Macs typically running 10.12. Newer versions of OS X should not be a problem. Versions of OS X as old as 10.6 should work, but you will need to find and install older Python distributions -- see section III below.
    44
    5 == Detailed installation information ==
     5== I. Installing the easy way ==
    66
    7 Prerequisite: Before GSAS-II can be used on your computer, you must have Python 2.7.x installed with a number of [PythonPackages required Python packages] (see below.)
     7Most people will install GSAS-II by downloading a single file that contains all needed Python packages and then launches a script that downloads the appropriate files from the GSAS-II svn server. Use [MacSingleStepInstaller the instructions here] and please report any problems.
    88
    9 GSAS-II has been tested by us on Intel (i386) Macs running 10.5-10.11. 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.
     9== II. Installing for Anaconda Enthusiasts ==
     10
     11If you are already a user of Anaconda Python, then you may not want to install yet another version of Python on your computer. If so, you can use the conda package manager in Anaconda to install GSAS-II for you with a simple terminal window command:
     12
     13conda install gsas2pkg -c briantoby
     14
     15See here for more information on this.
     16
     17== III. Installing Python etc. Manually ==
     18
     19Note that Before GSAS-II can be used on your computer, you must have Python 2.7.x or Python 3.6+ installed with a number of [PythonPackages required Python packages] (see below.) You will also need to have subversion (svn) installed.
     20
     21Getting 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.
    1022
    1123[InstallNotesMavericks 10.9 Users, please see these notes] (probably appropriate for 10.8, too) before reading farther.
     
    1628
    1729
    18 1.   We have made extensive use of the older 32-bit EPDfree Python distribution; 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/.) Alternates are the 64-bit Canopy Express from [https://www.enthought.com/downloads/ Enthought downloads] and [https://www.continuum.io/downloads Anaconda from Continuum]. Be sure to download Python 2.7. **''GSAS-II does not yet support Python 3.x.''**
    19  At present, both EPDfree and Canopy Express require administrator privileges to install.
     301.   We have made extensive use of the older 32-bit EPDfree Python distribution; 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/.) Alternates are the 64-bit Canopy Express from [https://www.enthought.com/downloads/ Enthought downloads] and [https://www.continuum.io/downloads Anaconda from Continuum].
     31At present, both EPDfree and Canopy Express require administrator privileges to install.
    2032
    21 2. (For 10.7 or earlier, skip this step.) Install Subversion, if running Mountain Lion (OS X 10.8+) or later type svn in at a terminal window to get a prompt from OS X to download and install this directly from Apple.
     332. **Install Subversion**: (For 10.7 or earlier, skip this step; if using anaconda, you can also use the "conda install svn" command as an alterative to this step.)  For Mountain Lion (OS X 10.8+) or later type svn into a terminal window to get a prompt from OS X to download and install this directly from Apple.
    2234
    23353. Download file bootstrap.py file from ​https://subversion.xray.aps.anl.gov/trac/pyGSAS/browser/install/bootstrap.py?format=txt and move it to the location where you want GSAS-II to be installed.
     
    3143=== Python ===
    3244
    33 Python 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. You must use a 2.7 version of Python. GSAS-II will not run under Python 3.x. Note that we are seeing some minor GUI bugs with wxPython 2.9 and later, which is the first Mac release to support 64-bit Python. Please report them.
     45Python 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 Python 2.7 and Python 3.6 (and later) are both supported for GSAS-II.**
    3446
    35 We mostly use the [http://www.enthought.com/products/epd.php Enthought Python Distribution] (EPD) package for our code development, but most users seem to be using Continuum Inc's [https://www.continuum.io/downloads Anaconda Python] package (Note: be sure to use the **Python 2.7** version) and do some testing with that. We have also done just a bit of testing with Enthought's newer product, Canopy. The free versions of EPD and Canopy 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.
     47We mostly use See Anaconda Inc.'s !Miniconda/Anaconda package (see [https://www.continuum.io/downloads here for Anaconda Python]. With anaconda, you will need to use the conda command to download wxpython and possibly other packages. Previously we used
     48the [http://www.enthought.com/products/epd.php Enthought Python Distribution] (EPD) package for our code development.
    3649
    37 ** Note that at this time, Python 2.7 is recommended and probably required for GSAS-II. GSAS-II does not yet support Python 3.0+.**
     50* [http://www.enthought.com/products/epd_free.php Enthought Canopy] should also work, but be sure to the **Python 2.7** version of Canopy because Canopy 3.x does not have wxpython) and do some testing with that. We have also done just a bit of testing with Enthought's newer product, Canopy. The free versions of EPD and Canopy 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.
    3851
    39  * See Continuum Inc's web page to download and install [https://www.continuum.io/downloads Anaconda Python]. You will need to use the conda command to download wxpython and possibly other packages.
    40 
    41  * The freely distributed [http://www.enthought.com/products/epd_free.php Enthought Canopy Express Python package] and its precursor, [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the older EPDfree 32-bit Mac installer], 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 paid subscription versions of Canopy/EPD do contain this package and also work fine.
    42 
    43  To get Canopy Express, use the "Get Canopy Express" button on http://www.enthought.com/downloads. See  [InstallNotesMavericks these notes for installation details.]
    44 
    45  For EPD free 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/.  Installation of EPD free 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:
     52 * For Macs running really old versions of OS X, you will need a compatible Python distribution. There may be older versions of Anaconda or Canopy that will work. One option that should work is the [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg quite old EPDfree 32-bit Mac installer], 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. Installation of EPD free 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:
    4653{{{
    4754# Setting PATH for EPD-7.2-2