{ "__type": "IngestedDoc", "__tag": 4010, "_content": { "Notes": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "When one of " }, { "__type": "ParamRef", "__tag": 4071, "name": "actual" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "ParamRef", "__tag": 4071, "name": "desired" }, { "__type": "Text", "__tag": 4046, "value": " is a scalar and the other is array_like, the function checks that each element of the array_like is equal to the scalar. Note that empty arrays are therefore considered equal to scalars. This behaviour can be disabled by setting " }, { "__type": "InlineCode", "__tag": 4051, "value": "strict==True" }, { "__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": [ { "__type": "Parameters", "__tag": 4026, "children": [ { "__type": "DocParam", "__tag": 4016, "name": "", "annotation": "AssertionError", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If actual and desired are not equal." } ] } ] } ] } ], "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": [], "title": [], "level": 0, "target": null }, "Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Raises an AssertionError if two objects are not equal." } ] } ], "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": "actual", "annotation": "array_like", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The object to check." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "desired", "annotation": "array_like", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The expected object." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "err_msg", "annotation": "str, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The error message to be printed in case of failure." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "verbose", "annotation": "bool, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If True, the conflicting values are appended to the error message." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "strict", "annotation": "bool, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If True and either of the " }, { "__type": "ParamRef", "__tag": 4071, "name": "actual" }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "ParamRef", "__tag": 4071, "name": "desired" }, { "__type": "Text", "__tag": 4046, "value": " arguments is an array, raise an " }, { "__type": "InlineCode", "__tag": 4051, "value": "AssertionError" }, { "__type": "Text", "__tag": 4046, "value": " when either the shape or the data type of the arguments does not match. If neither argument is an array, this parameter has no effect." } ] }, { "__type": "Admonition", "__tag": 4056, "kind": "versionadded", "base_type": "neutral", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "versionadded 2.0.0" } ] } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Extended Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Given two objects (scalars, lists, tuples, dictionaries or numpy arrays), check that all elements of these objects are equal. An exception is raised at the first conflicting values." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "This function handles NaN comparisons as if NaN was a \"normal\" number. That is, AssertionError is not raised if both objects have NaNs in the same positions. This is in contrast to the IEEE standard on NaNs, which says that NaN compared to anything must return False." } ] } ], "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/numpy/testing/_private/utils.py", "item_line": 255, "item_type": "function", "aliases": [ "numpy.testing.assert_equal" ], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Code", "__tag": 4050, "value": "np.testing.assert_equal([4, 5], [4, 6])\n", "execution_status": "none" }, { "__type": "Text", "__tag": 4046, "value": "\nThe following comparison does not raise an exception. There are NaNs\nin the inputs, but they are in the same positions.\n\n" }, { "__type": "Code", "__tag": 4050, "value": "np.testing.assert_equal(np.array([1.0, 2.0, np.nan]), [1, 2, np.nan])\n", "execution_status": "none" }, { "__type": "Text", "__tag": 4046, "value": "\nAs mentioned in the Notes section, `assert_equal` has special\nhandling for scalars when one of the arguments is an array.\nHere, the test checks that each value in `x` is 3:\n\n" }, { "__type": "Code", "__tag": 4050, "value": "x = np.full((2, 5), fill_value=3)\nnp.testing.assert_equal(x, 3)\n", "execution_status": "none" }, { "__type": "Text", "__tag": 4046, "value": "\nUse `strict` to raise an AssertionError when comparing a scalar with an\narray of a different shape:\n\n" }, { "__type": "Code", "__tag": 4050, "value": "np.testing.assert_equal(x, 3, strict=True)\n", "execution_status": "none" }, { "__type": "Text", "__tag": 4046, "value": "\nThe `strict` parameter also ensures that the array data types match:\n\n" }, { "__type": "Code", "__tag": 4050, "value": "x = np.array([2, 2, 2])\ny = np.array([2., 2., 2.], dtype=np.float32)\nnp.testing.assert_equal(x, y, strict=True)\n", "execution_status": "none" } ], "title": [], "level": 0, "target": null }, "see_also": [ { "__type": "SeeAlsoItem", "__tag": 4028, "name": { "__type": "CrossRef", "__tag": 4002, "value": "assert_allclose", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.testing._private.utils:assert_allclose" }, "kind": "module" }, "descriptions": [], "type": null }, { "__type": "SeeAlsoItem", "__tag": 4028, "name": { "__type": "CrossRef", "__tag": 4002, "value": "assert_array_almost_equal_nulp", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.testing._private.utils:assert_array_almost_equal_nulp" }, "kind": "module" }, "descriptions": [], "type": null }, { "__type": "SeeAlsoItem", "__tag": 4028, "name": { "__type": "CrossRef", "__tag": 4002, "value": "assert_array_max_ulp", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "numpy.testing._private.utils:assert_array_max_ulp" }, "kind": "module" }, "descriptions": [], "type": null } ], "signature": { "__type": "SignatureNode", "__tag": 4029, "kind": "function", "parameters": [ { "__type": "SigParam", "__tag": 4030, "name": "actual", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "desired", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "err_msg", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "" }, { "__type": "SigParam", "__tag": 4030, "name": "verbose", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "True" }, { "__type": "SigParam", "__tag": 4030, "name": "strict", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "KEYWORD_ONLY", "default": "False" } ], "return_annotation": { "__type": "Empty", "__tag": 4031 }, "target_name": "assert_equal" }, "references": null, "qa": "numpy.testing._private.utils:assert_equal", "arbitrary": [], "local_refs": [ "actual", "desired", "err_msg", "strict", "verbose" ] }