From e909e7c76110d68242e18521f8c1fde67d790da5 Mon Sep 17 00:00:00 2001 From: mzwiessele Date: Thu, 1 Oct 2015 18:07:15 +0100 Subject: [PATCH] [master] readme takeover --- README.md | 47 +++++++++++++++++++++++++---------------------- 1 file changed, 25 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index db40350a..87580b4f 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,5 @@ # GPy - A Gaussian processes framework in Python. * [GPy homepage](http://sheffieldml.github.io/GPy/) @@ -8,8 +7,21 @@ A Gaussian processes framework in Python. * [User mailing list](https://lists.shef.ac.uk/sympa/subscribe/gpy-users) * [Online documentation](https://gpy.readthedocs.org/en/latest/) * [Unit tests (Travis-CI)](https://travis-ci.org/SheffieldML/GPy) +* [![licence](https://img.shields.io/badge/licence-BSD-blue.svg)](http://opensource.org/licenses/BSD-3-Clause) + +#### Continuous integration +| | Travis-CI | Codecov | Readthedocs | +| ---: | :--: | :---: | :---: | +| **master:** | [![master](https://travis-ci.org/SheffieldML/GPy.svg?branch=master)](https://travis-ci.org/SheffieldML/GPy) | [![codecov.io](http://codecov.io/github/SheffieldML/GPy/coverage.svg?branch=master)](http://codecov.io/github/SheffieldML/GPy?branch=master) | [![mdocs](https://img.shields.io/badge/docs-master-blue.svg?style=flat)](http://gpy.readthedocs.org/en/master/) | +| **devel:** | [![devel](https://travis-ci.org/SheffieldML/GPy.svg?branch=devel)](https://travis-ci.org/SheffieldML/GPy) | [![codecov.io](http://codecov.io/github/SheffieldML/GPy/coverage.svg?branch=devel)](http://codecov.io/github/SheffieldML/GPy?branch=devel) | [![ddocs](https://img.shields.io/badge/docs-devel-blue.svg?style=flat)](http://gpy.readthedocs.org/en/devel/) | + +### Supported Platforms: + +[](https://www.python.org/) [](http://www.microsoft.com/en-gb/windows) [](http://www.apple.com/osx/) [](https://en.wikipedia.org/wiki/List_of_Linux_distributions) +---- + +Python 2.7, 3.3 and higher -Continuous integration status: ![CI status](https://travis-ci.org/SheffieldML/GPy.png) ### Citation @@ -20,11 +32,11 @@ Continuous integration status: ![CI status](https://travis-ci.org/SheffieldML/GP year = {2012--2015} } -### Pronounciation +### Pronounciation: dʒí páj -We like to pronounce it 'Gee-pie'. +We like to pronounce it 'g-pie'. -### Getting started: installing with pip +### Getting started: installing with pip We are now requiring the newest version (0.16) of [scipy](http://www.scipy.org/) and thus, we strongly recommend using @@ -39,12 +51,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. -### Python 3 Compatibility -Work is underway to make GPy run on Python 3. +### Troubleshooting installation problems -* All tests in the testsuite now run on Python3. - -To see this for yourself, in Ubuntu 14.04, you can do +If you're having trouble installing GPy via `pip install GPy` here is a probable solution: git clone https://github.com/mikecroucher/GPy.git cd GPy @@ -52,19 +61,11 @@ To see this for yourself, in Ubuntu 14.04, you can do python3 setup.py build_ext --inplace 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! - +### Direct downloads +[![PyPI version](https://badge.fury.io/py/GPy.svg)](https://pypi.python.org/pypi/GPy) [![source](https://img.shields.io/badge/download-source-green.svg)](https://github.com/SheffieldML/GPy/releases/latest) +[![Windows](https://img.shields.io/badge/download-windows-orange.svg)](https://github.com/SheffieldML/GPy/releases/latest) +[![MacOSX](https://img.shields.io/badge/download-macosx-blue.svg)](https://github.com/SheffieldML/GPy/releases/latest) ### Ubuntu hackers @@ -165,6 +166,8 @@ or from within IPython Current support for the GPy software is coming through the following projects. +* [EU FP7-HEALTH Project Ref 305626](http://radiant-project.eu) "RADIANT: Rapid Development and Distribution of Statistical Tools for High-Throughput Sequencing Data" + * [EU FP7-PEOPLE Project Ref 316861](http://staffwww.dcs.shef.ac.uk/people/N.Lawrence/projects/mlpm/) "MLPM2012: Machine Learning for Personalized Medicine" * MRC Special Training Fellowship "Bayesian models of expression in the transcriptome for clinical RNA-seq"