*! version 1.0.2 24jan2012
help spmat putmatrix

Title

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

Syntax

spmat putmatrix objname [matname]
[, options]

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)