sdetorus (version 0.1.10)

driftJp: 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)

Value

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

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.

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. 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. 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])
}