1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
|
# Annotate equations in LaTeX using TikZ
This package provides commands that make it easy to highlight terms in equations & add annotation labels (based on TikZ).
Should work with pdflatex as well as lualatex.
Inspired by Sibin Mohan's https://github.com/synercys/annotated_latex_equations/
Please report any bugs, issues, contribute changes & improvements on https://github.com/st--/annotate-equations/ :)
Package author: ST John, http://www.infinitecuriosity.org/
License: [MIT](LICENSE)
[Documentation](annotate-equations.pdf)
## A package with reusable commands

Using [`annotate-equations.sty`](https://github.com/st--/annotate-equations/blob/main/annotate-equations.sty), an equation can easily be annotated as follows:
```latex
\begin{equation*}
\mathcal{O}\big(
(
\eqnmarkbox[NavyBlue]{p1}{p}
\eqnmarkbox[OliveGreen]{k1}{\kappa}^3 % note that we have the ^3 outside the \eqnmark/\tikzmarknode arguments
)
\eqnmarkbox[WildStrawberry]{T1}{T}
+
(
\eqnmarkbox[NavyBlue]{p2}{p} % tikz nodes need distinct names!
\eqnmark[OliveGreen]{k2}{\kappa}
)
(
\eqnmarkbox[WildStrawberry]{T2}{T}^2
\tikzmarknode{Is}{|\mathcal{I}^*|} % manual \tikzmarknode works, too
\eqnmarkbox[Plum]{Nb}{N_b}
\eqnmark[RoyalPurple]{M}{M}
)
\big)
\end{equation*}
\annotatetwo[yshift=1em]{above}{p1}{p2}{\# of nodes}
\annotatetwo[yshift=-1em,xshift=0.2ex]{below}{T1}{T2}{\# of graphs in $\hat{\mathcal{G}}_T$}
\annotatetwo[yshift=-2em]{below}{k1}{k2}{max.\ indegree in $\hat{\mathcal{G}}_T$}
\annotate[yshift=3em]{above,left}{Is}{size of set of allowed interventions}
\annotate[yshift=1em]{above}{Nb}{\# of samples per batch}
\annotate[yshift=-1em]{below}{M}{\# of samples for $\mathbb{E}_y$}
```
More details are in the [user manual](annotate-equations.pdf).
Should work with both pdflatex and lualatex.
## How to do it from scratch: annotated examples

Inspired by Sibin Mohan's https://github.com/synercys/annotated_latex_equations/, but with significantly simplified TikZ code, and with lots of comments to explain what is going on.
Two versions, one [as Beamer slides with transitions](https://github.com/st--/annotate-equations/blob/main/examples/demo_manual_annotate_beamer.tex), one [as an article](https://github.com/st--/annotate-equations/blob/main/examples/demo_manual_annotate_article.tex). For further examples, see https://github.com/synercys/annotated_latex_equations/.
### Giving all highlight boxes the same height
Simply add a `\mathstrut` within the colorbox:
```diff
-\newcommand{\highlight}[2]{\colorbox{#1!17}{$#2$}}
+\newcommand{\highlight}[2]{\colorbox{#1!17}{$\mathstrut #2$}}
```

## Much more information...
...in the answers to [this TeX StackExchange question](https://tex.stackexchange.com/q/254844/171664).
|