.. Copyright 2021 IRT Saint-Exupéry, https://www.irt-saintexupery.com This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. .. _gen_distribution_algos: Probability distributions ========================= .. warning:: Some capabilities may require the :ref:`installation ` of |g| with :ref:`all its features ` and some others may depend on :ref:`plugins `. .. note:: All the features of the wrapped libraries may not be exposed through |g|. .. raw:: html .. _OTDiracDistribution_options: OTDiracDistribution ------------------- Module: :class:`gemseo.uncertainty.distributions.openturns.dirac` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **lower_bound** : *float | None, optional* A lower bound to truncate the probability distribution. If ``None``, no lower truncation. By default it is set to None. .. raw:: html
  • **threshold** : *float, optional* A threshold in [0,1]. By default it is set to 0.5. .. raw:: html
  • **transformation** : *str | None, optional* A transformation applied to the random variable, e.g. :math:`\sin(x)`. If ``None``, no transformation. By default it is set to None. .. raw:: html
  • **upper_bound** : *float | None, optional* An upper bound to truncate the probability distribution. If ``None``, no upper truncation. By default it is set to None. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
  • **variable_value** : *float, optional* The value of the random variable. By default it is set to 0.0. .. raw:: html
.. _OTDistribution_options: OTDistribution -------------- Module: :class:`gemseo.uncertainty.distributions.openturns.distribution` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **interfaced_distribution** : *str, optional* The name of the probability distribution, typically the name of a class wrapped from an external library, such as ``"Normal"`` for OpenTURNS or ``"norm"`` for SciPy. By default it is set to Uniform. .. raw:: html
  • **lower_bound** : *float | None, optional* A lower bound to truncate the probability distribution. If ``None``, no lower truncation. By default it is set to None. .. raw:: html
  • **parameters** : *tuple[Any], optional* The parameters of the probability distribution. By default it is set to (). .. raw:: html
  • **standard_parameters** : *StandardParametersType | None, optional* The parameters of the probability distribution used for string representation only (use ``parameters`` for computation). If ``None``, use ``parameters`` instead. For instance, let us consider the interfaced OpenTURNS distribution ``"Dirac"``. Then, the string representation of ``OTDistribution("x", "Dirac", (1,), 1, {"loc": 1})`` is ``"Dirac(loc=1)"`` while the string representation of ``OTDistribution("x", "Dirac", (1,))`` is ``"Dirac(1)"``. By default it is set to None. .. raw:: html
  • **threshold** : *float, optional* A threshold in [0,1]. By default it is set to 0.5. .. raw:: html
  • **transformation** : *str | None, optional* A transformation applied to the random variable, e.g. :math:`\sin(x)`. If ``None``, no transformation. By default it is set to None. .. raw:: html
  • **upper_bound** : *float | None, optional* An upper bound to truncate the probability distribution. If ``None``, no upper truncation. By default it is set to None. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _OTExponentialDistribution_options: OTExponentialDistribution ------------------------- Module: :class:`gemseo.uncertainty.distributions.openturns.exponential` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **loc** : *float, optional* The location of the exponential random variable. By default it is set to 0.0. .. raw:: html
  • **lower_bound** : *float | None, optional* A lower bound to truncate the probability distribution. If ``None``, no lower truncation. By default it is set to None. .. raw:: html
  • **rate** : *float, optional* The rate of the exponential random variable. By default it is set to 1.0. .. raw:: html
  • **threshold** : *float, optional* A threshold in [0,1]. By default it is set to 0.5. .. raw:: html
  • **transformation** : *str | None, optional* A transformation applied to the random variable, e.g. :math:`\sin(x)`. If ``None``, no transformation. By default it is set to None. .. raw:: html
  • **upper_bound** : *float | None, optional* An upper bound to truncate the probability distribution. If ``None``, no upper truncation. By default it is set to None. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _OTJointDistribution_options: OTJointDistribution ------------------- Module: :class:`gemseo.uncertainty.distributions.openturns.joint` .. raw:: html
Required parameters
  • **distributions** : *Sequence[OTDistribution]* The marginal distributions. .. raw:: html
  • **variable** : *str* The name of the variable, if any; otherwise, concatenate the names of the random variables defined by ``distributions``. .. raw:: html
Optional parameters
  • **copula** : *ots.Distribution | None, optional* A copula distribution defining the dependency structure between random variables; if ``None``, consider an independent copula. By default it is set to None. .. raw:: html
.. _OTNormalDistribution_options: OTNormalDistribution -------------------- Module: :class:`gemseo.uncertainty.distributions.openturns.normal` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **lower_bound** : *float | None, optional* A lower bound to truncate the probability distribution. If ``None``, no lower truncation. By default it is set to None. .. raw:: html
  • **mu** : *float, optional* The mean of the normal random variable. By default it is set to 0.0. .. raw:: html
  • **sigma** : *float, optional* The standard deviation of the normal random variable. By default it is set to 1.0. .. raw:: html
  • **threshold** : *float, optional* A threshold in [0,1]. By default it is set to 0.5. .. raw:: html
  • **transformation** : *str | None, optional* A transformation applied to the random variable, e.g. :math:`\sin(x)`. If ``None``, no transformation. By default it is set to None. .. raw:: html
  • **upper_bound** : *float | None, optional* An upper bound to truncate the probability distribution. If ``None``, no upper truncation. By default it is set to None. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _OTTriangularDistribution_options: OTTriangularDistribution ------------------------ Module: :class:`gemseo.uncertainty.distributions.openturns.triangular` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **lower_bound** : *float | None, optional* A lower bound to truncate the probability distribution. If ``None``, no lower truncation. By default it is set to None. .. raw:: html
  • **maximum** : *float, optional* The maximum of the random variable. By default it is set to 1.0. .. raw:: html
  • **minimum** : *float, optional* The minimum of the triangular random variable. By default it is set to 0.0. .. raw:: html
  • **mode** : *float, optional* The mode of the triangular random variable. By default it is set to 0.5. .. raw:: html
  • **threshold** : *float, optional* A threshold in [0,1]. By default it is set to 0.5. .. raw:: html
  • **transformation** : *str | None, optional* A transformation applied to the random variable, e.g. :math:`\sin(x)`. If ``None``, no transformation. By default it is set to None. .. raw:: html
  • **upper_bound** : *float | None, optional* An upper bound to truncate the probability distribution. If ``None``, no upper truncation. By default it is set to None. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _OTUniformDistribution_options: OTUniformDistribution --------------------- Module: :class:`gemseo.uncertainty.distributions.openturns.uniform` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **lower_bound** : *float | None, optional* A lower bound to truncate the probability distribution. If ``None``, no lower truncation. By default it is set to None. .. raw:: html
  • **maximum** : *float, optional* The maximum of the uniform random variable. By default it is set to 1.0. .. raw:: html
  • **minimum** : *float, optional* The minimum of the uniform random variable. By default it is set to 0.0. .. raw:: html
  • **threshold** : *float, optional* A threshold in [0,1]. By default it is set to 0.5. .. raw:: html
  • **transformation** : *str | None, optional* A transformation applied to the random variable, e.g. :math:`\sin(x)`. If ``None``, no transformation. By default it is set to None. .. raw:: html
  • **upper_bound** : *float | None, optional* An upper bound to truncate the probability distribution. If ``None``, no upper truncation. By default it is set to None. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _OTWeibullDistribution_options: OTWeibullDistribution --------------------- Module: :class:`gemseo.uncertainty.distributions.openturns.weibull` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **location** : *float, optional* The location parameter :math:`\gamma` of the Weibull distribution. By default it is set to 0.0. .. raw:: html
  • **lower_bound** : *float | None, optional* A lower bound to truncate the probability distribution. If ``None``, no lower truncation. By default it is set to None. .. raw:: html
  • **scale** : *float, optional* The scale parameter of the Weibull distribution. By default it is set to 1.0. .. raw:: html
  • **shape** : *float, optional* The shape parameter of the Weibull distribution. By default it is set to 1.0. .. raw:: html
  • **threshold** : *float, optional* A threshold in [0,1]. By default it is set to 0.5. .. raw:: html
  • **transformation** : *str | None, optional* A transformation applied to the random variable, e.g. :math:`\sin(x)`. If ``None``, no transformation. By default it is set to None. .. raw:: html
  • **upper_bound** : *float | None, optional* An upper bound to truncate the probability distribution. If ``None``, no upper truncation. By default it is set to None. .. raw:: html
  • **use_weibull_min** : *bool, optional* Whether to use the Weibull minimum extreme value distribution (the support of the random variable is :math:`[\gamma,+\infty[`) or the Weibull maximum extreme value distribution (the support of the random variable is :math:`]-\infty[,\gamma]`). By default it is set to True. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _SPDistribution_options: SPDistribution -------------- Module: :class:`gemseo.uncertainty.distributions.scipy.distribution` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **interfaced_distribution** : *str, optional* The name of the probability distribution, typically the name of a class wrapped from an external library, such as ``"Normal"`` for OpenTURNS or ``"norm"`` for SciPy. By default it is set to uniform. .. raw:: html
  • **parameters** : *Mapping[str, Any], optional* The parameters of the probability distribution. By default it is set to {}. .. raw:: html
  • **standard_parameters** : *StandardParametersType | None, optional* The parameters of the probability distribution used for string representation only (use ``parameters`` for computation). If ``None``, use ``parameters`` instead. For instance, let us consider the interfaced SciPy distribution ``"uniform"``. Then, the string representation of ``SPDistribution("x", "uniform", parameters, 1, {"min": 1, "max": 3})`` with ``parameters={"loc": 1, "scale": 2}`` is ``"uniform(max=3, min=1)"`` while the string representation of ``SPDistribution("x", "uniform", parameters)`` is ``"uniform(loc=1, scale=2)"``. By default it is set to None. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _SPExponentialDistribution_options: SPExponentialDistribution ------------------------- Module: :class:`gemseo.uncertainty.distributions.scipy.exponential` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **loc** : *float, optional* The location of the exponential random variable. By default it is set to 0.0. .. raw:: html
  • **rate** : *float, optional* The rate of the exponential random variable. By default it is set to 1.0. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _SPJointDistribution_options: SPJointDistribution ------------------- Module: :class:`gemseo.uncertainty.distributions.scipy.joint` .. raw:: html
Required parameters
  • **distributions** : *Sequence[SPDistribution]* The marginal distributions. .. raw:: html
  • **variable** : *str* The name of the variable, if any; otherwise, concatenate the names of the random variables defined by ``distributions``. .. raw:: html
Optional parameters
  • **copula** : *None, optional* A copula distribution defining the dependency structure between random variables; if ``None``, consider an independent copula. By default it is set to None. .. raw:: html
.. _SPNormalDistribution_options: SPNormalDistribution -------------------- Module: :class:`gemseo.uncertainty.distributions.scipy.normal` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **mu** : *float, optional* The mean of the normal random variable. By default it is set to 0.0. .. raw:: html
  • **sigma** : *float, optional* The standard deviation of the normal random variable. By default it is set to 1.0. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _SPTriangularDistribution_options: SPTriangularDistribution ------------------------ Module: :class:`gemseo.uncertainty.distributions.scipy.triangular` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **maximum** : *float, optional* The maximum of the triangular random variable. By default it is set to 1.0. .. raw:: html
  • **minimum** : *float, optional* The minimum of the triangular random variable. By default it is set to 0.0. .. raw:: html
  • **mode** : *float, optional* The mode of the triangular random variable. By default it is set to 0.5. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _SPUniformDistribution_options: SPUniformDistribution --------------------- Module: :class:`gemseo.uncertainty.distributions.scipy.uniform` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **maximum** : *float, optional* The maximum of the uniform random variable. By default it is set to 1.0. .. raw:: html
  • **minimum** : *float, optional* The minimum of the uniform random variable. By default it is set to 0.0. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html
.. _SPWeibullDistribution_options: SPWeibullDistribution --------------------- Module: :class:`gemseo.uncertainty.distributions.scipy.weibull` .. raw:: html
Optional parameters
  • **dimension** : *int, optional* The dimension of the random variable. If greater than 1, the probability distribution is applied to all components of the random variable under the hypothesis that these components are stochastically independent. To be removed in a future version; use a :class:`.BaseJointDistribution` instead. By default it is set to 1. .. raw:: html
  • **location** : *float, optional* The location parameter of the Weibull distribution. By default it is set to 0.0. .. raw:: html
  • **scale** : *float, optional* The scale parameter of the Weibull distribution. By default it is set to 1.0. .. raw:: html
  • **shape** : *float, optional* The shape parameter of the Weibull distribution. By default it is set to 1.0. .. raw:: html
  • **use_weibull_min** : *bool, optional* Whether to use the Weibull minimum extreme value distribution (the support of the random variable is :math:`[\gamma,+\infty[`) or the Weibull maximum extreme value distribution (the support of the random variable is :math:`]-\infty[,\gamma]`). By default it is set to True. .. raw:: html
  • **variable** : *str, optional* The name of the random variable. By default it is set to x. .. raw:: html