W3cubDocs

/TensorFlow Python

tf.contrib.bayesflow.monte_carlo.expectation_importance_sampler

tf.contrib.bayesflow.monte_carlo.expectation_importance_sampler(
    f,
    log_p,
    sampling_dist_q,
    z=None,
    n=None,
    seed=None,
    name='expectation_importance_sampler'
)

Defined in tensorflow/contrib/bayesflow/python/ops/monte_carlo_impl.py.

See the guide: BayesFlow Monte Carlo (contrib) > Ops

Monte Carlo estimate of \\(E_p[f(Z)] = E_q[f(Z) p(Z) / q(Z)]\\).

With \\(p(z) := exp^{log_p(z)}\\), this Op returns

\\(n^{-1} sum_{i=1}^n [ f(z_i) p(z_i) / q(z_i) ],  z_i ~ q,\\)
\\(\approx E_q[ f(Z) p(Z) / q(Z) ]\\)
\\(=       E_p[f(Z)]\\)

This integral is done in log-space with max-subtraction to better handle the often extreme values that f(z) p(z) / q(z) can take on.

If f >= 0, it is up to 2x more efficient to exponentiate the result of expectation_importance_sampler_logspace applied to Log[f].

User supplies either Tensor of samples z, or number of samples to draw n

Args:

  • f: Callable mapping samples from sampling_dist_q to Tensors with shape broadcastable to q.batch_shape. For example, f works "just like" q.log_prob.
  • log_p: Callable mapping samples from sampling_dist_q to Tensors with shape broadcastable to q.batch_shape. For example, log_p works "just like" sampling_dist_q.log_prob.
  • sampling_dist_q: The sampling distribution. tf.contrib.distributions.Distribution. float64 dtype recommended. log_p and q should be supported on the same set.
  • z: Tensor of samples from q, produced by q.sample for some n.
  • n: Integer Tensor. Number of samples to generate if z is not provided.
  • seed: Python integer to seed the random number generator.
  • name: A name to give this Op.

Returns:

The importance sampling estimate. Tensor with shape equal to batch shape of q, and dtype = q.dtype.

© 2018 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/contrib/bayesflow/monte_carlo/expectation_importance_sampler