Ë
    7^(h'!  ã                   óÔ  — d Z g d¢ZddlmZmZmZmZmZmZm	Z	m
Z
mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z! ddl"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z. ddl/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[m\Z\m]Z]m^Z^m_Z_m`Z`maZambZbmcZcmdZdmeZemfZf ddlgmhZhmiZimjZjmkZkmlZlmmZmmnZnmoZompZpmqZqmrZr ddlsmtZtmuZumvZvmwZwmxZxmyZymzZzm{Z{m|Z|m}Z}m~Z~mZm€Z€ ddl�m‚Z‚mƒZƒm„Z„m…Z…m†Z†m‡Z‡mˆZˆm‰Z‰mŠZŠm‹Z‹mŒZŒ dd	l�mŽZŽm�Z�m�Z�m‘Z‘m’Z’m“Z“m”Z”m•Z•m–Z–m—Z—m˜Z˜ dd
l™mšZšm›Z›mœZœm�Z� ddlžmŸZŸm Z m¡Z¡m¢Z¢m£Z£m¤Z¤ ddl¥m¦Z¦m§Z§m¨Z¨ y)aÕ  
SymPy statistics module

Introduces a random variable type into the SymPy language.

Random variables may be declared using prebuilt functions such as
Normal, Exponential, Coin, Die, etc...  or built with functions like FiniteRV.

Queries on random expressions can be made using the functions

========================= =============================
    Expression                    Meaning
------------------------- -----------------------------
 ``P(condition)``          Probability
 ``E(expression)``         Expected value
 ``H(expression)``         Entropy
 ``variance(expression)``  Variance
 ``density(expression)``   Probability Density Function
 ``sample(expression)``    Produce a realization
 ``where(condition)``      Where the condition is true
========================= =============================

Examples
========

>>> from sympy.stats import P, E, variance, Die, Normal
>>> from sympy import simplify
>>> X, Y = Die('X', 6), Die('Y', 6) # Define two six sided dice
>>> Z = Normal('Z', 0, 1) # Declare a Normal random variable with mean 0, std 1
>>> P(X>3) # Probability X is greater than 3
1/2
>>> E(X+Y) # Expectation of the sum of two dice
7
>>> variance(X+Y) # Variance of the sum of two dice
35/6
>>> simplify(P(Z>1)) # Probability of Z being greater than 1
1/2 - erf(sqrt(2)/2)/2


One could also create custom distribution and define custom random variables
as follows:

1. If you want to create a Continuous Random Variable:

>>> from sympy.stats import ContinuousRV, P, E
>>> from sympy import exp, Symbol, Interval, oo
>>> x = Symbol('x')
>>> pdf = exp(-x) # pdf of the Continuous Distribution
>>> Z = ContinuousRV(x, pdf, set=Interval(0, oo))
>>> E(Z)
1
>>> P(Z > 5)
exp(-5)

1.1 To create an instance of Continuous Distribution:

>>> from sympy.stats import ContinuousDistributionHandmade
>>> from sympy import Lambda
>>> dist = ContinuousDistributionHandmade(Lambda(x, pdf), set=Interval(0, oo))
>>> dist.pdf(x)
exp(-x)

2. If you want to create a Discrete Random Variable:

>>> from sympy.stats import DiscreteRV, P, E
>>> from sympy import Symbol, S
>>> p = S(1)/2
>>> x = Symbol('x', integer=True, positive=True)
>>> pdf = p*(1 - p)**(x - 1)
>>> D = DiscreteRV(x, pdf, set=S.Naturals)
>>> E(D)
2
>>> P(D > 3)
1/8

2.1 To create an instance of Discrete Distribution:

>>> from sympy.stats import DiscreteDistributionHandmade
>>> from sympy import Lambda
>>> dist = DiscreteDistributionHandmade(Lambda(x, pdf), set=S.Naturals)
>>> dist.pdf(x)
2**(1 - x)/2

3. If you want to create a Finite Random Variable:

>>> from sympy.stats import FiniteRV, P, E
>>> from sympy import Rational, Eq
>>> pmf = {1: Rational(1, 3), 2: Rational(1, 6), 3: Rational(1, 4), 4: Rational(1, 4)}
>>> X = FiniteRV('X', pmf)
>>> E(X)
29/12
>>> P(X > 3)
1/4

3.1 To create an instance of Finite Distribution:

>>> from sympy.stats import FiniteDistributionHandmade
>>> dist = FiniteDistributionHandmade(pmf)
>>> dist.pmf(x)
Lambda(x, Piecewise((1/3, Eq(x, 1)), (1/6, Eq(x, 2)), (1/4, Eq(x, 3) | Eq(x, 4)), (0, True)))
)�ÚPÚEÚHÚdensityÚwhereÚgivenÚsampleÚcdfÚmedianÚcharacteristic_functionÚpspaceÚsample_iterÚvarianceÚstdÚskewnessÚkurtosisÚ
covarianceÚ	dependentÚentropyÚindependentÚrandom_symbolsÚcorrelationÚfactorial_momentÚmomentÚcmomentÚsampling_densityÚmoment_generating_functionÚsmomentÚquantileÚ
coskewnessÚsample_stochastic_processÚFiniteRVÚDiscreteUniformÚDieÚ	BernoulliÚCoinÚBinomialÚBetaBinomialÚHypergeometricÚ
RademacherÚIdealSolitonÚRobustSolitonÚFiniteDistributionHandmadeÚContinuousRVÚArcsinÚBeniniÚBetaÚBetaNoncentralÚ	BetaPrimeÚBoundedParetoÚCauchyÚChiÚChiNoncentralÚ
ChiSquaredÚDagumÚDavisÚErlangÚ
ExGaussianÚExponentialÚExponentialPowerÚFDistributionÚFisherZÚFrechetÚGammaÚGammaInverseÚGompertzÚGumbelÚKumaraswamyÚLaplaceÚLevyÚLogisticÚ	LogCauchyÚLogLogisticÚLogitNormalÚ	LogNormalÚLomaxÚMoyalÚMaxwellÚNakagamiÚNormalÚGaussianInverseÚParetoÚPowerFunctionÚ
QuadraticUÚRaisedCosineÚRayleighÚ
ReciprocalÚStudentTÚShiftedGompertzÚTrapezoidalÚ
TriangularÚUniformÚ
UniformSumÚVonMisesÚWaldÚWeibullÚWignerSemicircleÚContinuousDistributionHandmadeÚFlorySchulzÚ	GeometricÚHermiteÚLogarithmicÚNegativeBinomialÚPoissonÚSkellamÚ	YuleSimonÚZetaÚ
DiscreteRVÚDiscreteDistributionHandmadeÚJointRVÚ	DirichletÚGeneralizedMultivariateLogGammaÚ$GeneralizedMultivariateLogGammaOmegaÚMultinomialÚMultivariateBetaÚMultivariateEwensÚMultivariateTÚNegativeMultinomialÚNormalGammaÚMultivariateNormalÚMultivariateLaplaceÚmarginal_distributionÚStochasticProcessÚDiscreteTimeStochasticProcessÚDiscreteMarkovChainÚTransitionMatrixOfÚStochasticStateSpaceOfÚGeneratorMatrixOfÚContinuousMarkovChainÚBernoulliProcessÚPoissonProcessÚWienerProcessÚGammaProcessÚCircularEnsembleÚCircularUnitaryEnsembleÚCircularOrthogonalEnsembleÚCircularSymplecticEnsembleÚGaussianEnsembleÚGaussianUnitaryEnsembleÚGaussianOrthogonalEnsembleÚGaussianSymplecticEnsembleÚjoint_eigen_distributionÚJointEigenDistributionÚlevel_spacing_distributionÚMatrixGammaÚWishartÚMatrixNormalÚMatrixStudentTÚProbabilityÚExpectationÚVarianceÚ
CovarianceÚMomentÚCentralMomentÚExpectationMatrixÚVarianceMatrixÚCrossCovarianceMatrixé   )r   r   r   r   r   r   r   r	   r
   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r    )r!   r"   r#   r$   r%   r&   r'   r(   r)   r,   r*   r+   )7r-   r.   r/   r0   r1   r2   r3   r4   r5   r6   r7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rA   rB   rR   rC   rD   rE   rF   rG   rH   rI   rJ   rK   rL   rM   rO   rN   rP   rQ   rS   rU   rV   rW   rX   rY   rT   rZ   r[   r\   r]   r^   r_   r`   ra   rb   rc   )rd   re   rf   rg   rh   ri   rj   rk   rl   rm   rn   )ro   rp   rq   rr   rs   rt   ru   rv   rw   rx   ry   rz   r{   )r|   r}   r~   r   r€   r�   r‚   rƒ   r„   r…   r†   )r‡   rˆ   r‰   rŠ   r‹   rŒ   r�   rŽ   r�   r�   r‘   )r’   r“   r”   r•   )r–   r—   r˜   r™   rš   r›   )rœ   r�   rž   N)©Ú__doc__Ú__all__Úrv_interfacer   r   r   r   r   r   r   r	   r
   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r    Ú	frv_typesr!   r"   r#   r$   r%   r&   r'   r(   r)   r,   r*   r+   Ú	crv_typesr-   r.   r/   r0   r1   r2   r3   r4   r5   r6   r7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rA   rB   rR   rC   rD   rE   rF   rG   rH   rI   rJ   rK   rL   rM   rO   rN   rP   rQ   rS   rU   rV   rW   rX   rY   rT   rZ   r[   r\   r]   r^   r_   r`   ra   rb   rc   Ú	drv_typesrd   re   rf   rg   rh   ri   rj   rk   rl   rm   rn   Újoint_rv_typesro   rp   rq   rr   rs   rt   ru   rv   rw   rx   ry   rz   r{   Ústochastic_process_typesr|   r}   r~   r   r€   r�   r‚   rƒ   r„   r…   r†   Úrandom_matrix_modelsr‡   rˆ   r‰   rŠ   r‹   rŒ   r�   rŽ   r�   r�   r‘   Úmatrix_distributionsr’   r“   r”   r•   Úsymbolic_probabilityr–   r—   r˜   r™   rš   r›   Ú!symbolic_multivariate_probabilityrœ   r�   rž   © ó    úR/var/www/skyplay_api_hub/venv/lib/python3.12/site-packages/sympy/stats/__init__.pyú<module>r¯      s  ðñdòL1€÷d#÷ #÷ #÷ #÷ #÷ #÷ #÷ #ñ #÷A÷ A÷ Aó A÷	(÷ 	(÷ 	(÷ 	(÷ 	(÷ 	(÷ 	(÷ 	(÷ 	(÷ 	(÷ 	(÷ 	(÷ 	(÷ 	(ñ 	(÷L÷ L÷ Lñ L÷÷ ÷ õ ÷÷ ÷ ñ ÷<÷ <÷ <ñ <÷ UÓ T÷+÷ +÷ò r­   