.-
help for ^outreg^                                               (STB-46: sg97)
.-

Write formatted regression output to a text file
------------------------------------------------

After any estimation command:

   ^outreg^ [varlist] ^using^ filename [^, se^ ^nol^abel ^b^dec^(^#^)^ ^t^dec^(^#^)^ 
         ^nopa^ren ^noas^ter ^nocon^s ^nonob^s ^noni^ ^nor^2 ^ad^jr2 ^nonot^es ^com^ma 
         ^ap^pend ^replace^ ]


Description
-----------

^outreg^ formats regression output as it is presented in most documents: 
t-statistics or standard errors in parentheses under each coefficient, 
asterisks indicating coefficients statistically different from zero, and 
summary statistics like R-squared at the bottom.  The formatted output is 
written to a tab- or comma-separated ASCII file, which can then be loaded 
into wordprocessing or spreadsheet programs to be converted to a table.  For 
example, the output file can be opened in Word97, the text selected, and 
converted to a table by choosing Table then Convert Table to Text. 

^outreg^ works after any Stata estimation command (see ^estimation commands^ 
in Stata manual for a complete list).  In addition to coefficient estimates, 
it will report number of observations, true R-squareds, the number of groups 
in panel estimation, and indicate whether @_robust@ heteroskedasticity-
consistent errors or t-statistics are being reported. 

If filename is specified without an extension, ^.out^ is assumed.

Several regressions with differing independent variables can be combined into 
a single table with the ^append^ option. 

If a varlist is specified, only the regression coefficients corresponding to 
the variables is varlist will be included in the table, except that the 
intercept coefficient is included unless the ^nocons^ option is chosen.


Options
-------

^se^ specifies that standard errors rather than t-statistics are reported.

^nolabel^ specifies that variable names rather than variable labels (where 
    they exist) be used to identify coefficients.  Note that this differs 
    from the ^nolabel^ option on many other Stata commands.
    
^bdec(^#^)^ specifies the number of decimal places reported for coefficient 
    estimates (the b's).  It also specifies the decimal places reported for 
    standard errors if ^se^ is chosen.  The default value for ^bdec^ is 3.
    
^tdec(^#^)^ specifies the number of decimal places reported for t-statistics.  
    It also specifies the decimal places reported for R-squared or adjusted 
    R-squared.  The default value for ^bdec^ is 2.
    
^noparen^ specifies that no parentheses be placed around t-statistics or 
    standard errors.
    
^noaster^ specifies that no asterisks denoting 1% and 5% confidence intervals 
    be reported.
    
^nocons^ specifies that the intercept (constant) coefficient estimate not be 
    reported.

^nonobs^ specifies that the number of observations in the estimation not be 
    reported.
 
^noni^ specifies that the number of groups in a panel data regression not be 
    reported (e.g. the number of groups specified by the i() variable in 
    @xtreg@).
 
^nor2^ specifies that no R-squared (or adjusted R-squared) be reported.  This 
    option is only meaningful when Stata calculates a true R-squared.

^adjr2^ specifies that the adjusted R-squared be reported rather than the 
    regular R-squared.

^nonotes^ specifies that notes explaining the t-statistics (or standard errors) 
    and asterisks not be included.
    
^comma^ specifies that the ASCII file output be separated by commas rather than 
    by tabs.
    
^append^ specifies that new estimation output be appended to an existing 
    output file.  The notes at the bottom of the table explaining the 
    t-statistics or standard errors and asterisks are appropriate for the 
    first estimation in the output file.  If subsequently appended estimation 
    results use different options (such as ^noaster^, or change the estimations' 
    ^robust^ option), the notes will not be appropriate for all the columns.
    
^replace^ specifies that it is okay to replace filename if it already exists.


Examples
--------
   . ^outreg using model1^

   . ^outreg x1-x3 using model1, se bdec(4) tdec(3) nocons nonotes replace^

   . ^regress y x1-x2^
   . ^outreg using modl1_3, nolabel replace^
   . ^regress y x1-x3^
   . ^outreg using modl1_3, nolabel append^
   . ^regress y x1-x2 x4^
   . ^outreg using modl1_3, nolabel append^
   . ^type modl1_3.out^                                              
   y                       (1)         (2)         (3)             
   x1                     4.585       2.543       4.556    
                        (72.08)**   (14.14)**   (58.28)**              
   x2                   480.112     410.828     448.646               
                        (30.56)**   (34.91)**    (8.82)**            
   x3                                 1.888        
                                    (11.66)**              
   x4                                             0.342             
                                                 (0.65)     
   Constant             -97.793     -54.978     -95.236    
                        (24.38)**   (12.23)**   (16.94)**      
   Number of observations  100         100         100     
   R-squared              
   
   * significant at 5% level; ** significant at 1% level


Author
------

       John Luke Gallup
       Harvard University
       jgallup@@hiid.harvard.edu


Also see
--------

    STB:  sg97 (STB-46)