Diagramas comutativos

Setas e rótulos do tikz-cd sem uma sopa de coordenadas.

Diagramas comutativos

Um diagrama comutativo é uma grade de objetos ligados por setas rotuladas, a imagem padrão em teoria das categorias, álgebra e topologia. O TikZ puro consegue desenhar um, mas posicionar cada nó por coordenadas é lento e frágil. O pacote tikz-cd envolve o TikZ numa sintaxe parecida com a de uma matriz: você dispõe os objetos como numa tabela e descreve cada seta pela direção.

\usepackage{tikz-cd}
\begin{tikzcd}
A \arrow[r,"f"] \arrow[d,"g"'] & B \arrow[d,"h"] \\
C \arrow[r,"k"'] & D
\end{tikzcd}

Lendo a sintaxe

A grade funciona como uma matriz: & separa colunas e \\ separa linhas, então este diagrama tem A e B na linha de cima e C e D na de baixo. Cada \arrow[...] pertence à célula em que foi escrito e aponta para fora dela. A primeira opção é a direção, escrita com as letras r, l, u e d: \arrow[r] vai uma célula para a direita, \arrow[d] uma célula para baixo. As letras se combinam e se repetem para formar diagonais e alcances maiores, então rd é um passo na diagonal para baixo e à direita e rr cobre duas colunas.

Um rótulo entre aspas acompanha a seta. Por padrão ele fica de um lado; um apóstrofo depois da aspa de fechamento, como em "g"', o passa para o outro lado. No exemplo, os apóstrofos mantêm os quatro rótulos do lado de fora do quadrado, que é o arranjo limpo usual.

Mais opções de seta

Outras opções se empilham depois da direção e do rótulo para mudar o estilo da seta. hook curva a cauda numa seta de inclusão, two heads dobra a ponta para indicar uma sobrejeção, dashed marca um morfismo que você está afirmando, e não pressupondo, e Rightarrow produz a seta de haste dupla usada para transformações naturais. Uma seta típica de propriedade universal se escreve \arrow[rd, dashed, "\exists u"']. Quando um diagrama parece apertado, ajudam as opções de espaçamento no ambiente, por exemplo \begin{tikzcd}[column sep=large].

Notas práticas

O tikz-cd carrega o próprio TikZ, então não é preciso uma linha \usepackage{tikz} separada, e os diagramas compilam com um motor padrão, sem nenhuma ferramenta de desenho externa. O erro estrutural mais comum é uma grade irregular: linhas com números diferentes de separadores & deslocam os objetos para as colunas erradas, e as setas acabam em lugares estranhos. Comece de um quadrado que funcione, como o de cima, aumente-o uma linha ou coluna por vez e recompile a cada passo. É muito mais fácil depurar diagramas olhando o resultado do que o código-fonte, e o playground ao vivo oferece esse retorno enquanto você digita.

Voltar para Desenhar em TeX