# Directory `macros/latex/contrib/siunitx`

# siunitx - A comprehensive (SI) units package

Physical quantities have both numbers and units, and each physical quantity should be expressed as the product of a number and a unit. Typesetting physical quantities requires care to ensure that the combined mathematical meaning of the number-unit combination is clear. In particular, the SI units system lays down a consistent set of units with rules on how these are to be used. However, different countries and publishers have differing conventions on the exact appearance of numbers (and units). The `siunitx`

package provides a set of tools for authors to typeset quantities in a consistent way. The package has an extended set of configuration options which make it possible to follow varying typographic conventions with the same input syntax. The package includes automated processing of numbers and units, and the ability to control tabular alignment of numbers.

## Installation

The package is supplied in `dtx`

format and as a pre-extracted zip file, `siunitx.tds.zip`

. The later is most convenient for most users: simply unzip this in your local texmf directory . If you want to unpack the `.dtx`

yourself, running `tex`

siunitx.dtx` will extract the package whereas `

latex siunitx.dtx` will extract it and also typeset the documentation.`

The package requires LaTeX3 support as provided in the `l3kernel`

and `l3packages`

bundles. Both of these are available on CTAN as ready-to-install zip files. Suitable versions are available in MiKTeX 2.9 and TeX Live 2015 (updating the relevant packages online may be necessary). LaTeX3, and so `siunitx`

, requires the ε-TeX extensions: these are available on all modern TeX systems.

Typesetting the documentation requires a number of packages in addition to those needed to use the package. This is mainly because of the number of demonstration items included in the text. To compile the documentation without error, you will need the packages:

`amsmath`

`booktabs`

`cancel`

`caption`

`cleveref`

`colortbl`

`csquotes`

`datatool`

`helvet`

`mathpazo`

`multirow`

`listings`

`pgfplots`

`xcolor`

Download the contents of this package in one zip archive (707.5k).

## siunitx – A comprehensive (SI) units package

Typesetting values with units requires care to ensure that the combined mathematical meaning of the value plus unit combination is clear. In particular, the SI units system lays down a consistent set of units with rules on how they are to be used. However, different countries and publishers have differing conventions on the exact appearance of numbers (and units). A number of LaTeX packages have been developed to provide consistent application of the various rules: SIunits, sistyle, unitsdef and units are the leading examples. The numprint package provides a large number of number-related functions, while dcolumn and rccol provide tools for typesetting tabular numbers.

The siunitx package takes the best from the existing packages, and adds new features and a consistent interface. A number of new ideas have been incorporated, to fill gaps in the existing provision. The package also provides backward-compatibility with SIunits, sistyle, unitsdef and units. The aim is to have one package to handle all of the possible unit-related needs of LaTeX users.

The package relies on LaTeX 3 support from the l3kernel and l3packages bundles.

Package | siunitx |

Home page | https://www.texdev.net |

Bug tracker | https://github.com/josephwright/siunitx/issues |

Repository | https://github.com/josephwright/siunitx |

Version | 2.7k 2017-11-26 |

Licenses | The LaTeX Project Public License 1.3c |

Copyright | 2008–2017 Joseph Wright |

Maintainer | Joseph Wright |

TDS archive | `siunitx.tds.zip` |

Contained in | TeX Live as siunitx MiKTeX as siunitx |

Topics | Scientific docs Units |