driftJp: Drift for the JP diffusion

In sdetorus: Statistical Tools for Toroidal Diffusions

Drift for the JP diffusion

Description

Drift for the Langevin diffusion associated to the Jones and Pewsey (JP) family of circular distributions.

Usage

driftJp(x, alpha, mu, psi)

Arguments

x	vector with the evaluation points for the drift.
alpha	strength of the drift.
mu	unconditional mean of the diffusion.
psi	shape parameter, see details.

Details

Particular interesting choices for the shape parameter are:

• psi = -1: gives the Wrapped Cauchy as stationary density.

• psi = 0: is the sinusoidal drift of the vM diffusion.

• psi = 1: gives the Cardioid as stationary density.

See Section 2.2.3 in García-Portugués et al. (2019) for details.

Value

A vector of the same length as x containing the drift.

References

García-Portugués, E., Sørensen, M., Mardia, K. V. and Hamelryck, T. (2019) Langevin diffusions on the torus: estimation and applications. Statistics and Computing, 29(2):1–22. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1007/s11222-017-9790-2")}

Jones, M. C. and Pewsey, A. (2005). A family of symmetric distributions on the circle. Journal of the American Statistical Association, 100(472):1422–1428. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1198/016214505000000286")}

Examples

x <- seq(-pi, pi, l = 200)
plot(x, x, type = "n", ylab = "drift")
for (i in 0:20) {
  lines(x, driftJp(x = x, alpha = 1, mu = 0, psi = -1 + 2 * i / 20),
        col = rainbow(21)[i + 1])
}

sdetorus documentation built on Aug. 21, 2023, 1:08 a.m.