Learn R Programming

SDLfilter (version 2.0.1)

asymptote: Horizontal asymptotes of rational functions

Description

Function to find horizontal asymptotes of a rational function.

Usage

asymptote(
  data = NULL,
  x = NULL,
  y = NULL,
  d1 = 1,
  d2 = 1,
  threshold = 0.95,
  proportional = TRUE
)

Arguments

data

An output object from boot_overlap or boot_area.

x, y

Numeric vectors of independent (x) and dependent (y) variables. These parameters will be ignored if data is supplied.

d1, d2

Maximal degrees of numerator (d1) and denominator (d2) of a rational function.

threshold

Threshold value for considering an asymptote. Once the y value reaches the threshold, it is considered that an asymptote is reached.

proportional

If TRUE (default), a threshold is calculated as estimated asymptote * threshold. If FALSE, the value specified in threshold is used in the analysis.

Value

A list containing a data frame (rational function fit associated with x values), an estimated horizontal asymptote, and the minimum sample size if an asymptote is reached.

Details

This function fits a rational function to the input data. When an output object from boot_overlap or boot_area is supplied, a rational function is fit to the means of the bootstrap results (e.g. mean overlap probability) as a function of x (e.g. sample size). It then estimates horizontal asymptotes and identifies the sample size when an asymptote is considered.

References

Press, W. H., S. A. Teukolsky, W. T. Vetterling, and B. P. Flannery (2007). Numerical Recipes: The Art of Numerical Computing. Third Edition, Cambridge University Press, New York.

Shimada et al., (in prep)

See Also

boot_overlap, boot_area