help spmat putmatrix
-------------------------------------------------------------------------------

Title

    spmat putmatrix -- Put a Mata matrix into an spmat object


Syntax

        spmat putmatrix objname [matname] [, options]


    options                  Description
    -------------------------------------------------------------------------
      id(varname|vecname)    variable or Mata vector containing unique IDs
      eig(vecname)           Mata vector containing eigenvalues
      idistance              convert distance data to inverse distances
      normalize(norm)        normalization method
      bands(l u)             lower and upper band of matname
      replace                replace objname
    -------------------------------------------------------------------------


Description

    spmat putmatrix puts Mata matrices into an existing spmat object objname,
    or into a new spmat object, if the specified object does not exist.  The
    optional unique place identifiers can be provided in the id() option in a
    Mata vector vecname or in a Stata variable varname.  If objname does not
    exist and you do not specify place identifiers, spmat putmatrix will
    create the IDs 1, ..., n.


Options

    id(varname|vecname) specifies a Stata variable or a Mata vector
        containing unique place identifiers.

    eig(vecname) specifies a Mata vector containing the eigenvalues of
        matname.

    idistance specifies to convert the data to inverse distances.  The value
        d will be converted to 1/d with the exception of the main diagonal,
        which will contain zero entries.

    normalize(norm) specifies the normalization method.  norm can be row,
        minmax, or spectral.

    bands(l u) specifies the lower and upper band of matname if matname is
        banded. Neither value can be greater than floor((cols(matname)-1)/4).

    replace allows objname to be overwritten if it already exists.


Example

    Setup
        . spmat use cobj using pollute.spmat
        . spmat getmatrix cobj mymat, id(myid)
        . spmat drop cobj

    Create the spmat object cobj from the Mata matrix mymat and the Mata
    vector myid
        . spmat putmatrix cobj mymat, id(myid)


Also see

    Online:  spmat, spreg, spivreg, spmap, shp2dta, mif2dta (if installed)