Changes between Version 24 and Version 25 of InstallMacHardWay


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

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallMacHardWay

    v24 v25  
    2121Getting 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.
    2222
    23 [InstallNotesMavericks 10.9 Users, please see these notes] (probably appropriate for 10.8, too) before reading farther.
     23=== Overview for Manual Installation ===
    2424
    25 === Overview for Step-by-step Installation ===
    26 
    27 ''Note that we are now recommending the  [MacSingleStepInstaller new procedure here] rather than the instructions below.''
     25''Please don't do this unless you have to. The [MacSingleStepInstaller single-step installer] is so much easier than the instructions below.''
    2826
    2927
    30 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].
    31 At present, both EPDfree and Canopy Express require administrator privileges to install.
     281. **Python**:  We recommend use of [https://www.continuum.io/downloads Anaconda Python], but we previously made extensive use of the older 32-bit EPDfree Python distribution, which can be  [https://s3.amazonaws.com/storage.enthought.com/installers/epd_free-7.3-2-macosx-i386.dmg the downloaded here] -- note this requires administrator privileges to install. Another choice is Canopy from [https://www.enthought.com/downloads/ Enthought downloads]
    3229
    33 2. **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.
     302. **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 ([InstallNotesMavericks as shown here]) to get a prompt from OS X to download and install this directly from Apple.
    3431
    35323. 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.
    3633
    37 4. Start a terminal window and run the previous file by typing ```<path1>python <path2>bootstrap.py```, where ```<path1>``` is the location where the full python has been loaded. If you are not sure, you can type python on a line by itself and see if you are running EPD python. ```<path2>```` will be where you have installed the bootstrap.py file. Simply clicking on that file might work.
     344. Start a terminal window and run the previous file by typing ```<path1>python <path2>bootstrap.py```, where ```<path1>``` is the location where the full python has been loaded. If you are not sure, you can type python on a line by itself and see if you are running the python you installed. ```<path2>```` will be where you have installed the bootstrap.py file. Simply clicking on that file might work.
    3835
    39365. Run GSAS-II with the GSASII.app file created by the bootstrap procedure.
    4037
    41 == Background Information on Installation ==
     38== Detailed Information on Installation ==
    4239
    4340=== Python ===
    4441
    45 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. ** Note that Python 2.7 and Python 3.6 (and later) are both supported for GSAS-II.**
     42Python is a computer scripting language, which means that one must have the Python interpreter installed on your Mac to run a Python program. ** Note that Python 2.7 and Python 3.6 (and later) are both supported for GSAS-II.** Macs do come with Python installed, but not with all the [PythonPackages Python packages required by GSAS-II] and adding those packages to the Mac installation is hard, if not impossible. Use of the Fink or !DarwinPorts versions of Python is also not a good choice -- the GUI and graphics will be shown in X-windows rather than in Mac style.
    4643
    47 We 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
    48 the [http://www.enthought.com/products/epd.php Enthought Python Distribution] (EPD) package for our code development.
     44* We mostly use Anaconda Inc.'s !Miniconda/Anaconda packages (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.
    4945
    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.
     46* [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 with Python 3.x does not have wxpython). We have not done any recent testing with Canopy. 
    5147
    5248 * 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:
     
    6056[[Image(EPDerror.png,300)]]
    6157
    62  * [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.
     58 * [http://www.activestate.com/activepython ActiveState ActivePython] is a another possible alternative. This is also commercial licensed software, with a free version with no support. We have not tried this yet. If it works for you, please let us know.
    6359
    6460=== Subversion ===
     
    9288Note 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.
    9389
    94 === Updated GSAS-II.app ===
     90=== Updating GSAS-II.app ===
    9591
    96 As of GSAS-II version 983 (July 7, 2013), a new app builder is used. This can be rerun using the supplied ``makeMacApp.py`` file manually (be sure to use the Python needed for GSAS-II with a command like
     92Since 2013, a script to build an app to run GSAS-II called ``makeMacApp.py``is supplied. This can be rerun using the appropriate version of Python needed to run GSAS-II with a command like
    9793{{{<path>python <path>makeMacApp.py}}})
    9894
    9995=== Compiling Fortran Code ===
    10096
    101 Please 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.
     97This step can usually be skipped, unless you have an older computer running OS X 10.4 or a PPC (G4, etc.) CPU.
    10298
    103 GSAS-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.
     99GSAS-II requires a small number of Fortran routines that are incorporated as Python packages (.so files). GSAS-II provides these for many common Python configurations. 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.
    104100
    105101To 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