PGF/TikZ Manual

# The TikZ and PGF Packages Manual for version 3.1.9a

## Libraries

#### 59 Matrix Library

• TikZ Library matrix

• \usetikzlibrary{matrix} % and plain
\usetikzlibrary[matrix] % Cont

This library package defines additional styles and options for creating matrices. The basic matrix styles and options can be found in Section 20.

##### 59.1 Matrices of Nodes¶

A matrix of nodes is a TikZ matrix in which each cell contains a node. In this case it is bothersome having to write \node{ at the beginning of each cell and }; at the end of each cell. The following key simplifies typesetting such matrices.

• /tikz/matrix of nodes(no value)

• Conceptually, this key adds \node{ at the beginning and }; at the end of each cell and sets the anchor of the node to base. Furthermore, it adds the option name option to each node, where the name is set to matrix name-row number-column number. For example, if the matrix has the name my matrix, then the node in the upper left cell will get the name my matrix-1-1.

You may wish to add options to certain nodes in the matrix. This can be achieved in three ways.

• 1. You can modify, say, the row 2 column 3 style to pass special options to this particular cell.

• 2. At the beginning of a cell, you can use a special syntax. If a cell starts with a vertical bar, then everything between this bar and the next bar is passed on to the node command.

You can also use an option like |[red] (seven)| to give a different name to the node.

Note that the & character also takes an optional argument, which is an extra column skip.

• 3. If your cell starts with a \path command or any command that expands to \path, which includes \draw, \node, \fill and others, the \node{ startup code and the }; code are suppressed. This means that for this particular cell you can provide totally different contents.

• /tikz/matrix of math nodes(no value)

• This style is almost the same as the previous style, only \$ is added at the beginning and at the end of each node, so math mode will be switched on in all nodes.

• /tikz/nodes in empty cells=true or false (default true)

• When set to true, a node (with empty contents) is put in empty cells. Normally, empty cells are just, well, empty. The style can be used together with both a matrix of nodes and a matrix of math nodes.

##### 59.2 End-of-Lines and End-of-Row Characters in Matrices of Nodes¶

Special care must be taken about the usage of the \\ command inside a matrix of nodes. The reason is that this character is overloaded in : On the one hand, it is used to denote the end of a line in normal text; on the other hand it is used to denote the end of a row in a matrix. Now, if a matrix contains node which in turn may have multiple lines, it is unclear which meaning of \\ should be used.

This problem arises only when you use the text width option of nodes. Suppose you write a line like

This leaves trying to riddle out how many rows this matrix should have. Do you want two rows with the upper right cell containing a two-line text. Or did you mean a three row matrix with the second row having only one cell?

Since is not clairvoyant, the following rules are used:

• 1. Inside a matrix, the \\ command, by default, signals the end of the row, not the end of a line in a cell.

• 2. However, there is an exception to this rule: If a cell starts with a -group (this is, with {), then inside this first group the \\ command retains the meaning of “end of line” character. Note that this special rule works only for the first group in a cell and this group must be at the beginning.

The net effect of these rules is the following: Normally, \\ is an end-of-row indicator; if you want to use it as an end-of-line indicator in a cell, just put the whole cell in curly braces. The following example illustrates the difference:

Note that this system is not fool-proof. If you write things like a&b{c\\d}\\ in a matrix of nodes, an error will result (because the second cell did not start with a brace, so \\ retained its normal meaning and, thus, the second cell contained the text b{c, which is not balanced with respect to the number of braces).

##### 59.3 Delimiters¶

Delimiters are parentheses or braces to the left and right of a formula or a matrix. The matrix library offers options for adding such delimiters to a matrix. However, delimiters can actually be added to any node that has the standard anchors north, south, north west and so on. In particular, you can add delimiters to any rectangle box. They are implemented by “measuring the height” of the node and then adding a delimiter of the correct size to the left or right using some after node magic.

• /tikz/left delimiter=delimiter(no default)

• This option can be given to a any node that has the standard anchors north, south and so on. The delimiter can be any delimiter that is acceptable to ’s \left command.

• /tikz/every delimiter(style, initially empty)

• This style is executed for every delimiter. You can use it to shift or color delimiters or do whatever.

• /tikz/every left delimiter(style, initially empty)

• This style is additionally executed for every left delimiter.

• /tikz/right delimiter=delimiter(no default)

• Works as above.

• /tikz/every right delimiter(style, initially empty)

• Works as above.

• /tikz/above delimiter=delimiter(no default)

• This option allows you to add a delimiter above the node. It is implemented by rotating a left delimiter.

• /tikz/every above delimiter(style, initially empty)

• Works as above.

• /tikz/below delimiter=delimiter(no default)

• Works as above.

• /tikz/every below delimiter(style, initially empty)

• Works as above.