{smcl} {* *! version 1.0.1 01feb2010}{...} {cmd:help parttau} {hline} {title:Title} {phang} {bf:parttau} {hline 2} Calculate Kendall's partial tau and confidence interval. {title:Syntax} {p 8 17 2} {cmdab:parttau} {varlist} {ifin} [{cmd:,} {it:options}] {pstd} When {it:varlist} contains three or more variables, the first two are the primary variables, and all others confounders. When {it:varlist} contains two variables, the pairwise tau is calculated. {synoptset 20 tabbed}{...} {synopthdr} {synoptline} {syntab:Main} {synopt:{opth c:luster(varname)}}treat data set as samples of clusters{p_end} {synopt:{opt wcluster}}calculate the within-cluster partial and pairwise taus{p_end} {synopt:{opth est:imate(varname)}}save jackknife estimates in given variable name{p_end} {synopt:{opth trans:form(string)}}report the tau, SE, and confidence interval in a transformed space; transformations are same as for {help somersd}; see below{p_end} {synopt:{opt l:evel(#)}}specifies percent coverage for confidence interval{p_end} {synopt:{opt run2}}forces calculation of pairwise tau when no confounder is given; see below{p_end} {synopt:{opt show}}displays all pairwise taus between all given variables{p_end} {synoptline} {p2colreset}{...} {title:Options} {dlgtab:Main} {phang} {opt cluster(varname)} instructs the program that the data set should be treated as samples of clusters from a population of clusters, and that the given variable specifies the clusters. If {cmd:cluster} is specified and the option {cmd:wcluster} is not specified, then the partial tau is calculated between clusters. {phang} {opt estimate(varname)} specifies that the jackknife estimates should be saved in variable {it:varname}. If the variable exists prior to calling this option, the variable is overwritten and a warning message given. Otherwise a variable with the given name is created. {phang} {opt transform(name)} changes the ouput estimate, SE, and confidence interval to a transformed space. If specified, the confidence interval will be symmetric in the transformed space. Allowed transformations are same as for {help somersd}: {cmd: z}, {cmd:asin}, {cmd:rho}, {cmd:zrho}, {cmd:c}, though fewer aliases are allowed. If calculating a partial tau (i.e., using one or more confounder variables), and option {cmd:show} is specified, reported pairwise taus will not be transformed. {phang} {opt level(#)} specifies the percent coverage of the confidence interval. {phang} {opt run2} forces calculation of pairwise tau. {cmd:parttau} is primarily intended for calculating Kendall's partial tau between two variables with one or more confounders. Thus, typically, three or more variables will be specified. If two variables are specified, {cmd:parttau} will assume that the user wants to calculate the pairwise tau and will attempt to use {cmd:somersd}. If that program is not found, {cmd:parttau} will calculate the pairwise tau itself. Using {cmd:run2} forces {cmd:parttau} to calculate the pairwise tau; if {cmd:somersd} is installed, both will be used. {phang} {opt show} displays all pairwise taus between all given variables. The pairwise taus are also saved in the matrix {bf:e(taus)}. {title:Description} {pstd} {cmd:parttau} calculates Kendall's partial tau and confidence interval. {cmd:parttau} can be used to calculate {it:pairwise} taus if {help somersd} is not installed, or if the option {cmd:run2} is specified. For repeated calculation of the pairwise tau, the user will probably find {cmd:somersd} preferable; it is faster and has more options. {title:Authors} {pstd} James Fiedler, Universities Space Research Association{break} Email: {browse "mailto:james.fiedler-1@nasa.gov":james.fiedler-1@nasa.gov} {pstd} Alan H. Feiveson, National Aeronautics and Space Administration{break} Email: {browse "mailto:alan.h.feiveson@nasa.gov":alan.h.feiveson@nasa.gov}