-
Notifications
You must be signed in to change notification settings - Fork 2
/
empty_line.sthlp
60 lines (45 loc) · 1.77 KB
/
empty_line.sthlp
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
{smcl}
{* *! version 1.0.1 28apr2021}{...}
{hline}
{cmd:help empty_line}
{hline}
{title:Title}
{phang}
{bf:empty_line} {hline 2} Inserts empty observations (rows) in a data set.
{marker syntax}{...}
{title:Syntax}
{p 4 6 2}
{cmdab:empty_line} {ifin} [{cmd:,} {opth g:enerate(newvar)} {opth pos:ition(string)}]
{marker description}{...}
{title:Description}
{pstd}
{cmd:empty_line} creates empty observations (rows) within a data set
after or before observations specified by {cmd:if} or {cmd:in}.
{marker options}{...}
{title:Options}
{p 4 6 2}
{phang}
{opth g:enerate(newvar)} creates new variable {it:newvar} containing {cmd:0} if the observation
originally appeared in the dataset and {cmd:1} if the observation is inserted.
{phang}
{opth pos:ition(string)}} specifies whether the observation is inserted {it:after}(default) or {it:before}
the observation specified by {cmd:in} or {cmd:if}.
{marker results}{...}
{title:Stored results}
{synoptset 22 tabbed}{...}
{p2col 5 22 19 2: Scalars}{p_end}
{synopt:{cmd: r(insert_line)}}Row at which the observation was inserted (if only one){p_end}
{marker examples}{...}
{title:Examples}
{pstd}Add an observation on top{p_end}
{phang2}{cmd:. sysuse auto}{p_end}
{phang2}{cmd:. empty_line in 1, position(before)}{p_end}
{phang2}{cmd:. replace make="Header" in `r(insert_line)'}{p_end}
{phang2}{cmd:. list in 1/5}{p_end}
{pstd}Add an observation before domestic and foreign cars{p_end}
{phang2}{cmd:. sysuse auto}{p_end}
{phang2}{cmd:. sort foreign make}{p_end}
{phang2}{cmd:. empty_line if foreign!=foreign[_n-1], gen(inserted) position(before)}{p_end}
{phang2}{cmd:. replace make="Domestic cars" if inserted==1 & foreign[_n+1]==0}{p_end}
{phang2}{cmd:. replace make="Foreign cars" if inserted==1 & foreign[_n+1]==1}{p_end}
{phang2}{cmd:. list}{p_end}