You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2439 lines
106 KiB
Plaintext

7 months ago
{smcl}
{* 09mar2009}{...}
{cmd:help estout}{right:also see: {helpb esttab}, {helpb eststo}, {helpb estadd}, {helpb estpost}}
{right: {browse "http://repec.org/bocode/e/estout"}}
{hline}
{title:Title}
{p 4 4 2}{hi:estout} {hline 2} Making regression tables from stored estimates
{title:Table of contents}
{help estout##syn:Syntax}
{help estout##des:Description}
{help estout##opt:Options}
{help estout##exa:Examples}
{help estout##rem:Remarks}
{help estout##ret:Saved results}
{help estout##ref:Backmatter}
{marker syn}
{title:Syntax}
{p 8 15 2}
{cmd:estout} [ {help estout##what:{it:what}} ]
[ {cmd:using} {it:filename} ]
[ {cmd:,} {help estout##opt0:{it:options}} ]
{marker what}
{it:what}{col 30}description
{hline 70}
{it:namelist}{col 30}{...}
tabulate stored estimation sets; {it:namelist} is
{col 32}a name, a list of names, or {cmd:_all}; the {cmd:*} and
{col 32}{cmd:?} wildcards are allowed; a name may also be
{col 32}{cmd:.}, meaning the current (active) estimates
{cmdab:m:atrix:(}{it:name}[{cmd:,} {it:subopts}]{cmd:)}{col 30}{...}
tabulate matrix {it:name}
{cmd:e(}{it:name}[{cmd:,} {it:subopts}]{cmd:)}{col 30}{...}
tabulate matrix {cmd:e(}{it:name}{cmd:)}
{cmd:r(}{it:name}[{cmd:,} {it:subopts}]{cmd:)}{col 30}{...}
tabulate matrix {cmd:r(}{it:name}{cmd:)}
{it:subopts}:
{helpb estout##mfmt:{ul:f}mt}{cmd:(}{it:fmtlist}{cmd:)}{col 30}{...}
set the display format(s)
{helpb estout##mtranspose:{ul:t}ranspose}{col 30}{...}
tabulate transposed matrix
{hline 70}
{marker opt0}
{it:options}{col 38}description
{hline 70}
Parameter statistics
{helpb estout##cells:{ul:c}ells}{cmd:(}{it:elements and subopts}{cmd:)}{col 38}{...}
contents of the table cells, where
{col 40}an {it:element}'s {it:subopts} are in paren-
{col 40}theses, i.e. {it:element}[{cmd:(}{it:subopts}{cmd:)}]
{it:elements}:
{cmd:b}{col 38}raw coefficient (point estimate)
{cmd:se}{col 38}standard error
{cmd:var}{col 38}variance
{cmd:t}{col 38}t or z statistic
{cmd:z}{col 38}t or z statistic (synonym for {cmd:t})
{cmd:p}{col 38}p-value
{cmd:ci}{col 38}confidence interval
{cmd:ci_l}{col 38}lower bound of confidence interval
{cmd:ci_u}{col 38}upper bound of confidence interval
{cmd:_star}{col 38}"significance stars"
{cmd:_sign}{col 38}sign of point estimate
{cmd:_sigsign}{col 38}sign and significance of estimate
{cmd:.}{col 38}null element (empty cell)
{cmd:&}{col 38}combine elements in single cell
{it:myel}{col 38}results from {cmd:e(}{it:myel}{cmd:)}
{it:myel}{cmd:[}{it:#}{cmd:]}{col 38}results from row {it:#} in {cmd:e(}{it:myel}{cmd:)}
{it:myel}{cmd:[}{it:rowname}{cmd:]}{col 38}results from row {it:rowname} in {cmd:e(}{it:myel}{cmd:)}
{it:subopts} (for each {it:element},
except for {cmd:.} and {cmd:&}):
[{cmdab:no:}]{helpb estout##cstar:{ul:s}tar}{col 38}{...}
attach "significance stars"
{helpb estout##cfmt:{ul:f}mt}{cmd:(}{it:{help estout##fmt:fmt}} [{it:{help estout##fmt:fmt}} ...]{cmd:)}{col 38}{...}
set the display format(s)
{helpb estout##clabel:{ul:l}abel}{cmd:(}{it:string}{cmd:)}{col 38}{...}
define a label for {it:element}
{helpb estout##cpar:par}[{cmd:(}{it:l} {it:r}{cmd:)}] | {cmd:nopar}{col 38}{...}
place results in parentheses
{helpb estout##cvacant:{ul:v}acant}{cmd:(}{it:string}{cmd:)}{col 38}{...}
print {it:string} if coefficient is absent
{helpb estout##cdrop:{ul:d}rop}{cmd:(}{it:droplist}{cmd:)}{col 38}{...}
drop certain individual results
{helpb estout##ckeep:{ul:k}eep}{cmd:(}{it:keeplist}{cmd:)}{col 38}{...}
keep certain individual results
{helpb estout##cpattern:{ul:pat}tern}{cmd:(}{it:pattern}{cmd:)}{col 38}{...}
model selection
{helpb estout##cpvalue:{ul:pval}ue}{cmd:(}{it:name}{cmd:)}{col 38}{...}
set p-values for {cmd:star} (default: {cmd:p})
[{cmd:no}]{helpb estout##cabs:abs}{col 38}{...}
use absolute t-statistics
[{cmdab:no:}]{helpb estout##ctranspose:{ul:t}ranspose}{col 38}{...}
transpose {cmd:e(}{it:myel}{cmd:)} for tabulation
{helpb estout##drop:{ul:d}rop}{cmd:(}{it:droplist}{cmd:)}{col 38}{...}
drop individual coefficients
{helpb estout##keep:{ul:k}eep}{cmd:(}{it:keeplist}{cmd:)}{col 38}{...}
keep individual coefficients
{helpb estout##order:{ul:o}rder}{cmd:(}{it:orderlist}{cmd:)}{col 38}{...}
change order of coefficients
{helpb estout##indicate:{ul:i}ndicate}{cmd:(}{it:groups} [{cmd:,} {it:subopt}]{cmd:)}{col 38}{...}
indicate presence of parameters
{it:subopt}: {cmdab:l:abels(}{it:yes} {it:no}{cmd:)}{col 38}{...}
redefine "Yes" and "No" labels
{helpb estout##rename:{ul:ren}ame}{cmd:(}{it:old} {it:new} [{it:old} {it:new} ...]{cmd:)}{col 38}{...}
rename individual coefficients
{helpb estout##equations:{ul:eq}uations}{cmd:(}{it:eqmatchlist}{cmd:)}{col 38}{...}
match the models' equations
{helpb estout##eform:eform}[{cmd:(}{it:pattern}{cmd:)}] | {cmd:noeform}{col 38}{...}
report exponentiated coefficients
{helpb estout##transform:{ul:tr}ansform}{cmd:(}{it:list} [{cmd:,} {it:subopt}]{cmd:)}{col 38}{...}
apply transformations to coefficients
{it:subopt}: {cmdab:p:attern:(}{it:pattern}{cmd:)}]{cmd:)}{col 38}{...}
select models
{helpb estout##margin:{ul:m}argin}[{cmd:(}{cmd:u}|{cmd:c}|{cmd:p}{cmd:)}] | {cmdab:nom:argin}{col 38}{...}
report marginal effects/elasticities
{helpb estout##discrete:{ul:di}screte}{cmd:(}{it:string}{cmd:)} | {cmdab:nodi:screte}{col 38}{...}
identify 0/1 variables (if {cmd:margin})
{helpb estout##meqs:{ul:meq}s}{cmd:(}{it:eq_list}{cmd:)}{col 38}{...}
select equations for marginal effects
{helpb estout##dropped:dropped}[{cmd:(}{it:string}{cmd:)}] | {cmd:nodropped}{col 38}{...}
indicate null coefficients as dropped
{helpb estout##level:level}{cmd:(}{it:#}{cmd:)}{col 38}{...}
set level for confidence intervals
Summary statistics
{helpb estout##stats:{ul:s}tats}{cmd:(}{it:scalarlist}[{cmd:,} {it:subopts}]{cmd:)}{col 38}{...}
display summary statistics at the
{col 38}bottom of the table
{it:subopts}:
{helpb estout##statsfmt:{ul:f}mt}{cmd:(}{it:{help estout##fmt:fmt}} [{it:{help estout##fmt:fmt}} ...]{cmd:)}{col 38}{...}
set the display formats
{helpb estout##statslabels:{ul:l}abels}{cmd:(}{it:strlist}[{cmd:,} {col 38}{...}
label the summary statistics
{it:{help estout##lsub0:label_subopts}}]{cmd:)}
{helpb estout##statsstar:{ul:s}tar}[{cmd:(}{it:sca'list}{cmd:)}] | {cmdab:nos:tar}{col 38}{...}
denote the model significance
{helpb estout##statslayout:{ul:lay}out}{cmd:(}{it:array}{cmd:)}{col 38}{...}
arrange the summary statistics
{helpb estout##statspchar:{ul:pc}har}{cmd:(}{it:symbol}{cmd:)}{col 38}{...}
placeholder in {cmdab:layout()}; default is {cmd:@}
Significance stars
{helpb estout##starlevels:{ul:starl}evels}{cmd:(}{it:levelslist}{cmd:)}{col 38}{...}
define thresholds and symbols,
{col 40}where '{it:levelslist}' is '{it:symbol} {it:#}
{col 40}[{it:symbol} {it:#} ...]' with {it:#} in (0,1] and
{col 40}listed in descending order
{helpb estout##stardrop:{ul:stard}rop}{cmd:(}{it:droplist}{cmd:)}{col 38}{...}
drop stars for individual coefs
{helpb estout##starkeep:{ul:stark}eep}{cmd:(}{it:keeplist}{cmd:)}{col 38}{...}
keep stars for individual coefs
[{cmdab:no:}]{helpb estout##stardetach:{ul:stard}etach}{col 38}{...}
display the stars in their own column
Layout
{helpb estout##varwidth:{ul:var}width}{cmd:(}{it:#}{cmd:)}{col 38}{...}
set width of the table's left stub
{helpb estout##modelwidth:{ul:model}width}{cmd:(}{it:#} [{it:#} ...]{cmd:)}{col 38}{...}
set width of the results columns
[{cmdab:no:}]{helpb estout##unstack:{ul:uns}tack}{col 38}{...}
place equations from multiple-
{col 40}equation models in separate columns
{helpb estout##begin:{ul:beg}in}{cmd:(}{it:string}{cmd:)}{col 38}{...}
specify the beginning of the rows
{helpb estout##delimiter:{ul:del}imiter}{cmd:(}{it:string}{cmd:)}{col 38}{...}
specify the column delimiter
{helpb estout##end:end}{cmd:(}{it:string}{cmd:)}{col 38}{...}
specify the ending of the table rows
{helpb estout##incelldel:{ul:incell}delimiter}{cmd:(}{it:string}{cmd:)}{col 38}{...}
specify delimiter within cell
{helpb estout##dmarker:{ul:dm}arker}{cmd:(}{it:string}{cmd:)}{col 38}{...}
define the decimal marker
{helpb estout##msign:{ul:ms}ign}{cmd:(}{it:string}{cmd:)}{col 38}{...}
define the minus sign
[{cmd:no}]{helpb estout##lz:lz}{col 38}{...}
print the leading zero of fixed
{col 40}format numbers in (-1,1)
{helpb estout##extracols:{ul:extra}cols}{cmd:(}{it:numlist}{cmd:)}{col 38}{...}
add empty column to the table
{helpb estout##substitute:{ul:sub}stitute}{cmd:(}{it:subst}{cmd:)}{col 38}{...}
apply end-of-pipe substitutions, where
{col 40}'{it:subst}' is '{it:from} {it:to} [{it:from} {it:to} ... ]'
Labeling
[{cmdab:no:}]{helpb estout##label:{ul:l}abel}{col 38}{...}
make use of variable labels
[{cmdab:no:}]{helpb estout##abbrev:{ul:ab}brev}{col 38}{...}
abbreviate long names and labels
[{cmdab:no:}]{helpb estout##wrap:wrap}{col 38}{...}
wrap long labels (if space permits)
{helpb estout##title:{ul:ti}tle}{cmd:(}{it:string}{cmd:)}{col 38}{...}
specify a title for the table
{helpb estout##note:note}{cmd:(}{it:string}{cmd:)}{col 38}{...}
specify a note for the table
[{cmdab:no:}]{helpb estout##legend:{ul:le}gend}{col 38}{...}
add a significance symbols legend
{helpb estout##prehead:{ul:preh}ead}{cmd:(}{it:strlist}{cmd:)}{col 38}{...}
add text before the table heading
{helpb estout##prehead:{ul:posth}ead}{cmd:(}{it:strlist}{cmd:)}{col 38}{...}
add text after the table heading
{helpb estout##prehead:{ul:pref}oot}{cmd:(}{it:strlist}{cmd:)}{col 38}{...}
add text before the table footer
{helpb estout##prehead:{ul:postf}oot}{cmd:(}{it:strlist}{cmd:)}{col 38}{...}
add text after the table footer
{helpb estout##hlinechar:{ul:hl}inechar}{cmd:(}{it:string}{cmd:)}{col 38}{...}
specify look of {cmd:@hline}
{helpb estout##varlabels:{ul:varl}abels}{cmd:(}{it:matchlist}[{cmd:,} {it:sub.}]{cmd:)} {col 38}{...}
relabel the parameters
{it:subopts}:
{cmdab:bl:ist:(}{it:matchlist}{cmd:)}{col 38}{...}
assign prefixes to certain rows
{cmdab:el:ist:(}{it:matchlist}{cmd:)}{col 38}{...}
assign suffixes to certain rows
{it:{help estout##lsub0:label_subopts}}
{helpb estout##labcol2:{ul:labcol}2}{cmd:(}{it:strlist}[{cmd:,} {it:subopts}]{cmd:)} {col 38}{...}
add a second labeling column
{it:subopts}:
{cmdab:t:itle:(}{it:strlist}{cmd:)}{col 38}{...}
add column title in table header
{cmdab:w:idth:(}{it:#}{cmd:)}{col 38}{...}
set width of column
{helpb estout##refcat:{ul:ref}cat}{cmd:(}{it:matchlist}[{cmd:,} {it:subopts}]{cmd:)} {col 38}{...}
add reference category information
{it:subopts}:
{cmdab:l:abel:(}{it:string}{cmd:)} | {cmdab:nol:abel}{col 38}{...}
redefine the "ref." label
{cmdab:b:elow}{col 38}{...}
change positioning of refcat
{helpb estout##mlabels:{ul:ml}abels}{cmd:(}{it:strlist}[{cmd:,} {it:subopts}]{cmd:)}{col 38}{...}
label the models
{it:subopts}:
[{cmdab:no:}]{cmdab:dep:vars}{col 38}{...}
use the name/label of the dependent
{col 42}variable as model label
[{cmdab:no:}]{cmdab:ti:tles}{col 38}{...}
use estimates title as model label
[{cmdab:no:}]{cmdab:num:bers}{col 38}{...}
number models labels consecutively
{it:{help estout##lsub0:label_subopts}}
{helpb estout##collabels:{ul:coll}abels}{cmd:(}{it:strlist}[{cmd:,} {col 38}{...}
label the columns within models
{it:{help estout##lsub0:label_subopts}}]{cmd:)}
{helpb estout##eqlabels:{ul:eql}abels}{cmd:(}{it:strlist}[{cmd:,} {it:subopts}]{cmd:)}{col 38}{...}
label the equations
{it:subopts}:
[{cmdab:no:}]{cmdab:m:erge}{col 38}{...}
merge equation and parameter labels
{it:{help estout##lsub0:label_subopts}}
{helpb estout##mgroups:{ul:mgr}oups}{cmd:(}{it:strlist}[{cmd:,} {it:subopts}]{cmd:)}{col 38}{...}
define and label groups of models
{it:subopts}:
{cmdab:pat:tern:(}{it:pattern}{cmd:)}{col 38}{...}
define the grouping of the models
{it:{help estout##lsub0:label_subopts}}
{helpb estout##numbers:{ul:num}bers}[{cmd:(}{it:l} {it:r}{cmd:)}] | {cmdab:nonum:bers}{col 38}{...}
add a row containing model numbers
Output
[{cmdab:no:}]{helpb estout##replace:{ul:r}eplace}{col 38}{...}
overwrite an existing file
[{cmdab:no:}]{helpb estout##append:{ul:a}ppend}{col 38}{...}
append the output to an existing file
[{cmdab:no:}]{helpb estout##type:{ul:ty}pe}{col 38}{...}
print the table in the results window
[{cmd:no}]{helpb estout##showtabs:showtabs}{col 38}{...}
display tabs as {cmd:<T>}s
{helpb estout##topfile:{ul:top}file}{cmd:(}{it:filename}{cmd:)}{col 38}{...}
insert file contents above table
{helpb estout##topfile:{ul:bot}tomfile}{cmd:(}{it:filename}{cmd:)}{col 38}{...}
insert file contents below table
Defaults
{helpb estout##style:{ul:sty}le}{cmd:(}{it:style}{cmd:)}{col 38}{...}
specify a style for the output table
{it:styles}:
{cmd:smcl}{col 38}SMCL formatted table (screen default)
{cmd:tab}{col 38}tab delimited table (export default)
{cmd:fixed}{col 38}fixed format table
{cmd:tex}{col 38}table for use with LaTeX
{cmd:html}{col 38}table for use with HTML
{it:mystyle}{col 38}user defined addition
{hline 70}
{marker lsub0}
{it:{help estout##lsub:label_subopts}}{col 38}Description
{hline 70}
[{cmd:no}]{cmd:none}{col 38}{...}
suppress the labels
{cmdab:p:refix:(}{it:string}{cmd:)}{col 38}{...}
add a common prefix
{cmdab:s:uffix:(}{it:string}{cmd:)}{col 38}{...}
add a common suffix
{cmdab:b:egin:(}{it:strlist}{cmd:)}{col 38}{...}
add an overall prefix
[{cmdab:no:}]{cmdab:f:irst}{col 38}{...}
print the first occurrence of {cmd:begin()}
{cmdab:e:nd:(}{it:strlist}{cmd:)}{col 38}{...}
add an overall suffix
[{cmdab:no:}]{cmdab:l:ast}{col 38}{...}
print the last occurrence of {cmd:end()}
{cmdab:r:eplace}{col 38}{...}
replace global {cmd:begin()}/{cmd:end()}
[{cmd:no}]{cmd:span}{col 38}{...}
span columns if appropriate
{cmdab:er:epeat:(}{it:string}{cmd:)}{col 38}{...}
add a "span" suffix
{cmd:lhs(}{it:string}{cmd:)}{col 38}{...}
label the table's left stub
{hline 70}
{marker des}
{title:Description}
{p 4 4 2}
{cmd:estout} assembles a table of coefficients, "significance
stars", summary statistics, standard errors, t- or z-statistics, p-values,
confidence intervals, and other statistics for one or more models
previously fitted and stored by {helpb estimates store} or {helpb eststo}.
It then displays the table in Stata's results window or writes it to a text
file specified by {cmd:using}. The default is to use {help smcl:SMCL}
formatting tags and horizontal lines to structure the table. However,
if {cmd:using} is specified, a tab-delimited table without lines
is produced.
{p 4 4 2}
{it:namelist} provides the names of the stored estimation
sets to be tabulated. You may use the {cmd:*} and {cmd:?} wildcards in
{it:namelist}. The results estimated last may be indicated by a period
({cmd:.}), even if they have not yet been stored. If no model is
specified, {cmd:estout} tabulates the estimation sets stored by
{cmd:eststo} (see help {helpb eststo}) or, if no such estimates are
present, the currently active estimates (i.e. the model fit last).
{cmd:estout} may be used after any estimation command that
returns its results in {cmd:e()}.
{p 4 4 2}
See the {help estout##intro:Introduction} in the
{help estout##exa:Examples} section for an introduction on using
{cmd:estout}. See help {helpb estimates} for general information
about managing estimation results. Furthermore, see help {helpb eststo}
for an alternative to the {cmd:estimates store} command.
{p 4 4 2}
The default for {cmd:estout} is to produce a plain
table containing point estimates. Producing a fully formatted
end-product may involve specifying many options. However, note that a
simple-to-use {cmd:estout} wrapper producing pre-formatted
publication style tables is available as {helpb esttab}. Furthermore,
use {helpb estadd} to make additional results available for
tabulation (such as the standardized coefficients or the means and
standard deviations of the regressors) and {helpb estpost} to
tabulate results from non-estimation commands such as {helpb summarize}
or {helpb tabulate}.
{p 4 4 2}
{cmd:estout} can also be used to tabulate the contents of a Stata
matrix (see help {helpb matrix}). Type {cmd:estout marix(}{it:name}{cmd:)},
where {it:name} is the name of the matrix, instead of providing a
{it:namelist} of stored estimation sets. See the
{help estout##ex7:examples} below. Alternatively, you may also specify
{cmd:e(}{it:name}{cmd:)} or {cmd:r(}{it:name}{cmd:)} to tabulate an
{cmd:e()}-matrix or an {cmd:r()}-matrix. The {cmd:cells()} option is
disabled if tabulating a matrix.
{p 4 4 2}
Programms similar to {cmd:estout} include {cmd:outreg} by John Luke
Gallup, {cmd:outreg2} by Roy Wada, {cmd:modltbl} by John H. Tyler,
{cmd:mktab} by Nicholas Winter, {cmd:outtex} by Antoine Terracol, or
{cmd:est2tex} by Marc Muendler. Also see Newson (2003) for a very
appealing approach.
{marker opt}
{title:Options}
Contents
{help estout##par:Parameter statistics}
{help estout##sum:Summary statistics}
{help estout##sig:Significance stars}
{help estout##lay:Layout}
{help estout##lab:Labeling}
{help estout##out:Output}
{help estout##def:Defaults}
{it:{help estout##lsub:label_subopts}}
{it:{help estout##msub:matrix_subopts}}
{marker par}
{dlgtab:Parameter statistics}
{marker cells}
{p 4 8 2}
{cmd:cells(}{it:array}{cmd:)} specifies the parameter statistics to be
reported and how they are to be arranged. The default is for cells to
report point estimates only, i.e. {cmd:cells(b)}. {cmd:cells(none)} may
be used to completely suppress the printing of parameter statistics.
Alternatively, {cmd:cells(b se)} would result in the reporting of point
estimates and standard errors. Multiple statistics are placed in
separate rows beneath one another by default. However, elements of
{it:array} that are listed in quotes or in parentheses, e.g.
{bind:{cmd:"b se"}} or {bind:{cmd:`"b se"'}} or {bind:{cmd:(b se)}},
are placed beside one another. For example, {bind:{cmd:cells("b p" se)}}
or, equivalently, {bind:{cmd:cells((b p) se)}} would produce a
table with point estimates and p-values beside one another in first row
and standard errors in the second row beneath the point estimates.
{p 8 8 2}
The parameter statistics available are {cmd:b} (point estimates),
{cmd:se} (standard errors), {cmd:var} (variance), {cmd:t}
(t/z-statistics), {cmd:z} (synonym for {cmd:t}), {cmd:p} (p-values), and
{cmd:ci} (confidence
intervals; to display the lower and upper bounds in separate cells use
{cmd:ci_l} and {cmd:ci_u}). Any additional parameter statistics
included in the {cmd:e()}-returns for the models can be tabulated as
well. If, for example, {cmd:e(beta)} contains the standardized
coefficients, type {cmd:cells(beta)} to tabulate them (use
{helpb estadd} to add statistics such as the standardized coefficients to the
{cmd:e()}-returns of a model). The syntax {it:name}{cmd:[}{it:#}{cmd:]}
or {it:name}{cmd:[}{it:rowname}{cmd:]} can be used to refer to specific
rows in {cmd:e(}{it:name}{cmd:)}. For example, type {cmd:cell(ci_bc[1] ci_bc[2])}
or {cmd:cell(ci_bc[ll] ci_bc[ul])} to tabulate the lower and upper
bounds of the bias-corrected confidence intervals after {helpb bootstrap}.
The default is to report the results from the first row.
Also see the {cmd:eform} and {cmd:margin} options for more information
on the kinds of statistics that can be displayed.
{p 8 8 2}
Further available elements in {it:array} are {cmd:_star},
{cmd:_sign}, and {cmd:_sigsign}. {cmd:_star} causes stars denoting the
significance of the coefficients to be printed (* for p<.05, ** for p<.01,
and *** for p<.001; customizable via the {cmd:starlevels()} option below).
{cmd:_star} places the significance stars in their own cells. See the
{cmd:star} suboption below if you want to attach the stars to another
element. {cmd:_sign} prints the signs of the coefficients ("+", "-", or
"0"). {cmd:_sigsign}, a combination of {cmd:_star} and {cmd:_sign}, repeats
the signs of the coefficients where the number of repetitions reflects the
level of significance (non-significant coefficients are left empty;
however, you may set the first level to 1 in the {cmd:starlevels()}
option).
{p 8 8 2}
Finally, {cmd:.} and {cmd:&} may be used in {it:array}. {cmd:.} inserts a
"null" element. Use this to add empty cells. For example,
{cmd:cells("b p" ". se")} would produce a table with point estimates in the
first column and p-values and standard errors beneath one another in the
second column. {cmd:&} is used to combine elements in the same cell. Use
the {helpb estout##incelldel:incelldelimiter()} option to specify the text to
be printed between the combined elements (the default is to print a
single blank). For example, in HTML, use {cmd:cell(b & se)} and
{cmd:incelldelimiter(<br>)} to include point estimates and standard
errors in a single cell and insert a line break between them.
{p 8 8 2}
A set of suboptions may be specified in parentheses for each
element named in {it:array} (except for {cmd:.} and {cmd:&}). For example,
to add significance stars to the coefficients and place the standard errors
in parentheses, specify {bind:{cmd:cells(b(star) se(par))}}. The following
suboptions are available. Use:
{p_end}
{marker cstar}
{p 12 16 2}
{cmd:star} to specify that stars denoting the significance of the
coefficients be attached to the statistic: {cmd:*} for p<.05,
{cmd:**} for p<.01, and {cmd:***} for p<.001. The symbols and the
values for the thresholds and the number of levels are fully customizable
(see the {help estout##sig:Significance stars} options).
{p_end}
{marker cfmt}
{p 12 16 2}
{cmd:fmt(}{it:{help estout##fmt:fmt}} [{it:{help estout##fmt:fmt}} ...]{cmd:)}
to specify the display format(s) of a statistic. It
defaults to {cmd:%9.0g} or the format for the first statistic in
{cmd:cells()}. If only one format is specified, it is used for all
occurrences of the statistic. For example, type
{p 20 20 2}
{inp:. estout} {it:...}{inp:, cells("b(fmt(3)) t(fmt(2))")}
{p 16 16 2}
to print coefficients and t-values beside one another using three
decimal places for coefficients and two decimal places for
t-values. If multiple formats are specified, the first format is
used for the first regressor in the estimates table, the second
format for the second regressor, and so on. The last format is used
for the remaining regressors if the number of regressors in the
table is greater than the number of specified formats. For
instance, type
{p 20 20 2}
{inp:. estout} {it:...}{inp:, cells(b(fmt(3 4 2)))}
{p 16 16 2}
to use three decimal places for the first coefficient, four decimal
places for the second, and two decimal places for all remaining
coefficients. Note that, regardless of the display format chosen,
leading and trailing blanks are removed from the numbers. White
space can be added by specifying a {cmd:modelwidth()} (see the
{help estout##lay:Layout} options). {it:{help estout##fmt:fmt}} may
be any of Stata's numerical display formats, e.g., {cmd:%9.0g} or
{cmd:%8.2f}, an integer {it:#} such as {cmd:1} or {cmd:3} to use a
fixed format with {it:#} decimal places, or {cmd:a}{it:#} such as
{cmd:a1} or {cmd:a3} to use {cmd:estout}'s adaptive display format
(see {help estout##fmt:Numerical formats} in the
{help estout##rem:Remarks} section for details).
{p_end}
{marker clabel}
{p 12 16 2}
{cmd:label(}{it:string}{cmd:)} to specify a label to appear in the
column heading. The default is the name of the statistic.
{p_end}
{marker cpar}
{p 12 16 2}
{cmd:par}[{cmd:(}{it:l} {it:r}{cmd:)}] to specify that the
statistic in question be placed in parentheses. It is also possible
to specify custom "parentheses". For example, {cmd:se(par({ }))}
would display the standard errors in curly brackets. Or,
{cmd:se(par(`"="("' `")""'))} will write parentheses in a way that
Excel can recognize. For {cmd:ci} the syntax is:
{p 20 20 2}
{cmd:ci(par}[{cmd:(}{it:l} {it:m} {it:r}{cmd:)}]{cmd:)}
{p_end}
{marker cvacant}
{p 12 16 2}
{cmd:vacant(}{it:string}{cmd:)} to print {it:string} if a
coefficient is not in the model. The default is to leave such cells
empty.
{p_end}
{marker cdrop}
{p 12 16 2}
{cmd:drop(}{it:droplist} [{cmd:, relax}]{cmd:)} to cause certain
individual statistics to be dropped. For example, specifying
{cmd:t(drop(_cons))} suppresses the t-statistics for the constants.
{it:droplist} is specified as in the global
{helpb estout##drop:drop()} option (see below).
{p_end}
{marker ckeep}
{p 12 16 2}
{cmd:keep(}{it:keeplist} [{cmd:, relax}]{cmd:)} to cause certain
individual statistics to be kept. For example, the specification
{cmd:t(keep(mpg))} would display the t-statistics exclusively for
the variable {cmd:mpg}. {it:keeplist} is specified analogous to
{it:droplist} in {helpb estout##drop:drop()} (see below).
{p_end}
{marker cpattern}
{p 12 16 2}
{cmd:pattern(}{it:pattern}{cmd:)} to designate a pattern of models
for which the statistics are to be reported, where the {it:pattern}
consists of zeros and ones. A {cmd:1} indicates that the statistic
be printed; {cmd:0} indicates that it be suppressed. For example
{cmd:beta(pattern(1 0 1))} would result in {cmd:beta} being
reported for the first and third models, but not for the second.
{p_end}
{marker cpvalue}
{p 12 16 2}
{cmd:pvalue(}{it:name}{cmd:)} to specify the p-values used to
determine the significance stars (see {cmd:star} above). The
default is {cmd:pvalue(p)}, indicating that the standard p-values
are to be used (i.e. the p-values computed form the coefficients
vector and the variance matrix). Alternatively, specify
{cmd:pvalue(}{it:mypvalue}{cmd:)}, in which case the significance
stars will be determined from the values in
{cmd:e(}{it:mypvalue}{cmd:)}. Values outside [0,1] will be ignored.
{p_end}
{marker cabs}
{p 12 16 2}
{cmd:abs} to specify that absolute t-statistics be used instead of
regular t-statistics (relevant only if used with {cmd:t()}).
{p_end}
{marker ctranspose}
{p 12 16 2}
{cmd:transpose} to specify that {cmd:e(}{it:myel}{cmd:)} be transposed
for tabulation.
{p_end}
{marker drop}
{p 4 8 2}
{cmd:drop(}{it:droplist} [{cmd:, relax}]{cmd:)} identifies the coefficients
to be dropped from the table. A {it:droplist} comprises one or more
specifications, separated by white space. A specification can be either a
parameter name (e.g. {cmd:price}), an equation name followed by a colon
(e.g. {cmd:mean:}), or a full name (e.g. {cmd:mean:price}). You may use the
{cmd:*} and {cmd:?} wildcards in equation names and parameter names. Be sure
to refer to the matched equation names, and not to the original equation names
in the models, when using the {cmd:equations()} option to match equations.
Specify the {cmd:relax} suboption to allow {it:droplist} to contain elements
for which no match can be found.
{p_end}
{marker keep}
{p 4 8 2}
{cmd:keep(}{it:keeplist} [{cmd:, relax}]{cmd:)} selects the coefficients to
be included in the table. {it:keeplist} is specified analogous to {it:droplist} in
{helpb estout##drop:drop()} (see above). Note that {cmd:keep()} does {it:not} change the
the order of the coefficients. Use {cmd:order()} to change the order
of coefficients.
{p_end}
{marker order}
{p 4 8 2}
{cmd:order(}{it:orderlist}{cmd:)} changes the order of the
coefficients and equations within the table. {it:orderlist} is specified
analogous to {it:droplist} in {cmd:drop()} (see above). Reordering of
coefficients is performed equation by equation, unless equations are
explicitly specified. Coefficients and equations that do not appear in
{it:orderlist} are placed last (in their original order). Extra table rows
are inserted for elements in {it:orderlist} that are not found in the
table.
{p_end}
{marker indicate}
{p 4 8 2}
{cmd:indicate(}{it:groups} [{cmd:,} {cmdab:l:abels(}{it:yes}
{it:no}{cmd:)}]{cmd:)} indicates for each model (or, if {cmd:unstack}
is specified, for each equation) the presence of certain groups of
coefficients at the end of the table body. The syntax for {it:groups}
is
{it:group} [ {it:group} {it:...} ]
{p 8 8 2}
where a {it:group} is
[{it:name} = ] {it:list}
{p 8 8 2}
and {it:list} is a list of coefficient specifications as defined in
{cmd:drop()} above. The single groups should be enclosed in quotes
unless there is only one group and "{it:name} =" is specified. If
"{it:name} =" is omitted, the first element of {it:list} is used as
name. Note that {it:name} may contain spaces.
{p 8 8 2}
For example, if some of the models contain a set of year
dummies, say {cmd:y1 y2 y3}, specify
{com}estout{txt} {it:...}{com}, indicate(year effects = y1 y2 y3){txt}
{p 8 8 2}
to drop the dummies from the table and add a "year effects" row
containing "Yes" for models in which {it:at least one} of the dummies
is present, and "No" for the other models.
{p 8 8 2}
Use the {cmd:labels()} suboption to redefine the indication labels to
be printed in the table. The default is {cmd:labels(Yes No)}. Use
quotes if the labels include spaces,
e.g. {bind:{cmd:labels("in model" "not in model")}}.
{p_end}
{marker rename}
{p 4 8 2}
{cmd:rename(}{it:matchlist}{cmd:)} changes the names of individual
coefficients, where {it:matchlist} is
{p 12 12 2}
{it:oldname} {it:newname} [{it:oldname} {it:newname} ...]
{p 8 8 2}
{it:oldname} can be a parameter name (e.g. {cmd:price}) or a full
name including an equation specification (e.g. {cmd:mean:price})
(abbreviation and wildcards not allowed); {it:newname} is a name without
equation specification and must not already occur in a model's equation.
{cmd:rename()} is applied before matching the models and equations and can
therefore be used to merge different coefficients across models (or
equations if {cmd:unstack} is specified) into a single table row. See the
{cmd:varlabels()} option if you are interested in relabeling coefficients
after matching models and equations.
{p_end}
{marker equations}
{p 4 8 2}
{cmd:equations(}{it:matchlist}{cmd:)} specifies how the models' equations are
to be matched. The default is to match all first equations into one equation
(named {cmd:main}, if the equations have different names) and match the remaining
equations by name. Specify {cmd:equations("")} to match all equations by
name. Alternatively, specify {it:matchlist}, which has the syntax
{it:term} [{cmd:,} {it:term} ... ]
{p 8 8 2}
where {it:term} is
[{it:eqname} {cmd:=}] {it:#}{cmd::}{it:#}...{cmd::}{it:#}{col 50}(syntax 1)
[{it:eqname} {cmd:=}] {it:#}{col 50}(syntax 2)
{p 8 8 2}
In syntax 1, each {it:#} is a number or a period ({cmd:.}). If a number, it
specifies the position of the equation in the corresponding model;
{cmd:1:3:1} would indicate that equation 1 in the first model matches equation
3 in the second, which matches equation 1 in the third. A period indicates
that there is no corresponding equation in the model; {cmd:1:.:1} indicates
that equation 1 in the first matches equation 1 in the third.
{p 8 8 2}
In syntax 2, you specify just one number, say, {cmd:1} or {cmd:2}, and that
is shorthand for {cmd:1:1}...{cmd::1} or {cmd:2:2}...{cmd::2}, meaning that
equation 1 matches across all models specified or that equation 2 matches
across all models specified.
{p 8 8 2}
{it:eqname} is used to name the matched equations. If it is suppressed,
a name such as {cmd:#1} or {cmd:#2} etc. is used, depending on the position
of the {it:term}. For example, {cmd:equations(1)}
indicates that all first equations are to be matched into one equation
named {cmd:#1}. All equations not matched by position are
matched by name.
{p_end}
{marker eform}
{p 4 8 2}
{cmd:eform}[{cmd:(}{it:pattern}{cmd:)}] displays the coefficient table in
exponentiated form. The exponent of {cmd:b} is displayed in lieu of the
untransformed coefficient; standard errors and confidence intervals are
transformed as well. Specify a {it:pattern} if the exponentiation is to be
applied only for certain models. For instance, {cmd:eform(1 0 1)} would
transform the statistics for Models 1 and 3, but not for Model 2. Note that,
unlike {cmd:regress} and {cmd:estimates table}, {cmd:estout} in
eform-mode does not suppress the display of the intercept. To drop the
intercept in eform-mode, specify {cmd:drop(_cons)}. Note: {cmd:eform} is
implemented via the {cmd:transform()} option. If both options are specified,
{cmd:transform()} takes precedence over {cmd:eform}.
{p_end}
{marker transform}
{p 4 8 2}
{cmd:transform(}{it:list} [, {cmd:pattern(}{it:pattern}{cmd:)}]{cmd:)}
displays transformed coefficients, standard errors and
confidence intervals. {it:list} may be
{it:fx} {it:dfx}
{p 8 8 2}
where {it:fx} is the transformation function and {it:dfx} is its first
derivative. {it:fx} is applied to coefficients and confidence
intervals, that is, {it:fx}({cmd:b}) and {it:fx}({cmd:ci}) is displayed
instead of {cmd:b} and {cmd:ci}. {it:dfx} is used to delta transform
standard errors, i.e. {cmd:se}*{it:dfx}({cmd:b}) is displayed instead
of {cmd:se}. Use {cmd:@} as a placeholder for the function's argument
in {it:fx} and {it:dfx}. For example, type
{com}estout{txt} {it:...}{com}, transform(exp(@) exp(@)){txt}
{p 8 8 2}
to report exponentiated results (this is equivalent to specifying
the {cmd:eform} option).
{p 8 8 2}
Alternatively, {it:list} may be specified as
{p 12 12 2}
{it:coefs} {it:fx} {it:dfx} [ {it:...} [{it:coefs}] {it:fx} {it:dfx} ]
{p 8 8 2}
where {it:coefs} identifies the coefficients
to be transformed. Syntax for {it:coefs} is as explained above in the
description of the {cmd:drop()} option (however, include {it:coefs}
in quotes if it contains multiple elements). Say, a model has
two equations, {cmd:price} and {cmd:select}, and you want to
exponentiate the {cmd:price} equation but not the {cmd:select}
equation. You could then type
{com}estout{txt} {it:...}{com}, transform(price: exp(@) exp(@)){txt}
{p 8 8 2}
Note that omitting {it:coef} in the last transformation
specification causes the last transformation to be applied to
all remaining coefficients.
{p 8 8 2}
Specify the {cmd:pattern()} suboption if the transformations are to be
applied only for certain models. For instance, {cmd:pattern(1 0 1)} would
apply the transformation to Models 1 and 3, but not Model 2.
{p_end}
{marker margin}
{p 4 8 2}
{cmd:margin}[{cmd:(}{cmd:u}|{cmd:c}|{cmd:p}{cmd:)}] indicates that the
marginal effects or elasticities be reported instead of the raw
coefficients. This option has an effect only if {cmd:mfx} has been
applied to a model before its results were stored (see help {helpb mfx}) or if a
{cmd:dprobit} (see help {helpb probit}), {cmd:truncreg,marginal}
(help {helpb truncreg}), or {cmd:dtobit} (Cong 2000) model is estimated. One
of the parameters {cmd:u}, {cmd:c}, or {cmd:p}, corresponding to the
unconditional, conditional, and probability marginal effects, respectively,
is required for {cmd:dtobit}. Note that the standard errors, confidence
intervals, t-statistics, and p-values are transformed as well.
{p 8 8 2}
Using the {cmd:margin} option with multiple-equation models can be tricky.
The marginal effects of variables that are used in several equations are
printed repeatedly for each equation because the equations per se are
meaningless for {cmd:mfx}. To display the effects for certain equations only,
specify the {cmd:meqs()} option. Alternatively, use the {cmd:keep()} and
{cmd:drop()} options to eliminate redundant rows. The {cmd:equations()}
option might also be of help here.
{p_end}
{marker discrete}
{p 4 8 2}
{cmd:discrete(}{it:string}{cmd:)} may be used to override the default symbol and
explanatory text used to identify dummy variables when reporting marginal
effects. The first token in {it:string} is used as the symbol. The default is:
{p 12 12 2}
{inp:discrete(" (d)" for discrete change of dummy variable from 0 to 1)}
{p 8 8 2}
To display explanatory text, specify either the {cmd:legend} option or use
the {cmd:@discrete} variable (see the
{help estout##atvar:Remarks on using @-variables}).
{p 8 8 2}
Use {cmd:nodiscrete} to disable the identification of dummy variables as
such. The default is to indicate the dummy variables unless they have been
interpreted as continuous variables in all of the models for which results are
reported (for {cmd:dprobit} and {cmd:dtobit}, however, dummy variables will
always be listed as discrete variables unless {cmd:nodiscrete} is specified).
{p_end}
{marker meqs}
{p 4 8 2}
{cmd:meqs(}{it:eq_list}{cmd:)} specifies that marginals be printed only for the
equations in {it:eq_list}. Specifying this option does not affect how the
marginals are calculated. An {it:eq_list} comprises one or more equation
names (without colons) separated by white space. If you use the
{cmd:equations()} option to match equations, be sure to refer to the matched
equation names and not to the original equation names in the models.
{p_end}
{marker dropped}
{p 4 8 2}
{cmd:dropped}[{cmd:(}{it:string}{cmd:)}] causes null coefficients
(coefficients for which {cmd:e(b)} and {cmd:e(V)} is zero) to be indicated
as dropped. {it:string} specifies the text to be printed in place of
the estimates. The default text is "(dropped)".
{p_end}
{marker level}
{p 4 8 2}
{cmd:level(}{it:#}{cmd:)} assigns the confidence level, in percent, for
the confidence intervals of the coefficients (see help {help level}).
{marker sum}
{dlgtab:Summary statistics}
{marker stats}
{p 4 8 2}
{cmd:stats(}{it:scalarlist}[{cmd:,} {it:stats_subopts}]{cmd:)} specifies
one or more scalar statistics - separated by white space - to be displayed
at the bottom of the table. The {it:scalarlist} may contain numeric
{cmd:e()}-scalars such as, e.g., {cmd:N}, {cmd:r2}, or {cmd:chi2}, but also
string {cmd:e()}-macros such as {cmd:cmd} or {cmd:depvar}. In
addition, the following statistics are available:
{p 12 24 2}
{cmd:aic}{space 5}Akaike's information criterion{p_end}
{p 12 24 2}
{cmd:bic}{space 5}Schwarz's information criterion{p_end}
{p 12 24 2}
{cmd:rank}{space 4}rank of {cmd:e(V)}, i.e. the number of free
parameters in model{p_end}
{p 12 24 2}
{cmd:p}{space 7}the p-value of the model (overall model significance)
{p 8 8 2}
See {bf:[R] estimates table} for details on the {cmd:aic} and {cmd:bic} statistics.
The rules for the determination of {cmd:p} are as follows (note that although
the procedure outlined below is appropriate for most models, there might be
some models for which it is not):
{p 12 15 2}
1) p-value provided: If the {cmd:e(p)} scalar is provided by the
estimation command, it will be interpreted as indicating the p-value
of the model.
{p 12 15 2}
2) F test: If {cmd:e(p)} is not provided, {cmd:estout} checks for the
presence of the {cmd:e(df_m)}, {cmd:e(df_r)}, and {cmd:e(F)}
scalars and, if they are present, the p-value of the model will be
calculated as {cmd:Ftail(df_m,df_r,F)}. This p-value corresponds to
the standard overall F test of linear regression.
{p 12 15 2}
3) chi2 test: Otherwise, if neither {cmd:e(p)} nor {cmd:e(F)} is
provided, {cmd:estout} checks for the presence of {cmd:e(df_m)} and
{cmd:e(chi2)} and, if they are present, calculates the p-value as
{cmd:chi2tail(df_m,chi2)}. This p-value corresponds to the
Likelihood-Ratio or Wald chi2 test.
{p 12 15 2}
4) If neither {cmd:e(p)}, {cmd:e(F)}, nor {cmd:e(chi2)}
is available, no p-value will be reported.
{p 8 8 2}
Type {cmd:ereturn list} after estimating a model to see a list of
the returned {cmd:e()}-scalars and macros (see help {helpb ereturn}). Use
the {helpb estadd} command to add extra statistics and
other information to the {cmd:e()}-returns.
{p 8 8 2}
The following {it:stats_subopts} are available. Use:
{p_end}
{marker statsfmt}
{p 12 16 2}
{cmd:fmt(}{it:{help estout##fmt:fmt}} [{it:{help estout##fmt:fmt}} {it:...}]{cmd:)}
to set the display formats for the scalars statistics in {it:scalarlist}.
{it:{help estout##fmt:fmt}} may be any of Stata's numerical display
formats, e.g., {cmd:%9.0g} or {cmd:%8.2f}, an integer {it:#} such as
{cmd:1} or {cmd:3} to use a fixed format with {it:#} decimal places, or
{cmd:a}{it:#} such as {cmd:a1} or {cmd:a3} to use {cmd:estout}'s adaptive
display format (see {help estout##fmt:Numerical formats} in the {help
estout##rem:Remarks} section for details). For example, {cmd:fmt(3 0)}
would be suitable for {cmd:stats(r2_a N)}. Note that the last specified
format is used for the remaining scalars if the list of scalars is longer
than the list of formats. Thus, only one format needs to be specified if
all scalars are to be displayed in the same format. If no format is
specified, the default format is the display format of the coefficients.
{p_end}
{marker statslabels}
{p 12 16 2}
{cmd:labels(}{it:strlist}[{cmd:,} {it:{help estout##lsub:label_subopts}}]{cmd:)}
to specify labels for rows containing the scalar statistics. If
specified, the labels are used instead of the scalar names. For example:
{p 20 20 2}
{inp:. estout} {it:...}{inp:, stats(r2_a N, labels("Adj. R-Square" "Number of Cases"))}
{p 16 16 2}
Note that names like {cmd:r2_a} produce an error in LaTeX because the
underscore character has a special meaning in LaTeX (to print the
underscore in LaTeX, type {cmd:\_}). Use the {cmd:label()} suboption to
rename such statistics, e.g. {cmd:stats(r2_a, labels(r2\_a))}. An alternative
approach is to use {cmd:estout}'s {cmd:substitute()} option (see the
{help estout##lay:Layout} options).
{p_end}
{marker statsstar}
{p 12 16 2}
{cmd:star}[{cmd:(}{it:scalarlist}{cmd:)}] to specify that the overall
significance of the model be denoted by stars. The stars are attached to
the scalar statistics specified in {it:scalarlist}. If
{it:scalarlist} is omitted, the stars are attached to the first
reported scalar statistic. The printing of the stars is suppressed in
empty results cells (i.e. if the scalar statistic in question is missing
for a certain model). The determination of the model significance is
based on the p-value of the model (see above).
{p 16 16 2}
Hint: It is possible to attach the stars to different scalar statistics
within the same table. For example, specify
{cmd:stats(,star(r2_a r2_p))}
when tabulating OLS estimates and, say, probit estimates. For
the OLS models, the F test will be carried out and the significance
stars will be attached to the {cmd:r2_a}; for the probit models, the
chi2 test will be used and the stars will appear next to the
{cmd:r2_p}.
{p_end}
{marker statslayout}
{p 12 16 2}
{cmd:layout(}{it:array}{cmd:)} to rearrange the summary statistics. The default
is to print the statistics in separate rows beneath one another (in
each model's first column). The syntax for {it:array} is
<{it:row}> [ <{it:row}> ... ]
{p 16 16 2}
where {it:row} is
<{it:cell}> [ <{it:cell}> ... ]
{p 16 16 2}
and {cmd:@} is used as a placeholder for the statistics, one
after another. Rows and cells that contain blanks
have to be embraced in quotes. For example,
{com} ... stats(chi2 df_m N, layout("@ @" @)){txt}
{p 16 16 2}
prints for each model in row 1/column 1 the chi-squared, in
row1/column 2 the degrees of freedom, and in row 2/column 1 the number of
observations. Cells may contain multiple statistics and text other than
the placeholder symbol is printed as is (provided the cells' statistics are part
of the model). For example,
{com} ... stats(chi2 df_m N, layout(`""@ (@)""' @)){txt}
{p 16 16 2}
prints a cell containing "chi2 (df_m)" in the first row and the
number of observations in the second row. Note that the number of columns
in the table only depends on the {cmd:cells()} option (see above) and not
on the {cmd:layout()} suboption. If, for example, the table has two columns
per model and you specify three columns of summary statistics, the summary statistics
in the third column are not printed.
{p_end}
{marker statspchar}
{p 12 16 2}
{cmd:pchar(}{it:symbol}{cmd:)} to specify the placeholder symbol
used in {cmdab:layout()}. The default placeholder is {cmd:@}.
{marker sig}
{dlgtab:Significance stars}
{marker starlevels}
{p 4 8 2}
{cmd:starlevels(}{it:levelslist}{cmd:)} overrides the default thresholds and
symbols for "significance stars". For instance,
{bind:{cmd:starlevels(+ 0.10 * 0.05)}}
sets the following thresholds: {cmd:+} for p<.10 and {cmd:*} for
p<.05. Note that the thresholds must lie in the (0,1] interval and must be
specified in descending order. To, for example, denote insignificant
results, type {bind:{cmd:starlevels(* 1 "" 0.05)}}.
{p_end}
{marker stardrop}
{p 4 8 2}
{cmd:stardrop(}{it:droplist} [{cmd:, relax}]{cmd:)}
identifies the coefficients for which the significance stars be
suppressed. {it:droplist} is specified as in
{helpb estout##drop:drop()} (see above).
{p_end}
{marker starkeep}
{p 4 8 2}
{cmd:starkeep(}{it:keeplist} [{cmd:, relax}]{cmd:)} selects the coefficients
for which the significance stars, if requested, be printed. {it:keeplist}
is specified analogous to {it:droplist} in
{helpb estout##drop:drop()} (see above).
{p_end}
{marker stardetach}
{p 4 8 2}
{cmd:stardetach} specifies that a delimiter be placed between the statistics
and the significance stars (i.e. that the stars are to be displayed in their
own column).
{marker lay}
{dlgtab:Layout}
{marker varwidth}
{p 4 8 2}
{cmd:varwidth(}{it:#}{cmd:)} specifies the number of characters used to display
the names (labels) of regressors and statistics (i.e. {cmd:varwidth}
specifies the width of the table's left stub). Long names (labels) are
abbreviated (depending on the {cmd:abbrev} option) and short or empty
cells are padded out with blanks to fit the width specified by the user.
{cmd:varwidth} set to 0 means that the names are not
abbreviated and no white space is added. Specifying low values may cause
misalignment.
{p_end}
{marker modelwidth}
{p 4 8 2}
{cmd:modelwidth(}{it:#} [{it:#} ...]{cmd:)} designates the number of characters
used to display the results columns. If a non-zero {cmd:modelwidth} is
specified, model names are abbreviated if necessary (depending on the
{cmd:abbrev} option) and short or empty results cells are padded out
with blanks. In contrast, {cmd:modelwidth} does not shorten or truncate
the display of the results themselves (coefficients, t-statistics,
summary statistics, etc.) although it may add blanks if needed.
{cmd:modelwidth} set to 0 means that the model names are not
abbreviated and no white space is added. Specifying low values may
cause misalignment. Specify a list of numbers in {cmd:modelwidth()} to
assign individual widths to the different results columns (the list is
recycled if there are more columns than numbers).
{p 8 8 2}
The purpose of {cmd:modelwidth} is to be able to construct a fixed-format
table and thus make the raw table more readable. Be aware, however, that the
added blanks may cause problems with the conversion to a table in word
processors or spreadsheets.
{p_end}
{marker unstack}
{p 4 8 2}
{cmd:unstack} specifies that the individual equations from multiple-equation
models (e.g. {cmd:mlogit}, {cmd:reg3}, {cmd:heckman}) be placed in
separate columns. The default is to place the equations below one another in a
single column. Summary statistics will be reported for each equation if
{cmd:unstack} is specified and the estimation command is either {cmd:reg3},
{cmd:sureg}, or {cmd:mvreg} (see help {helpb reg3}, help {helpb sureg},
help {helpb mvreg}).
{p_end}
{marker begin}
{p 4 8 2}
{cmd:begin(}{it:string}{cmd:)} specifies a string to be printed at the
beginning of every table row. It is possible to
use special functions such as {cmd:_tab} or {cmd:_skip} in
{cmd:begin()}. For more information on using such functions, see the
description of the functions in help {helpb file}.
{p_end}
{marker delimiter}
{p 4 8 2}
{cmd:delimiter(}{it:string}{cmd:)} designates the delimiter used between the
table columns. See the {cmd:begin} option above for further details.
{p_end}
{marker end}
{p 4 8 2}
{cmd:end(}{it:string}{cmd:)} specifies a string to be printed at the end of
every table row. See the {cmd:begin} option above for further details.
{p_end}
{marker incelldel}
{p 4 8 2}
{cmd:incelldelimiter(}{it:string}{cmd:)} specifies text to be printed
between parameter statistics that have been combined in a single cell
by the {cmd:&} operator. See the {helpb estout##par:cells()} option
for details. The default string is a single blank.
{p_end}
{marker dmarker}
{p 4 8 2}
{cmd:dmarker(}{it:string}{cmd:)} specifies the form of the decimal marker. The
standard decimal symbol (a period or a comma, depending on the input provided
to {cmd:set dp}; see help {help format}) is replaced by {it:string}.
{p_end}
{marker msign}
{p 4 8 2}
{cmd:msign(}{it:string}{cmd:)} determines the form of the minus sign. The
standard minus sign ({cmd:-}) is replaced by {it:string}.
{p_end}
{marker lz}
{p 4 8 2}
{cmd:lz} specifies that the leading zero of fixed format numbers in the
interval (-1,1) be printed. This is the default. Use {cmd:nolz} to advise
{cmd:estout} to omit the leading zeros (that is, to print numbers like
{cmd:0.021} or {cmd:-0.33} as {cmd:.021} and {cmd:-.33}).
{p_end}
{marker extracols}
{p 4 8 2}
{cmd:extracols(}{it:{help numlist}}{cmd:)} inserts empty table columns
at the indicated positions. For example, {cmd:extracols(1)} adds
an extra column between the left stub of the table and the first
column.
{p_end}
{marker substitute}
{p 4 8 2}
{cmd:substitute(}{it:subst_list}{cmd:)} specifies that the substitutions
specified in {it:subst_list} be applied to the estimates table after it has
been created. Specify {it:subst_list} as a list of substitution pairs, that
is:
{p 12 12 2}
{it:from} {it:to} [{it:from} {it:to} ...]
{p 8 8 2}
For example, specify {cmd:substitute(_ \_)} to replace the underscore
character (as in {cmd:_cons} or {cmd:F_p}) with it's LaTeX equivalent {cmd:\_}.
{marker lab}
{dlgtab:Labeling}
{marker label}
{p 4 8 2}
{cmd:label} specifies that variable labels be displayed instead of variable
names in the left stub of the table.
{p_end}
{marker abbrev}
{p 4 8 2}
{cmd:abbrev} specifies that long names and labels be abbreviated if
a {cmd:modelwidth()} and/or a {cmd:varwidth()} is specified.
{p_end}
{marker wrap}
{p 4 8 2}
{cmd:wrap} causes long variable labels to be wrapped if space permits and
a {cmd:varwidth()} is specified. The {cmd:wrap} option is only useful if
several parameter statistics are printed beneath one another and, therefore,
white space is available beneath the labels.
{p_end}
{marker title}
{p 4 8 2}
{cmd:title(}{it:string}{cmd:)} may be used to specify a title for the table.
The {it:string} is printed at the top of the table unless {cmd:prehead()},
{cmd:posthead()}, {cmd:prefoot()}, or {cmd:postfoot()} is specified. In
the latter case, the variable {cmd:@title} can be used to insert the title.
{p_end}
{marker note}
{p 4 8 2}
{cmd:note(}{it:string}{cmd:)} may be used to specify a note for the table.
The {it:string} is printed at the bottom, of the table unless {cmd:prehead()},
{cmd:posthead()}, {cmd:prefoot()}, or {cmd:postfoot()} is specified. In
the latter case, the variable {cmd:@note} can be used to insert the note.
{p_end}
{marker legend}
{p 4 8 2}
{cmd:legend} adds a legend explaining the significance symbols and
thresholds.
{p_end}
{marker prehead}
{p 4 8 2}
{cmd:prehead(}{it:strlist}{cmd:)}, {cmd:posthead(}{it:strlist}{cmd:)},
{cmd:prefoot(}{it:strlist}{cmd:)}, and {cmd:postfoot(}{it:strlist}{cmd:)} may
be used to define lists of text lines to appear before and after the table
heading or the table footer. For example, the specification
{p 12 12 2}
{inp:. estout} {it:...}{inp:, prehead("\S_DATE \S_TIME" "")}
{p 8 8 2}
would add a line containing the current date and time followed by
an empty line before the table. Various substitution functions can be used
as part of the text lines specified in {it:strlist} (see the
{help estout##atvar:Remarks on using @-variables}). For example,
{cmd:@hline} plots a horizontal "line" (series of dashes, by default; see
the {cmd:hlinechar()} option) or {cmd:@M} inserts the number of models
in the table. {cmd:@M} could be used in a LaTeX table heading
as follows:
{p 12 12 2}
{inp:. estout} {it:...}{inp:, prehead(\begin{tabular}{l*{@M}{r}})}
{p_end}
{marker hlinechar}
{p 4 8 2}
{cmd:hlinechar(}{it:string}{cmd:)} specifies the character(s) to be
used in {cmd:@hline}. The default is {cmd:hlinechar(-)}, resulting in a
dashed line. To produce a solid line, specify {cmd:hlinechar(`=char(151)')}
(Windows only; other systems may use other codes).
{p_end}
{marker varlabels}
{p 4 8 2}
{cmd:varlabels(}{it:matchlist}[{cmd:,} {it:suboptions}]{cmd:)} may be used to
relabel the regressors from the models, where {it:matchlist} is
{p 12 12 2}
{it:name} {it:label} [{it:name} {it:label} ...]
{p 8 8 2}
A {it:name} is a parameter name (e.g. {cmd:price}) or a full name
(e.g. {cmd:mean:price}) (abbreviation and wildcards
not allowed). For example, specify {cmd:varlabels(_cons Constant)} to replace
each occurrence of {cmd:_cons} with {cmd:Constant}. (Note that, in LaTeX,
the underscore character produces an error unless it is specified as
{cmd:\_}. Thus, names such as {cmd:_cons} should always be changed if
the estimates table is to be used with LaTeX. The {cmd:substitute()} may also be
helpful; see the {help estout##lay:Layout} options.) The {it:suboptions} are:
{p 12 16 2}
{cmd:blist(}{it:matchlist}{cmd:)} to assign specific prefixes to
certain rows in the table body. Specify the {it:matchlist} as pairs of
regressors and prefixes, that is:
{p 20 20 2}
{it:name} {it:prefix} [{it:name} {it:prefix} ...]
{p 16 16 2}
A {it:name} is a parameter name (e.g. {cmd:price}), an equation name
followed by a colon (e.g. {cmd:mean:}), or a full name
(e.g. {cmd:mean:price}) (abbreviation and wildcards
not allowed). Note that equation names cannot be used if the
{cmd:unstack} option is specified.
{p 12 16 2}
{cmd:elist(}{it:matchlist}{cmd:)} to assign specific suffixes to
certain rows in the table body (see the analogous {cmd:blist()} option
above). This option may, for example, be useful for separating
thematic blocks of variables by
adding vertical space at the end of each block. A LaTeX example:
{p 20 20 2}
{inp:. estout} {it:...}{inp:, varlabels(,elist(price \addlinespace mpg \addlinespace))}
{p 16 16 2}
(the macro {cmd:\addlinespace} is provided by the
{cmd:booktabs} package in LaTeX)
{p 12 16 2}
{it:{help estout##lsub:label_subopts}}, which are
explained in their own section.
{p_end}
{marker labcol2}
{p 4 8 2}
{cmd:labcol2(}{it:strlist}[{cmd:,} {it:suboptions}]{cmd:)} adds a second column
containing additional labels for the coefficients and summary statistics. Labels
containing spaces should be embraced in double quotes ({bind:{cmd:"}{it:label 1}{cmd:"}}
{bind:{cmd:"}{it:label 2}{cmd:"}} etc.). An example would be to add a column
indicating the hypothesized directions of effects, e.g.,
{com}. estout {txt}{it:...}{com}, labcol2(+ - +/- + 0){txt}
{p 8 8 2}
The {it:suboptions} are:
{p 12 16 2}
{cmd:title(}{it:strlist}{cmd:)} to add text in the table header above
the column. Use double quotes to break the title into several
rows (given there are multiple header rows), i.e. specify {it:strlist}
as {bind:{cmd:"}{it:line 1}{cmd:"}} {bind:{cmd:"}{it:line 2}{cmd:"}} etc.
{p 12 16 2}
{cmd:width(}{it:#}{cmd:)} to set the width, in number of characters, of the
column. The default is the value of {cmd:modelwidth()}.
{p_end}
{marker refcat}
{p 4 8 2}
{cmd:refcat(}{it:matchlist}[{cmd:,} {it:suboptions}]{cmd:)} may be used to
insert a row containing information on the reference category
of a categorical variable in the model. {it:matchlist} is
{p 12 12 2}
{it:name} {it:refcat} [{it:name} {it:refcat} ...]
{p 8 8 2}
A {it:name} is a parameter name (e.g. {cmd:_Irep78_2})
(abbreviation and wildcards not allowed). For
example, assume that you include the categorical variable {cmd:rep78}
("Repair Record 1978" from the auto dataset) in some of your models
using {cmd:xi} (see help {helpb xi}). Since {cmd:rep78} has five
levels, 1 through 5, {cmd:xi} will create 4 dummy variables,
{cmd:_Irep78_2} through {cmd:_Irep78_5}. You can now type
{p 12 12 2}
{inp:. estout} {it:...}{inp:, refcat(_Irep78_2 _Irep78_1)}
{p 8 8 2}
to add a table row containing "_Irep78_1" in the left stub and
"ref." in each column in which the {cmd:_Irep78_2}
dummy appears. The {it:suboptions} are:
{p 12 16 2}
{cmd:label(}{it:string}{cmd:)} to specify the label that is printed
in the table columns. The default is {cmd:label(ref.)}. Type {cmd:nolabel}
to suppress the default label.
{p 12 16 2}
{cmd:below} to position the reference category row below the specified
coefficient's row. The default is above. For example, if the 5th
category of {cmd:rep78} is used as reference category, i.e. if
{cmd:_Irep78_1} through {cmd:_Irep78_4} are included in the models,
you might want to type {cmd:refcat(_Irep78_4 _Irep78_5, below)}.
{p_end}
{marker mlabels}
{p 4 8 2}
{cmd:mlabels(}{it:strlist}[{cmd:,} {it:suboptions}]{cmd:)} determines the
model captions printed in the table heading. The default is to use the names of
the stored estimation sets (or their titles, if the {cmd:label} option is
specified and titles are available). The {it:suboptions} for use with
{cmd:mlabels} are:
{p 12 16 2}
{cmd:depvars} to specify that the name (or label) of the (first) dependent
variable of the model be used as model label.
{p 12 16 2}
{cmd:titles} to specify that, if available, the title of the stored
estimation set be used as the model label. Note that the {cmd:label} option
implies {cmd:titles} (unless {cmd:notitles} is specified). {cmd:depvars}
takes precedence over {cmd:titles}.
{p 12 16 2}
{cmd:numbers} to cause the model labels to be numbered consecutively.
{p 12 16 2}
{it:{help estout##lsub:label_subopts}}, which are explained in their own section.
{p_end}
{marker collabels}
{p 4 8 2}
{cmd:collabels(}{it:strlist}[{cmd:,} {it:{help estout##lsub:label_subopts}}]{cmd:)}
specifies labels for the columns within models or equations. The
default is to compose a label from the names or labels of the
statistics printed in the cells of that column. The {it:label_subopts}
are explained in their own section below.
{p_end}
{marker eqlabels}
{p 4 8 2}
{cmd:eqlabels(}{it:strlist}[{cmd:,} {it:suboptions}]{cmd:)}
labels the equations. The default is to use the equation names as
stored by the estimation command, or to use the variable labels if the
equation names correspond to individual variables and the {cmd:label}
option is specified. The {it:suboptions} for use with {cmd:eqlabels}
are:
{p 12 16 2}
{cmd:merge} to merge equation labels and parameter labels instead of
printing equation labels in separate rows. Equation and parameter labels
will be separated by ":" unless another delimiter is specified via the
{cmd:suffix()} suboption (see {it:{help estout##lsub:label_subopts}}).
{cmd:merge} has no effect if {cmd:unstack} is specified.
{p 12 16 2}
{it:{help estout##lsub:label_subopts}}, which are explained in their own
section. Note that {bind:{cmd:eqlabels(none)}} causes {cmd:_cons} to be
replaced with the equation name or label, if {cmd:_cons} is the only
parameter in an equation. This is useful, e.g., for tabulating
{cmd:ologit} or {cmd:oprobit} results in Stata 9. Specify
{bind:{cmd:eqlabels("", none)}} to not replace {cmd:_cons}.
{p_end}
{marker mgroups}
{p 4 8 2}
{cmd:mgroups(}{it:strlist}[{cmd:,} {it:suboptions}]{cmd:)} may be used to
labels groups of (consecutive) models at the top of the table heading. The
labels are placed in the first physical column of the output for the group of
models to which they apply. The {it:suboptions} for use with {cmd:mgroups}
are:
{p 12 16 2}
{cmd:pattern(}{it:pattern}{cmd:)} to establish how the models are to be grouped.
{it:pattern} should be a list of zeros and ones, with ones indicating the
start of a new group of models. For example,
{p 20 20 2}
{inp:. estout} {it:...}{inp:, mgroups("Group 1" "Group 2", pattern(1 0 0 1 0))}
{p 16 16 2}
would group Models 1, 2, and 3 together and then groups Models 4 and 5
together as well. Note that the first group will always start with the first
model regardless of whether the first token of {it:pattern} is a one or a
zero.
{p 12 16 2}
{it:{help estout##lsub:label_subopts}}, which are explained
in their own section. In
particular, the {cmd:span} suboption might be of interest here.
{p_end}
{marker numbers}
{p 4 8 2}
{cmd:numbers}[{cmd:(}{it:l} {it:r}{cmd:)}] adds a row to the table header
displaying consecutive model numbers. The default is to
enclose the numbers in parentheses, i.e. {cmd:(1)}, {cmd:(2)}, etc.
Alternatively, specify {it:l} and {it:r} to change the tokens on the
left and right of each number. For example, {cmd:numbers("" ")")}
would result in {cmd:1)}, {cmd:2)}, etc.
{marker out}
{dlgtab:Output}
{marker replace}
{p 4 8 2}
{cmd:replace} permits {cmd:estout} to overwrite an existing file.
{p_end}
{marker append}
{p 4 8 2}
{cmd:append} specifies that the output be appended to an existing file. It
may be used even if the file does not yet exist.
{p_end}
{marker type}
{p 4 8 2}
{cmd:type} specifies that the assembled estimates table be printed in the
results window and the log file. This is the default unless {cmd:using} is
specified. Use {cmd:notype} to suppress the display of the table.
{p_end}
{marker showtabs}
{p 4 8 2}
{cmd:showtabs} requests that tabs be displayed as {cmd:<T>}s in both the
results window and the log file instead of in expanded form. This option does
not affect how tabs are written to the text file specified by {cmd:using}.
{p_end}
{marker topfile}
{p 4 8 2}
{cmd:topfile(}{it:filename}{cmd:)} and
{cmd:bottomfile(}{it:filename}{cmd:)} may be used to insert text before
and after the table, where the text is imported from a file on disk. Note that
{cmd:substitute()} does not apply to text inserted by {cmd:topfile()} or
{cmdab:bottomfile()}.
{marker def}
{dlgtab:Defaults}
{marker style}
{p 4 8 2}
{cmd:style(}{it:style}{cmd:)} specifies a "style" for the output
table. {cmdab:def:aults:(}{it:style}{cmd:)} is a synonym for
{cmd:style(}{it:style}{cmd:)}. A "style" is a named combination of options
that is saved in an auxiliary file called {cmd:estout_}{it:style}{cmd:.def}.
In addition, there are five internal styles called {cmd:smcl}
(default for screen display), {cmd:tab} (export default), {cmd:fixed},
{cmd:tex}, and {cmd:html}. The {cmd:smcl} style is suitable for displaying
the table in Stata's results window and is the default unless
{cmd:using} is specified. It includes {help smcl:SMCL} formatting tags and
horizontal lines to structure the table. The particulars of the other styles are:
settings {col 38}styles
{col 26}{cmd:tab}{col 34}{cmd:fixed}{col 42}{cmd:tex}{col 50}{cmd:html}
{hline 47}
{cmd:begin} {col 50}{cmd:<tr><td>}
{cmd:delimiter} {col 26}{cmd:_tab}{col 34}{cmd:" "}{col 42}{cmd:&}{col 50}{cmd:</td><td>}
{cmd:end} {col 42}{cmd:\\}{col 50}{cmd:</td></tr>}
{cmd:varwidth} {col 26}{cmd:0}{col 34}{cmd:12/20}*{col 42}{cmd:12/20}*{col 50}{cmd:12/20}*
{cmd:modelwidth}{col 26}{cmd:0}{col 34}{cmd:12}{col 42}{cmd:12}{col 50}{cmd:12}
{cmd:abbrev} {col 26}off{col 34}on{col 42}off{col 50}off
(* if {cmd:label} is on)
{p 8 8 2}
{cmd:tab} is the default export style (i.e. if {cmd:using} is specified).
{p 8 8 2}
Note that explicitly specified options take precedence
over settings provided by a style. For example, if you type
{com}. estout, delimiter("") style(tab){txt}
{p 8 8 2}
then the column delimiter will be set to empty string since the
{cmd:delimiter()} option overwrites the default from the {cmd:tab}
style. Similarly, specifying
{cmd:noabbrev} will turn abbreviation off if using the {cmd:fixed}
style.
{p 8 8 2}
See {help estout##defaults:Defaults files} in the
{help estout##rem:Remarks} section to make available your own style.
{marker lsub}
{it:{dlgtab:label_subopts}}
{p 4 4 2}
The following suboptions may be used within the {cmd:mgroups()},
{cmd:mlabels()}, {cmd:collabels()}, {cmd:eqlabels()},
{cmd:varlabels()}, and {cmd:stats(, labels())} options:
{p 4 8 2}
{cmd:none} suppresses the printing of the labels or drops the
part of the table heading to which it applies. Note that instead of
typing {bind:{it:option}{cmd:(, none)}} you may simply specify
{it:option}{cmd:(none)}.
{p 4 8 2}
{cmd:prefix(}{it:string}{cmd:)} specifies a common prefix to be added to each
label.
{p 4 8 2}
{cmd:suffix(}{it:string}{cmd:)} specifies a common suffix to be added to each
label.
{p 4 8 2}
{cmd:begin(}{it:strlist}{cmd:)} specifies a prefix to be printed at the
beginning of the part of the table to which it applies. If {cmd:begin} is
specified in {cmd:varlabels()} or {cmd:stats(,labels())}, the prefix will
be repeated for each regressor or summary statistic.
{p 4 8 2}
{cmd:first} specifies that the first occurrence of the {cmd:begin()}-prefix in
{cmd:varlabels()} or {cmd:stats(,labels())} be printed. This
is the default. Use {cmd:nofirst} to suppress the first occurrence of the
prefix. In {cmd:varlabels()}, {cmd:nofirst} applies equation-wise, i.e., the first
{cmd:begin()}-prefix in each equation is suppressed (unless {cmd:unstack} is
specified).
{p 4 8 2}
{cmd:end(}{it:strlist}{cmd:)} specifies a suffix to be printed at the end of the
part of the table to which it applies. If {cmd:end} is specified in
{cmd:varlabels()} or {cmd:stats(,labels())}, the suffix will be repeated
for each regressor or summary statistic.
{p 4 8 2}
{cmd:last} specifies that the last occurrence of the {cmd:end()}-suffix in
{cmd:varlabels()} or {cmd:stats(,labels())} be printed. This
is the default. Use {cmd:nolast} to suppress the last occurrence of the
suffix. In {cmd:varlabels()}, {cmd:nolast} applies equation-wise, i.e., the last
{cmd:end()}-suffix in each equation is suppressed (unless {cmd:unstack} is
specified).
{p 4 8 2}
{cmd:replace} causes the label suboption {cmd:begin()}-prefix and {cmd:end()}-suffix
to be used instead of the global {cmd:begin()} and {cmd:end()} strings. The default
is to print both. {cmd:replace} also applies to {cmd:blist()} and {cmd:elist()}
if specified in {cmd:varlabels()}.
{p 4 8 2}
{cmd:span} causes labels to span columns, i.e. extends the labels across
several columns, if appropriate. This suboption is relevant only for the
{cmd:mgroups()}, {cmd:mlabels()}, {cmd:eqlabels()}, and
{cmd:collabels()} options. The {cmd:@span} string returns the number of
spanned columns if it is included in the label, prefix, or suffix. A LaTeX example:
{p 8 8 2}
{inp:. estout} {it:...}{inp:, mlabels(, span prefix(\multicolumn{@span}{c}{) suffix(}))}
{p 4 8 2}
{cmd:erepeat(}{it:string}{cmd:)} specifies a string that is repeated for each
group of spanned columns at the very end of the row if the {cmd:span}
suboption is specified. This suboption is relevant only for the
{cmd:mgroups()}, {cmd:mlabels()}, {cmd:eqlabels()}, and
{cmd:collabels()} options. If the {cmd:@span} string is included in
{it:string} it will be replaced by the range of columns spanned. A LaTeX example:
{p 8 8 2}
{inp:. estout} {it:...}{inp:, mlabels(, span erepeat(\cline{@span}))}
{p 4 8 2}
{cmd:lhs(}{it:string}{cmd:)} inserts {it:string} into the otherwise empty cell
in the left stub of the row of the table heading to which it applies. This
suboption is relevant only for the {cmd:mgroups()}, {cmd:mlabels()},
{cmd:eqlabels()}, and {cmd:collabels()} options.
{marker msub}
{it:{dlgtab:matrix_subopts}}
{p 4 4 2}
The following suboptions may be applied within the {cmd:matrix()},
{cmd:e()}, or {cmd:r()} argument used to tabulate a matrix:
{p_end}
{marker mfmt}
{p 4 8 2}
{cmd:fmt(}{it:fmtlist}{cmd:)} sets the display formats for the matrix.
{it:fmtlist} contains a list of format specifications, one for each
column of the matrix. {it:fmtlist} is recycled if it supplies less
specifications than there are columns in the matrix. A format
specification may be a single {it:{help estout##fmt:fmt}} such as,
e.g., {cmd:%9.0g} or {cmd:a3} (see {help estout##fmt:Numerical formats}
in the {help estout##rem:Remarks} section for details) to be applied to
all cells in the column. Alternatively, a format specification may be
a list of {it:{help estout##fmt:fmt}}s, enclosed in double quotes, to be
used for the cells in the column one by one. The last format in the
list is used for the remaining cells if the number of cells in the
column is greater than the number of formats in the list. Also see the
{help estout##ex7:examples} below.
{p_end}
{marker mtranspose}
{p 4 8 2}
{cmd:transpose} causes the matrix to be transposed for tabulation.
{marker exa}
{title:Examples}
Contents
{help estout##intro:Introduction}
{help estout##ex1:Publication style table}
{help estout##ex2:t-statistics for selected variables only}
{help estout##ex3:Summary statistics only}
{help estout##ex4:Table of descriptives}
{help estout##ex5:Unstack multiple equations}
{help estout##ex6:Marginal effects}
{help estout##ex7:Tabulating a matrix}
{p 4 4 2} Please first read the {help estout##intro:Introduction}. The
other examples are more advanced and intended for users
already familiar with the basic features of
{cmd:estout}. Additional examples can be found in Jann (2005) and at
{browse "http://repec.org/bocode/e/estout"}.
{marker intro}
{dlgtab:Introduction}
{p 4 4 2}
The full syntax of {cmd:estout} is rather complex and is to be found
above. However, consider the following basic syntax, which
includes only the most important options:
{p 8 15 2}
{cmd:estout} [ {it:namelist} ] [ {cmd:using} {it:filename} ] [ {cmd:,}
{cmdab:c:ells:(}{it:array}{cmd:)}
{cmdab:s:tats:(}{it:scalarlist}{cmd:)}
{cmdab:sty:le:(}{it:style}{cmd:)}
{it:more_options}
]
{p 4 4 2}
where {it:namelist} is a list of the names of stored estimation sets (the name
list can be entered as {cmd:*} to refer to all stored estimates). The
{cmd:cells()} and {cmd:stats()} options determine the primary contents of
the table. The {cmd:style()} option determines the basic formatting of the
table.
{p 4 4 2}{ul:Basic usage}
{p 4 4 2}
The general procedure for using {cmd:estout} is to first store several
models using the {cmd:estimates store} or the {helpb eststo} command and then apply
{cmd:estout} to display or save a table of the estimates. By default,
{cmd:estout} displays a plain table of the coefficients of the models and
uses {help SMCL} tags and horizontal lines to structure the table:
{com}. sysuse auto
{txt}(1978 Automobile Data)
{com}. replace price = price / 1000
{txt}price was {res}int{txt} now {res}float
{txt}(74 real changes made)
{com}. replace weight = weight / 1000
{txt}weight was {res}int{txt} now {res}float
{txt}(74 real changes made)
{com}. quietly regress price weight mpg
{txt}
{com}. estimates store m1, title(Model 1)
{txt}
{com}. generate forXmpg = foreign * mpg
{txt}
{com}. quietly regress price weight mpg forXmpg foreign
{txt}
{com}. estimates store m2, title(Model 2)
{txt}
{com}. estout m1 m2
{res}
{txt}{hline 38}
{txt} m1 m2
{txt} b b
{txt}{hline 38}
{txt}weight {res} 1.746559 4.613589{txt}
{txt}mpg {res} -.0495122 .2631875{txt}
{txt}forXmpg {res} -.3072165{txt}
{txt}foreign {res} 11.24033{txt}
{txt}_cons {res} 1.946068 -14.44958{txt}
{txt}{hline 38}
{p 4 4 2}Alternatively, if {cmd:using} is specified, {cmd:estout} writes a
raw tab-delimited table (without SMCL tags and without lines) to the
indicated file ({cmd:*} is used in the following example to indicate that
all stored models be tabulated):
{com}. estout * using example.txt
{txt}(output written to {browse `"example.txt"'})
{com}. type example.txt
{res} m1 m2
b b
weight 1.746559 4.613589
mpg -.0495122 .2631875
forXmpg -.3072165
foreign 11.24033
_cons 1.946068 -14.44958
{txt}
{p 4 4 2} The table looks messy in the Stata results window or the Stata
log because the columns are tab-separated (note that tab characters are not
preserved in the results window or the log). However, the table would look
tidy if "example.txt" were opened, for example, in a spreadsheet program.
{p 4 4 2}{ul:Choosing a style}
{p 4 4 2}{cmd:estout} has a {cmd:style()} option to set the basic format of
the table. The default style for screen display is the {cmd:smcl} style.
The default export style (i.e. if {cmd:using} is specified) is the
{cmd:tab} style. (See the examples above.) Other predefined styles are
{cmd:fixed}, {cmd:tex}, and {cmd:html}, but it is also possible to define
one's own styles (see {help estout##defaults:Defaults files} in the
{help estout##rem:Remarks} section). The {cmd:tex} style, for example, modifies
the output table for use with LaTeX's tabular environment:
{com}. estout *, style(tex) varlabels(_cons \_cons)
{res}
& m1& m2\\
& b& b\\
weight & 1.746559& 4.613589\\
mpg & -.0495122& .2631875\\
forXmpg & & -.3072165\\
foreign & & 11.24033\\
\_cons & 1.946068& -14.44958\\
{txt}
{p 4 4 2}
Note that {cmd:_cons} has been replaced by its LaTeX equivalent in the example above
using the {cmd:varlabels()} option (the underscore character produces an
error in LaTeX unless it is preceded by a backslash). For more
information on the {cmd:varlabels()} option, see {cmd:estout}'s
{help estout##lab:Labeling} options.
{p 4 4 2}{ul:The cells option}
{p 4 4 2}
Use the {cmd:cells()} option to specify the parameter statistics to be
tabulated and how they are to be arranged. The parameter statistics
available are {cmd:b} (point estimates; the default), {cmd:se} (standard
errors), {cmd:t} (t-/z-statistics), {cmd:p} (p-values), {cmd:ci}
(confidence intervals; to display the lower and upper bounds in separate
cells use {cmd:ci_l} and {cmd:ci_u}), as well as any additional
parameter statistics included in the {cmd:e()}-returns for the models
(see {cmd:estout}'s {help estout##par:Parameter Statistics} options). For
example, {cmd:cells(b se)} results
in the reporting of point estimates and standard errors:
{com}. estout *, cells(b se)
{res}
{txt}{hline 38}
{txt} m1 m2
{txt} b/se b/se
{txt}{hline 38}
{txt}weight {res} 1.746559 4.613589{txt}
{res} .6413538 .7254961{txt}
{txt}mpg {res} -.0495122 .2631875{txt}
{res} .086156 .1107961{txt}
{txt}forXmpg {res} -.3072165{txt}
{res} .1085307{txt}
{txt}foreign {res} 11.24033{txt}
{res} 2.751681{txt}
{txt}_cons {res} 1.946068 -14.44958{txt}
{res} 3.59705 4.42572{txt}
{txt}{hline 38}
{p 4 4 2}
Multiple statistics are placed in separate rows beneath one another by
default as in the example above. However, elements that are listed in
quotes or in parentheses are placed beside one another. For
example, specifying {bind:{cmd:cells("b se t p")}} or, equivalently,
{bind:{cmd:cells((b se t p))}} produces the following table:
{com}. estout m2, cells("b se t p")
{res}
{txt}{hline 64}
{txt} m2
{txt} b se t p
{txt}{hline 64}
{txt}weight {res} 4.613589 .7254961 6.359219 1.89e-08{txt}
{txt}mpg {res} .2631875 .1107961 2.375421 .0203122{txt}
{txt}forXmpg {res} -.3072165 .1085307 -2.830687 .0060799{txt}
{txt}foreign {res} 11.24033 2.751681 4.084896 .0001171{txt}
{txt}_cons {res} -14.44958 4.42572 -3.26491 .0017061{txt}
{txt}{hline 64}
{p 4 4 2}
The two approaches can be combined. For example, {cmd:cells("b p" se)}
would produce a table with point estimates and standard errors beneath one
another in the first column and p-values in the top row of the second
column for each model.
{p 4 4 2}
Note that for each statistic named in the {cmd:cells()} option a set of
suboptions may be specified in parentheses. For example, in social sciences
it is common to report standard errors or t-statistics in parentheses beneath
the coefficients and to indicate the significance of individual
coefficients with stars. Furthermore, the results are rounded. Just such a
table can be created using the following procedure:
{com}. estout *, cells(b(star fmt(3)) t(par fmt(2)))
{res}
{txt}{hline 44}
{txt} m1 m2
{txt} b/t b/t
{txt}{hline 44}
{txt}weight {res} 1.747** 4.614***{txt}
{res} (2.72) (6.36) {txt}
{txt}mpg {res} -0.050 0.263* {txt}
{res} (-0.57) (2.38) {txt}
{txt}forXmpg {res} -0.307** {txt}
{res} (-2.83) {txt}
{txt}foreign {res} 11.240***{txt}
{res} (4.08) {txt}
{txt}_cons {res} 1.946 -14.450** {txt}
{res} (0.54) (-3.26) {txt}
{txt}{hline 44}
{p 4 4 2}
The {cmd:estout} default is to display {cmd:*} for p<.05,
{cmd:**} for p<.01, and {cmd:***} for p<.001. However, note that
the significance thresholds and symbols are fully customizable (see {cmd:estout}'s
{help estout##sig:Significance stars} options).
{p 4 4 2}{ul:The stats option}
{p 4 4 2}
Finally, use the {cmd:stats()} option to specify scalar
statistics to be displayed for each model in the table footer. The
available scalar statistics are {cmd:aic} (Akaike's information criterion),
{cmd:bic} (Schwarz's information criterion), {cmd:rank} (the rank of
{cmd:e(V)}, i.e. the number of free parameters in model), {cmd:p} (the
p-value of the model), as well as any numeric or string scalars contained in the
{cmd:e()}-returns for the models (see
{cmd:estout}'s
{help estout##sum:Summary statistics} options). For example, specify
{cmd:stats(r2 bic N)} to add the R-squared, BIC, and the number of cases:
{com}. estout *, stats(r2 bic N)
{res}
{txt}{hline 38}
{txt} m1 m2
{txt} b b
{txt}{hline 38}
{txt}weight {res} 1.746559 4.613589{txt}
{txt}mpg {res} -.0495122 .2631875{txt}
{txt}forXmpg {res} -.3072165{txt}
{txt}foreign {res} 11.24033{txt}
{txt}_cons {res} 1.946068 -14.44958{txt}
{txt}{hline 38}
{txt}r2 {res} .2933891 .5516277{txt}
{txt}bic {res} 356.2918 331.2406{txt}
{txt}N {res} 74 74{txt}
{txt}{hline 38}
{marker ex1}
{dlgtab:Publication style table}
{com}. label variable foreign "Foreign car type"
{txt}
{com}. label variable forXmpg "Foreign*Mileage"
{txt}
{com}. estout *, cells(b(star fmt(%9.3f)) se(par)) ///
> stats(r2_a N, fmt(%9.3f %9.0g) labels(R-squared)) ///
> legend label collabels(none) varlabels(_cons Constant)
{res}
{txt}{hline 52}
{txt} Model 1 Model 2
{txt}{hline 52}
{txt}Weight (lbs.) {res} 1.747** 4.614***{txt}
{res} (0.641) (0.725) {txt}
{txt}Mileage (mpg) {res} -0.050 0.263* {txt}
{res} (0.086) (0.111) {txt}
{txt}Foreign*Mileage {res} -0.307** {txt}
{res} (0.109) {txt}
{txt}Foreign car type {res} 11.240***{txt}
{res} (2.752) {txt}
{txt}Constant {res} 1.946 -14.450** {txt}
{res} (3.597) (4.426) {txt}
{txt}{hline 52}
{txt}R-squared {res} 0.273 0.526 {txt}
{txt}N {res} 74 74 {txt}
{txt}{hline 52}
{txt}* p<0.05, ** p<0.01, *** p<0.001
{marker ex2}
{dlgtab:t-statistics for selected variables only}
{com}. estout *, cells(b(star) t(par keep(mpg)))
{res}
{txt}{hline 44}
{txt} m1 m2
{txt} b/t b/t
{txt}{hline 44}
{txt}weight {res} 1.746559** 4.613589***{txt}
{txt}mpg {res} -.0495122 .2631875* {txt}
{res} (-.5746806) (2.375421) {txt}
{txt}forXmpg {res} -.3072165** {txt}
{txt}foreign {res} 11.24033***{txt}
{txt}_cons {res} 1.946068 -14.44958** {txt}
{txt}{hline 44}
{marker ex3}
{dlgtab:Summary statistics only}
{com}. estout *, cells(none) stats(r2_a bic N, star)
{res}
{txt}{hline 44}
{txt} m1 m2
{txt}{hline 44}
{txt}r2_a {res} .2734846*** .5256351***{txt}
{txt}bic {res} 356.2918 331.2406 {txt}
{txt}N {res} 74 74 {txt}
{txt}{hline 44}
{marker ex4}
{dlgtab:Table of descriptives}
{com}. quietly generate x = uniform()
{txt}
{com}. quietly regress x price weight mpg foreign
{txt}
{com}. estadd mean
{txt}added matrix:
e(mean) : {res}1 x 5
{txt}
{com}. estadd sd, nobinary
{txt}added matrix:
e(sd) : {res}1 x 5
{txt}
{com}. estout, cells("mean sd") stats(N) mlabels(,none) drop(_cons)
{res}
{txt}{hline 38}
{txt} mean sd
{txt}{hline 38}
{txt}price {res} 6.165257 2.949496{txt}
{txt}weight {res} 3.019459 .7771936{txt}
{txt}mpg {res} 21.2973 5.785503{txt}
{txt}foreign {res} .2972973 {txt}
{txt}{hline 38}
{txt}N {res} 74 {txt}
{txt}{hline 38}
{marker ex5}
{dlgtab:Unstack multiple equations}
{com}. quietly sureg (price foreign weight length) ///
> (mpg displ = foreign weight)
{txt}
{com}. estout, cells(b t(par)) stats(r2 chi2 p) unstack
{res}
{txt}{hline 51}
{txt} price mpg displacement
{txt} b/t b/t b/t
{txt}{hline 51}
{txt}foreign {res} 3.57526 -1.650029 -25.6127{txt}
{res} (5.749891) (-1.565555) (-2.047999){txt}
{txt}weight {res} 5.691462 -6.587886 96.75485{txt}
{res} (6.182983) (-10.55641) (13.06594){txt}
{txt}length {res} -.0882711 {txt}
{res} (-2.809689) {txt}
{txt}_cons {res} 4.506212 41.6797 -87.23547{txt}
{res} (1.255897) (19.64914) (-3.46585){txt}
{txt}{hline 51}
{txt}r2 {res} .548808 .6627029 .8115213{txt}
{txt}chi2 {res} 89.73586 145.3912 318.6174{txt}
{txt}p {res} 2.50e-19 2.68e-32 6.50e-70{txt}
{txt}{hline 51}
{marker ex6}
{dlgtab:Marginal effects}
{com}. generate record = 0
{txt}
{com}. replace record = 1 if rep > 3
{txt}(34 real changes made)
{com}. eststo raw: quietly logit foreign mpg record
{txt}
{com}. eststo mfx: quietly mfx
{txt}
{com}. estout raw mfx, cells("b Xmfx_X(pattern(0 1))" se(par)) margin legend
{res}
{txt}{hline 51}
{txt} raw mfx
{txt} b/se b/se Xmfx_X
{txt}{hline 51}
{txt}mpg {res} .1079219 .0184528 21.2973{txt}
{res} (.0565077) (.0101674) {txt}
{txt}record (d) {res} 2.435068 .4271707 .4594595{txt}
{res} (.7128444) (.1043178) {txt}
{txt}_cons {res} -4.689347 {txt}
{res} (1.326547) {txt}
{txt}{hline 51}
{txt}(d) for discrete change of dummy variable from 0 to 1
{marker ex7}
{dlgtab:Tabulating a matrix}
{p 4 4 2}
Use {cmd:estout matrix(}{it:matname}{cmd:)} to tabulate Stata matrix
{it:matname}. Example:
{com}. set seed 123
{txt}
{com}. matrix A = matuniform(3,2)
{txt}
{com}. matrix list A
{txt}A[3,2]
c1 c2
r1 {res}.91204397 .0075452
{txt}r2 {res}.28085881 .46027868
{txt}r3 {res}.56010592 .67319061
{txt}
{com}. estout matrix(A)
{res}
{txt}{hline 38}
{txt} A
{txt} c1 c2
{txt}{hline 38}
{txt}r1 {res} .912044 .0075452{txt}
{txt}r2 {res} .2808588 .4602787{txt}
{txt}r3 {res} .5601059 .6731906{txt}
{txt}{hline 38}
{p 4 4 2}
Numeric formats for the columns can be set using the {cmd:fmt()}
suboption:
{com}. estout matrix(A, fmt(2 3))
{res}
{txt}{hline 38}
{txt} A
{txt} c1 c2
{txt}{hline 38}
{txt}r1 {res} 0.91 0.008{txt}
{txt}r2 {res} 0.28 0.460{txt}
{txt}r3 {res} 0.56 0.673{txt}
{txt}{hline 38}
{p 4 4 2}
A list of formats can be specified for each column:
{com}. estout matrix(A, fmt("2 3 4" "4 3 2"))
{res}
{txt}{hline 38}
{txt} A
{txt} c1 c2
{txt}{hline 38}
{txt}r1 {res} 0.91 0.0075{txt}
{txt}r2 {res} 0.281 0.460{txt}
{txt}r3 {res} 0.5601 0.67{txt}
{txt}{hline 38}
{marker rem}
{title:Remarks}
Contents
{help estout##fmt:Numerical formats}
{help estout##spchar:Special characters}
{help estout##atvar:Using @-variables}
{help estout##defaults:Defaults files}
{marker fmt}
{dlgtab:Numerical formats}
{p 4 4 2}
Numerical display formats may be specified in {cmd:estout}
as follows:
{p 5 8 2}
1. Official Stata's display formats: You may specify formats, such as
{cmd:%9.0g} or {cmd:%8.2f}. See help {help format} for a list
of available formats. {cmd:%g} or {cmd:g} may be used as a
synonym for {cmd:%9.0g}.
{p 5 8 2}
2. Fixed format: You may specify an integer value such as {cmd:0},
{cmd:1}, {cmd:2}, etc. to request a display format with a fixed number
of decimal places. For example, {cmd:cells(t(fmt(3)))} would display
t-statistics with three decimal places.
{p 5 8 2}
3. Automatic format: You may specify {cmd:a1}, {cmd:a2}, ..., or
{cmd:a9} to cause {cmd:esttab} to choose a reasonable display format for
each number depending on the number's value. {cmd:a} may be used as a
synonym for {cmd:a3}. The {it:#} in
{cmd:a}{it:#} determines the minimum precision according to the
following rules:
{p 10 12 2}
o Absolute numbers smaller than 1 are displayed with {it:#}
significant decimal places (i.e. with {it:#} decimal places ignoring
any leading zeros after the decimal point). For example,
{cmd:0.00123456} is displayed as {cmd:0.00123} if the format is
{cmd:a3}.
{p 10 12 2}
o Absolute numbers greater than 1 are displayed with as many digits
required to retain at least one decimal place and are displayed with
a minimum of ({it:#} + 1) digits. For example, if the format is
{cmd:a3}, {cmd:1.23456} is displayed as {cmd:1.235}, {cmd:12.3456} is
displayed as {cmd:12.35}, and {cmd:1234.56} is displayed as
{cmd:1234.6}.
{p 10 12 2}
o In any case, integers are displayed with zero decimal places, and
very large or very small absolute numbers are displayed in
exponential format.
{marker spchar}
{dlgtab:Special characters}
{p 4 4 2}
The {cmd:\} and {cmd:$} characters and quotation marks have
special meanings in Stata. You should therefore consider the following
instructions if you, for example, intend to specify akward delimiters or
specify special characters in labels:
{p 6 8 2}- Strings containing unmatched quotes should be enclosed in compound double
quotes (thus, {cmd:delimiter(`"""')} results in columns
delimited by {cmd:"}, while {cmd:delimiter(")} produces an error).
{p 6 8 2}- The backslash character is used to delay macro expansion in
Stata. Specifying {cmd:\\} in Stata 8 just results in the printing of {cmd:\}. To get
a double backslash in Stata 8 (the {cmd:\newline} command in TeX), type {cmd:\\\}.
{p 6 8 2}- The dollar sign is used for global macro expansion in Stata. Thus,
{cmd:$x} would result in the display of the contents of global macro
{cmd:x} (or nothing, if the macro is empty). Therefore, use
{cmd:\$} to produce {cmd:$} in the output. For math mode in LaTeX I
recommend using {cmd:\(}...{cmd:\)} instead of {cmd:$}...{cmd:$}.
{p 4 4 2}
Stata's {cmd:char()} function may also be used to specify odd characters
(see help {help strfun}). In particular, {cmd:"`=char(9)'"}
results in a tab character and {cmd:"`=char(13)'"} results
in a carriage return. For example, {bind:{cmd:delimiter(" `=char(9)' ")}}
specifies that a tab character with a leading and
a trailing blank be used as delimiter.
{p 4 4 2} {it:Tip:} It is sometimes very useful to set the format of all cells in a
spreadsheet to "Text" before pasting the estimates table. This prevents the
spreadsheet program from trying to interpret the cells and ensures that the contents
of the table remain unchanged.
{marker atvar}
{dlgtab:Using @-variables}
{p 4 4 2}
{cmd:estout} features several variables that can be used within string
specifications. The following list provides an overview of these variables.
{p 5 8 2}o{space 2}In {cmd:prehead()}, {cmd:posthead()}, {cmd:prefoot()},
and {cmd:postfoot()}, in the {cmd:begin()} and {cmd:end()} label
suboptions, and in the {cmd:blist()} and {cmd:elist()} suboptions
in {cmd:varlabels()}:
{p 12 16 2}{cmd:@span} to return the value of a count variable for the total number of physical
columns of the table.
{p 12 16 2}{cmd:@M} to return the number of models in the table.
{p 12 16 2}{cmd:@E} to return the total number columns containing separate equations.
{p 12 16 2}{cmd:@width} to return the total width of the table (number of characters).
{p 12 16 2}{cmd:@hline} to return a horizontal line (series of dashes, by default;
see the {cmd:hlinechar()} option).
{p 5 8 2}o{space 2}In {cmd:prehead()}, {cmd:posthead()}, {cmd:prefoot()},
and {cmd:postfoot()}:
{p 12 16 2}{cmd:@title} to return the title specified with the {cmd:title()} option.
{p 12 16 2}{cmd:@note} to return the note specified with the {cmd:note()} option.
{p 12 16 2}{cmd:@discrete} to return the explanations provided by the
{cmd:discrete()} option (provided that the {cmd:margin} option is activated).
{p 12 16 2}{cmd:@starlegend} to return a legend explaining the significance symbols.
{p 5 8 2}o{space 2}In the {cmd:prefix()} and {cmd:suffix()} suboptions of {cmd:mgroups()},
{cmd:mlabels()}, {cmd:eqlabels()}, and
{cmd:collabels()}, and in the labels specified in these options:
{p 12 16 2}{cmd:@span} to return the number of spanned columns.
{p 5 8 2}o{space 2}In the {cmd:erepeat()} suboption of
{cmd:mgroups()}, {cmd:mlabels()}, {cmd:eqlabels()}, and
{cmd:collabels()}:
{p 12 16 2}{cmd:@span} to return the range of spanned columns (e.g. {cmd:2-4} if columns 2, 3 and 4
are spanned).
{marker defaults}
{dlgtab:Defaults files}
{p 4 4 2}{ul:Creating new defaults files:}
{p 4 4 2}
To make available an own set
of default options, proceed as follows:
{p 8 11 2}
1. Download "estout_mystyle.def" from the SSC
Archive (click
{stata "copy http://fmwww.bc.edu/repec/bocode/e/estout_mystyle.def estout_mystyle.def, text":here}
to copy the file from SSC and store it in the working directory).
{p 8 11 2}
2. Open "estout_mystyle.def" in a text editor and make the desired modifications
(click {stata "doedit estout_mystyle.def":here} to open "estout_mystyle.def" in Stata's Do-File
Editor).
{p 8 11 2}
3. Save the file in the current directory or elsewhere
in the ado-file path as {cmd:estout_}{it:newstyle}{cmd:.def} (see help {help sysdir}).
{p 4 4 2}To use the new options set in {cmd:estout}, then type:
{inp:. estout} {it:...} {inp:, style(}{it:newstyle}{inp:)}
{p 4 4 2}{ul:Defaults files syntax:}
{p 4 4 2}
{cmd:estout} has two main types of options, which are treated differentially
in defaults files. On the one hand, there are simple on/off options without
arguments, like {cmd:legend} or {cmd:showtabs}. To turn such an option on,
enter the option followed by the options name as an argument, i.e. add the line
{it:option} {it:option}
{p 4 4 2}
to the defaults file. For example,
{inp:legend legend}
{p 4 4 2}
specifies that a legend be printed in the table footer. Otherwise, if you want
to turn the option of, just delete or comment out the line that contains it (or
specify {it:option} without an argument).
{p 4 4 2}
To temporarily turn off an option that has been activated in a defaults file,
specify {cmd:no}{it:option} in the command line (do not, however, use
{cmd:no}{it:option} in defaults files). For example, if the legend has been
turned on in the defaults file, but you want to suppress it in a specific call of
{cmd:estout}, type
{inp:. estout} {it:...}{inp:, nolegend}
{p 4 4 2}
On the other hand, there are options that take arguments, such as
{cmd:prehead(}{it:args}{cmd:)}, {cmd:delimiter(}{it:args}{cmd:)}, or
{cmd:stats(}{it:args}{cmd:,} {it:...}{cmd:)}. Such options are specified as
{it:option} {it:args}
{p 4 4 2}
in the defaults file (where {it:args} must not include suboptions; see
below). Specifying an option in the command line overwrites the settings from
the defaults file. However, note that a {cmd:no} form, which exists for the
first options type, is not available here.
{p 4 4 2}
Last but not least, there are two options that reflect a combination of the first
and second types: {cmd:eform}[{cmd:(}{it:args}{cmd:)}] and
{cmd:margin}[{cmd:(}{it:args}{cmd:)}]. These options can be specified
as either
{it:option} {it:option}
{p 4 4 2}
or
{it:option} {it:args}
{p 4 4 2}
in the defaults file; the {cmd:no} form is allowed.
{p 4 4 2}
Many {cmd:estout} options have suboptions, i.e., an option might take the
form {it:option}{cmd:(}{it:...}{cmd:,} {it:suboption}{cmd:)} or
{it:option}{cmd:(}{it:...}{cmd:,} {it:suboption}{cmd:(}{it:args}{cmd:))}. In
the defaults file, the suboptions cannot be included in the
definition of a higher-level option. Instead, they must be
specified in their own lines, as either
{it:optionsuboption} {it:suboption}
{p 4 4 2}
or
{it:optionsuboption} {it:args}
{p 4 4 2}
In the case of a two-level nesting of options, the name
used to refer to the suboption is a concatenation of the option's name and the
suboption's name,
i.e. {cmd:"}{it:optionsuboption}{cmd:"="}{it:option}{cmd:"+"}{it:suboption}{cmd:"}. For
example, the {cmd:labels()} suboption of the {cmd:stats()} option would be
set by the term {cmd:statslabels}. Analogously, the three level nesting in
the {cmd:stats()} option yields suboption names composed of three names. For
instance, the suboption called by the command
{inp:. estout} {it:...}{inp:, stats(}{it:...}{inp:, labels(}{it:...}{inp:, prefix(}{it:args}{inp:)))}
{p 4 4 2}
would be referred to as
{inp:statslabelsprefix} {it:args}
{p 4 4 2}
in the defaults file. The {cmd:cells()} option represents an exception to
this rule. It may be defined in the defaults file using
only a plain array of cells elements without suboptions, e.g.
{inp:cells "b se" p}
{p 4 4 2}
However, the suboptions of the cells elements may be referred to as
{it:el_suboption}, for example
{inp:b_star star}
{p 4 4 2}
or
{inp:se_par [ ]}
{p 4 4 2}{ul:Comments in defaults files:}
{p 4 4 2}
Be aware that the support for comments in defaults files is limited. In
particular, the {cmd:/*} and {cmd:*/} comment indicators cannot be used.
The other comment indicators work (more or less) as usual, that is:
{p 5 8 2}
o{space 2}Empty lines and lines beginning with {cmd:*} (with or without preceding
blanks) will be ignored.
{p 5 8 2}
o{space 2}{cmd://} preceded by one or more blanks indicates that the rest of the
line should be ignored. Lines beginning with {cmd://} (with or without preceding
blanks) will be ignored.
{p 5 8 2}
o{space 2}{cmd:///} preceded by one or more blanks indicates that the rest of the
line should be ignored and the part of the line preceding it should be added to
the next line. In other words, {cmd:///} can be used to split commands into
two or more lines of code.
{marker ret}
{title:Saved results}
{p 4 4 2}
{cmd:estout} saves the following in {cmd:r()}:
{p 4 4 2}Scalars
{p_end}
{p 6 20 2}{cmd:r(nmodels)}{space 4}number of models
{p_end}
{p 6 20 2}{cmd:r(ccols)}{space 6}number of columns per model in {cmd:r(coefs)}
{p_end}
{p 4 4 2}Macros
{p_end}
{p 6 20 2}{cmd:r(cmdline)}{space 4}command as typed
{p_end}
{p 6 20 2}{cmd:r(names)}{space 6}names of models
{p_end}
{p 6 20 2}{cmd:r(m}{it:#}{cmd:_}{it:name}{cmd:)}{space 4}model-specific
macros where {it:#} is the model number and {it:name} is macro name
{p_end}
{p 4 4 2}Matrices
{p_end}
{p 6 20 2}{cmd:r(coefs)}{space 6}coefficients
{p_end}
{p 6 20 2}{cmd:r(stats)}{space 6}summary statistics
{p_end}
{marker ref}
{title:References}
{p 4 8 2}Cong, R. (2000). sg144: Marginal effects of the tobit model.
{it:Stata Technical Bulletin} 56: 27-34.
{p 4 8 2}Jann, B. (2005). Making regression tables from stored estimates.
{it:The Stata Journal} 5(3): 288-308.
{p 4 8 2}Jann, B. (2007). Making regression tables simplified.
{it:The Stata Journal} 7(2): 227-244.
{p 4 8 2}Newson, R. (2003). Confidence intervals and p-values for delivery to the end
user. {it:The Stata Journal} 3(3): 245-269.
{marker ack}
{title:Acknowledgements}
{p 4 4 2}I would like to thank numerous people
for their comments and suggestions. Among them
are
Joao Pedro Azevedo,
Kit Baum,
Elisabeth Coutts,
Henriette Engelhardt,
Jonathan Gardnerand,
Simone Hirschvogl,
Daniel Hoechle,
Friedrich Huebler,
Maren Kandulla,
J. Scott Long,
David Newhouse,
Clive Nicholas,
Fredrik Wallenberg,
Ian Watson, and
Vince Wiggins.
{marker aut}
{title:Author}
Ben Jann, ETH Zurich, jannb@ethz.ch
{marker als}
{title:Also see}
Manual: {hi:[R] estimates}
SJ: SJ5-3 st0085 (Jann 2005)
SJ7-2 st0085_1 (Jann 2007)
{p 4 13 2}Online: help for
{helpb estimates},
{help estcom},
{helpb est_table:estimates table},
{helpb ereturn},
{help format},
{helpb file},
{helpb mfx},
{helpb eststo},
{helpb esttab},
{helpb estadd},
{helpb estpost}
{p_end}