{
    "body": "<section id=\"installation\">\n<span id=\"installpage\"></span><h1>Installation<a class=\"headerlink\" href=\"#installation\" title=\"Permalink to this heading\">\uf0c1</a></h1>\n<p>astLib requires:</p>\n<ul class=\"simple\">\n<li><p>Python (tested on versions 3.6+)</p></li>\n<li><p>Astropy - <a class=\"reference external\" href=\"http://www.astropy.org\">http://www.astropy.org</a> (tested on version 3.2.1)</p></li>\n<li><p>Numpy - <a class=\"reference external\" href=\"http://numpy.scipy.org\">http://numpy.scipy.org</a> (tested on version 1.18.1)</p></li>\n<li><p>SciPy - <a class=\"reference external\" href=\"http://scipy.org\">http://scipy.org</a> (tested on version 1.3.1)</p></li>\n<li><p>Matplotlib - <a class=\"reference external\" href=\"http://matplotlib.sourceforge.net\">http://matplotlib.sourceforge.net</a> (tested on version 3.1.1)</p></li>\n</ul>\n<p>Optional:</p>\n<ul class=\"simple\">\n<li><p>Python Imaging Library - <a class=\"reference external\" href=\"http://www.pythonware.com/products/pil\">http://www.pythonware.com/products/pil</a> (tested on version 1.1.7)</p></li>\n</ul>\n<p>Other versions of the software listed above are likely to work.</p>\n<p>You can install astLib via pip:</p>\n<div class=\"highlight-default notranslate\"><div class=\"highlight\"><pre><span></span><span class=\"n\">pip</span> <span class=\"n\">install</span> <span class=\"n\">astLib</span> <span class=\"o\">--</span><span class=\"n\">user</span>\n</pre></div>\n</div>\n<p>You may also install using the standard <code class=\"docutils literal notranslate\"><span class=\"pre\">setup.py</span></code> script, e.g., as root:</p>\n<div class=\"highlight-default notranslate\"><div class=\"highlight\"><pre><span></span><span class=\"n\">sudo</span> <span class=\"n\">python</span> <span class=\"n\">setup</span><span class=\"o\">.</span><span class=\"n\">py</span> <span class=\"n\">install</span>\n</pre></div>\n</div>\n<p>Alternatively,</p>\n<div class=\"highlight-default notranslate\"><div class=\"highlight\"><pre><span></span><span class=\"n\">python</span> <span class=\"n\">setup</span><span class=\"o\">.</span><span class=\"n\">py</span> <span class=\"n\">install</span> <span class=\"o\">--</span><span class=\"n\">user</span>\n</pre></div>\n</div>\n<p>will install <code class=\"docutils literal notranslate\"><span class=\"pre\">astLib</span></code> under <code class=\"docutils literal notranslate\"><span class=\"pre\">$HOME/.local</span></code> (on Ubuntu), and in some other default location on Mac.</p>\n<p>You can also use the <code class=\"docutils literal notranslate\"><span class=\"pre\">--prefix</span></code> option, e.g.,</p>\n<div class=\"highlight-default notranslate\"><div class=\"highlight\"><pre><span></span>python setup.py install --prefix=$HOME/local\n</pre></div>\n</div>\n<p>and then add, e.g., <code class=\"docutils literal notranslate\"><span class=\"pre\">$HOME/local/lib/python3.6/site-packages</span></code> to\n$PYTHONPATH (adjust the path according to your Python version number).</p>\n<div class=\"highlight-default notranslate\"><div class=\"highlight\"><pre><span></span>export PYTHONPATH=$HOME/local/lib/python3.6/site-packages:$PYTHONPATH\n</pre></div>\n</div>\n<section id=\"installation-on-recent-versions-of-macos-may-no-longer-be-relevant\">\n<h2>Installation on recent versions of macOS (may no longer be relevant)<a class=\"headerlink\" href=\"#installation-on-recent-versions-of-macos-may-no-longer-be-relevant\" title=\"Permalink to this heading\">\uf0c1</a></h2>\n<p>Some users have reported that the standard method for installing <code class=\"docutils literal notranslate\"><span class=\"pre\">astLib</span></code> does not work on recent versions\nof macOS (e.g., Big Sur), due to the default compiler flags. The current workaround for this is to install\nusing:</p>\n<div class=\"highlight-default notranslate\"><div class=\"highlight\"><pre><span></span><span class=\"n\">CFLAGS</span><span class=\"o\">=</span><span class=\"s2\">&quot;-Wno-error=implicit-function-declaration&quot;</span> <span class=\"n\">python</span> <span class=\"n\">setup</span><span class=\"o\">.</span><span class=\"n\">py</span> <span class=\"n\">install</span>\n</pre></div>\n</div>\n<p>Thanks to Michael Cowley and Stefano Covino for helping to resolve this issue.</p>\n</section>\n</section>\n",
    "title": "Installation",
    "sourcename": "install.rst.txt",
    "current_page_name": "install",
    "toc": "<ul>\n<li><a class=\"reference internal\" href=\"#\">Installation</a><ul>\n<li><a class=\"reference internal\" href=\"#installation-on-recent-versions-of-macos-may-no-longer-be-relevant\">Installation on recent versions of macOS (may no longer be relevant)</a></li>\n</ul>\n</li>\n</ul>\n",
    "page_source_suffix": ".rst"
}