1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
===============================
Building from source on Mac OSX
===============================
.. note::
This document has not been maintained and is retained for reference only.
For building on macOS, please see :ref:`quickstart-mac`.
These instructions describe how to build NumPy and SciPy libraries from
source.
If you just want to use NumPy or SciPy, install pre-built binaries as described
in :ref:`installing-upgrading`.
Python
------
Apple ships its own version of Python with OS X. However, we
*strongly* recommend installing the `official Python distribution
<https://www.python.org/downloads/>`__.
Alternatively, use Python from one of the OS X package managers
(Homebrew, MacPorts, Fink).
Compilers (C/C++/FORTRAN/Cython)
--------------------------------
Though virtually any commercial C/C++ compiler may be used with SciPy, Clang C/C++ compiler,
which is a Xcode command line tool, can be used for OS X.
The only thing missing is the GNU FORTRAN compiler.
We recommend gfortran; this is a free, open source, F95 compiler. We suggest you
use the following binaries:
* gfortran installed via `Homebrew <https://brew.sh/>`__, or,
* http://r.research.att.com/tools/gcc-42-5666.3-darwin11.pkg (for Xcode
4.2 or higher)
See `this site <http://r.research.att.com/tools/>`__ for the most recent links.
Unless you are building from released source packages, the `Cython
<https://cython.org/>`__ compiler is also needed.
BLAS/LAPACK Installation
------------------------
You will also need to install a library providing the BLAS and LAPACK
interfaces. ATLAS, OpenBLAS, and MKL all work. OpenBLAS can be installed
via `Homebrew <https://brew.sh/>`.
As of SciPy version 1.2.0, we do not support compiling against the system
Accelerate library for BLAS and LAPACK. It does not support a sufficiently
recent LAPACK interface.
Version-specific notes
----------------------
This section notes only things specific to one version of OS X or Python.
The build instructions in :ref:`Obtaining and Building NumPy and SciPy
<osx-obtaining-and-building>` apply to all versions.
.. _osx-obtaining-and-building:
Obtaining and Building NumPy and SciPy
--------------------------------------
You may install NumPy and SciPy either by checking out the source
files or downloading a source archive file from
`GitHub <https://github.com/scipy/scipy>`__. If you choose the latter,
simply expand the archive (generally a gzipped tar file), otherwise
check out the following branches from the repository:
::
$ git clone https://github.com/numpy/numpy.git
$ git clone https://github.com/scipy/scipy.git
Both NumPy and SciPy are built as follows:
::
$ python setup.py build
$ python setup.py install
The above applies to the `official Python distribution
<https://www.python.org/downloads/>`__, which is 32-bit
only for 2.6 while 32/64-bit bundles are available for 2.7 and
3.x. For alternative 64-bit Pythons (either from Apple or home-built)
on Snow Leopard, you may need to extend your build flags to specify
the architecture by setting LDFLAGS and FFLAGS.
Note that with distutils (setup.py) given build flags like LDFLAGS
**do not extend but override the defaults**, so you have to specify
all necessary flags. Only try this if you know what you're doing!
After a successful build, you may try running the built-in unit tests
for SciPy:
::
$ python
>>> import numpy as np
>>> np.test('full')
>>> import scipy
>>> scipy.test()
Be sure not to import numpy or scipy while you're in the numpy/scipy
source tree. Change directory first.
If you have any problems installing SciPy on your Mac
based on these instructions, please check the `scipy-users and
scipy-dev mailing list archives
<https://www.scipy.org/scipylib/mailing-lists.html>`__
for possible solutions. If you
are still stuck, feel free to join scipy-users for further
assistance. Please have the following information ready:
* Your OS version
* The versions of gcc and gfortran and where you obtained gfortran
* ``$ gcc --version``
* ``$ gfortran --version``
* The versions of numpy and scipy that you are trying to install
* The full output of ``$ python setup.py build``
|
