# Function to plot several conditional error functions running through a "path" of given points

### Description

This function plots several conditional error functions of the same family such that each one runs through one of several given points.

### Usage

1 2 |

### Arguments

`typ` |
type of test: |

`fun` |
a conditional error function |

`dis` |
a distortion method for a supplied conditional error function (see details): |

`p1` |
a vector (at least of length 2) of p-values |

`p2` |
a vector (at least of length 2) of p-values |

`x` |
vector on which the conditional error functions are plotted (should be relatively dense in [0,1]) |

`plt.pt` |
logical determining whether the points that the conditional error functions are made to run through should be plotted or not (default: not) |

`plt.ptann` |
logical determining whether the points that the conditional error functions are made to run through should be annotated or not (default: not) |

`xlab` |
a label for the x axis (default: no label) |

`ylab` |
a label for the y axis (default: no label) |

`...` |
arguments to be passed on to the underlying |

### Details

It can be instructive to plot not only one conditional error function, but to visualize a whole family. This can easily be done with `pathCEF`

. The function is used in a similar way as `plotCEF`

, but `p1`

and `p2`

are now vectors (of the same length, at least of length 2). Conditional error functions are plotted that run through the specified elementwise points `(p1,p2)`

(which by default lie on the main diagonal).

Internally, `pathCEF`

uses `plotCEF`

to plot the individual conditional error functions; see this latter function for further details.

### Value

The function `pathCEF`

is invoked for its plotting effect; it returns no meaningful value.

### Note

Provide either `typ`

or `fun`

, not both! If `fun`

is provided, then also specify `dis`

.

Unlike `plotCEF`

, it is not possible with `pathCEF`

to specify the conditional error functions by the parameter *alpha2* or the parameter *c*.

`plt.ptann`

is not considered if `plt.pt = FALSE`

.

### Author(s)

Marc Vandemeulebroecke

### References

Bauer, P., Koehne, K. (1994). Evaluation of experiments with adaptive interim analyses. *Biometrics* 50, 1029-1041.

Lehmacher, W., Wassmer, G. (1999). Adaptive sample size calculations in group sequential trials. *Biometrics* 55, 1286-1290.

Vandemeulebroecke, M. (2006). An investigation of two-stage tests. *Statistica Sinica* 16, 933-951.

### See Also

`adaptTest`

package description, `CEF`

, `plotCEF`

, `tsT`

### Examples

1 2 3 4 5 6 |