Skip to content

OSX install #3238

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
Jul 17, 2014
Merged

OSX install #3238

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
7b9fef5
replaces epd and pythonxy with anaconda and canopy. Also, added some …
katyhuff Jul 12, 2014
7108099
adds dyld_fallback_library_path
katyhuff Jul 12, 2014
a79cfc6
removing pythonxy
katyhuff Jul 12, 2014
d847a85
reformatting for line length
katyhuff Jul 12, 2014
7e2fdd2
redhat->linux
katyhuff Jul 12, 2014
156ff59
drops pylab reference
katyhuff Jul 12, 2014
a68e33e
getting rid of extra space
katyhuff Jul 12, 2014
9bd9c6f
both are good distributions
katyhuff Jul 12, 2014
1b3243c
conda libpng and freetype don't help
katyhuff Jul 12, 2014
a52cd33
Two
katyhuff Jul 13, 2014
40861f7
moves libpng from optional to required
katyhuff Jul 13, 2014
8755041
puts pythonxy back in
katyhuff Jul 14, 2014
4efb43a
python(x,y) is now on google code?
katyhuff Jul 16, 2014
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 14 additions & 15 deletions INSTALL
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,18 +11,18 @@ depends on what operating system you are using, what you already have
installed, and how you want to use it. To avoid wading through all
the details (and potential complications) on this page, the easiest
thing for you to do is use one of the pre-packaged python
distributions that already provide matplotlib built-in. The Enthought
Python Distribution `(EPD)
<http://www.enthought.com/products/epd.php>`_ for Windows, OS X or
Redhat is an excellent choice that "just works" out of the box.
distributions that already provide matplotlib built-in. The Continuum.io
Python distribution `(Anaconda)
<https://store.continuum.io/cshop/anaconda/>`_ and the Enthought
distribution `(Canopy) <https://www.enthought.com/products/canopy/>`_
are both excellent choices that "just work" out of the box for any
platform. Both of these packages include matplotlib and
*lots* of other useful tools.
Another excellent alternative for Windows users is `Python (x, y)
<http://www.pythonxy.com/>`_ which tends to be updated a bit more
frequently. Both of these packages include matplotlib and pylab, and
*lots* of other useful tools. matplotlib is also packaged for almost
<https://code.google.com/p/pythonxy>`_ . matplotlib is also packaged for almost
every major Linux distribution. So if you are on Linux, your package
manager will probably provide matplotlib prebuilt.


Manually installing pre-built packages
======================================

Expand Down Expand Up @@ -198,6 +198,12 @@ six 1.3 or later
Python 2/3 compatibility library. This is also a dependency of
:term:`dateutil`.

libpng 1.2 (or later)
library for loading and saving :term:`PNG` files (`download
<http://www.libpng.org/pub/png/libpng.html>`__). libpng requires
zlib. If you are a Windows user, you can ignore this because we
build support into the matplotlib single-click installer


**Optional GUI frameworks**

Expand Down Expand Up @@ -241,13 +247,6 @@ ImageMagick
user, you can ignore this since we build support into the
matplotlib single click installer.


libpng 1.2 (or later)
library for loading and saving :term:`PNG` files (`download
<http://www.libpng.org/pub/png/libpng.html>`__). libpng requires
zlib. If you are a Windows user, you can ignore this because we
build support into the matplotlib single-click installer

**Required libraries that ship with matplotlib**

:term:`agg` 2.4
Expand Down
21 changes: 14 additions & 7 deletions README.osx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
Building mpl on OSX has proven to be a nightmare because of all the
Building mpl on OSX is sometimes a nightmare because of all the
different types of zlib, png and freetype that may be on your system.
The recommended and supported way to build is to use a third-party
package manager to install the required dependencies, and then
install matplotlib from source using the setup.py script. Two widely
used package managers are homebrew and MacPorts. The following
example illustrates how to install libpng and freetype using
homebrew.

For developers who want to build matplotlib from source, the recommended and
supported way to build is to use a third-party package manager to install the
required dependencies, and then install matplotlib from source using the
setup.py script. Two widely used package managers are homebrew, and
MacPorts. The following example illustrates how to install libpng and freetype
using brew:

Example usage::

Expand All @@ -22,3 +23,9 @@ To install matplotlib from source, execute:
Example usage::

python setup.py install
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So -- this is totally cool, but I think we maybe just discovered this doesn't work (at least it didn't for Michael Nagy and I). building matplotlib from source using conda as dependencies, it doesn't pick up freetype from conda since conda doesn't include pkg-config. Anyway, if it's working for you @katyhuff, it would be good to know so we can get to the bottom of the cause.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ahhhh... I have two sets of each library installed. Glad you caught this. Matplotlib is picking up my macports libpng rather than the conda one! Changing instructions back accordingly.



Note that your environment is somewhat important. Some conda users have
found that, to run the tests, their PYTHONPATH must include
/path/to/anaconda/.../site-packages and their DYLD_FALLBACK_LIBRARY_PATH
must include /path/to/anaconda/lib.