summary.dmm: Make summary tables of (co)variance component estimates and...

Description Usage Arguments Details Value Note Author(s) See Also Examples

View source: R/summary.dmm.R

Description

Extracts the (co)variance component and fixed effect estimates from an object of class dmm, for the specified set of traits and set of components. Makes tables of component estimates ordered either by trait or by component. Tables include component estimate, its standard error, and its 95 percent confidence limits. If there are class specific components these appear with appropriate labels in the list of components.

Usage

1
2
3
## S3 method for class 'dmm'
summary(object, traitset = "all", componentset = "all", bytrait = T,
            gls = F, digits = 3, ...)

Arguments

object

An object of class dmm. (Co)variance component estimates are obtained from this object.

traitset

A vector containing the names of the subset of traits for which tables of (co)variance component estimates are to be constructed. Default is "all" which means all traits present in object object.

componentset

A vector containing the names of the subset of (co)variance components for which tables are to be constructed. Default is "all" which means all (co)variance components present in object object.

bytrait

Logical flag: should the tables of (co)variance component estimates be constructed with trait varying least rapidly from line to line? If TRUE each subtable contains component estimates for one trait or traitpair and for all components in argument componentset. If FALSE each subtable contains component estimates for one component and for all traits or traitpairs.

gls

Logical flag: should the (co)variance component estimates by GLS-b method be tabled in addition to the (co)variance component estimates by OLS-b method? Default is gls=FALSE. The GLS-b (co)variance component estimates can only be tabled if object object contains the attribute gls, that is if object was constructed by a dmm() call with argument gls=TRUE.

digits

Number of digits for output. This is returned as part of the return value for us e by the S3 print function print.summary.dmm().

...

Ellipsis argument.

Details

This is a long printout with estimates, standard errors and confidence limits, arranged in tables with one estimate per line. For a short printout see function print.dmm(). In the case of class-specific components, the components which are class-specific are labelled with their class-codes prepended to the variance component name, and components for all classes are included, so the listed components do not sum to phenotypic variance. To list the components in class groups, so that they sum to the class phenotypic variance use function csummary().

Value

An object of class gsummary.dmm which is a list containing the following items:

btables

A list of dataframe objects each containing one subtable of estimates of the fixed effects, along with the appropriate standard errors and confidence limits. Based on OLS-b fixed effect estimates.

ctables

A list of dataframe objects each containing one subtable of estimates of the (co)variance components, along with the appropriate standard errors and confidence limits. Based on OLS-b component estimates.

gbtables

A list of dataframe objects each containing one subtable of estimates of the fixed effects, along with the appropriate standard errors and confidence limits. Based on GLS-b fixed effect estimates.

gctables

A list of dataframe objects each containing one subtable of estimates of the (co)variance components, along with the appropriate standard errors and confidence limits. Based on GLS-b component estimates. Only present if argument gls=TRUE.

traits

A vector of traitnames as specified in argument traitset.

components

A vector of component names as specified in argument componentset.

bytrait

Logical flag: as specified in argument bytrait.

gls

Logical flag: as specified in argument gls.

digits

A numeric value, as specified in argument digits.

call

The function call

Note

There is no provision to constrain the 95 percent confidence limits for component estimates. Hence for small samples, these may vary outside the bounds for the component, that is for components which are variances, they may be negative. Fixed effects are not bounded. Use summary() if you want to see the components as estimated. Use csummrry() if you want to see the components summing to phenotypic (co)variance, or sorted into class-specific groups.

Author(s)

Neville Jackson

See Also

Function print.summary.dmm().

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
# get some data
data(sheep.df)
# prepare it - only need "E" and "A" relationship matrices
sheep.mdf <- mdf(sheep.df,pedcols=c(1:3),factorcols=c(4:6),ycols=c(7:9),
             sexcode=c("M","F"),relmat=c("E","A"))
# estimate (co)variance components  - individual and maternal
sheep.fit5 <- dmm(sheep.mdf, Ymat ~ 1 + Year + Sex,
              components=c("VarE(I)","VarG(Ia)","VarE(M)","VarG(Ma)",
              "CovG(Ia,Ma)","CovG(Ma,Ia)"))
# look just at component "VarG(Ma)" across all traits
summary(sheep.fit5,componentset="VarG(Ma)",bytrait=FALSE)
# look just at trait "Cww"
summary(sheep.fit5,traitset="Cww")
# cleanup
rm(sheep.df)
rm(sheep.mdf)
rm(sheep.fit5)

dmm documentation built on Sept. 27, 2017, 5:03 p.m.