runmixregls: Running MIXREGLS within Stata
runmixregls is a Stata command which allows Stata users to run the MIXREGLS mixed-effects location scale software from within Stata.
The mixed-effects location scale model extends the standard two-level random-intercept mixed-effects model for continuous responses (implemented in Stata as xtreg, mle or mixed) in three ways:
- The (log of the) within- and between-group variances are further modelled as functions of the covariates.
- A new random effect, referred to as the random- scale effect, is then entered into the within-group variance function to account for any unexplained group differences in the residual variance. The existing random-intercept effect is now referred to as the random-location effect.
- A group-level association between the location and the scale may be allowed for by entering the random-location effect into the within-group variance function using either a linear or quadratic functional form. The regression coefficients of these linear and quadratic terms are then estimated.
The distributions of the random-location and random-scale effects are assumed to be Gaussian.
MIXREGLS is developed by Hedeker and Nordgren (2013).
The runmixregls journal article
Read the runmixregls journal article for a comprehensive introduction to the command.
- Leckie, G. (2014). runmixregls - A Program to Run the MIXREGLS Mixed-effects Location Scale Software from within Stata. Journal of Statistical Software, 59, Code Snippet 2, 1-41.
- Please note, the original do-file to replicate our article no longer works in one or two places as we have made several improvements to runmixregls since it was published. For those wishing to replicate the article, please therefore use the updated do-file.
Presentations
We have created a presentation to provide a quick overview of how runmixregls works and the range of models which can be fitted.
- runmixregls Slides
- Please note, the original do-file to replicate these slides no longer works in one or two places as we have made several improvements to runmixregls since it was published. For those wishing to replicate the article, please therefore use the updated do-file.
Installation
The MIXREGLS functionality is included within the runmixregls Stata package. To install runmixregls, type the following command in a net aware version of Stata:
. ssc install runmixregls
Keeping runmixregls up-to-date
We may make improvements to runmixregls over time. To check that you are using the latest version of runmixregls, type the following command:
. adoupdate runmixregls
Documentation
We have created a comprehensive Stata help file for runmixregls.
- runmixregls Stata help file
Citing runmixregls
runmixregls is not an official Stata command. It is a free contribution to the research community, like a paper. Please cite it as such:
- Leckie, G. (2014). runmixregls - A Program to Run the MIXREGLS Mixed-effects Location Scale Software from within Stata. Journal of Statistical Software, 59, Code Snippet 2, 1-41.
Similarly, please also cite the MIXREGLS software:
- Hedeker, D. R. and Nordgren. 2013. MIXREGLS: A Program for Mixed-effects Location Scale Analysis. Journal of Statistical Software, 52, 12, 1-38.
Author
runmixregls is developed by George Leckie (g.leckie@bristol.ac.uk) and Chris Charlton (c.charlton@bristol.ac.uk).
Acknowledgments
We are very grateful to Don Hedeker and also colleagues at the Centre for Multilevel Modelling and the University of Bristol for their useful comments.
The development of this command was funded under the LEMMA3 project, a node of the UK Economic and Social Research Council's National Centre for Research Methods (grant number RES-576-25-0035).