# coefplot.default

### Description

Dotplot for coefficients

### Usage

1 2 3 4 5 6 7 8 9 10 11 | ```
## Default S3 method:
coefplot(model, title = "Coefficient Plot",
xlab = "Value", ylab = "Coefficient", innerCI = 1, outerCI = 2,
lwdInner = 1, lwdOuter = 0, pointSize = 3, color = "blue",
shape = 16, cex = 0.8, textAngle = 0, numberAngle = 0,
zeroColor = "grey", zeroLWD = 1, zeroType = 2, facet = FALSE,
scales = "free", sort = c("natural", "magnitude", "alphabetical"),
decreasing = FALSE, numeric = FALSE, fillColor = "grey", alpha = 1/2,
horizontal = FALSE, factors = NULL, only = NULL, shorten = TRUE,
intercept = TRUE, interceptName = "(Intercept)", coefficients = NULL,
predictors = NULL, strict = FALSE, newNames = NULL, plot = TRUE, ...)
``` |

### Arguments

`model` |
The model to plot. |

`title` |
The name of the plot, if NULL then no name is given |

`xlab` |
The x label |

`ylab` |
The y label |

`innerCI` |
How wide the inner confidence interval should be, normally 1 standard deviation. If 0, then there will be no inner confidence interval. |

`outerCI` |
How wide the outer confidence interval should be, normally 2 standard deviations. If 0, then there will be no outer confidence interval. |

`lwdInner` |
The thickness of the inner confidence interval |

`lwdOuter` |
The thickness of the outer confidence interval |

`pointSize` |
Size of coefficient point |

`color` |
The color of the points and lines |

`shape` |
The shape of the points |

`cex` |
The text size multiplier, currently not used |

`textAngle` |
The angle for the coefficient labels, 0 is horizontal |

`numberAngle` |
The angle for the value labels, 0 is horizontal |

`zeroColor` |
The color of the line indicating 0 |

`zeroLWD` |
The thickness of the 0 line |

`zeroType` |
The type of 0 line, 0 will mean no line |

`facet` |
logical; If the coefficients should be faceted by the variables, numeric coefficients (including the intercept) will be one facet. Currently not available. |

`scales` |
The way the axes should be treated in a faceted plot. Can be c("fixed", "free", "free_x", "free_y"). Currently not available. |

`sort` |
Determines the sort order of the coefficients. Possible values are c("natural", "normal", "magnitude", "size", "alphabetical") |

`decreasing` |
logical; Whether the coefficients should be ascending or descending |

`numeric` |
logical; If true and factors has exactly one value, then it is displayed in a horizontal graph with constinuous confidence bounds. Currently not available. |

`fillColor` |
The color of the confidence bounds for a numeric factor. Currently not available. |

`alpha` |
The transparency level of the numeric factor's confidence bound. Currently not available. |

`horizontal` |
logical; If the plot should be displayed horizontally. Currently not available. |

`factors` |
Vector of factor variables that will be the only ones shown |

`only` |
logical; If factors has a value this determines how interactions are treated. True means just that variable will be shown and not its interactions. False means interactions will be included. |

`shorten` |
logical or character; If |

`intercept` |
logical; Whether the Intercept coefficient should be plotted |

`interceptName` |
Specifies name of intercept it case it is not the default of "(Intercept"). |

`coefficients` |
A character vector specifying which factor coefficients to keep. It will keep all levels and any interactions, even if those are not listed. |

`predictors` |
A character vector specifying which coefficients to keep. Each individual coefficient can be specfied. Use predictors to specify entire factors. |

`strict` |
If TRUE then predictors will only be matched to its own coefficients, not its interactions |

`newNames` |
Named character vector of new names for coefficients |

`plot` |
logical; If the plot should be drawn, if false then a data.frame of the values will be returned |

`...` |
Arguments passed on to other functions |

### Details

A graphical display of the coefficients and standard errors from a fitted model

`coefplot`

is the S3 generic method for plotting the coefficients from a fitted model.

This method also plots coefficients from glm (using coefplot.lm) and rxLinMod models (through a redirection from coefplot.rxLinMod)

### Value

If `plot`

is `TRUE`

then a `ggplot`

object is returned. Otherwise a `data.frame`

listing coeffcients and confidence bands is returned.

### Author(s)

Jared P. Lander

### See Also

`lm`

`glm`

`ggplot`

`coefplot`

`plotcoef`

### Examples

1 2 3 4 5 6 7 8 9 | ```
data(diamonds)
head(diamonds)
model1 <- lm(price ~ carat + cut*color, data=diamonds)
model2 <- lm(price ~ carat*color, data=diamonds)
coefplot(model1)
coefplot(model2)
coefplot(model1, predictors="color")
coefplot(model1, predictors="color", strict=TRUE)
coefplot(model1, coefficients=c("(Intercept)", "color.Q"))
``` |