help for rvpplot2

Plot residuals versus predictor values after model fit

rvpplot2 varname [ , residualtype force rscale(exp) lowess[(lowess_options)] scatter_options plot(plot) ]


rvpplot2 graphs a residual-versus-predictor plot (a.k.a. independent variable plot, a.k.a. carrier plot), a graph of the residuals versus the specified predictor varname from the last regression-type model. The residuals are, by default, those calculated by predict, residuals or (if the previous estimation command was glm) by predict, response.

rvpplot2 is for use after regress and similar commands; see help on the command of interest. It is a generalisation of official Stata's rvpplot.


residualtype specifies a type of residual other than the default. The following types are currently supported: anscombe, deviance, likelihood, pearson, residuals, response, rstandard, rstudent, score, working.

force allows you to specify a predictor variable not included in the previous model.

rscale(exp) specifies a transformed scale on which to show the residuals using Stata syntax and X as a placeholder for the residual variable name. Thus rscale(X^2) specifies squaring, to show relative contribution to residual variance; rscale(abs(X)) specifies absolute value, to set aside sign; rscale(sqrt(abs(X))) specifies root of absolute value, a useful scale on which to check for heteroscedasticity.

lowess[(lowess_options)] specifies that the residuals will be smoothed as a function of the predictor using twoway lowess (options may be specified).

scatter_options are options of twoway scatter.

plot(plot) provides a way to add other plots to the generated graph; see plot_option.


. reg width length . rvpplot2 length

. glm price weight, link(log) . rvpplot2 weight, anscombe yli(0)


Nicholas J. Cox, University of Durham, U.K. n.j.cox@durham.ac.uk


Kit Baum identified an error in a previous version of this help.

Also see

On-line: help for scatter, predict, modeldiag