{ "__type": "IngestedDoc", "__tag": 4010, "_content": { "Notes": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The normalized counterpart of an (unnormalized) associated Legendre polynomial has the additional factor" } ] }, { "__type": "Math", "__tag": 4058, "value": "\\sqrt{\\frac{(2 n + 1) (n - m)!}{2 (n + m)!}}" } ], "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": "", "annotation": "ndarray or tuple of ndarray", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Associated Legendre polynomial with " }, { "__type": "InlineCode", "__tag": 4051, "value": "diff_n" }, { "__type": "Text", "__tag": 4046, "value": " derivatives." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Associated Legendre polynomial of the first kind." } ] } ], "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": "array_like of ints", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Degree of the associated Legendre polynomial. Must have " }, { "__type": "InlineCode", "__tag": 4051, "value": "n >= 0" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "m", "annotation": "array_like of ints", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Order of the associated Legendre polynomial." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "z", "annotation": "array_like", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Input value." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "branch_cut", "annotation": "array_like of ints, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Selects branch cut. Must be 2 (default) or 3. 2: cut on the real axis " }, { "__type": "InlineCode", "__tag": 4051, "value": "|z| > 1" }, { "__type": "Text", "__tag": 4046, "value": " 3: cut on the real axis " }, { "__type": "InlineCode", "__tag": 4051, "value": "-1 < z < 1" } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "norm", "annotation": "bool, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If " }, { "__type": "InlineCode", "__tag": 4051, "value": "True" }, { "__type": "Text", "__tag": 4046, "value": ", compute the normalized associated Legendre polynomial. Default is " }, { "__type": "InlineCode", "__tag": 4051, "value": "False" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "diff_n", "annotation": "int, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "A non-negative integer. Compute and return all derivatives up to order " }, { "__type": "InlineCode", "__tag": 4051, "value": "diff_n" }, { "__type": "Text", "__tag": 4046, "value": ". Default is 0." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Extended Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Defined as" } ] }, { "__type": "Math", "__tag": 4058, "value": "P_n^m(z) = (-1)^m (1 - z^2)^{m/2}\n \\frac{d^m}{dz^m} P_n(z)" }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "where " }, { "__type": "InlineMath", "__tag": 4057, "value": "P_n" }, { "__type": "Text", "__tag": 4046, "value": " is the Legendre polynomial." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "This definition includes the Condon-Shortley phase " }, { "__type": "InlineMath", "__tag": 4057, "value": "(-1)^m" }, { "__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": "build-install/usr/lib/python3.14/site-packages/scipy/special/_multiufuncs.py", "item_line": null, "item_type": "MultiUFunc", "aliases": [ "scipy.special.assoc_legendre_p" ], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Text", "__tag": 4046, "value": "Evaluate :math:`P_2^1(z)` on :math:`[-1, 1]`:\n\n" }, { "__type": "Code", "__tag": 4050, "value": "import numpy as np\nfrom scipy.special import assoc_legendre_p\nz = np.linspace(-1, 1, 11)\nexpected = -3 * z * np.sqrt(1 - z**2)\nnp.allclose(assoc_legendre_p(2, 1, z), expected)\n", "execution_status": "success", "out": "True\n" }, { "__type": "Text", "__tag": 4046, "value": "\nCompute the normalized associated Legendre polynomial:\n\n" }, { "__type": "Code", "__tag": 4050, "value": "scale = np.sqrt(5/12)\nnp.allclose(assoc_legendre_p(2, 1, z, norm=True), scale * expected)\n", "execution_status": "success", "out": "True\n" } ], "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": "m", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "z", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "branch_cut", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "KEYWORD_ONLY", "default": "2" }, { "__type": "SigParam", "__tag": 4030, "name": "norm", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "KEYWORD_ONLY", "default": "False" }, { "__type": "SigParam", "__tag": 4030, "name": "diff_n", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "KEYWORD_ONLY", "default": "0" } ], "return_annotation": { "__type": "Empty", "__tag": 4031 }, "target_name": "assoc_legendre_p" }, "references": null, "qa": "scipy.special._multiufuncs:assoc_legendre_p", "arbitrary": [], "local_refs": [ "branch_cut", "diff_n", "m", "n", "norm", "z" ] }