sleuth_fitR Documentation

Fit a measurement error model

Description

This function is a wrapper for fitting a measurement error model using sleuth. It performs the technical variance estimation from the boostraps, biological variance estimation, and shrinkage estimation.

Usage

sleuth_fit(obj, formula = NULL, fit_name = NULL, ...)

Arguments

obj

a sleuth object

formula

an R formula specifying the design to fit OR a design matrix. If you are interested in only fitting the model that was specified in sleuth_prep you do not need to specify it again (will be fit as the 'full' model).

fit_name

the name to store the fit in the sleuth object (at so$fits$fit_name). If NULL, the model will be named 'full'.

...

advanced options for sleuth_fit. See details.

Details

For most users, simply providing the sleuth object should be sufficient. By default, this behavior will fit the full model initially specified and store it in the sleuth object under 'full'.

To see which models have been fit, users will likely find the function models helpful.

There are some advanced options for users how wish to customize the fitting procedure. Note that these options have not been thoroughly tested, so their effect on the accuracy of the results are unknown. Here are those advanced options:

Advanced options for modeling choice:

Advanced options for the sliding window shrinkage procedure (these options are passed to sliding_window_grouping):

Value

a sleuth object with updated attributes.

See Also

models for seeing which models have been fit, sleuth_prep for creating a sleuth object, sleuth_wt to test whether a coefficient is zero, sleuth_lrt to test nested models.

Examples

# If you specified the formula in sleuth_prep, you can simply run to run the full model
so <- sleuth_fit(so)
# The intercept only model can be fit like this
so <- sleuth_fit(so, ~1, 'reduced')