INGAP: Stata module to insert gap observations into a data set before output by listtex

ingap inserts gap and/or heading observations into a data set before the data set is output by the listtex package (q.v.), which outputs variables to table rows which the user can insert into a TeX, LaTeX, HTML or Microsoft Word table. ingap inserts observation next to (before or after) each of a list of observations specified by the user. The user specifies a list of integers, and ingap inserts gap observations next to the observations in the corresponding positions in the data set, or in the corresponding positions in each by-group if by-variables are specified. ingap assumes that the data set in memory has up to 3 classes of variables. These are the by-variables which define by-groups representing the pages of the table, a row label variable containing the row labels in the left margin of the table, and the remaining variables, which may form the entries in the table rows. A gap observation inserted by ingap has the same values for the by-variables as the observation next to which it was inserted, a row label value specified by the user, and missing values (or possibly column headings) in the remaining variables. ingap may also create an additional binary variable, identifying which observations are gap observations. The user may output the data set using listtex, or may alternatively create a plot for immediate impact, using Stata graphics together with the sencode package (q.v.).