Updated/extended macOS install instructions #1297
Conversation
heplesser
added
T: Enhancement
| @@ -49,7 +49,7 @@ Manual installation | |||
|
|
|||
| The clang/clang++ compiler that ships with OS X/macOS does not support OpenMP threads and creates code that fails some tests. You therefore need to use **GCC** to compile NEST under OS X/macOS. | |||
|
|
|||
| Installation instructions here have been tested under OS X 10.11 *El Capitan* and macOS 10.12 *Sierra* with `Anaconda Python 2 and 3 <https://www.continuum.io/anaconda-overview>`_ and all other dependencies installed via `Homebrew <http://brew.sh>`_. See below for `Manual installation with dependencies from MacPorts`_. | |||
| Installation instructions here have been tested under macOS 10.14 *Mojave* with `Anaconda Python 3 <https://www.continuum.io/anaconda-overview>`_ and all other dependencies installed via `Homebrew <http://brew.sh>`_. They should also work with earlier versions of macOS. | |||
There was a problem hiding this comment.
@heplesser Can you be more explicit here in the steps you took to create this environment?
What about the PyNEST dependencies like numpy, scipy, and matplotlib?
which order did you use (brew install then conda install) ? Do you create a conda environment before installing the dependencies?
There was a problem hiding this comment.
I have tried different approaches at different times, both with the full Anaconda package and miniconda plus the conda install line shown in the Python section. I did not explicitly create conda environments in all cases I tested, it worked with and without for me. Therefore I have't been more specific here.
There was a problem hiding this comment.
Many thanks for taking time to fix up this file @heplesser
This is related to the PR #1262 but I think it can stand as its own PR because I didn't do many changes to the mac_install page in that other one.
Just a couple of questions related to this page- should we keep the section on homebrew install of nest (the latest version we have is 2.14)? I would also suggest moving or changing the section Python on Mac and explain clearly what steps need to be taken to install dependencies (see comment above).
|
@jessica-mitchell Should we replace the Homebrew section with one on how to install from Conda? Given that the Homebrew version is outdated and no longer maintained, I believe (@tammoippen ?), replacing it with instructions to install from Conda would make sense. But since #1262 is on its way, maybe for now we could leave it as it is? I would also suggest leaving the Python section at the end for now to keep it out of the way. There is a forward link at the start of the document, so users should be able to find it. |
|
@heplesser I would also suggest using a numbered list rather than bullets. In #1262, the 'pre-packaged' versions (conda, ppa, docker, virtual machine) are separated from the 'compiling from source' directions. So I wouldnt want to add the Conda instructions on this page. I think we can discuss in that PR if we want to change how it's organized. But in the case of homebrew, if it will not be updated and maintained with our releases, I would be for removing it. Other than that, I think it's good to go |
|
@jessica-mitchell I have removed the Homebrew instructions now, changed the top-level heading to "manual installation" and changed to an enumerated list. |
I updated the macOS install instructions to a current gcc version number and added troubleshooting information. I also removed the MacPorts instructions, because they have not been tested for a long time and we have, I believe, currently no-one around who uses MacPorts and could test them.