René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Bug]: Type hints for xy and xycoords in annotate are too strict","articleBody":"### Bug summary\n\nRight now, it looks like the type hints for Axes.annotate only accept a tuple of floats as input for the `xy` and `xycoords` arguments, but that is too narrow. Specifically, if I've plotted something with a datetime on the x axis (a not-unusual practice), I am most likely going to specify the annotation position with an acceptable datetime-like object.\n\nThere are no runtime issues, but both mypy and basedpyright complain about the `annotate` line in the following code (ignore the messy output, it's just for example purposes). `t` is truly a `pd.Timestamp`, but even if I try using a native `datetime` object the problem occurs.\n\n### Code for reproduction\n\n```Python\nfrom typing import cast\n\nimport matplotlib.pyplot as plt\nimport numpy as np\nimport pandas as pd\n\nidx = pd.date_range(start='01/01/2014', end='03/01/2014', freq='1h')\nn = len(idx)\nrng = np.random.default_rng()\ndata = rng.normal(size=n)\ndf = pd.DataFrame({\"data\": data}, index=idx)\n\ndaily = df.resample(\"D\")\nmaxs = daily.max()\nmins = daily.min()\n\nax = maxs.plot()\nmins.plot(ax=ax)\nfor t, x in maxs[\"data\"].items():\n    t = cast(pd.Timestamp, t)\n    x = cast(float, x)\n    ax.annotate(str(x), (t, x))\n\nplt.show()\n```\n\n### Actual outcome\n\n$ basedpyright dummy1.py \n/home/andrea/Code/playground/dummy1.py\n  /home/andrea/Code/playground/dummy1.py:26:26 - error: Argument of type \"tuple[Timestamp, float]\" cannot be assigned to parameter \"xy\" of type \"tuple[float, float]\" in function \"annotate\"\n    \"Timestamp\" is not assignable to \"float\" (reportArgumentType)\n1 error, 0 warnings, 0 notes\n\n$ mypy dummy1.py\ndummy1.py:26: error: Argument 2 to \"annotate\" of \"Axes\" has incompatible type \"tuple[Timestamp, float]\"; expected \"tuple[float, float]\"  [arg-type]\nFound 1 error in 1 file (checked 1 source file)\n\n### Expected outcome\n\nNo type errors.\n\n### Additional information\n\nVersions:\npython: 3.12\nmatplotlib: 3.10.3\nbasedpyright: 1.31.0\nmypy: 1.17.0\n\n### Operating system\n\nDebian (Linux Mint)\n\n### Matplotlib Version\n\n3.10.3\n\n### Matplotlib Backend\n\nqtagg\n\n### Python version\n\n3.12\n\n### Jupyter version\n\n_No response_\n\n### Installation\n\npip","author":{"url":"https://github.com/Jeitan","@type":"Person","name":"Jeitan"},"datePublished":"2025-07-28T18:28:00.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":15},"url":"https://github.com/30365/matplotlib/issues/30365"}