[Tex/LaTex] cref table caption: works in body, not in lot

clevereftable of contents

I am using cleveref package. In one of my table, i'm refering to an equation in the text. The reference works fine (also hyperref) in the caption just below the table. Unfortunately it doesn't work in the list of tables and I get the traditional ?? in my pdf output together with the following warning:

LaTeX Warning: cref reference format for label type 'equation' undefined on in

Some piece of code (I hope sufficiently):

\documentclass[en,printlayout]{udesoftec}
\usepackage{cleveref}
\begin{document}
\frontmatter
\mainmatter
\part{Part1}
\begin{align}
\label{eq:CDF}
        D_{fit}(x) =& \sum_{i=1}^{N-1} \frac{1}{2}K_i\left(1+erf(\frac{x-m_i}{\sqrt{2}\sigma_i})\right)\nonumber \\
         &+  \frac{1}{2}(1-\sum_{i=1}^{N-1}K_i)\left(1+erf(\frac{x-m_N}{\sqrt{2}\sigma_N})\right)
\end{align}

\part{Part2}
\begin{table}[htbp]
\begin{tabular*}{\hsize}{@{\extracolsep{\stretch{1}}} c  c  c  c }
    \hline
\rule{0pt}{3ex} $i$ & $K $& $m$ & $\sigma$  \\
    \end{tabular*}
    \caption{$i$, $K$, $m$ and $\sigma$ correspond to the parameters in  \cref{eq:CDF}}
    \label{tab:myTab}
\end{table}
\end{document}

The class can be found on CTAN: http://www.ctan.org/pkg/udesoftec

I have already tried to delete the .lot file and compile twice without success. Any idea?

Thanks

Best Answer

The diagnosis by Jean-Sébastien Gosselin is correct: the udesoftec class abuses \AtBeginDocument for typesetting material, which is not a good thing to do, see this answer by Heiko Oberdiek

The problem is that cleveref has to defer several of its tricks at begin document, but these will happen after some material has already been typeset, in particular the list of tables.

Fortunately there is a hook that can be used to transfer the material erroneously executed at begin document to \AfterEndPreamble, as suggested by Heiko. The maintainers of the class should be made aware of the problem.

I also fixed the equation, please look at it: the correct environment to use is multline and several small adjustments are also necessary; the main one is defining an operator for the error function.

\documentclass[en,printlayout]{udesoftec}
\usepackage{etoolbox}
\usepackage{cleveref}

\DeclareMathOperator{\erf}{erf}

%%% the hack!
\def\udesoftecoverride#1\mainmatter{%
  \AfterEndPreamble{#1\mainmatter}%
}
%%%

\begin{document}
\frontmatter
\mainmatter
\part{Part1}
\begin{multline}
\label{eq:CDF}
D_{\mathrm{fit}}(x) = 
  \sum_{i=1}^{N-1} 
    \frac{1}{2}K_i
    \left(1+\erf\Bigl(\frac{x-m_i}{\sqrt{2}\,\sigma_i}\Bigr)\right) \\
  + \frac{1}{2}\biggl(1-\sum_{i=1}^{N-1}K_i\biggr)
    \left(1+\erf\Bigl(\frac{x-m_N}{\sqrt{2}\,\sigma_N}\Bigr)\right)
\end{multline}

\part{Part2}
\begin{table}[htbp]
\begin{tabular*}{\hsize}{@{\extracolsep{\stretch{1}}} c  c  c  c }
    \hline
\rule{0pt}{3ex} $i$ & $K $& $m$ & $\sigma$  \\
    \end{tabular*}
    \caption{$i$, $K$, $m$ and $\sigma$ correspond to the parameters in  \cref{eq:CDF}}
    \label{tab:myTab}
\end{table}
\end{document}

enter image description here

The fixed equation

enter image description here

Related Solutions

[Tex/LaTex] \cref does not work for Section in emulateapj.cls

After spending half a day digging through the sources, I think I may have discovered the cause of this problem.

All LaTeX \section commands contain the macro \refstepcounter, which is responsible for updating section counters. It is redefined by cleveref to store additional information about the current section in \cref@currentlabel. This information is later written out by a redefined \label command to the .aux file. If we now look at the redefinition of \@sect (renamed to \H@old@sect by hyperref) in emulateapj.cls, we find that \refstepcounter is now enclosed between a pair of \begingroup and \endgroup, so all changes to \cref@currentlabel are lost upon exiting the group. A kludge is to make the assignment inside the group global.

We illustrate by the following example:

\documentclass{emulateapj}
\usepackage{hyperref,cleveref}

% patch
\makeatletter
\usepackage{etoolbox}
\patchcmd\H@refstepcounter{\protected@edef}{\protected@xdef}{}{}
\makeatother

\begin{document}
\section{This}\label{this}\cref{that}
\section{That}\label{that}\cref{this}
\end{document}

If we were to typeset the document without the patch, we would find the following lines in the .aux file:

\newlabel{this}{{1}{2}{This}{section.1}{}}
\newlabel{this@cref}{{}{2}}
...
\newlabel{that}{{2}{3}{That}{section.2}{}}
\newlabel{that@cref}{{}{3}}

This is the section information written out by \label; clearly something is missing between the empty braces in the second and fourth lines. With the patch in place, we get instead:

\newlabel{this}{{1}{2}{This}{section.1}{}}
\newlabel{this@cref}{{[section][1][]1}{2}}
...
\newlabel{that}{{2}{3}{That}{section.2}{}}
\newlabel{that@cref}{{[section][2][]2}{3}}

The information is now present, and section references work as well.

[Tex/LaTex] List of equations, including equation contents and caption

Since you want a cheat sheet, I'd recommend the extract package. With a slightly different MWE:

\documentclass{article}
\usepackage[
  active,
  header=false,
  copydocumentclass=true,
  generate=\jobname-Cheatsheet,
  extract-env={equation},
  extract-cmdline={synopsis},
  ]{extract} % http://ctan.org/pkg/extract
\begin{extract*}
% Items executed in both the main and extracted document
% (extract manual, section 5.1)
\usepackage{amsmath}
\end{extract*}
\begin{extract}
% Items executed only in extracted document
\def\synopsis#1{#1}
\end{extract}
\def\synopsis#1{}
\begin{document}
First Euler observed that
\synopsis{Euler's equation tying together the five fundamental constants of mathematics}%
\begin{equation}
1 + e^{i \Pi} = 0.
\end{equation}

Then, Gauss discovered the normal distribution:
\synopsis{Normal distribution}%
\begin{equation}
P(x) = \frac{1}{{\sigma \sqrt {2\pi } }}e^{{{ - \left( {x - \mu } \right)^2 } \mathord{\left/ {\vphantom {{ - \left( {x - \mu } \right)^2 } {2\sigma ^2 }}} \right. \kern-\nulldelimiterspace} {2\sigma ^2 }}}
\end{equation}

Finally, Einstein proclaimed: 
\synopsis{Equivalence of mass and energy}%
\begin{equation}
E = m C^2
\end{equation}
\end{document}

you get an original document of:

enter image description here

and an extracted document of:

\documentclass{article}
% Items executed in both the main and extracted document
% (extract manual, section 5.1)
\usepackage{amsmath}
% Items executed only in extracted document
\def\synopsis#1{#1}

\begin{document}

\synopsis{Euler's equation tying together the five fundamental constants of mathematics}%

\begin{equation}
1 + e^{i \Pi} = 0.
\end{equation}

\synopsis{Normal distribution}%

\begin{equation}
P(x) = \frac{1}{{\sigma \sqrt {2\pi } }}e^{{{ - \left( {x - \mu } \right)^2 } \mathord{\left/ {\vphantom {{ - \left( {x - \mu } \right)^2 } {2\sigma ^2 }}} \right. \kern-\nulldelimiterspace} {2\sigma ^2 }}}
\end{equation}

\synopsis{Equivalence of mass and energy}%

\begin{equation}
E = m C^2
\end{equation}

\end{document}

and:

enter image description here

This also works with your original \caption command.

Best Answer

The fixed equation

Related Solutions

[Tex/LaTex] \cref does not work for Section in emulateapj.cls

[Tex/LaTex] List of equations, including equation contents and caption

Related Question