|
1 |
| -# PyMC 3 |
| 1 | +# PyMC3 |
2 | 2 | [](https://gitter.im/pymc-devs/pymc?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
3 | 3 |
|
4 | 4 | [](https://travis-ci.org/pymc-devs/pymc3)
|
5 | 5 |
|
6 |
| -PyMC is a python module for Bayesian statistical modeling and model fitting which focuses on advanced Markov chain Monte Carlo fitting algorithms. Its flexibility and extensibility make it applicable to a large suite of problems. |
| 6 | +PyMC3 is a python module for Bayesian statistical modeling and model fitting which focuses on advanced Markov chain Monte Carlo fitting algorithms. Its flexibility and extensibility make it applicable to a large suite of problems. |
7 | 7 |
|
8 | 8 | Check out the [Tutorial](http://pymc-devs.github.io/pymc3/getting_started/)!
|
9 | 9 |
|
10 |
| -***PyMC 3 is alpha software*** and is not ready for use in production. We encourage most new users to use the current release version in the [PyMC 2 repository](https://github.com/pymc-devs/pymc). |
| 10 | +PyMC3 is Beta software. Users should consider using [PyMC 2 repository](https://github.com/pymc-devs/pymc). |
11 | 11 |
|
12 | 12 | ## Features
|
13 | 13 |
|
14 | 14 | * Intuitive model specification syntax, for example, `x ~ N(0,1)` translates to `x = Normal(0,1)`
|
15 |
| - * Powerful sampling algorithms such as [Hamiltonian Monte Carlo](http://en.wikipedia.org/wiki/Hybrid_Monte_Carlo) |
16 |
| - * Easy optimization for finding the *maximum a posteriori* point |
| 15 | + * Powerful sampling algorithms such as the [No U-Turn Sampler] allow complex models with thousands of parameters with little specialized knowledge of fitting algorithms. |
| 16 | + * Easy optimization for finding the *maximum a posteriori*(MAP) point |
17 | 17 | * [Theano](http://deeplearning.net/software/theano/) features
|
18 | 18 | * Numpy broadcasting and advanced indexing
|
19 | 19 | * Linear algebra operators
|
20 | 20 | * Computation optimization and dynamic C compilation
|
21 | 21 | * Simple extensibility
|
| 22 | + * Transparent support for missing value imputation |
22 | 23 |
|
23 | 24 | ## Getting started
|
24 |
| - * [PyMC 3 Tutorial](http://pymc-devs.github.io/pymc3/getting_started/) |
| 25 | + * [PyMC3 Tutorial](http://pymc-devs.github.io/pymc3/getting_started/) |
25 | 26 | * Coal Mining Disasters model in [PyMC 2](https://github.com/pymc-devs/pymc/blob/master/pymc/examples/disaster_model.py) and [PyMC 3](https://github.com/pymc-devs/pymc3/blob/master/pymc3/examples/disaster_model.py)
|
26 | 27 | * [Global Health Metrics & Evaluation model](http://nbviewer.ipython.org/urls/raw.github.com/pymc-devs/pymc3/master/pymc3/examples/GHME%202013.ipynb) case study for GHME 2013
|
27 | 28 | * [Stochastic Volatility model](http://nbviewer.ipython.org/urls/raw.github.com/pymc-devs/pymc3/master/pymc3/examples/stochastic_volatility.ipynb)
|
28 | 29 | * [Several blog posts on linear regression](http://twiecki.github.io/tag/bayesian-statistics.html)
|
29 | 30 | * [Talk at PyData NYC 2013 on PyMC3](http://twiecki.github.io/blog/2013/12/12/bayesian-data-analysis-pymc3/)
|
30 | 31 | * [PyMC3 port of the models presented in the book "Doing Bayesian Data Analysis" by John Kruschke](https://github.com/aloctavodia/Doing_bayesian_data_analysis)
|
31 |
| - * [The PyMC examples folder](https://github.com/pymc-devs/pymc3/tree/master/pymc3/examples) |
| 32 | + * [The PyMC3 examples folder](https://github.com/pymc-devs/pymc3/tree/master/pymc3/examples) |
32 | 33 |
|
33 | 34 | ## Installation
|
34 | 35 |
|
35 |
| -The latest version of PyMC 3 can be installed from the master branch using pip: |
| 36 | +The latest version of PyMC3 can be installed from the master branch using pip: |
36 | 37 |
|
37 | 38 | ```
|
38 | 39 | pip install --process-dependency-links git+https://github.com/pymc-devs/pymc3
|
39 | 40 | ```
|
40 | 41 |
|
41 |
| -The `--process-dependency-links` flag ensures that the developmental branch of Theano, which PyMC requires, is installed. If a recent developmental version of Theano has been installed with another method, this flag can be dropped. |
| 42 | +The `--process-dependency-links` flag ensures that the developmental branch of Theano, which PyMC3 requires, is installed. If a recent developmental version of Theano has been installed with another method, this flag can be dropped. |
42 | 43 |
|
43 |
| -Another option is to clone the repository and install PyMC using `python setup.py install` or `python setup.py develop`. |
| 44 | +Another option is to clone the repository and install PyMC3 using `python setup.py install` or `python setup.py develop`. |
44 | 45 |
|
45 |
| -**Note:** Running `pip install pymc` will install PyMC 2.3, not PyMC 3, from PyPI. |
| 46 | +**Note:** Running `pip install pymc` will install PyMC 2.3, not PyMC3, from PyPI. |
46 | 47 |
|
47 | 48 | ## Dependencies
|
48 | 49 |
|
49 |
| -PyMC is tested on Python 2.7 and 3.3 and depends on Theano, NumPy, |
| 50 | +PyMC3 is tested on Python 2.7 and 3.3 and depends on Theano, NumPy, |
50 | 51 | SciPy, Pandas, and Matplotlib (see setup.py for version information).
|
51 | 52 |
|
52 | 53 | ### Optional
|
|
0 commit comments