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

{title:Title}

{p2colset 5 12 14 2}{...}
{p2col :{hi:yvn} {hline 2}}Testing consistency with outcome versus not the outcome{p_end}
{p2colreset}{...}


{title:Syntax}

{p 8 14 2} {cmd:yvn} [{it:outcomevar} {it:configurations}]
 [{it:{help if}}] {weight}
 [{cmd:,} 
 {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:yvn} performs a test of the consistencies of each configuration entered in
{it:configurations} with the outcome versus their consistencies with the
negation of the outcome (i.e., 1 - {it:outcomevar}).  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}
{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 consistency with the outcome, while {cmd:col2} is the
consistency with the negation.

{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.
This is used in the computation of the consistency scores.


{title:Examples}

{p 4 8 2}{cmd:. yvn Y Abc aBc AC}

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

{p 4 8 2}{cmd:. fuzzy D A G F, settest(yvv) sigonly greater(col1) reduce}{p_end}
{phang}{cmd:. yvn, 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:. yvn, 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}