lsfit                 package:stats                 R Documentation

_F_i_n_d _t_h_e _L_e_a_s_t _S_q_u_a_r_e_s _F_i_t

_D_e_s_c_r_i_p_t_i_o_n:

     The least squares estimate of *b* in the model

                             y = X b + e

     is found.

_U_s_a_g_e:

     lsfit(x, y, wt = NULL, intercept = TRUE, tolerance = 1e-07,
           yname = NULL)

_A_r_g_u_m_e_n_t_s:

       x: a matrix whose rows correspond to cases and whose columns
          correspond to variables.

       y: the responses, possibly a matrix if you want to fit multiple
          left hand sides.

      wt: an optional vector of weights for performing weighted least
          squares.

intercept: whether or not an intercept term should be used.

tolerance: the tolerance to be used in the matrix decomposition.

   yname: names to be used for the response variables.

_D_e_t_a_i_l_s:

     If weights are specified then a weighted least squares is
     performed with the weight given to the _j_th case specified by the
     _j_th entry in 'wt'.

     If any observation has a missing value in any field, that
     observation is removed before the analysis is carried out. This
     can be quite inefficient if there is a lot of missing data.

     The implementation is via a modification of the LINPACK
     subroutines which allow for multiple left-hand sides.

_V_a_l_u_e:

     A list with the following named components: 

    coef: the least squares estimates of the coefficients in the model
          (*b* as stated above).

residuals: residuals from the fit.

intercept: indicates whether an intercept was fitted.

      qr: the QR decomposition of the design matrix.

_R_e_f_e_r_e_n_c_e_s:

     Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) _The New S
     Language_. Wadsworth & Brooks/Cole.

_S_e_e _A_l_s_o:

     'lm' which usually is preferable; 'ls.print', 'ls.diag'.

_E_x_a_m_p_l_e_s:

     ##-- Using the same data as the lm(.) example:
     lsD9 <- lsfit(x = unclass(gl(2,10)), y = weight)
     ls.print(lsD9)