What package should I use to typeset units?

As the author of siunitx I have some idea about the relative strengths of the various alternatives. There are various things that need to be done for units:

  • Semantic input of units, so \kilo\metre rather than km: this allows special effects such as reformatting fractions 'on the go' (some people prefer to use literal input, and this ideally needs to be supported too).
  • Formatting of numbers, for example dividing up digits into groups.
  • Correctly presenting awkward symbols such as the micro symbol.
  • Setting the font: many guidelines call for units to be in upright roman font with no bold or italic variation.
  • Keeping numbers and units together (no space breaking)

Many packages have been written to address one or other aspect of this question. For example, SIunits is good at providing semantic input, whereas SIstyle focusses on correct typesetting but leaves the input to the user. On the other hand, unitsdef sticks to doing only units and does not worry about other aspects.

The aim of the siunitx package is to cover all of the requirements above, and to provide a way that package behaviour can be altered. Thus it uses a series of key-value options that will change how the output is formatted. The options can be applied to the entire document or to an individual piece of input. It also is designed to work in either math or text mode equally well. I have also been very careful to provide up to date advice about the internationally-agreed units in the documentation of siunitx.

As a demo, using the latest release of siunitx the following all show off the package:

\documentclass{article}
\usepackage{siunitx}
\sisetup{load-configurations = abbreviations}
\begin{document}

\begin{itemize}
  \item \SI{100}{\degreeCelsius}
  \item \SI{3e5}{\km\per\s} or \SI[per-mode = symbol]{3e5}{\km\per\s}
  \item \si{\newton\metre\squared\per\kilogram\squared} or 
    \si[per-mode = symbol]{\newton\metre\squared\per\kilogram\squared}
  \item \(  \SI{10}{\kilo\hertz} = \SI{1}{\per\second\tothe{4}} \)
  \item \SI[parse-numbers = false]{\sin(x)}{\metre}
\end{itemize}

\end{document}

Example

There are a couple of notes to bear in mind if using siunitx. First, it requires e-TeX, which can be an issue with some publishers (even over 10 years after it was finalised!). Secondly, the formatting does take up some time. There are settings to turn things off but it's always the case that working by hand will ultimately be faster. However, the upside of clearer and more flexible input is in my opinion worth it.

One other point is that siunitx is under development, with bug fixes (for example one due to the above example) and new features (there is a long list for v2.1). In contrast, both SIunits and SIstyle are depreciated: bug fixes only. The units and unitsdef packages have not been updated for many years.


The siunitx package discusses each of the others you've listed, noting that it can emulate all of them. I haven't used it extensively, but in the experience I do have, it seems to work very well, and be very comprehensive. A quick scan through that manual should let you find examples matching each of the ones you've listed.

Thus I think that the short answer is: use siunitx.


I'd also recommend siunitx. As you know its author is very active in the TeX community and provides excellent support.

Tags:

Fonts

Units