help svret

Title

svret -- Save returned results to your dataset.

Syntax

svret [classlist] [, long type(type) format(%fmt) keep(returnlist)]

where

classlist is one or more of the following: e, r, s, all,

type can be one of the following: all, scalars, or macros, and

returnlist is a list of returned results currently in memory, e.g., r(N).

Description

svret replaces the dataset in memory with the scalars and macros stored in e(), r(), and s().

Options

long instructs svret to store the results in long form. The default is to store them in wide form.

type(type) specifies which type of returns (scalars or macros) to save. The default is to save results from all classes.

format(%fmt) allows you to specify the formats of the numbers in your table.
For example, a format of %7.2f specifies that numbers are to be rounded to two decimal places. See [D] format for details.

keep(returnlist) specifies the variables to be kept from the returned results.

Remarks

LaTeX users can use the user-written command texsave (if installed) to automatically output their results into a LaTeX table. See example 3 below.

Examples

1. Store results from summarize in wide form:

. sysuse auto.dta, clear

. summarize price

. svret all

2. Store results from summarize in long form:

. sysuse auto.dta, clear

. summarize price

. svret r, long format(%8.2fc)

3. Output selected statistics from summarize into a LaTeX table. (This example requires the user-written commands
texsave and sortobs to be installed.):

. sysuse auto.dta, clear

. summarize price

. svret r, long format(%8.2fc) keep(r(sd) r(mean) r(min) r(max))

. replace variable = "Standard deviation" if variable == "r(sd)"

. replace variable = "Mean" if variable == "r(mean)"

. replace variable = "Min" if variable == "r(min)"

. replace variable = "Max" if variable == "r(max)"

. rename variable Statistic

. rename contents Value

. sortobs Statistic, values(Mean "Standard deviation" Min Max)

. texsave using "table.tex", title(Price statistics (units in dollars)) footnote("Data obtained from Stata's built-in auto.dta dataset") size(large) replace

Author

Julian Reif, University of Illinois

jreif@illinois.edu

Also see

svmat,
savedresults