{smcl}
{* 13Oct2003}{...}
{hline}
help for {hi:tarow}{right:(see also:  {hi:[R] tabulate})}
{hline}

{title:tarow}, "t-a-row", {title:tabulate by each row}

{p 8 17}{cmd:tarow} {it:varname1 varname2} [{cmd:if} {it:exp}] [{cmd:in} {it:range}] {it:,}
         [{cmdab:o:ptions_tabulate(}{it:tabulate options}{cmd:)}
          {cmdab:r:ow_options_tabulate(}{it:tabulate options for tables by each row}{cmd:)}]

{title:Description}

{p 0 4}{cmd:tarow} tabulates two numeric variables in order, row by column. 
Thereafter, provides, by each row level defined by the first variable, {it:varname1}, 
(1st level, 2nd level, ...) a 2Xn table where n equals the number of columns defined by the levels of 
the second variable, {it:varname2}. The two rows for each 2Xn table are {it:level i} and {it:all other}. 
{p_end}

{title:Options}

{p 0 4} {cmdab:o:ptions_tabulate(}{it:tabulate options}{cmd:)} and 
{cmdab:r:ow_options_tabulate(}{it:tabulate options for tables by each row}{cmd:)} take 
options available to {help tabulate} and are, in fact, passed directly to {help tabulate}. 
Examples of tabulate options are:{it: row, col, all, chi2,} and {it:exact}.

{title:Note}

{p 0 4} for this version of {cmd:tarow}:

{p 0 4} 1) [{it:weight}], an option of {help tabulate}, is not supported. 

{p 0 4} 2) only numeric variables are accepted; please see {help encode}, to encode string variables to numeric.

{title:Example}

{p 8 12}{inp:. tarow ibio_stg sex, o(row) r(chi exact col row)}{p_end}
{p 8 12}{inp:. tarow ibio_stg sex, if event_i~=0, o(missing) r(exact col row)}{p_end}

{title:Author}

{p 8 12} Allen Buxton, {p_end}
{p 8 12} Assistant Statistician {p_end}
{p 8 12} Children's Oncology Group {p_end}
{p 8 12} Arcadia, CA {p_end}

{title:Also see}

{p 1 14}Manual: {hi:[R] tabulate} {hi:[R] encode} {p_end}

{p 0 19}On-line: help for {help tabulate} {p_end}
