Skip to content

Commit be61825

Browse files
TomAugspurgerjorisvandenbossche
authored andcommitted
DOC: Update README to link to install instructions. (pandas-dev#13882)
1 parent 8d1646c commit be61825

File tree

1 file changed

+7
-82
lines changed

1 file changed

+7
-82
lines changed

README.md

+7-82
Original file line numberDiff line numberDiff line change
@@ -129,102 +129,27 @@ Here are just a few of the things that pandas does well:
129129
The source code is currently hosted on GitHub at:
130130
http://github.com/pydata/pandas
131131

132-
Binary installers for the latest released version are available at the Python
133-
package index
134-
135-
http://pypi.python.org/pypi/pandas/
136-
137-
And via `easy_install`:
132+
Binary installers for the latest released version are available at the [Python
133+
package index](http://pypi.python.org/pypi/pandas/) and on conda.
138134

139135
```sh
140-
easy_install pandas
136+
# conda
137+
conda install pandas
141138
```
142139

143-
or `pip`:
144-
145140
```sh
141+
# or PyPI
146142
pip install pandas
147143
```
148144

149-
or `conda`:
150-
151-
```sh
152-
conda install pandas
153-
```
154-
155145
## Dependencies
156146
- [NumPy](http://www.numpy.org): 1.7.0 or higher
157147
- [python-dateutil](http://labix.org/python-dateutil): 1.5 or higher
158148
- [pytz](http://pytz.sourceforge.net)
159149
- Needed for time zone support with ``pandas.date_range``
160150

161-
### Highly Recommended Dependencies
162-
- [numexpr](https://github.com/pydata/numexpr)
163-
- Needed to accelerate some expression evaluation operations
164-
- Required by PyTables
165-
- [bottleneck](http://berkeleyanalytics.com/bottleneck)
166-
- Needed to accelerate certain numerical operations
167-
168-
### Optional dependencies
169-
- [Cython](http://www.cython.org): Only necessary to build development version. Version 0.17.1 or higher.
170-
- [SciPy](http://www.scipy.org): miscellaneous statistical functions
171-
- [PyTables](http://www.pytables.org): necessary for HDF5-based storage
172-
- [SQLAlchemy](http://www.sqlalchemy.org): for SQL database support. Version 0.8.1 or higher recommended.
173-
- [matplotlib](http://matplotlib.org/): for plotting
174-
- [statsmodels](http://www.statsmodels.org/)
175-
- Needed for parts of `pandas.stats`
176-
- For Excel I/O:
177-
- [xlrd/xlwt](http://www.python-excel.org/)
178-
- Excel reading (xlrd) and writing (xlwt)
179-
- [openpyxl](http://packages.python.org/openpyxl/)
180-
- openpyxl version 1.6.1 or higher, but lower than 2.0.0, for
181-
writing .xlsx files
182-
- xlrd >= 0.9.0
183-
- [XlsxWriter](https://pypi.python.org/pypi/XlsxWriter)
184-
- Alternative Excel writer.
185-
- [Google bq Command Line Tool](https://cloud.google.com/bigquery/bq-command-line-tool)
186-
- Needed for `pandas.io.gbq`
187-
- [boto](https://pypi.python.org/pypi/boto): necessary for Amazon S3 access.
188-
- One of the following combinations of libraries is needed to use the
189-
top-level [`pandas.read_html`][read-html-docs] function:
190-
- [BeautifulSoup4][BeautifulSoup4] and [html5lib][html5lib] (Any
191-
recent version of [html5lib][html5lib] is okay.)
192-
- [BeautifulSoup4][BeautifulSoup4] and [lxml][lxml]
193-
- [BeautifulSoup4][BeautifulSoup4] and [html5lib][html5lib] and [lxml][lxml]
194-
- Only [lxml][lxml], although see [HTML reading gotchas][html-gotchas]
195-
for reasons as to why you should probably **not** take this approach.
196-
197-
#### Notes about HTML parsing libraries
198-
- If you install [BeautifulSoup4][BeautifulSoup4] you must install
199-
either [lxml][lxml] or [html5lib][html5lib] or both.
200-
`pandas.read_html` will **not** work with *only* `BeautifulSoup4`
201-
installed.
202-
- You are strongly encouraged to read [HTML reading
203-
gotchas][html-gotchas]. It explains issues surrounding the
204-
installation and usage of the above three libraries.
205-
- You may need to install an older version of
206-
[BeautifulSoup4][BeautifulSoup4]:
207-
- Versions 4.2.1, 4.1.3 and 4.0.2 have been confirmed for 64 and
208-
32-bit Ubuntu/Debian
209-
- Additionally, if you're using [Anaconda][Anaconda] you should
210-
definitely read [the gotchas about HTML parsing][html-gotchas]
211-
libraries
212-
- If you're on a system with `apt-get` you can do
213-
214-
```sh
215-
sudo apt-get build-dep python-lxml
216-
```
217-
218-
to get the necessary dependencies for installation of [lxml][lxml].
219-
This will prevent further headaches down the line.
220-
221-
[html5lib]: https://github.com/html5lib/html5lib-python "html5lib"
222-
[BeautifulSoup4]: http://www.crummy.com/software/BeautifulSoup "BeautifulSoup4"
223-
[lxml]: http://lxml.de
224-
[Anaconda]: https://store.continuum.io/cshop/anaconda
225-
[NumPy]: http://numpy.scipy.org/
226-
[html-gotchas]: http://pandas.pydata.org/pandas-docs/stable/gotchas.html#html-table-parsing
227-
[read-html-docs]: http://pandas.pydata.org/pandas-docs/stable/generated/pandas.io.html.read_html.html#pandas.io.html.read_html
151+
See the [full installation instructions](http://pandas.pydata.org/pandas-docs/stable/install.html)
152+
for recommended and optional dependencies.
228153

229154
## Installation from sources
230155
To install pandas from source you need Cython in addition to the normal

0 commit comments

Comments
 (0)