{smcl}
{* 26 April07}{...}
{hi:help yavyb}{right: ({browse "http://www.stata-journal.com/article.html?article=st0140":SJ8-1: st0140})}
{hline}

{title:Title}

{p2colset 5 14 16 2}{...}
{p2col :{hi:yavyb} {hline 2}}Testing consistency with outcome for two groups{p_end}
{p2colreset}{...}


{title:Syntax}

{p 8 14 2} {cmd:yavyb} [{it:outcomevar} {it:configurations}]
 [{it:{help if}}] {weight}
 [{cmd:,}
 {opt group(varname)}
 {cmdab:sig:only}
 {opt slev:el(#)}
 {bind:{cmdab:great:er(col1} | {cmd:col2)}}
 {cmdab:last}
 {cmdab:usered:uction}
 {opt cluster(varname)}]

{pstd}
{cmd:fweight}s, {cmd:iweight}s, and {cmd:pweight}s are allowed; see
{help weight}.


{title:Description}

{pstd}
{cmd:yavyb} performs a test of the consistencies of each configuration entered
in {it:configurations} with the outcome versus a 2-category group variable
(e.g., male/female).  The configurations do not need to exist in the dataset,
but their individual single, capital letter versions must exist.


{title:Options}

{p 4 8 2}
{opt group(varname)} determines the groups to test the consistencies against.
{it:varname} must be a 2-category variable.  A group variable must
be specified if {cmdab:yavyb} is entered, unless one was specified in the last
run {cmdab:fuzzy} or {cmdab:yavyb}. 

{p 4 8 2}
{cmd:sigonly} displays only those configurations that have significantly
different consistencies.	

{p 4 8 2}
{opt slevel(#)} changes the significance level to be used in determining
{cmd:sigonly}. The default is {cmd:slevel(.05)}.

{p 4 8 2}
{cmd:greater(col1} | {cmd:col2)} displays only those configurations in which
the specified column value is greater than the other column value.
{cmd:col1} is always the mean of the first group in the group variable, while
{cmd:col2} is the mean for the second group.

{p 4 8 2}
{cmd:last} uses the outcome variable and configurations (or sets) from the last
run {cmd:fuzzy} or {cmd:settest()} option call as {it:outcomevar} and
{it:configurations}.  When this option is specified, {it:outcomevar} and
{it:configurations} should not be entered. Specifically, it uses the last
displayed set of configurations.  Thus, when using this option, a
{cmd:settest()} option must have been invoked on the last call to {cmd:fuzzy}
or just run as a stand-alone command.  When {cmd:last} is used, only those last
displayed configurations will be used in the test. 

{p 4 8 2}
{cmd:usereduction} uses the outcome variable and reduced configurations from the
last run {cmd:reduce} command for the consistency test.	       

{p 4 8 2}
{opt cluster(varname)} allows the standard errors produced by the {cmd:ratio}
command when calculating consistencies to adjust for intragroup correlation.


{title:Examples}

{p 4 8 2}{cmd:. yavyb Y Abc aBc AC, group(female)}

{p 4 8 2}{cmd:. fuzzy drink age grades friends, label(D A G F)}{p_end}
{phang}{cmd:. yavyb, group(female) greater(col1)}

{p 4 8 2}{cmd:. fuzzy drink age grades friends, label(D A G F) settest(yvn) sigonly}{p_end}
{phang}{cmd:. yavyb, group(female) greater(col1) last}

{p 4 8 2}{cmd:. fuzzy D A G F, settest(yvn yavyb) group(female) sigonly greater(col1) reduce}{p_end}
{phang}{cmd:. yavyb, usereduction sigonly}

{p 4 8 2}{cmd:. fuzzy drink age grades friends, label(D A G F) settest(yvn)}{p_end}
{phang}{cmd:. yvv, last sigonly}{p_end}
{phang}{cmd:. yavyb, group(female) last sigonly}
{p_end}


{title:Also see}

{psee}
Article: {it:Stata Journal}, volume 8, number 1: {browse "http://www.stata-journal.com/article.html?article=st0140":st0140}
{p_end}
