TikZ matrix, why doesn't "every even row" work with "row sep" option?

Question

Please consider the following mwe:

\documentclass[tikz, margin=3mm]{standalone}
\usetikzlibrary{matrix}

\begin{document}
\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   column sep=-\pgflinewidth,
                   row sep=-\pgflinewidth,
                   every even column/.style={column sep=2pt},
                   every even row/.style={row sep=2pt},% doesn't insert row separation
                   inner sep=1pt,
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
};
\end{tikzpicture}
\end{document}

However every even column/.style={column sep=2pt}, yields the expected result, say, introducing additional column separation after each second column, the every even row/.style={row sep=2pt}, doesn't. Did I do something wrong or this is a bug in TikZ v3.1 (I've never tested this before, so I don't know if the same thing happens in v3.0.1)?

edit:

The same thing happens with, for example,

row 2/.style = {row sep=2pt} 

thus it might mean that every even row/.style=... and row <row number> work fine only if one wants to change some properties of cells inside row, for example, the color of nodes borders:

every even row/.style={draw red},

but not if one aims to change row separation (see @AndréC's comment below). However it is interesting, that this is possible to do in every column sep ...

Of course, the (temporary) workaround terminates each second row of the matrix with for example [2pt], but this is annoying when the matrix is huge like here.

Answer 1

The issue is with scopes. In order to make sure that the style code for the current row only applies to the current row, the style code is executed inside of a scope that is local to the current row. This scope is closed prior to ending the row and adding the row separation, so the value is reverted before it is applied. The solution is to make the change to the row sep global. The key row sep stores the value in \pgfmatrixrowsep so we globally define this to be the updated value. Because this change is global, it applies to all rows going forward, so we need an every odd row key setting the row sep to zero to switch it back.

\documentclass[tikz, margin=3mm]{standalone}
\usetikzlibrary{matrix}

\begin{document}
\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   column sep=-\pgflinewidth,
                   every even column/.style={column sep=2pt},
                   every even row/.style={/utils/exec=\gdef\pgfmatrixrowsep{2pt}},
                   every odd row/.style={/utils/exec=\gdef\pgfmatrixrowsep{-\pgflinewidth}},
                   inner sep=1pt,
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
};
\end{tikzpicture}
\end{document} 

Answer 2

This is more an extended comment than an answer. The comment concerns Hood Chathams proposal to make the dimensions global. Here is what happens:

\documentclass[tikz, margin=3mm]{standalone}
\usetikzlibrary{matrix}

\begin{document}
\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   inner sep=1pt,
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
};
\end{tikzpicture}

\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   column sep=-\pgflinewidth,
                   every even column/.style={column sep=2pt},
                   every even row/.style={/utils/exec=\gdef\pgfmatrixrowsep{2pt}},
                   every odd row/.style={/utils/exec=\gdef\pgfmatrixrowsep{-\pgflinewidth}},
                   inner sep=1pt,
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
};
\end{tikzpicture}

\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   inner sep=1pt,
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
};
\end{tikzpicture}

\end{document} 

Let me, however, stress that I really like the answer by Hood Chatham as a whole as it has a very nice explanation for why this happens. I just want add a word of caution.

Here is another proposal.

\documentclass[tikz, margin=3mm]{standalone}
\usetikzlibrary{matrix}
\begin{document}
\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   column sep=-\pgflinewidth,
                   row sep=\ifodd\pgfmatrixcurrentrow%
                   -\pgflinewidth%
                   \else%
                   2pt%
                   \fi,
                   every even column/.style={column sep=2pt},
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
};
\end{tikzpicture}
\end{document}

It does produce the desired output. However, it also produces warnings of the type \end occurred when \ifx on line 21 was incomplete. So I am definitely not claiming this proposal is better than Hood Chathams suggestion.

Of course, a very pragmatic solution would be to use

\documentclass[tikz, margin=3mm]{standalone}
\usetikzlibrary{matrix}

\begin{document}
\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   column sep=-\pgflinewidth,
                   row sep=-\pgflinewidth,
                   every even column/.style={column sep=2pt},
                   inner sep=1pt,
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\[2pt]
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
};
\end{tikzpicture}
\end{document}

Answer 3

Remark: This problem appears to have been fixed, so your MWE should work in some future version of the matrix library.

---

I just wanted to briefly mention another way in which the same result could be accomplished, so you may also consider this an extended comment.

The values of row sep and column sep are actually passed into the pgf math engine when they're used, so you can assign a value that depends on the current row/column number. The following should produce the desired output:

\documentclass[tikz, margin=3mm]{standalone}
\usetikzlibrary{matrix}

\begin{document}
\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   row sep=iseven(\pgfmatrixcurrentrow)?2pt:-\pgflinewidth,
                   column sep=iseven(\pgfmatrixcurrentcolumn)?2pt:-\pgflinewidth,
                   inner sep=1pt,
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
};
\end{tikzpicture}
\end{document}

In case you're not familiar with it, the notation <condition>?<true branch>:<false branch> means that if <condition> is true (non-zero,actually) the <true branch> is used and that the <false branch> is used otherwise. The functions iseven and isodd (and also isprime, wow) are documented in the pgf manual (in §99.3 on p1004 in the version for TikZ 3.1).

There is actually one rather annoying limitation to this, which is due the fact that the argument of row sep is actually stripped of three pairs of braces ({…}) and then split at comma's before the math engine gets to see it (each comma-separated term is applied separately). This means that you can't use functions whose syntax includes a comma unless you wrap the entire value in at least four sets of braces ({{{{…}}}}, more is also okay), like this:

\documentclass[tikz, margin=3mm]{standalone}
\usetikzlibrary{matrix}

\begin{document}
\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   row sep={{{{Mod(\pgfmatrixcurrentrow,3)?-\pgflinewidth:2pt}}}},
                   column sep={{{{Mod(\pgfmatrixcurrentcolumn,3)?-\pgflinewidth:2pt}}}},
                   inner sep=1pt,
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta & \epsilon & \zeta & \eta   \\
\alpha  & \beta   & \gamma  & \delta & \epsilon & \zeta & \eta   \\
\alpha  & \beta   & \gamma  & \delta & \epsilon & \zeta & \eta   \\
\alpha  & \beta   & \gamma  & \delta & \epsilon & \zeta & \eta   \\
\alpha  & \beta   & \gamma  & \delta & \epsilon & \zeta & \eta   \\
\alpha  & \beta   & \gamma  & \delta & \epsilon & \zeta & \eta   \\
\alpha  & \beta   & \gamma  & \delta & \epsilon & \zeta & \eta   \\
};
\end{tikzpicture}
\end{document}

Answer 4

This is from a bug in the matrix library. The bug was reported in issue #504 in the PGF bug tracker.

The problem is the scope where \pgfmatrixrowsep is set (the value you pass to row sep) ends before that value is actually used.

Henri Menke submitted a fix to this issue which will be in the next release of PGF.

Meanwhile, the following patch will work:

\makeatletter
\def\pgfmatrixendrow{%
  \let\pgf@matrix@signal@cell@end=\pgf@matrix@signal@cell@end
  \pgf@matrix@last@cell@in@rowtrue%
  \xdef\pgf@matrix@rowsep{\pgfmatrixrowsep}% <-- Define \pgf@matrix@rowsep globally
  &% <-- Scope ends here
  \pgf@matrix@correct@calltrue%
  \global\pgf@matrix@fixedfalse%
  \pgf@y=0pt%
  % The previous version used \pgfmatrixrowsep, which was reset at the &
  % \pgf@matrix@addtolength\pgf@y{\pgfmatrixrowsep}
  \pgf@matrix@addtolength\pgf@y{\pgf@matrix@rowsep}% <-- Now use the global def
  \pgfutil@ifnextchar[{\pgfmatrixendrow@skip}{\pgf@matrix@finish@line}%
}%
\makeatother

MWE:

\documentclass[tikz, margin=3mm]{standalone}
\usetikzlibrary{matrix}

\makeatletter
\def\pgfmatrixendrow{%
  \let\pgf@matrix@signal@cell@end=\pgf@matrix@signal@cell@end
  \pgf@matrix@last@cell@in@rowtrue%
  \xdef\pgf@matrix@rowsep{\pgfmatrixrowsep}%
  &\pgf@matrix@correct@calltrue%
  \global\pgf@matrix@fixedfalse%
  \pgf@y=0pt%
  \pgf@matrix@addtolength\pgf@y{\pgf@matrix@rowsep}%
  \pgfutil@ifnextchar[{\pgfmatrixendrow@skip}{\pgf@matrix@finish@line}%
}%
\makeatother

\begin{document}
\begin{tikzpicture}
\matrix (m) [matrix of math nodes,
            nodes={draw, font=\footnotesize, minimum size=1em,
                   anchor=center,inner sep=0pt},
                   column sep=-\pgflinewidth,
                   row sep=-\pgflinewidth,
                   every even column/.style={column sep=2pt},
                   every even row/.style={row sep=2pt},% doesn't insert row separation
                   inner sep=1pt,
                   left delimiter={[},right delimiter={]},
             ]
{
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
\alpha  & \beta   & \gamma  & \delta    \\
};
\end{tikzpicture}
\end{document}