-------------------------------------------------------------------------------
help for ^svmat^                                               [STB-24: ip6.2]
-------------------------------------------------------------------------------

Store a matrix in variables
---------------------------

	^svmat^ [type] A [^,^ ^n^ames^(col^|^eqcol^|^matcol^|string^)^ ]


Description
-----------

^svmat^ stores an m x n matrix as n variables (of specified type), each
containing a column of the matrix.  It is the reverse of the ^mkmat^ command
which creates a matrix from existing variables.


Options
-------

^names(col^|^eqcol^|^matcol^|string^)^ specifies how the new variables are to be named.

    ^names(col)^ uses the column names of the matrix to name the variables.  
    ^names(eqcol)^ uses the equation names prefixed to the column names.
    ^names(matcol)^ uses the matrix name prefixed to the column names.
    ^names(^string^)^ names the variables string1, string2,..., stringn, where 
    string is a user-specified string.

    If ^names()^ is not specified, the variables are named A1, A2,..., An, where
    A is the name of the matrix.

Note:  If necessary, names will be truncated to 8 characters, and if the
       truncated names are not unique, an error message will be returned.


Examples
--------

 . ^svmat A^
 . ^svmat double B^
 . ^svmat int C, n(col)^
 . ^svmat D, n(eqcol)^
 . ^svmat E, n(matcol)^
 . ^svmat F, n(x)^


Author
------

        Bill Sribney, StataCorp
        EMAIL  tech_support@@stata.com


Also see
--------

 Manual:  [6m] mkmat
On-line:  help for @mkmat@