+ nDj,^RIt^RIt^RIHtHtHtHtHt^RI H uH t ^RI Ht]!RR7]!R^RR7R R R /R ll44tR#) N)array_namespacexp_capabilities xp_device_count_nonmasked xp_promote)_axis_nan_policy_factoryT)marraycV#N)xs&P/data/cameron/venvs/s3viz/lib/python3.14/site-packages/scipy/stats/_variation.pyrsacV3#r r )r _s&&rrrsA4r) n_outputsresult_to_tuplekeepdimsFc \V4p\VRVR7pVfVPVR 4p^pVP\ WR7VP \ V4R7p\P!RRR7;_uu_4\P!4;_uu_4\P!R4VPWR7pVPWR7pWfV, , R,p W,V, p RRR4RRR4R p \P!W68HXX3V X R 7p V P ^8Xd V R ,#T # +'giLU;i +'giL`;i) ak Compute the coefficient of variation. The coefficient of variation is the standard deviation divided by the mean. This function is equivalent to:: np.std(x, axis=axis, ddof=ddof) / np.mean(x) The default for ``ddof`` is 0, but many definitions of the coefficient of variation use the square root of the unbiased sample variance for the sample standard deviation, which corresponds to ``ddof=1``. The function does not take the absolute value of the mean of the data, so the return value is negative if the mean is negative. Parameters ---------- a : array_like Input array. axis : int or None, optional Axis along which to calculate the coefficient of variation. Default is 0. If None, compute over the whole array `a`. nan_policy : {'propagate', 'raise', 'omit'}, optional Defines how to handle when input contains ``nan``. The following options are available: * 'propagate': return ``nan`` * 'raise': raise an exception * 'omit': perform the calculation with ``nan`` values omitted The default is 'propagate'. ddof : int, optional Gives the "Delta Degrees Of Freedom" used when computing the standard deviation. The divisor used in the calculation of the standard deviation is ``N - ddof``, where ``N`` is the number of elements. `ddof` must be less than ``N``; if it isn't, the result will be ``nan`` or ``inf``, depending on ``N`` and the values in the array. By default `ddof` is zero for backwards compatibility, but it is recommended to use ``ddof=1`` to ensure that the sample standard deviation is computed as the square root of the unbiased sample variance. Returns ------- variation : ndarray The calculated variation along the requested axis. Notes ----- There are several edge cases that are handled without generating a warning: * If both the mean and the standard deviation are zero, ``nan`` is returned. * If the mean is zero and the standard deviation is nonzero, ``inf`` is returned. * If the input has length zero (either because the array has zero length, or all the input values are ``nan`` and ``nan_policy`` is ``'omit'``), ``nan`` is returned. * If the input contains ``inf``, ``nan`` is returned. References ---------- .. [1] Zwillinger, D. and Kokoska, S. (2000). CRC Standard Probability and Statistics Tables and Formulae. Chapman & Hall: New York. 2000. Examples -------- >>> import numpy as np >>> from scipy.stats import variation >>> variation([1, 2, 3, 4, 5], ddof=1) 0.5270462766947299 Compute the variation along a given dimension of an array that contains a few ``nan`` values: >>> x = np.array([[ 10.0, np.nan, 11.0, 19.0, 23.0, 29.0, 98.0], ... [ 29.0, 30.0, 32.0, 33.0, 35.0, 56.0, 57.0], ... [np.nan, np.nan, 12.0, 13.0, 16.0, 16.0, 17.0]]) >>> variation(x, axis=1, ddof=1, nan_policy='omit') array([1.05109361, 0.31428986, 0.146483 ]) T)force_floatingxpN)axisdtypedeviceignore)divideinvalidg?c\W4pVPVPVP\ V4R7pVP V^8VP W14VP4#)r)rasarrayinfrrwherecopysignnan)std_amean_amxp_xp_infs&& r special_casevariation..special_casezsSe,++cggV\\)FBS+TyyCLL$A377KKr) fill_value)r )rrreshaper!rrrnperrstatewarningscatch_warnings simplefiltermeanstdxpx apply_wherendim) ar nan_policyddofrrnr'r& correctionresultr*s &&&&$ r variationr?s!r  B1Tb1A | JJq%  #A1ST VA ++Xx 8 8(:Q:Q:S:Sh'&q$t8ns* #f, ;T 8L__di5&/)f>F )6":5v5%;T:S 8 8s%E!!A E E! E E!! E1 )r propagater)r1numpyr/scipy._lib._array_apirrrrrscipy._external.array_api_extra _externalarray_api_extrar6_axis_nan_policyrr?r rrrGsX.-61.?q6Uq6q6r