pymc-devs · twiecki · Jun 25, 2017 · May 26, 2017 · May 26, 2017 · Jun 23, 2017
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
@@ -1,13 +1,29 @@
 # Release Notes
 
-## PyMC3 3.1 (TBA)
+## PyMC3 3.1 (June 23, 2017)
 
 ### New features
 
-* [Add Gaussian Process submodule](http://pymc-devs.github.io/pymc3/notebooks/GP-introduction.html)
+* New user forum at http://discourse.pymc.io
+
+* [Gaussian Process submodule](http://pymc-devs.github.io/pymc3/notebooks/GP-introduction.html)
+
+* Much improved variational inference support:
+
+  - [Add Operator Variational Inference (experimental).](http://pymc-devs.github.io/pymc3/notebooks/bayesian_neural_network_opvi-advi.html)
+
+  - [Add Stein-Variational Gradient Descent as well as Amortized SVGD (experimental).](https://github.com/pymc-devs/pymc3/pull/2183)
+
+  - [Add pm.Minibatch() to easily specify mini-batches.](http://pymc-devs.github.io/pymc3/notebooks/bayesian_neural_network_opvi-advi.html#Minibatch-ADVI)
+
+  - Added various optimizers including ADAM.
+
+  - Stopping criterion implemented via callbacks.
 
 * sample() defaults changed: tuning is enabled for the first 500 samples which are then discarded from the trace as burn-in.
 
+* MvNormal supports Cholesky Decomposition now for increased speed and numerical stability.
+
 * Many optimizations and speed-ups.
 
 * NUTS implementation now matches current Stan implementation.
@@ -28,24 +44,32 @@
 
 * Much improved variational inference support:
 
-  - [Add Operator Variational Inference (experimental).](http://pymc-devs.github.io/pymc3/notebooks/bayesian_neural_network_opvi-advi.html)
+  - [Added Operator Variational Inference (experimental).](http://pymc-devs.github.io/pymc3/notebooks/variational_api_quickstart.html)
 
-  - [Add Stein-Variational Gradient Descent as well as Amortized SVGD (experimental).](https://github.com/pymc-devs/pymc3/pull/2183)
+  - [Added Stein-Variational Gradient Descent as well as Amortized SVGD (experimental).](https://github.com/pymc-devs/pymc3/pull/2183)
 
-  - [Add pm.generator() to easily specify mini-batches.](http://pymc-devs.github.io/pymc3/notebooks/bayesian_neural_network_opvi-advi.html#Minibatch-ADVI)
+  - [Added `Minibatch` to easily specify mini-batches.](http://pymc-devs.github.io/pymc3/notebooks/bayesian_neural_network_opvi-advi.html#Minibatch-ADVI)
+
+  - Added full-rank ADVI
 
   - Added various optimizers including ADAM.
+
+  - Deprecated old ADVI interface
+
+  - implemented `fit` function as the primary interface to approximation algorithms
+
+* Added support for multidimensional minibatches
 
 * [Sampled posteriors can now be turned into priors for Bayesian updating with a new interpolated distribution.](https://github.com/pymc-devs/pymc3/pull/2163)
 
+* Added `Approximation` class and the ability to convert a sampled trace into an approximation via its `Empirical` subclass.
+
 * `Model` can now be inherited from and act as a base class for user specified models (see pymc3.models.linear).
 
 * Add MvGaussianRandomWalk and MvStudentTRandomWalk distributions.
 
 * GLM models do not need a left-hand variable anymore.
 
-* Add support for cholesky parametrizations for cov/corr matrices.
-
 * Refactored HMC and NUTS for better readability.
 
 * Add support for Python 3.6.

diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -78,7 +78,7 @@
 # The short X.Y version.
 version = '3.1'
 # The full version, including alpha/beta/rc tags.
-release = '3.1rc3'
+release = '3.1rc4'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

diff --git a/docs/source/notebooks/Diagnosing_biased_Inference_with_Divergences.ipynb b/docs/source/notebooks/Diagnosing_biased_Inference_with_Divergences.ipynb
diff --git a/docs/source/notebooks/GLM-hierarchical-advi-minibatch.ipynb b/docs/source/notebooks/GLM-hierarchical-advi-minibatch.ipynb
diff --git a/docs/source/notebooks/GP-introduction.ipynb b/docs/source/notebooks/GP-introduction.ipynb
diff --git a/docs/source/notebooks/GP-slice-sampling.ipynb b/docs/source/notebooks/GP-slice-sampling.ipynb
diff --git a/docs/source/notebooks/GP-smoothing.ipynb b/docs/source/notebooks/GP-smoothing.ipynb
diff --git a/docs/source/notebooks/LKJ.ipynb b/docs/source/notebooks/LKJ.ipynb
diff --git a/docs/source/notebooks/Model Comparison.ipynb b/docs/source/notebooks/Model Comparison.ipynb
diff --git a/docs/source/notebooks/PyMC3_tips_and_heuristic.ipynb b/docs/source/notebooks/PyMC3_tips_and_heuristic.ipynb
diff --git a/docs/source/notebooks/SMC2_gaussians.ipynb b/docs/source/notebooks/SMC2_gaussians.ipynb
diff --git a/docs/source/notebooks/bayesian_neural_network_advi.ipynb b/docs/source/notebooks/bayesian_neural_network_advi.ipynb
diff --git a/docs/source/notebooks/bayesian_neural_network_opvi-advi.ipynb b/docs/source/notebooks/bayesian_neural_network_opvi-advi.ipynb
diff --git a/docs/source/notebooks/cox_model.ipynb b/docs/source/notebooks/cox_model.ipynb
diff --git a/docs/source/notebooks/dependent_density_regression.ipynb b/docs/source/notebooks/dependent_density_regression.ipynb
diff --git a/docs/source/notebooks/dp_mix.ipynb b/docs/source/notebooks/dp_mix.ipynb
diff --git a/docs/source/notebooks/gaussian_process.ipynb b/docs/source/notebooks/gaussian_process.ipynb
diff --git a/docs/source/notebooks/getting_started.ipynb b/docs/source/notebooks/getting_started.ipynb
diff --git a/docs/source/notebooks/lda-advi-aevb.ipynb b/docs/source/notebooks/lda-advi-aevb.ipynb
diff --git a/docs/source/notebooks/multilevel_modeling.ipynb b/docs/source/notebooks/multilevel_modeling.ipynb
diff --git a/docs/source/notebooks/rugby_analytics.ipynb b/docs/source/notebooks/rugby_analytics.ipynb
diff --git a/docs/source/notebooks/stochastic_volatility.ipynb b/docs/source/notebooks/stochastic_volatility.ipynb
diff --git a/docs/source/notebooks/survival_analysis.ipynb b/docs/source/notebooks/survival_analysis.ipynb
diff --git a/docs/source/notebooks/updating_priors.ipynb b/docs/source/notebooks/updating_priors.ipynb
diff --git a/pymc3/__init__.py b/pymc3/__init__.py
@@ -1,5 +1,5 @@
 # pylint: disable=wildcard-import
-__version__ = "3.1rc3"
+__version__ = "3.1rc4"
 
 from .blocking import *
 from .distributions import *

diff --git a/pymc3/distributions/mixture.py b/pymc3/distributions/mixture.py
@@ -125,7 +125,7 @@ def random_choice(*args, **kwargs):
             else:
                 return np.random.choice(k, p=w, *args, **kwargs)
 
-        w = draw_values([self.w], point=point)
+        w = draw_values([self.w], point=point)[0]
 
         w_samples = generate_samples(random_choice,
                                      w=w,

diff --git a/setup.py b/setup.py
@@ -13,7 +13,7 @@
 AUTHOR_EMAIL = '[email protected]'
 URL = "http://github.com/pymc-devs/pymc3"
 LICENSE = "Apache License, Version 2.0"
-VERSION = "3.1rc3"
+VERSION = "3.1rc4"
 
 classifiers = ['Development Status :: 5 - Production/Stable',
                'Programming Language :: Python',