make_normal_distribution
fireopal.make_normal_distribution(uncertainty, mu=None, sigma=None, bounds=None, upto_diag=False)Create parameters for a normal (Gaussian) distribution.
Parameters
- uncertainty (int or list [ int ]) – The number of discrete points per dimension. Each value must be an integer greater than or equal to 2. Use a list for multivariate distributions.
- mu (float or list [ float ] or None , optional) – Mean value(s). Default is None (interpreted as 0 per dimension).
- sigma (float or list [ list [ float ] ] or None , optional) – Variance (not standard deviation). For multivariate distributions this is a covariance matrix. Default is None (interpreted as 1 per dimension).
- bounds (tuple [ float , float ] or list [ tuple [ float , float ] ] or None , optional) – Truncation bounds. Default is None (interpreted as (-1, 1) per dimension).
- upto_diag (bool , optional) – Whether to use an optimized circuit that loads the probability distribution up to a diagonal phase matrix. Setting this to True reduces overall circuit depth, which can improve execution fidelity on noisy hardware. Only use this if your subsequent objective function operations are unaffected by these relative phases. Default is False.
Returns
dict[str, Any] – A dictionary containing the parameters of the normal distribution,
suitable for use with make_monte_carlo_problem().