TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Annotated equations for increased readability and understanding of papers

192 pointsby visvivaover 3 years ago

22 comments

nitrogenover 3 years ago
From comments here it sounds like people already deeply familiar with the mathematical notation used in a domain really want to stick with the compact, black-ink-only equation representation. However, as an engineer who occasionally wants to translate papers from a mathematical field I rarely encounter into code I will use all the time, annotations like this would greatly increase the utility I could derive from a paper in a given amount of time.<p>Also, as yunruse mentioned in [0], and as I have done in my own videos that include math, syntax highlighting for math is very useful for absorbing new math. How acceptable would that be to practitioners already deep in their fields?<p>So, could annotations of this form be acceptable to both groups if they were switchable on or off in an online version of a paper?<p>[0] <a href="https:&#x2F;&#x2F;news.ycombinator.com&#x2F;item?id=29899938" rel="nofollow">https:&#x2F;&#x2F;news.ycombinator.com&#x2F;item?id=29899938</a>
评论 #29902984 未加载
评论 #29901721 未加载
评论 #29903875 未加载
评论 #29904106 未加载
orforforofover 3 years ago
For many of the papers I read (engineering) I would love to be able to click on symbols in an equation and have it link me back to where that term was first defined in the paper, either in another eqn or in the text. Tracing back in this way is a major pain point e.g. when trying to reproduce calculations. Seems like something journals&#x2F;latex could easily implement in an automated fashion (maybe already possible?)
评论 #29902989 未加载
yunruseover 3 years ago
Tangentially, one of the things I always enjoyed seeing in the wild was semantic colouring in equations. The educational YouTuber 3Blue1Brown [0] and to some extent the maths side of YouTube in general tend to make use of them, colouring like terms the same to give a subtle visual aid, similar to pretty printing.<p>[0] <a href="https:&#x2F;&#x2F;youtube.com&#x2F;3blue1brown" rel="nofollow">https:&#x2F;&#x2F;youtube.com&#x2F;3blue1brown</a>
mbokinalaover 3 years ago
I definitely see value in this, but it&#x27;s currently too much of a hassle to use. It requires lots of tedious code duplication and requires the user to manually set positions and lengths for the arrows and annotations, defeating the purpose of allowing writers to focus solely on the content of their work. However, this would be a great thing to try to encapsulate in a package.
VladimirGolovinover 3 years ago
I was reading Russian political Telrgram earlier today, and one of the better channels (&quot;Толкователь&quot;) had a post about a scientific study on why people prefer conspiracy theories over scientific information.<p>The study&#x27;s summary says that this is because conspiracy theories are communicated in a language that is understandable, while scientific communication uses language that is opaque for most people.<p>Which leads me to the conclusion that any effort towards making scientific communication more understandable to general public -- including the annotated equations -- is a good thing.
评论 #29916178 未加载
muth02446over 3 years ago
Mathematics seems to be obsessed with one-liners<p>Single letter variable names (often from different alphabets) and complex expressions that should be broken down would never make it through a code review ;-)
评论 #29900778 未加载
评论 #29900590 未加载
评论 #29900766 未加载
评论 #29900791 未加载
评论 #29902141 未加载
评论 #29904232 未加载
评论 #29900580 未加载
评论 #29901450 未加载
评论 #29902198 未加载
评论 #29900977 未加载
selwyniiover 3 years ago
While I like the annotations, I have to say they make it difficult to make out the original equation. It parses and highlights variables and gets in the way of seeing a cohesive whole equation.<p>I think an annotated version would be good as a supplement.
评论 #29900012 未加载
rq1over 3 years ago
I was skeptical when I clicked but that’s actually amazing.<p>It will eventually allow us to make even more complex constructs.
评论 #29901671 未加载
blauditoreover 3 years ago
I always wondered why no one is doing syntax (or, semantical) coloring&#x2F;highlighting for stuff like mathematics or sheet music. It could even help with simple plain text.<p>The reason is probably that &quot;it&#x27;s always been like that&quot;, just like keyboard layouts. Though one could argue that coloring would be not be very disruptive and backwards-compatible, so it wouldn&#x27;t hurt traditional reading much.
评论 #29906363 未加载
afthonosover 3 years ago
Rendering the different symbols in different colors might be enough, as long as those colors are used in the text defining the symbols. Used sparingly (i.e. only for the symbols that are relevant to the argument), it can greatly enhance readability.<p>I feel like these annotations go slightly overboard; the entire equation&#x2F;annotation construct is visually pleasing, but hard to parse.
yummypaintover 3 years ago
Seeing this presented for use in papers is a very good thing. These annotations look alot like slides many people make (sometimes showing relations between multiple equations, etc). However, much of this readability is customarily stripped out for the sake of uniformity. I think most journals im familiar with enforce specific formatting for equations.
_Nat_over 3 years ago
Definitely something that could be nice in an active-document.<p>By analogy, Wikipedia articles have a feature where, if you mouse-over a link, it&#x27;ll display a preview of the link-target (<a href="https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;Wikipedia:Tools&#x2F;Navigation_popups" rel="nofollow">https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;Wikipedia:Tools&#x2F;Navigation_pop...</a> ). This can be an efficient way for a reader to conveniently glance at the definition of a term while reading.<p>Mathematical notation varies significantly between fields, and many papers define custom symbols with their own paper-specific definitions. So this sort of feature isn&#x27;t just something for math-newbies, but rather something that could significantly benefit experts too.<p>The same sort of annotations might be more situational in non-active documents, where there&#x27;d be more of a trade-off between helpful-annotations and clutter.
blippageover 3 years ago
TBH, I don&#x27;t think the annotations add anything. You can simply write<p>&quot; Lap(x | mu, b) = ...<p>where b&gt;0, a scalar parameter. &quot;<p>What is needed is some better way to motivate the concepts behind any maths that is confusing for people who might be confused.
avnigoover 3 years ago
Here are the examples in long-form rather than a tweet:<p><a href="https:&#x2F;&#x2F;github.com&#x2F;synercys&#x2F;annotated_latex_equations" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;synercys&#x2F;annotated_latex_equations</a>
choegerover 3 years ago
Finally! This is super useful! I wanted to do stuff like this ten years ago for small code samples but didn&#x27;t get very far with TikZ. Doing it for equations is even more complicated to get into a pleasent shape, I guess.
评论 #29901882 未加载
tpoacherover 3 years ago
On one hand I like this, and have used similar visuals in presentations, on the other hand I feel it&#x27;s a less a problem related to math literacy per se, and more needing a workaround relating to the artificial limits and style restrictions imposed by journals (as well as the limitations of a paper medium, to some extent).<p>The whole &quot;pay £1000 per extra page&quot; by itself has been enough to reluctantly cause me to cram math inline and assume symbols are known to the field without too much explanation.
riffraffover 3 years ago
I understand math is optimized for writing, but honestly I&#x27;ve always felt it would be better if we just used long variable names instead of single letters.
评论 #29903562 未加载
评论 #29903626 未加载
glorifyingover 3 years ago
I’m not sure I understand what the point of this is.<p>If I’m reading academic papers on a particular topic then I already know the notation the math is written in.<p>If I’m reading a paper outside of my field then I’m not really interested in the details of the equation but more of its application and what it means.
评论 #29901408 未加载
评论 #29901452 未加载
评论 #29902162 未加载
jesprenjover 3 years ago
It would be very good to include this in a future release of TeXLive.
评论 #29900553 未加载
contravariantover 3 years ago
I don&#x27;t think I like this as a replacement for simply defining terms in the text. You could do both but something like &quot;S a subset of Range(X)&quot; when the equation is about the probability that X is in S doesn&#x27;t seem important enough to take that prominent a position in the equation.<p>I can see this style of annotation it being helpful when you need to add some context or want to explain a pre-existing formula.<p>And I can definitely see this being used to highlight key ideas during a tricky derivation, stuff like partial integration could be a lot neater if you can point out the part of the equation that you&#x27;re partially integrating.
cinntaileover 3 years ago
I want the explanations but without the highlighting. I get why it&#x27;s highlighted but personally I find it distracting.
wolfi1over 3 years ago
why not link directly to the github repo? but that aside, it&#x27;s quite neat
评论 #29906388 未加载