{smcl}
{* *! version 0.5.0 26May2009}{...}
{cmd:help gcsetup}: setup a group comparison \ 0.5.0 2009-05-26.
{hline}

{title:Title}

{p2colset 5 18 18 2}{...}
{p2col:{hi:gcsetup} {hline 2}}Specify the groups, variables, and labels for comparing groups in 
regression models for binary outcomes.{p_end}
{p2colreset}{...}


{title:Syntax}

{p 4 10 2}
{cmd:gcsetup} {varlist}
{cmd:,}
{cmd:grpvar(}{it:variable}{cmd:)}
{cmd:gr0var(}{it:new-variable}{cmd:)}
{cmd:gr1var(}{it:new-variable}{cmd:)}
[
{cmd:gr0label(}{it:string}{cmd:)}
{cmd:gr1label(}{it:string}{cmd:)}
{cmd:matrix(}{it:matrix-name}{cmd:)}
{cmd:details}
]

{synoptline}
{p 4 6 2}
  {it:varlist} contains the independent variables that may be used as predictors 
  in later binary regression models.
  {p_end}

{title:Description}

{pstd}
{opt gcsetup} names an existing variable that defines the two groups (hereafter {it:grpvar}); 
names two groups indicator variables to be created from {it:grpvar}; 
optionally provides short labels for the two groups and the name of a matrix to hold results;
and indicates the independent variables that will be used in later models.

{title:Options}

{phang}
{opt grpvar()} names an existing variable defining groups. Value 0 indicates group 0, while 
1 indicates group 1. This variable is referred to a {it:grpvar} below.

{phang}
{opt gr1var()} is the name of variable to be created that equals 1 when {it:grpvar} is
1, 0 when {it:grpvar} is 0.

{phang}
{opt gr0var()} is the name of variable to be created that equals 1 when {it:grpvar} is
0, 1 when {it:grpvar} is 0.

{phang}
{opt gr1label()} is a string with a short label for the group defined by {it:grpvar} equal to 1.

{phang}
{opt gr0label()} is a string with a short label for the group defined by {it:grpvar} equal to 0.

{phang}
{opt matrix()} is the name of a matrix that will be created to hold the results when 
{cmd:gcprvalue} is run.

{phang}
{opt details} produces details on the variables and global variables that are created.

{title:Examples}

{phang}{cmd:. gcsetup...}{p_end}


{title:Saved globals and variables}

{pstd}

{synoptset 15 tabbed}{...}
{p2col 5 15 19 2: Globals}{p_end}
{synopt:{cmd:a}}to be added{p_end}
{synopt:{cmd:bb}}to be added{p_end}

{p2col 5 15 19 2: Variables}{p_end}
{synopt:{cmd:a}}to be added{p_end}
{synopt:{cmd:bb}}to be added{p_end}
{p2colreset}{...}

INCLUDE help gc_adofooter