help for matnames

Return matrix row and column names


matnames [matrixname]

+-------------+ ----+ Description +------------------------------------------------------

matnames returns matrix row and column names as locals in r(). The macro extended functions that retrieve matrix row and column names (e.g. loc c: colnames b) do not quote the names, so that if names contain spaces, the number of tokens may not match the number of rows or columns (that is, you may not be able to rename the matrix rows or columns with its own names that you just retrieved). matnames uses the Mata functions st_matrixrowstripe and st_matrixcolstripe to circumvent this difficulty.

+----------+ ----+ Examples +---------------------------------------------------------

Cut and paste the entire block of example code to the Command window, or click on commands one by one to run:

mat b=J(2,3,1) mat rownames b="row x: item 1" "row y: item 2" mat colnames b="eq1: item 1" "eq1: item 2" "eq.2: item 3" mat li b mat c=J(2,3,0) matnames b ret li mat colnames c=`r(c)' mat rownames c=`r(r)' mat li c


Austin Nichols Urban Institute Washington, DC, USA austinnichols@gmail.com

Also see

On-line: help for macro, matrix, st_matrixrowstripe, st_matrixcolstripe, etc.