captionscross-referencingsubfloats
So its a fairly simple question to a problem people normally experience. I have a rough idea of what to do, but I am looking for the correct way of doing things. So in the solution I will include what would be the bare minimum requirements I think would get this problem solved. I am looking for feedback and corrections though.
So please tell me, how does one go about creating subfigures within a figure. After that, caption it. Then label it for reference and then refer to it in the text?
You should write \protect\plotref{LAB} in your caption. I suppose that it is an expansion issue; your \plotref command is "fragile" in terms of LaTeX, and "fragile" commands need to be \protected inside of captions, section titles etc.
This doesn't support all the features of \subcaptionbox: the optional argument <inner-pos> can't be expressed.
The optional argument to the xsubcaption environment is the explicit width of the subfigure.
\documentclass{article}
\usepackage{caption}
\usepackage{subcaption}
\usepackage{environ}
\makeatletter
\environfinalcode{}
\NewEnviron{xsubcaption}[1][-1sp]
{\let\xsc@theoptcaption\@empty
\let\xsc@thecaption\@empty
\let\xsc@thelabel\@empty
\expandafter\xsc@checkcaption\BODY\caption\xsc@checkcaption
\expandafter\xsc@checklabel\BODY\label\xsc@checklabel
\begingroup\edef\x{\endgroup
\noexpand\subcaptionbox
\ifx\xsc@theoptcaption\@empty\else
[\unexpanded\expandafter{\xsc@theoptcaption}]%
\fi
{\unexpanded\expandafter{\xsc@thecaption}%
\ifx\xsc@thelabel\@empty\else
\noexpand\label{\unexpanded\expandafter{\xsc@thelabel}}%
\fi}
\ifdim#1=-1sp % no optional argument
\else
[#1]%
\fi
{\unexpanded{\renewcommand\caption[2][]{}\renewcommand{\label}[1]{}}%
\unexpanded\expandafter{\BODY}}}\x
}
\long\def\xsc@checkcaption#1\caption#2\xsc@checkcaption{%
\if\relax\detokenize{#2}\relax
\expandafter\@gobble
\else
\expandafter\@firstofone
\fi
{\expandafter\xsc@getcaption\BODY\xsc@getcaption}%
}
\long\def\xsc@getcaption#1\caption#2#3\xsc@getcaption{%
\if[\detokenize{#2}%
\expandafter\@firstoftwo
\else
\expandafter\@secondoftwo
\fi
{\expandafter\xsc@getcaptionopt\BODY\xsc@getcaptionopt}%
{\def\xsc@thecaption{#2}}%
}
\long\def\xsc@getcaptionopt#1\caption[#2]#3#4\xsc@getcaptionopt{%
\def\xsc@theoptcaption{#2}%
\def\xsc@thecaption{#3}%
}
\long\def\xsc@checklabel#1\label#2\xsc@checklabel{%
\if\relax\detokenize{#2}\relax
\expandafter\@gobble
\else
\expandafter\@firstofone
\fi
{\expandafter\xsc@getlabel\BODY\xsc@getlabel}%
}
\long\def\xsc@getlabel#1\label#2#3\xsc@getlabel{%
\def\xsc@thelabel{#2}%
}
\makeatother
\begin{document}
\begin{figure}
\centering
\begin{xsubcaption}
\centering
Subfigure1 is located here
\caption{Subfigure1 caption}\label{subfig:1}
\end{xsubcaption}
\begin{xsubcaption}
\centering
Subfigure2 is located here
\end{xsubcaption}
\begin{xsubcaption}[3cm]
\centering
Subfigure3 is located here
\caption[A]{BBB}
\end{xsubcaption}
\caption{Figure caption}
\label{fig}
\end{figure}
\ref{subfig:1} \ref{fig}
\end{document}
I use the environ package to collect the environment's body in the macro \BODY. Then I check whether \caption appears in the body; if so I check whether it has an optional argument. In caption (and the "list caption", if present) is stored in a macro and then the whole \subcaptionbox instruction is built from the various parts (when the body is typeset, \caption is redefined to do nothing).
(Added) The same checks are performed to catch a \label command outside the argument of \caption (both ways are supported, of course).
Finally the \subcaptionbox macro with all arguments determined with the code above is executed. It appears to be complicated, but it's not really difficult: it's a standard way to catch the presence of some token (\caption and \label) in a list of tokens, in this case the contents of the environment, which is available as the expansion of \BODY.
Best Answer
You can use the
subfigpackage for this. For a brief guide on how to use it, including captioning, labeling and referencing, have a look at the excellent LaTeX WikiBook section covering it.