René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Whitespace in mathtext is too large and inconsistent with LaTeX","articleBody":"Hi matplotlib developers,\n\nAs a user quite familiar with LaTeX, I am constantly frustrated with the display size of the whitespace commands in matplotlib's mathtext mode with `'text.usetex':False`.  The matplotlib mathtext spacing commands are much larger than their LaTeX equivalents.  Here is a minimal working example:\n\n``` python\nimport matplotlib as mpl\nimport matplotlib.pyplot as plt\nmpl.rcParams.update({\n    'text.usetex':False,\n    'font.family':'sans-serif',\n    'font.sans-serif':['DejaVu Sans'], # Needs a true unicode font\n    'mathtext.default':'regular',\n    })\n\ndef M(space):\n    return \"${0}$          '{1}'\\n\".format(space.join(8*['M']),space)\n\ntext = (\n    M(r'\\! ')+\n    M(r'')+\n    M(r'\\hspace{0.1} ')+\n    M(r'\\, ')+\n    M(r'\\thinspace ')+\n    M(r'\\/ ')+\n    M(r'\\; ')+\n    M(r'\\ ')+\n    M(r'\\enspace ')+\n    M(r'\\quad ')+                         \n    M(r'\\qquad ')\n    )\n\nplt.figure(figsize=(8,3))\nplt.axis('off')\nplt.text(0,1,text,va='top')\nplt.show()\n```\n\n![mpl_spacing_bug](https://cloud.githubusercontent.com/assets/8595627/7131533/78783c66-e24e-11e4-8f90-fe874af8b288.png)\n\nTested with matplotlib 1.4.3, python 2.7 on Windows 7 and Linux.\nThe `\\thinspace` command and the `\\enspace` command are handled as Unicode characters, so this requires a true Unicode font, such as \"DejaVu Sans\", not the builtin default \"Bitstream Vera Sans\".\n\nIn the example shown above, the spacing between the series of \"M\" characters is much much bigger than expected for the commands `\\,` and `\\;` and `\\quad` and `\\qquad`.  Also, the spacing should be monotonically increasing from top to bottom, but it clearly does not.\nFor instance, in LaTeX, the `\\,` command is equivalent to `\\thinspace`, and should be 0.16667em wide, but in matplotlib, `\\,` is not thin at all, and is much larger than `\\thinspace`.  This means that `\\,` is useless when one wants to create a truly-thin space in math mode.\nSimilarly, `\\;` should be much smaller than `\\enspace`.\n\n@mdboom  After poking around in the source code, I discovered that the default values of these mathtext lengths are defined in \"mathtext.py\" by this dictionary:\n\n``` python\n    _space_widths = { r'\\ '      : 0.3,\n                      r'\\,'      : 0.4,\n                      r'\\;'      : 0.8,\n                      r'\\quad'   : 1.6,\n                      r'\\qquad'  : 3.2,\n                      r'\\!'      : -0.4,\n                      r'\\/'      : 0.4 }\n```\n\nwhere the dictionary values are the fractional width of the font (in \"em\" units).\nI don't know where these numbers came from, but they are very different than the LaTeX specification, which can be found here:\nhttp://tex.stackexchange.com/a/74354\nor if you can find a copy of the \"TeXbook\" by Donald Knuth himself, or there are probably many other source on the web.\n\nI propose to change this dictionary to the same values used by LaTeX:\n\n``` python\n    _space_widths = { r'\\,'         : 0.16667,  # 3/18 em = 3 mu\n                      r'\\thinspace' : 0.16667,  # 3/18 em = 3 mu\n                      r'\\/'         : 0.16667,  # 3/18 em = 3 mu\n                      r'\\\u003e'         : 0.22222,  # 4/18 em = 4 mu\n                      r'\\:'         : 0.22222,  # 4/18 em = 4 mu\n                      r'\\;'         : 0.27778,  # 5/18 em = 5 mu\n                      r'\\ '         : 0.33333,  # 6/18 em = 6 mu\n                      r'\\enspace'   : 0.5,      # 9/18 em = 9 mu\n                      r'\\quad'      : 1,        # 1 em = 18 mu\n                      r'\\qquad'     : 2,        # 2 em = 36 mu\n                      r'\\!'         : -0.16667, # -3/18 em = -3 mu\n                      } \n```\n\nAnd while, we are at it, we can add the LaTeX commands for `\\\u003e` and `\\:`, and we can remove the Unicode dependency for `\\thinspace` and `\\enspace` by adding definitions to this dictionary.\n(I don't think `\\/` is normally used by LaTeX in math mode, but in earlier versions of matplotlib it was defined to be equal to `0.1`em, so it was originally intended to be a thin space.)\nAfter making this change, the spacing behaves as expected:\n\n![mpl_spacing_bug2](https://cloud.githubusercontent.com/assets/8595627/7131549/9f85911e-e24e-11e4-8c37-774dcfa0b86e.png)\n\nHowever, I realize that this is a backwards incompatible change that will affect users out in the wild, but I think that it is worth the change to more sensible defaults, as long as it is well documented.\nI imagine that lots of people, besides myself, expect matplotlib's mathtext to behave like LaTeX.\n\nToday I discovered the undocumented `\\hspace{float}` command in matplotlib's mathtext, that is similar to the LaTeX command by the same name (except that lengths in LaTeX have units).  This provides a temporary workaround for me, but is annoying to have to use for such a common task as creating a thin space in math mode.\n\nThanks for the consideration.\n","author":{"url":"https://github.com/u55","@type":"Person","name":"u55"},"datePublished":"2015-04-14T07:26:54.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":4},"url":"https://github.com/4335/matplotlib/issues/4335"}