{ "__type": "IngestedDoc", "__tag": 4010, "_content": { "Notes": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Critical values provided when " }, { "__type": "ParamRef", "__tag": 4071, "name": "method" }, { "__type": "Text", "__tag": 4046, "value": " is unspecified are for the following significance levels:" } ] }, { "__type": "DefList", "__tag": 4033, "children": [ { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "normal/exponential" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "15%, 10%, 5%, 2.5%, 1%" } ] } ] }, { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "logistic" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "25%, 10%, 5%, 2.5%, 1%, 0.5%" } ] } ] }, { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "gumbel_l / gumbel_r" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "25%, 10%, 5%, 2.5%, 1%" } ] } ] }, { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "weibull_min" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "50%, 25%, 15%, 10%, 5%, 2.5%, 1%, 0.5%" } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If the returned statistic is larger than these critical values then for the corresponding significance level, the null hypothesis that the data come from the chosen distribution can be rejected. The returned statistic is referred to as 'A2' in the references." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For " }, { "__type": "InlineRole", "__tag": 4003, "value": "weibull_min", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": ", maximum likelihood estimation is known to be challenging. If the test returns successfully, then the first order conditions for a maximum likelihood estimate have been verified and the critical values correspond relatively well to the significance levels, provided that the sample is sufficiently large (>10 observations [7]). However, for some data - especially data with no left tail - " }, { "__type": "CrossRef", "__tag": 4002, "value": "anderson", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "scipy.stats._morestats:anderson" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " is likely to result in an error message. In this case, consider performing a custom goodness of fit test using " }, { "__type": "CrossRef", "__tag": 4002, "value": "scipy.stats.monte_carlo_test", "reference": { "__type": "RefInfo", "__tag": 4000, "module": "scipy", "version": "?", "kind": "module", "path": "scipy.stats._resampling:monte_carlo_test" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ], "title": [], "level": 0, "target": null }, "Warns": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Raises": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Yields": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Methods": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Returns": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Parameters", "__tag": 4026, "children": [ { "__type": "DocParam", "__tag": 4016, "name": "result", "annotation": "AndersonResult", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If " }, { "__type": "ParamRef", "__tag": 4071, "name": "method" }, { "__type": "Text", "__tag": 4046, "value": " is provided, this is an object with the following attributes:" } ] }, { "__type": "DefList", "__tag": 4033, "children": [ { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "statistic" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The Anderson-Darling test statistic." } ] } ] }, { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "pvalue: float" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The p-value corresponding with the test statistic, calculated according to the specified " }, { "__type": "ParamRef", "__tag": 4071, "name": "method" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If " }, { "__type": "ParamRef", "__tag": 4071, "name": "method" }, { "__type": "Text", "__tag": 4046, "value": " is unspecified, this is an object with the following attributes:" } ] }, { "__type": "DefList", "__tag": 4033, "children": [ { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "statistic" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The Anderson-Darling test statistic." } ] } ] }, { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "critical_values" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The critical values for this distribution." } ] } ] }, { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "significance_level" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The significance levels for the corresponding critical values in percents. The function returns critical values for a differing set of significance levels depending on the distribution that is being tested against." } ] } ] }, { "__type": "DefListItem", "__tag": 4037, "dt": { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "fit_result" } ] }, "dd": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "An object containing the results of fitting the distribution to the data." } ] } ] } ] }, { "__type": "Admonition", "__tag": 4056, "kind": "deprecated", "base_type": "neutral", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "deprecated 1.17.0" } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The tuple-unpacking behavior of the return object and attributes " }, { "__type": "InlineCode", "__tag": 4051, "value": "critical_values" }, { "__type": "Text", "__tag": 4046, "value": ", " }, { "__type": "InlineCode", "__tag": 4051, "value": "significance_level" }, { "__type": "Text", "__tag": 4046, "value": ", and " }, { "__type": "InlineCode", "__tag": 4051, "value": "fit_result" }, { "__type": "Text", "__tag": 4046, "value": " are deprecated. Beginning in SciPy 2.0.0, these features will no longer be available, and the object returned will have attributes " }, { "__type": "InlineCode", "__tag": 4051, "value": "statistic" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "InlineCode", "__tag": 4051, "value": "pvalue" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Anderson-Darling test for data coming from a particular distribution." } ] } ], "title": [], "level": 0, "target": null }, "Receives": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Warnings": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Attributes": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Parameters": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Parameters", "__tag": 4026, "children": [ { "__type": "DocParam", "__tag": 4016, "name": "x", "annotation": "array_like", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Array of sample data." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "dist", "annotation": "{'norm', 'expon', 'logistic', 'gumbel', 'gumbel_l', 'gumbel_r', 'extreme1', 'weibull_min'}, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The type of distribution to test against. The default is 'norm'. The names 'extreme1', 'gumbel_l' and 'gumbel' are synonyms for the same distribution." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "method", "annotation": "str or instance of `MonteCarloMethod`", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Defines the method used to compute the p-value. If " }, { "__type": "ParamRef", "__tag": 4071, "name": "method" }, { "__type": "Text", "__tag": 4046, "value": " is " }, { "__type": "InlineCode", "__tag": 4051, "value": "\"interpolated\"" }, { "__type": "Text", "__tag": 4046, "value": ", the p-value is interpolated from pre-calculated tables. If " }, { "__type": "ParamRef", "__tag": 4071, "name": "method" }, { "__type": "Text", "__tag": 4046, "value": " is an instance of " }, { "__type": "CrossRef", "__tag": 4002, "value": "MonteCarloMethod", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "scipy.stats._resampling:MonteCarloMethod" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": ", the p-value is computed using " }, { "__type": "CrossRef", "__tag": 4002, "value": "scipy.stats.monte_carlo_test", "reference": { "__type": "RefInfo", "__tag": 4000, "module": "scipy", "version": "?", "kind": "module", "path": "scipy.stats._resampling:monte_carlo_test" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " with the provided configuration options and other appropriate settings." } ] }, { "__type": "Admonition", "__tag": 4056, "kind": "versionadded", "base_type": "neutral", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "versionadded 1.17.0" } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If " }, { "__type": "ParamRef", "__tag": 4071, "name": "method" }, { "__type": "Text", "__tag": 4046, "value": " is not specified, " }, { "__type": "CrossRef", "__tag": 4002, "value": "anderson", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "scipy.stats._morestats:anderson" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": " will emit a " }, { "__type": "InlineCode", "__tag": 4051, "value": "FutureWarning" }, { "__type": "Text", "__tag": 4046, "value": " specifying that the user must opt into a p-value calculation method. When " }, { "__type": "ParamRef", "__tag": 4071, "name": "method" }, { "__type": "Text", "__tag": 4046, "value": " is specified, the object returned will include a " }, { "__type": "InlineCode", "__tag": 4051, "value": "pvalue" }, { "__type": "Text", "__tag": 4046, "value": " attribute, but no " }, { "__type": "InlineCode", "__tag": 4051, "value": "critical_value" }, { "__type": "Text", "__tag": 4046, "value": ", " }, { "__type": "InlineCode", "__tag": 4051, "value": "significance_level" }, { "__type": "Text", "__tag": 4046, "value": ", or " }, { "__type": "InlineCode", "__tag": 4051, "value": "fit_result" }, { "__type": "Text", "__tag": 4046, "value": " attributes. Beginning in 2.0.0, these other attributes will no longer be available, and a p-value will always be computed according to one of the available " }, { "__type": "ParamRef", "__tag": 4071, "name": "method" }, { "__type": "Text", "__tag": 4046, "value": " options." } ] } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Extended Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The Anderson-Darling test tests the null hypothesis that a sample is drawn from a population that follows a particular distribution. For the Anderson-Darling test, the critical values depend on which distribution is being tested against. This function works for normal, exponential, logistic, weibull_min, or Gumbel (Extreme Value Type I) distributions." } ] } ], "title": [], "level": 0, "target": null }, "Other Parameters": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null } }, "_ordered_sections": [ "Summary", "Extended Summary", "Parameters", "Attributes", "Methods", "Returns", "Yields", "Receives", "Other Parameters", "Raises", "Warns", "Warnings", "Notes" ], "item_file": "build-install/usr/lib/python3.14/site-packages/scipy/stats/_morestats.py", "item_line": 2366, "item_type": "function", "aliases": [ "scipy.stats.anderson" ], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Text", "__tag": 4046, "value": "Test the null hypothesis that a random sample was drawn from a normal\ndistribution (with unspecified mean and standard deviation).\n\n" }, { "__type": "Code", "__tag": 4050, "value": "import numpy as np\nfrom scipy.stats import anderson\nrng = np.random.default_rng(9781234521)\ndata = rng.random(size=35)\nres = anderson(data, dist='norm', method='interpolate')\nres.statistic\nres.pvalue\n", "execution_status": "success", "out": "np.float64(0.012111200538380142)\n" }, { "__type": "Text", "__tag": 4046, "value": "\nThe p-value is approximately 0.012,, so the null hypothesis may be rejected\nat a significance level of 2.5%, but not at a significance level of 1%." } ], "title": [], "level": 0, "target": null }, "see_also": [ { "__type": "SeeAlsoItem", "__tag": 4028, "name": { "__type": "CrossRef", "__tag": 4002, "value": "kstest", "reference": { "__type": "RefInfo", "__tag": 4000, "module": "current-module", "version": "current-version", "kind": "to-resolve", "path": "kstest" }, "kind": "module" }, "descriptions": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The Kolmogorov-Smirnov test for goodness-of-fit." } ] } ], "type": "func" } ], "signature": { "__type": "SignatureNode", "__tag": 4029, "kind": "function", "parameters": [ { "__type": "SigParam", "__tag": 4030, "name": "x", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "dist", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "norm" }, { "__type": "SigParam", "__tag": 4030, "name": "method", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "KEYWORD_ONLY", "default": "None" } ], "return_annotation": { "__type": "Empty", "__tag": 4031 }, "target_name": "anderson" }, "references": [ ".. [1] https://www.itl.nist.gov/div898/handbook/prc/section2/prc213.htm", ".. [2] Stephens, M. A. (1974). EDF Statistics for Goodness of Fit and", " Some Comparisons, Journal of the American Statistical Association,", " Vol. 69, pp. 730-737.", ".. [3] Stephens, M. A. (1976). Asymptotic Results for Goodness-of-Fit", " Statistics with Unknown Parameters, Annals of Statistics, Vol. 4,", " pp. 357-369.", ".. [4] Stephens, M. A. (1977). Goodness of Fit for the Extreme Value", " Distribution, Biometrika, Vol. 64, pp. 583-588.", ".. [5] Stephens, M. A. (1977). Goodness of Fit with Special Reference", " to Tests for Exponentiality , Technical Report No. 262,", " Department of Statistics, Stanford University, Stanford, CA.", ".. [6] Stephens, M. A. (1979). Tests of Fit for the Logistic Distribution", " Based on the Empirical Distribution Function, Biometrika, Vol. 66,", " pp. 591-595.", ".. [7] Richard A. Lockhart and Michael A. Stephens \"Estimation and Tests of", " Fit for the Three-Parameter Weibull Distribution\"", " Journal of the Royal Statistical Society.Series B(Methodological)", " Vol. 56, No. 3 (1994), pp. 491-500, Table 0.", ".. [8] D'Agostino, Ralph B. (1986). \"Tests for the Normal Distribution\".", " In: Goodness-of-Fit Techniques. Ed. by Ralph B. D'Agostino and", " Michael A. Stephens. New York: Marcel Dekker, pp. 122-141. ISBN:", " 0-8247-7487-6." ], "qa": "scipy.stats._morestats:anderson", "arbitrary": [], "local_refs": [ "dist", "method", "result", "x" ] }