Learn R Programming

MARSS (version 3.2)

MARSSinits: Initial Values for MLE

Description

Sets up generic starting values for parameters for maximum-likelihood estimation algorithms that use an iterative maximization routine needing starting values. Examples of such algorithms are the EM algorithm in MARSSkem and Newton methods in MARSSoptim. This is a utility function in the MARSS-package.

Usage

MARSSinits(modelObj, inits=list(B=1, U=0, Q=0.05, Z=1, A=0, R=0.05, x0=-99, V0=5), method)

Arguments

modelObj
An object of class marssm. MARSSinits uses three elements of the model object.
  • dataThe data element is used to determine n, the dimension of the y in the MARSS mode
inits
A list of up to 8 values to construct starting matrices for each parameter in a MARSSmodel.
method
The fitting algorithm to be used (e.g. kem)

Value

  • A list with 8 matrices A, R, B, U, Q, x0, V0, Z, specifying initial values for parameters in a MARSS model.

Details

Creates an inits parameter list for use by iterative maximization algorithms. Defaults values for inits is supplied in MARSSsettings.R. The user can alter these and supply any of the following (m is the dim of X and n is the dim of Y in the MARSS model):
  • elem=A,U
A numeric vector or matrix which will be constructed into inits$elem by the command array(inits$elem),dim=c(n or m,1)). If elem is fixed in the model, any inits$elem values will be overridden and replaced with the fixed value. Default is array(0,dim=c(n or m,1)). elem=Q,R,B A numeric vector or matrix. If length equals the length modelObj$fixed$elem then inits$elem will be constructed by array(inits$elem),dim=dim(modelObj$fixed$elem)). If length is 1 or equals m or n then inits$elem will be constructed into a diagonal matrix by the command diag(inits$elem,m or n). If elem is fixed in the model, any inits$elem values will be overridden and replaced with the fixed value. Default is diag(0.05,m or n) for Q and R. Default is diag(1,m) for B. x0 If inits$x0=-99, then starting values for x0 are estimated by a linear regression through the count data assuming A=0. This will be a poor start if inits$A is not 0. If inits$x0 is a numeric vector or matrix, inits$x0 will be constructed by the command array(inits$x0),dim=c(m,1)). If x0 is fixed in the model, any inits$x0 values will be overridden and replaced with the fixed value. Default is inits$x0=-99. Z If Z is fixed in the model, inits$Z set to the fixed value. If Z is not fixed, then the user must supply inits$Z. There is no default. elem=V0 V0 is never estimated, so this is never used.

See Also

marssm MARSSkem MARSSoptim