nestloop.sthlp

{smcl}
{* *! version 0.11.1 21oct2024}{...}
{vieweralsosee "siman" "siman"}{...}
{viewerjumpto "Syntax" "nestloop##syntax"}{...}
{viewerjumpto "Description" "nestloop##description"}{...}
{viewerjumpto "Example" "nestloop##example"}{...}
{viewerjumpto "References" "nestloop##references"}{...}
{viewerjumpto "Authors" "nestloop##authors"}{...}
{title:Title}

{phang}
{bf:nestloop} {hline 2} Nested loop plot of performance measures data.


{marker syntax}{...}
{title:Syntax}

{phang}
{cmdab:nestloop} {it:varname} [if]
[{cmd:,}
{opt desc:riptors(evarlist)}
{opt meth:od(varname)}
{it:options}]

{pstd} The variable {it:varname} will be graphed against the descriptors, overlaying the different values of method.


{synoptset 28 tabbed}{...}
{synopthdr}
{synoptline}
{syntab:Options specific to this stand-alone program}

{synopt:{opt desc:riptors(evarlist)}}defines the descriptor variables for the nested loop plot. 
A negative sign in front of the variable name 
will display its values on the graph in descending order.{p_end}
{synopt:{opt meth:od(varname)}}defines the method variable. 
One line will be drawn for each value of this variable.

{syntab:Options shared with siman nestloop}

{synopt:{opt options}}are any options for {help siman nestloop} except {cmd:dgmorder()}.


{marker description}{...}
{title:Description}

{pstd}
{cmd:nestloop} draws a nested loop plot of performance measures data ({help nestloop##ruckerschwarzer:Rücker and Schwarzer, 2014}).
This is a stand-alone program. Please see {help siman nestloop} for a description of the nested loop plot, and how to use it within the siman suite.


{marker example}{...}
{title:Example}

{pstd}Read and set up data

{phang}. {stata "use https://raw.githubusercontent.com/UCL/siman/master/testing/data/res.dta, clear"}

{pstd}Reshape into format required by nestloop

{phang}. {stata "drop v1"}

{phang}. {stata "reshape long exp mse cov bias var2, i(theta rho pc tau2 k) j(method) string"}

{pstd}Draw nestloop for 9 methods and 4*3*4*4*4 DGMs

{phang}. {stata "nestloop exp, descriptors(theta rho pc tau2 k) method(method) true(theta) legend(row(2)) dgsize(.25)"}


{marker references}{...}
{title:References}

{phang}{marker ruckerschwarzer}Rücker G, Schwarzer G. 
Presenting simulation results in a nested loop plot. BMC Med Res Methodol 14, 129 (2014). 
{browse "https://doi.org/10.1186/1471-2288-14-129":doi:10.1186/1471-2288-14-129}


{marker authors}{...}
{title:Authors}

{pstd}Ella Marley-Zagar, MRC Clinical Trials Unit at UCL{break}

{pstd}Ian White, MRC Clinical Trials Unit at UCL{break}
Email: {browse "mailto:ian.white@ucl.ac.uk":Ian White}

{pstd}Tim Morris, MRC Clinical  Trials Unit at UCL, London, UK.{break} 
Email: {browse "mailto:tim.morris@ucl.ac.uk":Tim Morris}


{p}{helpb siman: Return to main help page for siman}