Skip to contents

A convenience function for use with a regression model or list of regression models. Returns a named list of models, where the names are the models' respective dependent variables. Pass your list of models to dvnames before sending to modelsummary to automatically get dependent variable-titled columns.

Usage

dvnames(models, number = FALSE, fill = "Model")

Arguments

models

A regression model or list of regression models

number

Should the models be numbered (1), (2), etc., in addition to their dependent variable names?

fill

If insight::find_response() cannot find a response, the column title to use in its place. Set to ' ' to leave blank.

Examples


m1 <- lm(mpg ~ hp, data = mtcars)
m2 <- lm(mpg ~ hp + wt, data = mtcars)

# Without dvnames, column names are (1) and (2)
modelsummary(list(m1, m2))
#> <table class="table" style="width: auto !important; margin-left: auto; margin-right: auto;">
#>  <thead>
#>   <tr>
#>    <th style="text-align:left;">   </th>
#>    <th style="text-align:center;">  (1) </th>
#>    <th style="text-align:center;">   (2) </th>
#>   </tr>
#>  </thead>
#> <tbody>
#>   <tr>
#>    <td style="text-align:left;"> (Intercept) </td>
#>    <td style="text-align:center;"> 30.099 </td>
#>    <td style="text-align:center;"> 37.227 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;">  </td>
#>    <td style="text-align:center;"> (1.634) </td>
#>    <td style="text-align:center;"> (1.599) </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> hp </td>
#>    <td style="text-align:center;"> −0.068 </td>
#>    <td style="text-align:center;"> −0.032 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;">  </td>
#>    <td style="text-align:center;"> (0.010) </td>
#>    <td style="text-align:center;"> (0.009) </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> wt </td>
#>    <td style="text-align:center;">  </td>
#>    <td style="text-align:center;"> −3.878 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;box-shadow: 0px 1.5px">  </td>
#>    <td style="text-align:center;box-shadow: 0px 1.5px">  </td>
#>    <td style="text-align:center;box-shadow: 0px 1.5px"> (0.633) </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> Num.Obs. </td>
#>    <td style="text-align:center;"> 32 </td>
#>    <td style="text-align:center;"> 32 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> R2 </td>
#>    <td style="text-align:center;"> 0.602 </td>
#>    <td style="text-align:center;"> 0.827 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> R2 Adj. </td>
#>    <td style="text-align:center;"> 0.589 </td>
#>    <td style="text-align:center;"> 0.815 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> AIC </td>
#>    <td style="text-align:center;"> 181.2 </td>
#>    <td style="text-align:center;"> 156.7 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> BIC </td>
#>    <td style="text-align:center;"> 185.6 </td>
#>    <td style="text-align:center;"> 162.5 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> Log.Lik. </td>
#>    <td style="text-align:center;"> −87.619 </td>
#>    <td style="text-align:center;"> −74.326 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> F </td>
#>    <td style="text-align:center;"> 45.460 </td>
#>    <td style="text-align:center;"> 69.211 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> RMSE </td>
#>    <td style="text-align:center;"> 3.74 </td>
#>    <td style="text-align:center;"> 2.47 </td>
#>   </tr>
#> </tbody>
#> </table>

# With dvnames, they are "mpg" and "mpg"
modelsummary(dvnames(list(m1,m2)))
#> <table class="table" style="width: auto !important; margin-left: auto; margin-right: auto;">
#>  <thead>
#>   <tr>
#>    <th style="text-align:left;">   </th>
#>    <th style="text-align:center;"> mpg </th>
#>    <th style="text-align:center;"> mpg  </th>
#>   </tr>
#>  </thead>
#> <tbody>
#>   <tr>
#>    <td style="text-align:left;"> (Intercept) </td>
#>    <td style="text-align:center;"> 30.099 </td>
#>    <td style="text-align:center;"> 37.227 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;">  </td>
#>    <td style="text-align:center;"> (1.634) </td>
#>    <td style="text-align:center;"> (1.599) </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> hp </td>
#>    <td style="text-align:center;"> −0.068 </td>
#>    <td style="text-align:center;"> −0.032 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;">  </td>
#>    <td style="text-align:center;"> (0.010) </td>
#>    <td style="text-align:center;"> (0.009) </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> wt </td>
#>    <td style="text-align:center;">  </td>
#>    <td style="text-align:center;"> −3.878 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;box-shadow: 0px 1.5px">  </td>
#>    <td style="text-align:center;box-shadow: 0px 1.5px">  </td>
#>    <td style="text-align:center;box-shadow: 0px 1.5px"> (0.633) </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> Num.Obs. </td>
#>    <td style="text-align:center;"> 32 </td>
#>    <td style="text-align:center;"> 32 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> R2 </td>
#>    <td style="text-align:center;"> 0.602 </td>
#>    <td style="text-align:center;"> 0.827 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> R2 Adj. </td>
#>    <td style="text-align:center;"> 0.589 </td>
#>    <td style="text-align:center;"> 0.815 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> AIC </td>
#>    <td style="text-align:center;"> 181.2 </td>
#>    <td style="text-align:center;"> 156.7 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> BIC </td>
#>    <td style="text-align:center;"> 185.6 </td>
#>    <td style="text-align:center;"> 162.5 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> Log.Lik. </td>
#>    <td style="text-align:center;"> −87.619 </td>
#>    <td style="text-align:center;"> −74.326 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> F </td>
#>    <td style="text-align:center;"> 45.460 </td>
#>    <td style="text-align:center;"> 69.211 </td>
#>   </tr>
#>   <tr>
#>    <td style="text-align:left;"> RMSE </td>
#>    <td style="text-align:center;"> 3.74 </td>
#>    <td style="text-align:center;"> 2.47 </td>
#>   </tr>
#> </tbody>
#> </table>