Diagrammes commutatifs
Flèches et étiquettes tikz-cd sans soupe de coordonnées.
Diagrammes commutatifs
Un diagramme commutatif est une grille d’objets reliés par des flèches étiquetées, l’image classique de la théorie des catégories, de l’algèbre et de la topologie. TikZ brut peut en dessiner un, mais placer chaque nœud par ses coordonnées est lent et fragile. Le package tikz-cd enveloppe TikZ dans une syntaxe de type matrice : vous disposez les objets comme dans un tableau et décrivez chaque flèche par sa direction.
\usepackage{tikz-cd}\begin{tikzcd} A \arrow[r,"f"] \arrow[d,"g"'] & B \arrow[d,"h"] \\ C \arrow[r,"k"'] & D\end{tikzcd}Lire la syntaxe
La grille fonctionne comme une matrice : & sépare les colonnes et \\ sépare les lignes, si bien que ce diagramme a A et B sur la ligne du haut, C et D sur celle du bas. Chaque \arrow[...] appartient à la cellule où il est écrit et part de cette cellule. La première option est la direction, écrite avec les lettres r, l, u et d : \arrow[r] va une cellule vers la droite, \arrow[d] une cellule vers le bas. Les lettres se combinent et se répètent pour les diagonales et les portées plus longues, donc rd est un pas en bas à droite et rr couvre deux colonnes.
Une étiquette entre guillemets accompagne la flèche. Par défaut, elle se place d’un côté ; une apostrophe (prime) après le guillemet fermant, comme dans "g"', la bascule de l’autre côté. Dans l’exemple, les primes gardent les quatre étiquettes à l’extérieur du carré, ce qui est la disposition propre habituelle.
Autres options de flèche
D’autres options s’empilent après la direction et l’étiquette pour changer le style de la flèche. hook recourbe la queue en flèche d’inclusion, two heads double la pointe pour une surjection, dashed marque une application que vous affirmez au lieu de la supposer, et Rightarrow produit la flèche à double tige utilisée pour les transformations naturelles. Une flèche typique de propriété universelle s’écrit \arrow[rd, dashed, "\exists u"']. Quand un diagramme paraît à l’étroit, les options d’espacement de l’environnement aident, par exemple \begin{tikzcd}[column sep=large].
Remarques pratiques
tikz-cd charge TikZ lui-même, donc aucune ligne \usepackage{tikz} séparée n’est nécessaire, et les diagrammes se compilent avec un moteur standard, sans outil de dessin externe. L’erreur de structure la plus courante est une grille irrégulière : des lignes qui ont un nombre différent de séparateurs & décalent les objets dans de mauvaises colonnes, et les flèches aboutissent alors à des endroits étranges. Partez d’un carré qui fonctionne, comme celui ci-dessus, agrandissez-le d’une ligne ou d’une colonne à la fois, et recompilez au fur et à mesure. Un diagramme se débogue beaucoup plus facilement à l’œil qu’à partir de la source, et le terrain de jeu en direct vous donne ce retour pendant que vous tapez.