>hSrSSKrSSKJr SSKJrJrJr SSK J r SSK r SSK J r Sr"SS 5r"S S \5r"S S \5rg)a Empirical likelihood inference on descriptive statistics This module conducts hypothesis tests and constructs confidence intervals for the mean, variance, skewness, kurtosis and correlation. If matplotlib is installed, this module can also generate multivariate confidence region plots as well as mean-variance contour plots. See _OptFuncts docstring for technical details and optimization variable definitions. General References: ------------------ Owen, A. (2001). "Empirical Likelihood." Chapman and Hall N)optimize)chi2skewkurtosis) _fit_newton)utilscURS:XaUR[U5S5nURSS:Xa [ U5$URSS:a [ U5$g)at Returns an instance to conduct inference on descriptive statistics via empirical likelihood. See DescStatUV and DescStatMV for more information. Parameters ---------- endog : ndarray Array of data Returns : DescStat instance If k=1, the function returns a univariate instance, DescStatUV. If k>1, the function returns a multivariate instance, DescStatMV. N)ndimreshapelenshape DescStatUV DescStatMV)endogs rC:\Users\julio\OneDrive\Documentos\Trabajo\Ideas Frescas\venv\Lib\site-packages\statsmodels/emplike/descriptive.pyDescStatrs^ zzQ c%j!, {{1~%   {{1~%  c\rSrSrSrSrSrSrSrSr Sr S r S r SS jr S rS rSrSrSrSrSrSrSrg) _OptFuncts1a A class that holds functions that are optimized/solved. The general setup of the class is simple. Any method that starts with _opt_ creates a vector of estimating equations named est_vect such that np.dot(p, (est_vect))=0 where p is the weight on each observation as a 1 x n array and est_vect is n x k. Then _modif_Newton is called to determine the optimal p by solving for the Lagrange multiplier (eta) in the profile likelihood maximization problem. In the presence of nuisance parameters, _opt_ functions are optimized over to profile out the nuisance parameters. Any method starting with _ci_limits calculates the log likelihood ratio for a specific value of a parameter and then subtracts a pre-specified critical value. This is solved so that llr - crit = 0. cgNselfrs r__init___OptFuncts.__init__Cs rc:[R"U5[R"U5[R"X!5--nUSU- :nU)nXEU-n[R"SU- 5S- USUS- - --XV'[R"XW5XW'U$)a6 Transforms the log of observation probabilities in terms of the Lagrange multiplier to the log 'star' of the probabilities. Parameters ---------- eta : float Lagrange multiplier est_vect : ndarray (n,k) Estimating equations vector wts : nx1 array Observation weights Returns ------ data_star : ndarray The weighted logstar of the estimting equations Notes ----- This function is only a placeholder for the _fit_Newton. The function value is not used in optimization and the optimal value is disregarded when computing the log likelihood ratio. ??@)nplogsumdot) retaest_vectweightsnobs data_staridxnot_idxnxs r _log_star_OptFuncts._log_starFs6FF7Orvvg')vvh'<(=> "t)#$ cN "T *S02b1f3EE VVI$67 rc[R"U5[R"X!5-nUSU- :nU)nUS-*XV'XWS-*XW'X5-n[R"URUSS2S4U-5$)ag Calculates the hessian of a weighted empirical likelihood problem. Parameters ---------- eta : ndarray, (1,m) Lagrange multiplier in the profile likelihood maximization est_vect : ndarray (n,k) Estimating equations vector weights : 1darray Observation weights Returns ------- hess : m x m array Weighted hessian used in _wtd_modif_newton r r#N)r$r&r'T) rr(r)r*r+data_star_doub_primer-r.wtd_dsdps r_hess_OptFuncts._hessjs, "vvg1FF"R$Y.$&*aiK!+?+HR*O(O%1vvhjj(1d7"3h">??rc[R"U5[R"X!5-nUSU- :nU)nUSXEU-- -XV'SXW- XW'[R"X5-U5$)aj Calculates the gradient of a weighted empirical likelihood problem Parameters ---------- eta : ndarray, (1,m) Lagrange multiplier in the profile likelihood maximization est_vect : ndarray, (n,k) Estimating equations vector weights : 1darray Observation weights Returns ------- gradient : ndarray (m,1) The gradient used in _wtd_modif_newton r r#)r$r&r')rr(r)r*r+data_star_primer-r.s r_grad_OptFuncts._gradsr,&&/BFF8,AAT )$#q4#2F+F'FG#%(@#@ vvg/::rc ^^^^ [T5m UU UU4SjnUU UU4SjnUU UU4SjnSS0nUR5n[XEUSXvSSS 9nUS$) a Modified Newton's method for maximizing the log 'star' equation. This function calls _fit_newton to find the optimal values of eta. Parameters ---------- eta : ndarray, (1,m) Lagrange multiplier in the profile likelihood maximization est_vect : ndarray, (n,k) Estimating equations vector weights : 1darray Observation weights Returns ------- params : 1xm array Lagrange multiplier that maximizes the log-likelihood cV>[R"TRUTTT55*$r)r$r&r0x0r)r+rr*s r*_OptFuncts._modif_newton..s r8Wd KLLrc.>TRUTTT5*$r)r;r?s rrArBDJJr8WdCCrc.>TRUTTT5*$r)r7r?s rrArBrDrtol:0yE>r2r)hessmaxiterdisp)r squeezer) rr(r)r*fgradrIkwdsresr+s ` `` @r _modif_newton_OptFuncts._modif_newtonsQ*8} LCCt}kkm!3DR#$&1v rc[R"URUR- SXRUR- --- 5$)a% Finding the root of sum(xi-h0)/(1+eta(xi-mu)) solves for eta when computing ELR for univariate mean. Parameters ---------- eta : float Lagrange multiplier in the empirical likelihood maximization Returns ------- llr : float n times the log likelihood value for a given value of eta r )r$r&rmu0)rr(s r _find_eta_OptFuncts._find_etasAvvtzzDHH,C::01134 4rcDURU5SUR- $)a Calculates the difference between the log likelihood of mu_test and a specified critical value. Parameters ---------- mu : float Hypothesized value of the mean. Returns ------- diff : float The difference between the log likelihood value of mu0 and a specified value. r) test_meanr0)rmus r _ci_limits_mu_OptFuncts._ci_limits_mus! ~~b!!$tww..rc[R"URU- S-5nURU- S-U- nS[R"[R"URU-55-UR - $)a\ Finds gamma that satisfies sum(log(n * w(gamma))) - log(r0) = 0 Used for confidence intervals for the mean Parameters ---------- gamma : float Lagrange multiplier when computing confidence interval Returns ------- diff : float The difference between the log-liklihood when the Lagrange multiplier is gamma and a pre-specified value r3)r$r&rr%r+rY)rgammadenom new_weightss r _find_gamma_OptFuncts._find_gammasl$ U*r12zzE)b058 BFF266$))k"9:;; GG rc@URnURnX1- S-UR- nX1- n[R"Xe45nUR [R "SU- SU- /5U[R"U5SU- -5nS[R"XR5-n SU- S-U - Ul [R"[R"X@R-55n U(a[R"SU -S5$SU -$)aB This is the function to be optimized over a nuisance mean parameter to determine the likelihood ratio for the variance Parameters ---------- nuisance_mu : float Value of a nuisance mean parameter Returns ------- llr : float Log likelihood of a pre-specified variance holding the nuisance parameter constant r#r r r3)rr+sig2_0r$ column_stackrQarrayonesr'r4rar&r%rsf) r nuisance_mupvalrr+sig_datamu_datar)eta_starr`llrs r_opt_var_OptFuncts._opt_vars  yy(Q.kk"&??G#67%%bhhT /1Dy0:';E1ffRVVD#3#3345 7728Q' 'CxrcDURU5SUR- $)a| Used to determine the confidence intervals for the variance. It calls test_var and when called by an optimizer, finds the value of sig2_0 that is chi2.ppf(significance-level) Parameters ---------- var_test : float Hypothesized value of the variance Returns ------- diff : float The difference between the log likelihood ratio at var_test and a pre-specified value. r)test_varrY)rvars r_ci_limits_var_OptFuncts._ci_limits_var s!"}}S!!$tww..rcFURnURnX!S- nX!S- S-US- nX!S- S-USS-- UR- n[R"XEU45nUR [R "SU- SU- SU- /5U[R"U5SU- -5nS[R"XR5-n SU- S-U - Ul [R"[R"X0R-55n SU -$)aC Called by test_skew. This function is optimized over nuisance parameters mu and sigma Parameters ---------- nuis_params : 1darray An array with a nuisance mean and variance parameter Returns ------- llr : float The log likelihood ratio of a pre-specified skewness holding the nuisance parameters constant. rr#r r!r r3) rr+skew0r$rfrQrgrhr'r4rar&r%) r nuis_paramsrr+rmrl skew_datar)rnr`ros r _opt_skew_OptFuncts._opt_skew3s   yya.(^+1[^C1~-!3 ^s*,/3zz: ??Gy#AB%%bhhT /1Dy/1Dy0:';E1ffRVVD#3#3345CxrcLURnURnX!S- nX!S- S-US- nX!S- S-USS-- S- UR- n[R"XEU45nUR [R "SU- SU- SU- /5U[R"U5SU- -5nS[R"XR5-n SU- S-U - Ul [R"[R"X0R-55n SU -$)a@ Called by test_kurt. This function is optimized over nuisance parameters mu and sigma Parameters ---------- nuis_params : 1darray An array with a nuisance mean and variance parameter Returns ------- llr : float The log likelihood ratio of a pre-speified kurtosis holding the nuisance parameters constant rr#r rxr r3) rr+kurt0r$rfrQrgrhr'r4rar&r%) rrzrr+rmrl kurt_datar)rnr`ros r _opt_kurt_OptFuncts._opt_kurtSs(  yya.(^+1[^CA.14 ^q(*-./26**= ??Gy#AB%%bhhT /1Dy/1Dy0:';E1ffRVVD#3#3345Cxrc URnURnX!S- nX!S- S-US- nX!S- S-USS-- UR- nX!S- S-USS-- S- UR- n[R "XEXg45nUR [R"SU- SU- SU- SU- /5U[R"U5SU- -5n S[R"XR5-n SU- S-U - Ul [R"[R"X0R-55n SU -$) aX Called by test_joint_skew_kurt. This function is optimized over nuisance parameters mu and sigma Parameters ---------- nuis_params : 1darray An array with a nuisance mean and variance parameter Returns ------ llr : float The log likelihood ratio of a pre-speified skewness and kurtosis holding the nuisance parameters constant. rr#r rxr!rr r3)rr+ryrr$rfrQrgrhr'r4rar&r%) rrzrr+rmrlr{rr)rnr`ros r_opt_skew_kurt_OptFuncts._opt_skew_kurtss`  yya.(^+1[^C1~-!3 ^s*,/3zz: A.14 ^q(*-./26**= ??Gy#LM%%bhhT /1Dy/1Dy/1Dy0:';=E/1wwt}T /J L RVVHjj119r>E1ffRVVD#3#3345CxrcDURU5SUR- $)z Parameters ---------- skew0 : float Hypothesized value of skewness Returns ------- diff : float The difference between the log likelihood ratio at skew and a pre-specified value. r) test_skewrY)rrs r_ci_limits_skew_OptFuncts._ci_limits_skew!~~d#A&00rcDURU5SUR- $)z Parameters ---------- skew0 : float Hypothesized value of kurtosis Returns ------- diff : float The difference between the log likelihood ratio at kurt and a pre-specified value. r) test_kurtrY)rkurts r_ci_limits_kurt_OptFuncts._ci_limits_kurtrrcX1SSS2- RupxUS-US- n US-US- n Xx-UUSUS-S--- n [R"XyXU 45n URX\U5n S[R"X5-nSU- S-U- Ul[R "[R"X@R -55nSU-$)z Parameters ---------- nuis_params : 1darray Array containing two nuisance means and two nuisance variances Returns ------- llr : float The log-likelihood of the correlation coefficient holding nuisance parameters constant Nr#r rx?r r3)r4r$rfrQr'rar&r%)rrzcorr0rr+r@weights0mu1_datamu2_data sig1_data sig2_data correl_datar)rnr`ros r _opt_correl_OptFuncts._opt_correls$#A#&6699MKN2 MKN2  +u ^k!n4;0<< ??H$,$FG%%bH=RVVH//9r>E1ffRVVD#3#3345CxrcDURU5SUR- $Nr) test_corrrY)rcorrs r_ci_limits_corr_OptFuncts._ci_limits_corrs~~d#A&00r)raNF)__name__ __module__ __qualname____firstlineno____doc__rr0r7r;rQrUr[rbrprur|rrrrrr__static_attributes__rrrrr1sb" "H@<;:>4$/$.B/&@@!F 1 141rrc\rSrSrSrSrSSjrSSjrSSjrSSjr /S Q4S jr SS jr SS jr SS jr SSjrSSjrSrg)ria6 A class to compute confidence intervals and hypothesis tests involving mean, variance, kurtosis and skewness of a univariate random variable. Parameters ---------- endog : 1darray Data to be analyzed Attributes ---------- endog : 1darray Data to be analyzed nobs : float Number of observations cb[R"U5UlURSUlgr)r$rLrrr+rs rrDescStatUV.__init__s!ZZ& KKN rcXlURnURnSSU- - UR[U5- - nSSU- - UR[ U5- - n[ R "URXV5nSU- S-SXsUR- --- nS[R"[R"XH-55-n U(aU [R"U S5U4$U [R"U S54$)a Returns - 2 x log-likelihood ratio, p-value and weights for a hypothesis test of the mean. Parameters ---------- mu0 : float Mean value to be tested return_weights : bool If return_weights is True the function returns the weights of the observations under the null hypothesis. Default is False Returns ------- test_results : tuple The log-likelihood ratio and p-value of mu0 r r3r ) rTrr+maxminrbrentqrUr$r&r%rri) rrTreturn_weightsrr+eta_mineta_maxrnraros rrXDescStatUV.test_means( yyd#3u:(=>d#3u:(=>??4>>7DDyB&"x488;K/L*LM 266"&&!3455 Q4 4Q' 'rcURnSU- nUS:Xa[R"US5Ul[R "U5n[ U5[R "U5- U-n[R "U5[U5- U-n [R"URU[ U5U- 5n [R"URU[U5U -5n X4$US:Xa[R"US5Ul[R"URU[U5U- 5n [R"UR[ U5U-U5n Xl- S-[R"Xl- S-5- nXm- S-[R"Xm- S-5- n[R"X-5n[R"X-5nUU4$g)a6 Returns the confidence interval for the mean. Parameters ---------- sig : float significance level. Default is .05 method : str Root finding method, Can be 'nested-brent' or 'gamma'. Default is 'gamma' 'gamma' Tries to solve for the gamma parameter in the Lagrange (see Owen pg 22) and then determine the weights. 'nested brent' uses brents method to find the confidence intervals but must maximize the likelihood ratio on every iteration. gamma is generally much faster. If the optimizations does not converge, try expanding the gamma_high and gamma_low variable. gamma_low : float Lower bound for gamma when finding lower limit. If function returns f(a) and f(b) must have different signs, consider lowering gamma_low. gamma_high : float Upper bound for gamma when finding upper limit. If function returns f(a) and f(b) must have different signs, consider raising gamma_high. epsilon : float When using 'nested-brent', amount to decrease (increase) from the maximum (minimum) of the data when starting the search. This is to protect against the likelihood ratio being zero at the maximum (minimum) value of the data. If data is very small in absolute value (<10 ``**`` -6) consider shrinking epsilon When using 'gamma', amount to decrease (increase) the minimum (maximum) by to start the search for gamma. If function returns f(a) and f(b) must have different signs, consider lowering epsilon. Returns ------- Interval : tuple Confidence interval for the mean r z nested-brentr_r^N) rrppfrYr$meanrrrrr[rbr&)rsigmethodepsilon gamma_low gamma_highrmiddle epsilon_u epsilon_lulimllim gamma_star_l gamma_star_u weights_low weights_highmu_lowmu_highs rci_meanDescStatUV.ci_mean sj #g ^ #hhsA&DGWWU^FUbggen4?I#e*4?I??4#5#5vE Y&(D??4#5#5vE Y&(D:  W hhsA&DG#??4+;+;YE W$&L#??4+;+;Ug-z;L!0R7,345K"1b8,345LVVK/0Fff\12GG# # rcXl[UR5n[UR5n[R "UR XCSS9Sn[R"US5nU(aXVURR4$XV4$)aa Returns -2 x log-likelihood ratio and the p-value for the hypothesized variance Parameters ---------- sig2_0 : float Hypothesized variance to be tested return_weights : bool If True, returns the weights that maximize the likelihood of observing sig2_0. Default is False Returns ------- test_results : tuple The log-likelihood ratio and the p_value of sig2_0 Examples -------- >>> import numpy as np >>> import statsmodels.api as sm >>> random_numbers = np.random.standard_normal(1000)*100 >>> el_analysis = sm.emplike.DescStat(random_numbers) >>> hyp_test = el_analysis.test_var(9500) r ) full_output) rerrrr fminboundrprrirar4)rrermu_maxmu_minrop_vals rrsDescStatUV.test_varZsw6 TZZTZZ  -.0013Q t//111 1: rNc<URnUcEURS- UR5-[R"SURS- 5- nUcEURS- UR5-[R"SURS- 5- n[R"SU- S5Ul[ R"URXR55n[ R"URUR5U5nXV4$)aa Returns the confidence interval for the variance. Parameters ---------- lower_bound : float The minimum value the lower confidence interval can take. The p-value from test_var(lower_bound) must be lower than 1 - significance level. Default is .99 confidence limit assuming normality upper_bound : float The maximum value the upper confidence interval can take. The p-value from test_var(upper_bound) must be lower than 1 - significance level. Default is .99 confidence limit assuming normality sig : float The significance level. Default is .05 Returns ------- Interval : tuple Confidence interval for the variance Examples -------- >>> import numpy as np >>> import statsmodels.api as sm >>> random_numbers = np.random.standard_normal(100) >>> el_analysis = sm.emplike.DescStat(random_numbers) >>> el_analysis.ci_var() (0.7539322567470305, 1.229998852496268) >>> el_analysis.ci_var(.5, 2) (0.7539322567469926, 1.2299988524962664) Notes ----- If the function returns the error f(a) and f(b) must have different signs, consider lowering lower_bound and raising upper_bound. r g-C6?gH.?) rr+rtrrrYrrru)r lower_bound upper_boundrrrrs rci_varDescStatUV.ci_varsV    IIMUYY[8xxtyy1}-/K   IIMUYY[8xxtyy1}-/K((1s7A&t22KMt22EIIKMzr)皙?皙?皙?{Gz?MbP?c [R"5upU RS5 U RS5 [ [ R "XU55n [ [ R "X4U55n /n U H1n XlU H"nU RURUSS95 M$ M3 [ R"U 5R[U 5[U 55n U RXXS9 U$)aT Returns a plot of the confidence region for a univariate mean and variance. Parameters ---------- mu_low : float Lowest value of the mean to plot mu_high : float Highest value of the mean to plot var_low : float Lowest value of the variance to plot var_high : float Highest value of the variance to plot mu_step : float Increments to evaluate the mean var_step : float Increments to evaluate the mean levs : list Which values of significance the contour lines will be drawn. Default is [.2, .1, .05, .01, .001] Returns ------- Figure The contour plot VarianceMeanT)rklevels)r create_mpl_ax set_ylabel set_xlabellistr$arangereappendrpasarrayr r contour)rrrvar_lowvar_highmu_stepvar_steplevsfigaxmu_vectvar_vectzsig0rTs r plot_contourDescStatUV.plot_contoursH%%' j! fryy':; 'X>? DKs67 JJqM ! !#h-W > 7a 5 rcXXl[R"URR 5URR 5/5n[ R"URUSSS9Sn[R"US5nU(aXEURR4$XE4$)af Returns -2 x log-likelihood and p-value for the hypothesized skewness. Parameters ---------- skew0 : float Skewness value to be tested return_weights : bool If True, function also returns the weights that maximize the likelihood ratio. Default is False. Returns ------- test_results : tuple The log-likelihood ratio and p_value of skew0 r rrrK) ryr$rgrrrtr fmin_powellr|rrirar4)rryrstart_nuisancerors rrDescStatUV.test_skews& 4::??#4'+zz~~'7#9:""4>>>12<<=?Q  0 0 2 22 2zrcXXl[R"URR 5URR 5/5n[ R"URUSSS9Sn[R"US5nU(aXEURR4$XE4$)ai Returns -2 x log-likelihood and the p-value for the hypothesized kurtosis. Parameters ---------- kurt0 : float Kurtosis value to be tested return_weights : bool If True, function also returns the weights that maximize the likelihood ratio. Default is False. Returns ------- test_results : tuple The log-likelihood ratio and p-value of kurt0 r rr) rr$rgrrrtrrrrrirar4)rrrrrors rrDescStatUV.test_kurts& 4::??#4'+zz~~'7#9:""4>>>12<<=?Q t//111 1zrcdXlX l[R"URR 5URR 5/5n[R"URUSSS9Sn[R"US5nU(aXVURR4$XV4$)a Returns - 2 x log-likelihood and the p-value for the joint hypothesis test for skewness and kurtosis Parameters ---------- skew0 : float Skewness value to be tested kurt0 : float Kurtosis value to be tested return_weights : bool If True, function also returns the weights that maximize the likelihood ratio. Default is False. Returns ------- test_results : tuple The log-likelihood ratio and p-value of the joint hypothesis test. r rrr#)ryrr$rgrrrtrrrrrirar4)rryrrrrors rtest_joint_skew_kurtDescStatUV.test_joint_skew_kurt%s*  4::??#4'+zz~~'7#9:""4#6#612<<=?Q t//111 1zrcURnURnUc/[U5SSU-US- -US- US--US--- S---nUc/[U5SSU-US- -US- US--US--- S--- n[R"SU- S5Ul[ R"URU[U55n[ R"UR[U5U5nXg4$)aC Returns the confidence interval for skewness. Parameters ---------- sig : float The significance level. Default is .05 upper_bound : float Maximum value of skewness the upper limit can be. Default is .99 confidence limit assuming normality. lower_bound : float Minimum value of skewness the lower limit can be. Default is .99 confidence level assuming normality. Returns ------- Interval : tuple Confidence interval for the skewness Notes ----- If function returns f(a) and f(b) must have different signs, consider expanding lower and upper bounds @@r r"@rr ) r+rrrrrYrrr)rrrrr+rrrs rci_skewDescStatUV.ci_skewFs6yy   u+ BI+r dRi(r  "# ##K  u+ BI+r dRi(r  "# ##K((1s7A&t33[$u+Nt33T%[+NzrcVURnURnUcJ[U5SSSU-US- -US- US--US--- S---US-S- US- US--- S---nUcJ[U5SSSU-US- -US- US--US--- S---US-S- US- US--- S--- n[R"SU- S5Ul[ R"URU[U55n[ R"UR[U5U5nXg4$) a Returns the confidence interval for kurtosis. Parameters ---------- sig : float The significance level. Default is .05 upper_bound : float Maximum value of kurtosis the upper limit can be. Default is .99 confidence limit assuming normality. lower_bound : float Minimum value of kurtosis the lower limit can be. Default is .99 confidence limit assuming normality. Returns ------- Interval : tuple Lower and upper confidence limit Notes ----- For small n, upper_bound and lower_bound may have to be provided by the user. Consider using test_kurt to find values close to the desired significance level. If function returns f(a) and f(b) must have different signs, consider expanding the bounds. rr"rr rrg@r ) rr+rrrrYrrr)rrrrrr+rrs rci_kurtDescStatUV.ci_kurtrs@ yy  "5/ B29r 2r dRi(r  "##$"*"r )("$%%&K  "5/ B29r 2r dRi(r  "##$"*"r )("$%%&K ((1s7A&t33[%e_.t33Xe_(*zr)rrrTr+rYreryr)rr_rGld( ld( )NNrrNN)rrrrrrrXrrsrrrrrrrrrrrrrsT$#(B8@19N$`$L5r60d<<B*X5rrcJ\rSrSrSrSrS SjrS SjrS SjrS Sjr S r g)riz A class for conducting inference on multivariate means and correlation. Parameters ---------- endog : ndarray Data to be analyzed Attributes ---------- endog : ndarray Data to be analyzed nobs : float Number of observations c8XlURSUlgr)rrr+rs rrDescStatMV.__init__s KKN rc>URnURn[U5URS:wa [ S5eUR SURS5n[ R"URSURS45nX-nX5- nSU- [ R"URS5-nURXv[ R"U5SU- -5nS[ R"XR5-n SU- S-U - Ul S[ R"[ R"X@R-55-n [R"XRS5n U(aXURR4$X4$)a Returns -2 x log likelihood and the p-value for a multivariate hypothesis test of the mean Parameters ---------- mu_array : 1d array Hypothesized values for the mean. Must have same number of elements as columns in endog return_weights : bool If True, returns the weights that maximize the likelihood of mu_array. Default is False. Returns ------- test_results : tuple The log-likelihood ratio and p-value for mu_array r zJmu_array must have the same number of elements as the columns of the data.rr r3)rr+r r ValueErrorr r$rhrQr'r4rar&r%rri) rmu_arrayrrr+meansr) start_valsrnr`rors r mv_test_meanDescStatMV.mv_test_means[( yy x=EKKN *DE E##Au{{1~6QQ89 =$YQ!88 %%j&(ggdmrDy&ACBFF8ZZ00t8a<%/266"&&(8(8!89::^^A./  0 0 2 22 2: rNc URRSS:wa [S5e[R"5upU cU R S5 OU R U 5 UcU R S5 OU R U5 [R"XU5n [R"X4U5n[R"X5n/nUH:nURUR[R"U55S5 M< [R"X5unn[R"U5nURURSURS5nU R!XUR"US9 U (a5U R%URSS2S4URSS2S4S 5 U $) a Creates a confidence region plot for the mean of bivariate data Parameters ---------- m1_low : float Minimum value of the mean for variable 1 m1_upp : float Maximum value of the mean for variable 1 mu2_low : float Minimum value of the mean for variable 2 mu2_upp : float Maximum value of the mean for variable 2 step1 : float Increment of evaluations for variable 1 step2 : float Increment of evaluations for variable 2 levs : list Levels to be drawn on the contour plot. Default = (.001, .01, .05, .1, .2) plot_dta : bool If True, makes a scatter plot of the data on top of the contour plot. Defaultis False. var1_name : str Name of variable 1 to be plotted on the x-axis var2_name : str Name of variable 2 to be plotted on the y-axis Notes ----- The smaller the step size, the more accurate the intervals will be If the function returns optimization failed, consider narrowing the boundaries of the plot Examples -------- >>> import statsmodels.api as sm >>> two_rvs = np.random.standard_normal((20,2)) >>> el_analysis = sm.emplike.DescStat(two_rvs) >>> contourp = el_analysis.mv_mean_contour(-2, 2, -2, 2, .1, .1) >>> contourp.show() r r#z'Data must contain exactly two variablesNz Variable 2z Variable 1rrbo)rrr rrrrr$r itertoolsproductrrrmeshgridr rr4plot)rmu1_lowmu1_uppmu2_lowmu2_uppstep1step2r var1_name var2_nameplot_dtarrxypairsriXYs rmv_mean_contourDescStatMV.mv_mean_contours^^ ::  A ! #FG G%%'   MM, ' MM) $   MM, ' MM) $ IIg . IIg .!!!' A HHT&&rzz!}5a8 9{{1 1 JJqM IIaggaj!''!* - 1T *  GGDJJq!t$djjA&6 = rcURnURnURSS:wa [S5e[R "USS2S4R 5USS2S4R5USS2S4R 5USS2S4R5/5n[R"S5n[R "SU- /[U5-5nXX6U4n[R"URXXSSS9Sn [R"U S5n U(aXURR 4$X4$) a$ Returns -2 x log-likelihood ratio and p-value for the correlation coefficient between 2 variables Parameters ---------- corr0 : float Hypothesized value to be tested return_weights : bool If true, returns the weights that maximize the log-likelihood at the hypothesized value r r#z&Correlation matrix not yet implementedNrr )argsrrK)r+rrNotImplementedErrorr$rgrrtzerosintrfminrrrirar4) rrrr+rnuis0r@rr+rors rrDescStatMV.test_corr1syy  ;;q>Q %&NO O%1+**,#AqDkoo/#AqDk..0#AqDkoo/12 XXa[88R$YK#d)34d1mmD,,e12<<=?Q t//111 1zrc URnURn[R"SU- S5Ul[ R "USS2S4USS2S45SnUc![SUSSUS-- US- - S ---5nUc2[S US[ R"SUS-- US- - 5-- 5n[R"URX65n[R"URXb5nXx4$) a Returns the confidence intervals for the correlation coefficient Parameters ---------- sig : float The significance level. Default is .05 upper_bound : float Maximum value the upper confidence limit can be. Default is 99% confidence limit assuming normality. lower_bound : float Minimum value the lower confidence limit can be. Default is 99% confidence limit assuming normality. Returns ------- interval : tuple Confidence interval for the correlation r Nr)rr g+?rr r"rg+) rr+rrrYr$corrcoefrrsqrtrbrenthr) rrrrrr+ point_estrrs rci_corrDescStatMV.ci_corrRs , yy((1s7A&KKad U1a4[9$?  dI"yB"6"9"&*,!--%-.K  fi"yB*>"9*&"'('()Kt33[Lt33YLzr)rrar+rYr))rrrrrNNF)rr) rrrrrrrr'rr7rrrrrrs."#'TBF16FPB&rr)rnumpyr$scipyr scipy.statsrrrstatsmodels.base.optimizerrrstatsmodels.graphicsrrrrrrrrr>sP",,2&!.^1^1B UUpNNr