Scribd
Upload
39 views2 pages

Threeparttable Package Overview

The threeparttable package facilitates tables with captions and notes. It allows the caption and notes to be the same width as the table. The package contains a threeparttable environment that holds the caption and tabular environment, along with optional tablenotes. Various options are available to customize the formatting of the notes. Configuration commands like \TPTminimum and \TPTtagStyle can also be redefined. The package provides similar functionality for figures using a measuredfigure environment.

Uploaded by

ruben alejandro Teran
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
39 views2 pages

Threeparttable Package Overview

The threeparttable package facilitates tables with captions and notes. It allows the caption and notes to be the same width as the table. The package contains a threeparttable environment that holds the caption and tabular environment, along with optional tablenotes. Various options are available to customize the formatting of the notes. Configuration commands like \TPTminimum and \TPTtagStyle can also be redefined. The package provides similar functionality for figures using a measuredfigure environment.

Uploaded by

ruben alejandro Teran
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd

The threeparttable package∗

Donald Arseneau†
March 5, 2010

1 Outline
This package facilitates tables with titles (captions) and notes. The title and
notes are given a width equal to the body of the table (a tabular environment).
By itself, a threeparttable does not float, but you can put it in a table or
a table* or some other floating environment. (This causes extra typing, but
gives more flexibility.)
Inside a threeparttable there should be a caption, followed by a tabular
environment (tabular, tabular*, tabularx or the like), possibly followed by
a series of itemized tablenotes. (The caption may also go after the tabular
environment.)
For example:
\begin{table}
\begin{threeparttable}[b]
\caption{...}
\begin{tabular}...% or {tabular*}
...42\tnote{1}&.... ...
\end{tabular}
\begin{tablenotes}
\item [1] the first note ...
\end{tablenotes}
\end{threeparttable}
\end{table}
The threeparttable environment takes an optional vertical-placement param-
eter, [t], [b], or [c]; the default is [t].
There is nothing automatic about the notes; you must specify the identifier
in the body of the table (“\tnote{a}”) and in the notes below the table (“\item
[a]...”). The author chose this method because automatic numbering with
\footnote would be very hard to use, particularly because many tables make
repeated reference to a single note1 . \tnote commands may be given in the
caption too, and they will not appear in the list of tables.
There are several commands which should be redefined for customizing the
behaviour of threeparttable, especially the table notes. Some options are pro-
vided for common variations of the table notes:
∗ This documentation covers version 3.0 of the package, dated 2006-06-13
† Documentation put together by Robin Fairbairns
1 If someone has a convenient, elegant, automatic system, the author promises to listen!

1
para Notes come one-after-another without line breaks
flushleft No hanging indentation on notes

online \item tag is printed normal size, not superscript


normal restores default formatting
These options can be given to the \usepackage command or to each individual
tablenotes environment. The [normal] option is intended to reverse the whole-
document options for a particular table; e.g.
\usepackage[para]{threeparttable}
... document rambles on ...
\begin{tablenotes}[normal,flushleft]
These few options will not give you every format you might want, so you may find
that you need to redefine one or more of the configuration commands. Note that
mixing options with redefinitions is unlikely to work smoothly: Please submit
your redefinitions to be used as options in future versions!
Configuration commands:
• \TPTminimum: command givining minimum caption width. Default 4em;
change with \def or \renewcommand.
• \TPTrlap: A command with one argument, to make notes go out of the
column, into the column separation (for right-aligning)
• \TPTtagStyle: Command with one argument to set appearance of the
tag (number) in \tnote{tag}. It defaults to nil. It could be \textit.
• \tnote: Yes, you can redefine the \tnote command.
• \TPTnoteLabel: Command with one argument to format the item label
in the tablenotes list (\makelabel); default uses \tnote.

• \TPTnoteSettings: A command to issue all the list-environment setup


commands for the tablenotes.
• \tablenotes or \TPTdoTablenotes: Yes, you can redefine the whole
tablenotes environment. (\tablenotes processes optional parameters,
then invokes \TPTdoTablenotes; the [para] option replaces \TPTdoTablenotes).

For figures, there is an equivalent measuredfigure environment. It is fairly


fragile though, and should be used only for a single graphic above a single
caption.
Note that the \caption formatting is not adjusted by threeparttable. You
should use one of the caption-control packages to get captions that work well as
table titles. In truth, threeparttable sets \abovecaptionskip to zero for captions
above the table, but more complete changes are called for.

Common questions

Powered by AI

The \TPTnoteSettings command is used to issue all the list-environment setup commands for the tablenotes. It plays a critical role in setting up the environment where notes are processed. This is important for ensuring that the formatting of table notes is consistent and aligns with the document's styling preferences, allowing for adequate customization and control over how notes are presented in the final document .

The 'threeparttable' package allows modification of table notes through several commands to redefine their behavior and appearance. For instance, \TPTtagStyle can be set to alter the appearance of tags, and \TPTnoteLabel can format item labels in the tablenotes list. This customization is necessary to adapt the notes to fit the design and stylistic needs of the document, as not all formats may be supported out-of-the-box and documents may have differing aesthetic requirements .

When redefining configuration commands in the 'threeparttable' package, it is essential to ensure that such redefinitions do not conflict with options provided for common variations. Combining options with redefinitions can lead to unpredictable behavior or formatting issues. Users should carefully test their custom commands and consider submitting them for integration into future package versions to enhance compatibility and avoid interference with existing commands or options .

The 'threeparttable' package facilitates the addition of titles (captions) and notes to tables with a consistent width equal to the body of the table. This package helps in organizing the layout when tables contain multiple notes that need reference within the tabular environment. It allows for table notes to be specified manually, providing flexibility particularly in cases where repeated reference is made to a single note, which would be difficult with automatic systems like \footnote .

Allowing table notes to be manually specified provides greater flexibility and control, especially in cases where notes need repeated referencing within the same table. Automatic numbering could complicate such repeated references, leading to confusion or errors. This manual approach is particularly beneficial when the same note applies to multiple entries, ensuring clarity and precision in note identification .

The lack of adjustment in \caption formatting by the 'threeparttable' package implies that users must manually handle caption appearance, potentially leading to inconsistencies if not managed carefully. The document suggests using a dedicated caption-control package to ensure captions work well as table titles and to make more comprehensive changes beyond setting \abovecaptionskip to zero .

The optional vertical-placement parameter in a 'threeparttable' determines the alignment of the table within its enclosing environment. It can take the values [t], [b], or [c], corresponding to top, bottom, or center alignment, respectively. This allows the user to control where the table appears in the resulting document, providing greater flexibility in its layout .

The 'threeparttable' does not float by itself, which means it needs to be used within a floating environment like 'table' or 'table*' to achieve floating. This results in extra typing but provides more control and flexibility over the placement of tables in a document. This limitation can be addressed by embedding the 'threeparttable' in these environments to control its positioning effectively within the text .

The 'measuredfigure' environment in the 'threeparttable' package is intended for use when a single graphic is to be placed above a single caption, allowing for precise control over the dimensions and measurement of figures. Its limitations include fragility, as its use is restricted to such specific configurations and it may not handle more complex figure layouts without issues. This makes it less versatile compared to other figure environments .

The 'threeparttable' package provides the \TPTrlap command to manage the overlap of long table notes by allowing them to extend out of the table column and into the column separation area. This feature is useful for maintaining a clean and organized appearance, preventing the notes from forcing unwanted line breaks or disrupting the overall table formatting .

You might also like