{ "__type": "IngestedDoc", "__tag": 4010, "_content": { "Notes": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For fixed " }, { "__type": "InlineMath", "__tag": 4057, "value": "\\alpha, \\beta" }, { "__type": "Text", "__tag": 4046, "value": ", the polynomials " }, { "__type": "InlineMath", "__tag": 4057, "value": "P_n^{(\\alpha, \\beta)}" }, { "__type": "Text", "__tag": 4046, "value": " are orthogonal over " }, { "__type": "InlineMath", "__tag": 4057, "value": "[-1, 1]" }, { "__type": "Text", "__tag": 4046, "value": " with weight function " }, { "__type": "InlineMath", "__tag": 4057, "value": "(1 - x)^\\alpha(1 + x)^\\beta" }, { "__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": "P", "annotation": "orthopoly1d", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Jacobi polynomial." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Jacobi polynomial." } ] } ], "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": "n", "annotation": "int", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Degree of the polynomial." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "alpha", "annotation": "float", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Parameter, must be greater than -1." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "beta", "annotation": "float", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Parameter, must be greater than -1." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "monic", "annotation": "bool, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If " }, { "__type": "InlineRole", "__tag": 4003, "value": "True", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": ", scale the leading coefficient to be 1. Default is " }, { "__type": "InlineRole", "__tag": 4003, "value": "False", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Extended Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Defined to be the solution of" } ] }, { "__type": "Math", "__tag": 4058, "value": "(1 - x^2)\\frac{d^2}{dx^2}P_n^{(\\alpha, \\beta)}\n + (\\beta - \\alpha - (\\alpha + \\beta + 2)x)\n \\frac{d}{dx}P_n^{(\\alpha, \\beta)}\n + n(n + \\alpha + \\beta + 1)P_n^{(\\alpha, \\beta)} = 0" }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "for " }, { "__type": "InlineMath", "__tag": 4057, "value": "\\alpha, \\beta > -1" }, { "__type": "Text", "__tag": 4046, "value": "; " }, { "__type": "InlineMath", "__tag": 4057, "value": "P_n^{(\\alpha, \\beta)}" }, { "__type": "Text", "__tag": 4046, "value": " is a polynomial of degree " }, { "__type": "InlineMath", "__tag": 4057, "value": "n" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ], "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": "/scipy/special/_orthogonal.py", "item_line": 309, "item_type": "function", "aliases": [ "scipy.special.jacobi" ], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Text", "__tag": 4046, "value": "The Jacobi polynomials satisfy the recurrence relation:\n\n.. math::\n P_n^{(\\alpha, \\beta-1)}(x) - P_n^{(\\alpha-1, \\beta)}(x)\n = P_{n-1}^{(\\alpha, \\beta)}(x)\n\nThis can be verified, for example, for :math:`\\alpha = \\beta = 2`\nand :math:`n = 1` over the interval :math:`[-1, 1]`:\n\n" }, { "__type": "Code", "__tag": 4050, "value": "import numpy as np\nfrom scipy.special import jacobi\nx = np.arange(-1.0, 1.0, 0.01)\nnp.allclose(jacobi(0, 2, 2)(x),\n jacobi(1, 2, 1)(x) - jacobi(1, 1, 2)(x))\n", "execution_status": "success" }, { "__type": "Text", "__tag": 4046, "value": "\nPlot of the Jacobi polynomial :math:`P_5^{(\\alpha, -0.5)}` for\ndifferent values of :math:`\\alpha`:\n\n" }, { "__type": "Code", "__tag": 4050, "value": "import matplotlib.pyplot as plt\nx = np.arange(-1.0, 1.0, 0.01)\nfig, ax = plt.subplots()\n", "execution_status": "success" }, { "__type": "Code", "__tag": 4050, "value": "ax.set_ylim(-2.0, 2.0)\nax.set_title(r'Jacobi polynomials $P_5^{(\\alpha, -0.5)}$')\nfor alpha in np.arange(0, 4, 1):\n ax.plot(x, jacobi(5, alpha, -0.5)(x), label=rf'$\\alpha={alpha}$')\nplt.legend(loc='best')\n", "execution_status": "failure" }, { "__type": "Code", "__tag": 4050, "value": "plt.show()\n", "execution_status": "success" }, { "__type": "Figure", "__tag": 4024, "value": { "__type": "RefInfo", "__tag": 4000, "module": "scipy", "version": "1.17.1", "kind": "assets", "path": "fig-07bf01dc594ef610.png" } } ], "title": [], "level": 0, "target": null }, "see_also": [], "signature": { "__type": "SignatureNode", "__tag": 4029, "kind": "function", "parameters": [ { "__type": "SigParam", "__tag": 4030, "name": "n", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "alpha", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "beta", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "monic", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "False" } ], "return_annotation": { "__type": "Empty", "__tag": 4031 }, "target_name": "jacobi" }, "references": [ ".. [AS] Milton Abramowitz and Irene A. Stegun, eds.", " Handbook of Mathematical Functions with Formulas,", " Graphs, and Mathematical Tables. New York: Dover, 1972." ], "qa": "scipy.special._orthogonal:jacobi", "arbitrary": [], "local_refs": [ "P", "alpha", "beta", "monic", "n" ] }