help for xframeappend (Roger Newson)

Append data frames to the end of the current data frame

Syntax

xframeappend
framelist
[ , drop generate(newvarname) fast ]

drop drops the frames listed in framelist after they have been appended

generate(newvarname) specifies the name of a new variable to be created,
to mark the source of observations.
It will have values 0 for observations in the master dataframe (the current frame),
and the value k for observations from the kth frame in the framelist.

fast specifies that no extra work will be done to restore the original current dataset,
if the program fails, or if the user presses Break.

Description

xframeappend appends the contents of one or more frames in the input framelist
to the current data frame.
The new observations will be at the bottom of the current frame.
And any variables in the appended frames in the framelist but not in the current frame
will be ordered in order of appearance in the framelist.
The command works for variables whose names begin with an underscore.

Remarks and Acknowledgements

xframeappend is Roger Newson's idea of what a future frame append command shuld be like.
It is based on the existing SSC package frameappend,
written by Jeremy Freese and revised with help from Daniel Fernandez,
and adds a few improvements (in Roger Newson's opinion and not necessarily anybody else's).
For more about data frames in Stata Version 16 (and above),
see online help for data frames.

Author

Roger Newson, Imperial College London, United Kingdom.
Email: r.newson@imperial.ac.uk