NIPY logo

Site Navigation

NIPY Community

Table Of Contents

This Page

algorithms.statistics.models.nlsmodel

Module: algorithms.statistics.models.nlsmodel

Inheritance diagram for nipy.algorithms.statistics.models.nlsmodel:

Non-linear least squares model

NLSModel

class nipy.algorithms.statistics.models.nlsmodel.NLSModel(Y, design, f, grad, theta, niter=10)

Bases: nipy.algorithms.statistics.models.model.Model

Class representing a simple nonlinear least squares model.

Methods

SSE() Sum of squares error.
fit() Fit a model to data.
getZ() Set Z into self
getomega() Set omega into self
initialize() Initialize (possibly re-initialize) a Model instance. For
next() Do an iteration of fit
predict([design]) Get predicted values for design or self.design
__init__(Y, design, f, grad, theta, niter=10)

Initialize non-linear model instance

Parameters :

Y : ndarray

the data in the NLS model

design : ndarray

the design matrix, X

f : callable

the map between the (linear parameters (in the design matrix) and the nonlinear parameters (theta)) and the predicted data. f accepts the design matrix and the parameters (theta) as input, and returns the predicted data at that design.

grad : callable

the gradient of f, this should be a function of an nxp design matrix X and qx1 vector theta that returns an nxq matrix df_i/dtheta_j where:

is the nonlinear response function for the i-th instance in the model.

niter : int

number of iterations

SSE()

Sum of squares error.

Returns :

sse: float :

sum of squared residuals

fit()

Fit a model to data.

getZ()

Set Z into self

Returns :None :
getomega()

Set omega into self

Returns :None :
initialize()

Initialize (possibly re-initialize) a Model instance. For instance, the design matrix of a linear model may change and some things must be recomputed.

next()

Do an iteration of fit

Returns :None :
predict(design=None)

Get predicted values for design or self.design

Parameters :

design : None or array

design at which to predict data. If None (the default) then use the initial self.design

Returns :

y_predicted : array

predicted data at given (or initial) design