mxfusion.components.distributions.laplace

Members

class mxfusion.components.distributions.laplace.Laplace(location, scale, rand_gen=None, dtype=None, ctx=None)

Bases: mxfusion.components.distributions.univariate.UnivariateDistribution

The one-dimensional Laplace distribution. The Laplace distribution can be defined over a scalar random variable or an array of random variables. In case of an array of random variables, the location and scale are broadcasted to the shape of the output random variable (array).

Parameters:
  • location (Variable) – Location of the Laplace distribution.
  • scale (Variable) – Scale of the Laplace distribution.
  • rand_gen (RandomGenerator) – the random generator (default: MXNetRandomGenerator).
  • dtype (numpy.float32 or numpy.float64) – the data type for float point numbers.
  • ctx (None or mxnet.cpu or mxnet.gpu) – the mxnet context (default: None/current context).
log_pdf(F, variables, targets=None)

Computes the logarithm of the probability density/mass function (PDF/PMF) of the distribution. The inputs and outputs variables are fetched from the variables argument according to their UUIDs.

Parameters:
  • F (mxnet.symbol or mxnet.ndarray) – the MXNet computation mode
  • variables – the set of MXNet arrays that holds the values of

variables at runtime. :type variables: {str(UUID): MXNet NDArray or MXNet Symbol} :returns: log pdf of the distribution :rtypes: MXNet NDArray or MXNet Symbol

draw_samples(F, variables, num_samples=1, always_return_tuple=False, targets=None)

Draw a set of samples from the distribution. The inputs variables are fetched from the variables argument according to their UUIDs.

Parameters:
  • F (mxnet.symbol or mxnet.ndarray) – the MXNet computation mode
  • variables – the set of MXNet arrays that holds the values of

variables at runtime. :type variables: {str(UUID): MXNet NDArray or MXNet Symbol} :param num_samples: the number of drawn samples (default: one) :int num_samples: int :param always_return_tuple: Whether return a tuple even if there is only one variables in outputs. :type always_return_tuple: boolean :returns: a set samples of the distribution :rtypes: MXNet NDArray or MXNet Symbol or [MXNet NDArray or MXNet Symbol]

static define_variable(location=0.0, scale=1.0, shape=None, rand_gen=None, dtype=None, ctx=None)

Creates and returns a random variable drawn from a Laplace distribution.

Parameters:
  • location – Location of the distribution.
  • scale – Scale of the distribution.
  • shape (tuple or [tuple]) – the shape of the random variable(s).
  • rand_gen (RandomGenerator) – the random generator (default: MXNetRandomGenerator).
  • dtype (numpy.float32 or numpy.float64) – the data type for float point numbers.
  • ctx (None or mxnet.cpu or mxnet.gpu) – the mxnet context (default: None/current context).
Returns:

the random variables drawn from the Laplace distribution.
Rtypes:

Variable