[README] updated readme instructions, added troubleshooting

This commit is contained in:
Max Zwiessele 2015-09-11 17:34:06 +01:00
parent 5ff4683883
commit 4a1cd7c12c

View file

@ -11,6 +11,10 @@ A Gaussian processes framework in Python.
Continuous integration status: ![CI status](https://travis-ci.org/SheffieldML/GPy.png) Continuous integration status: ![CI status](https://travis-ci.org/SheffieldML/GPy.png)
### Avalability
Python 2.7 and 3.4, Windows, MacOSX, Linux
### Citation ### Citation
@Misc{gpy2014, @Misc{gpy2014,
@ -20,9 +24,9 @@ Continuous integration status: ![CI status](https://travis-ci.org/SheffieldML/GP
year = {2012--2015} year = {2012--2015}
} }
### Pronounciation ### Pronounciation: dʒí páj
We like to pronounce it 'dʒí páj'. We like to pronounce it 'g-pie'.
### Getting started: installing with pip ### Getting started: installing with pip
@ -39,12 +43,9 @@ although enthought currently (as of 8th Sep. 2015) does not support scipy 0.16.
If you'd like to install from source, or want to contribute to the project (e.g. by sending pull requests via github), read on. If you'd like to install from source, or want to contribute to the project (e.g. by sending pull requests via github), read on.
### Python 3 Compatibility ### Troubleshooting installation problems
Work is underway to make GPy run on Python 3.
* All tests in the testsuite now run on Python3. If you're having trouble installing GPy via `pip install GPy` here is a probable solution:
To see this for yourself, in Ubuntu 14.04, you can do
git clone https://github.com/mikecroucher/GPy.git git clone https://github.com/mikecroucher/GPy.git
cd GPy cd GPy
@ -52,20 +53,6 @@ To see this for yourself, in Ubuntu 14.04, you can do
python3 setup.py build_ext --inplace python3 setup.py build_ext --inplace
nosetests3 GPy/testing nosetests3 GPy/testing
nosetests3 is Ubuntu's way of reffering to the Python 3 version of nosetests. You install it with
sudo apt-get install python3-nose
The command `python3 setup.py build_ext --inplace` builds the Cython extensions. IF it doesn't work, you may need to install this:
sudo apt-get install python3-dev
* Test coverage is less than 100% so it is expected that there is still more work to be done. We need more tests and examples to try out.
* All weave functions not covered by the test suite are *simply commented out*. Can add equivalents later as test functions become available
* A set of benchmarks would be useful!
### Ubuntu hackers ### Ubuntu hackers
> Note: Right now the Ubuntu package index does not include scipy 0.16.0, and thus, cannot > Note: Right now the Ubuntu package index does not include scipy 0.16.0, and thus, cannot