*! v1.0.3 IHSalgado-Ugarte 07January2013
help circgph

Title

circgph -- Draws a circular kernel density estimator from density and degrees midpoints

Syntax

circgph denvar degvar [if] [in] [, rval(#) fr(#) gs(#)

scatter_options]

Description

circgph draws a kernel density estimation for circular variables from a density and degrees variables generated by circkden or cirkdevm

It is possible to use the twoway scatter options.

rval is a factor controlling the radius size of the circle used

frval is a factor applied to the density values in the cosine and sine transformation. It permits to stretch or compress the density values arround the unit circle.

gsval is a factor controlling the size of the graph. Large values give small graphics while less than unity figures produce bigger circle graphs.

Defaults are 1 in all the cases. It is possible for the graphs to depart from circle by using other values. This can be corrected by using the right combination.

graph_options are any of the options allowed with twoway scatter; see help for graph.

Examples

. use fisherfeldes2

. circbw laoriefeld if half==1

. circkden laoriefeld, h(22) gen(cden deg)

. circgph cden deg

It is possible to customize the graphs by changing the circular scale labeling (cardinal points or azimutal):

. circgph cden deg, text(0 0 "+", size(huge)) text(.9 0 "N") text(0 .9 "E") text(-.9 0 "S") text(0 -.9 "W") yline(0, lcolor(white)) xline(0, lcolor(white))

. circgph cden deg, text(0 0 "+", si(huge)) text(.9 0 "0") text(0 .85 "90") text(-.9 0 "180") text(0 -.8 "270") yline(0, lc(white)) xline(0, lc(white))

Authors

Isaías H. Salgado-Ugarte,
Laboratorio de Biometría y Biología Pesquera, FES Zaragoza, UNAM;
Departamento de Biología UAM Iztapalapa

ihsalgadougarte@gmail.com

Verónica Mitsui Saito-Quezada
Laboratorio de Biometría y Biología Pesquera, FES Zaragoza, UNAM.

mitsuisaito@gmail.com

Marco Aurelio Pérez-Hernández, Departamento de Biología;
Universidad Autónoma Metropolitana Iztapalapa, México.

maph@xanum.uam.mx

References

Cox, N.J. 1997. Circular statistics in Stata. 3rd UK User Group meeting. June 5, 1997. London.

Fisher, N.I. 1993. Statistical analysis of circular data. Cambridge University Press, Cambridge, 296p.

Salgado-Ugarte, I.H. & M.A. Pérez-Hernández, 2017. estimación de densidad por núcleo (kernel) para datos circulares. In: Rodríguez-Yam, G.A., F.J. Araiza-Hernández, B.R. Pérez-Salvador & F. Ulín-Montejo (eds.). Aportaciones Recientes a la Estadística en México. INEGI, Mexico: 518-526. ISBN: 978-607-530-067-2.

Also see

Manual: [R] kdensity

Online: Help for circbw, circkden, cirkdevm, circnpde