Package: ggcircular 0.2.0

ggcircular: A 'ggplot2' Extension for Circular, Cylindrical and Toroidal Data

Provides a 'ggplot2' grammar for circular, axial and directional data, including rose diagrams, circular densities, mean directions, confidence arcs, theoretical circular distributions, movement data visualizations, and displays for circular-linear and circular-circular dependence on cylinders and tori.

Authors:Aurélien Nicosia [aut, cre]

ggcircular_0.2.0.tar.gz
ggcircular_0.2.0.zip(r-4.7-any)ggcircular_0.2.0.zip(r-4.6-any)ggcircular_0.2.0.zip(r-4.5-any)
ggcircular_0.2.0.tgz(r-4.6-any)ggcircular_0.2.0.tgz(r-4.5-any)
ggcircular_0.2.0.tar.gz(r-4.7-any)ggcircular_0.2.0.tar.gz(r-4.6-any)
ggcircular_0.2.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
ggcircular/json (API)

# Install 'ggcircular' in R:
install.packages('ggcircular', repos = c('https://aureliennicosiaulaval.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/aureliennicosiaulaval/ggcircular/issues

Pkgdown/docs site:https://aureliennicosiaulaval.github.io

Datasets:

On CRAN:

Conda:

circular-statisticsdata-visualizationdirectional-dataggplot2

5.62 score 1 stars 35 scripts 337 downloads 108 exports 25 dependencies

Last updated from:b95492cbf2. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK250
source / vignettesOK223
linux-releaseOK208
macos-releaseOK226
macos-oldrelOK180
windows-develOK168
windows-releaseOK131
windows-oldrelOK160
wasm-releaseOK138

Exports:alignment_indexangular_differenceangular_distanceas_circular_drawsas_step_dataaugment_circularaugment_momentuHMM_anglesautoplot_circularautoplot_circular_drawsbootstrap_stat_orbitbootstrap_toroidal_ridgecartesian_to_sphericalcheck_anglecircular_mean_cicircular_model_diagnosticscircular_residualscircular_sdcircular_summarycircular_topography_datacircular_variancecompass_to_radcompute_bearingcompute_step_lengthcompute_turn_angleconditional_variation_indexcoord_circulardeg_to_raddiagnostic_atlas_datadiagnostic_scenariosestimate_cyl_densityestimate_kappaestimate_toroidal_densityfit_vonmises_mixturegeom_circular_densitygeom_circular_intervalgeom_circular_pointgeom_circular_ruggeom_confidence_arcgeom_direction_arrowgeom_mean_directiongeom_phase_loomgeom_rosegeom_toroidal_flowglance_circularhour_to_radis_anglelocal_circ_momentmarginal_support_datamean_directionmean_resultant_lengthmutate_directional_featuresnormalize_anglephase_loom_dataplot_circular_topographyplot_circular_topography_3dplot_classical_comparisonplot_diagnostic_atlasplot_marginal_supportplot_phase_loomplot_stat_orbitplot_state_anglesplot_toroidal_flowplot_toroidal_ridgeplot_toroidal_topographyplot_toroidal_topography_3drad_to_compassrad_to_degrad_to_hourrayleigh_testresultant_lengthscale_x_circular_compassscale_x_circular_degreesscale_x_circular_hoursscale_x_circular_radiansselect_cyl_smoothingselect_toroidal_smoothingsensitivity_bandwidth_gridsimulate_cyl_diagnosticsimulate_cylindricalsimulate_independence_lineupsimulate_tor_diagnosticsimulate_toroidalspherical_summaryspherical_to_cartesianstat_circular_densitystat_circular_teststat_circular_topographystat_mean_directionstat_orbit_datastat_rosestat_statistical_orbitstat_statistical_orbit_ribbonstat_toroidal_ridgestat_toroidal_topographystat_uniform_circularstat_vonmisesstat_vonmises_fitstat_vonmises_mixturestat_wrapped_normalsummarise_circular_drawstheme_circulartheme_compasstheme_rosetidy_circulartoroidal_flow_datatoroidal_ridge_datatoroidal_topography_datawatson_williams_test

Dependencies:clicpp11dplyrfarvergenericsggplot2gluegtableisobandlabelinglifecyclemagrittrpillarpkgconfigR6RColorBrewerrlangS7scalestibbletidyselectutf8vctrsviridisLitewithr

Circular-circular workflow

Last update: 2026-08-20
Started: 2026-08-20

Circular-linear workflow

Last update: 2026-08-20
Started: 2026-08-20

Getting started with ggcircular
Overview | Installation | Why circular data are different | Data included in the package | Directional versus axial data | Conventions for directions and bearings | First rose diagram | Counts, densities and proportions | Groups and facets | Circular density | Mean direction and resultant length | Uncertainty and circular tests | Compass display | Axial data | Movement data | Mixtures of von Mises distributions | Angular model diagnostics | Circular posterior draws | Experimental features | Statistical limitations | Next steps

Last update: 2026-08-20
Started: 2026-05-30

Smoothing and support diagnostics

Last update: 2026-08-20
Started: 2026-08-20

Validation examples
Purpose | Boundary behavior | Axial behavior | Known mean direction | Von Mises mixture recovery | Optional comparison with circular | CRAN readiness checks | Interpretation

Last update: 2026-05-31
Started: 2026-05-31

Rose diagrams
Definition | Linear versus circular histograms | Choosing the number of bins | Counts, densities and proportions | Area versus radius | Groups and facets | Axial data | Interpretation

Last update: 2026-05-30
Started: 2026-05-30

Readme and manuals

Help Manual

Help pageTopics
Alignment index for two angular variablesalignment_index
Signed angular differenceangular_difference
Circular angular distanceangular_distance
Simulated animal movement stepsanimal_steps
Convert posterior draws to circular drawsas_circular_draws
Coerce to step dataas_step_data
Circular model helper genericsaugment_circular glance_circular tidy_circular
Augment momentuHMM fits with angular statesaugment_momentuHMM_angles
Autoplot circular dataautoplot_circular
Autoplot circular posterior drawsautoplot_circular_draws
Plot bootstrap uncertainty for a statistical orbitautoplot.bootstrap_stat_orbit
Plot bootstrap uncertainty for a toroidal ridgeautoplot.bootstrap_toroidal_ridge
Plot diagnostic atlas dataautoplot.diagnostic_atlas_data
Simulated axial orientationsaxial_orientations
Bootstrap a statistical orbitbootstrap_stat_orbit
Bootstrap a toroidal conditional ridgebootstrap_toroidal_ridge
Convert Cartesian coordinates to spherical coordinatescartesian_to_spherical
Check an angle vectorcheck_angle
Confidence interval for a circular meancircular_mean_ci
Circular model diagnosticscircular_model_diagnostics
Circular residuals for angular modelscircular_residuals
Circular standard deviationcircular_sd
Summarize circular datacircular_summary
Compute circular topography datacircular_topography_data
Circular variancecircular_variance
Convert compass labels to radianscompass_to_rad
Compute bearingscompute_bearing
Compute step lengthscompute_step_length
Compute turn anglescompute_turn_angle
Conditional variation indexconditional_variation_index
Circular coordinate systemcoord_circular
Convert degrees to radiansdeg_to_rad
Build diagnostic atlas datadiagnostic_atlas_data
List built-in directional diagnostic scenariosdiagnostic_scenarios
Estimate a density on the cylinderestimate_cyl_density
Estimate von Mises concentrationestimate_kappa
Estimate a density on the torusestimate_toroidal_density
Fit a mixture of von Mises distributionsfit_vonmises_mixture
Circular density layergeom_circular_density
Circular point and rug helpersgeom_circular_point geom_circular_rug
Circular confidence arcgeom_circular_interval geom_confidence_arc
Direction arrowsgeom_direction_arrow
Mean direction layergeom_mean_direction
Add a phase loom layergeom_phase_loom
Rose diagram layergeom_rose
Add a toroidal flow layergeom_toroidal_flow
Convert hours to radianshour_to_rad
Simulated hourly activityhourly_activity
Test whether an object can represent anglesis_angle
Local circular momentlocal_circ_moment
Estimate angular marginal supportmarginal_support_data
Circular mean directionmean_direction
Mean resultant lengthmean_resultant_length
Add directional movement featuresmutate_directional_features
Normalize angles to a periodic intervalnormalize_angle
Compute phase loom dataphase_loom_data
Plot circular topographyplot_circular_topography
Experimental 3D circular topographyplot_circular_topography_3d
Plot a classical unfolded comparisonplot_classical_comparison
Plot a diagnostic atlasplot_diagnostic_atlas
Plot angular marginal supportplot_marginal_support
Plot a phase loomplot_phase_loom
Plot a statistical orbitplot_stat_orbit
Plot angular distributions by stateplot_state_angles
Plot toroidal flowplot_toroidal_flow
Plot a conditional toroidal ridgeplot_toroidal_ridge
Plot toroidal topographyplot_toroidal_topography
Experimental 3D toroidal topographyplot_toroidal_topography_3d
Convert radians to compass labelsrad_to_compass
Convert radians to degreesrad_to_deg
Convert radians to hoursrad_to_hour
Rayleigh test for circular uniformityrayleigh_test
Resultant lengthresultant_length
Circular x scalesscale_x_circular_compass scale_x_circular_degrees scale_x_circular_hours scale_x_circular_radians
Select smoothing parameters for circular-linear conditional densityselect_cyl_smoothing
Select smoothing parameters for toroidal conditional densityselect_toroidal_smoothing
Evaluate sensitivity to smoothing concentrationsensitivity_bandwidth_grid
Simulate diagnostic circular-linear datasimulate_cyl_diagnostic
Simulate circular-linear datasimulate_cylindrical
Simulate a visual-inference lineup under independencesimulate_independence_lineup
Simulate diagnostic circular-circular datasimulate_tor_diagnostic
Simulate circular-circular datasimulate_toroidal
Summarize spherical directionsspherical_summary
Convert spherical coordinates to Cartesian coordinatesspherical_to_cartesian
Circular density statisticstat_circular_density
Annotate circular testsstat_circular_test
Add a circular topography stat layerstat_circular_topography
Mean direction statisticstat_mean_direction
Compute statistical orbit datastat_orbit_data
Rose diagram statisticstat_rose
Add a statistical orbit linestat_statistical_orbit
Add a statistical orbit ribbonstat_statistical_orbit_ribbon
Add a conditional ridge stat layer on the torusstat_toroidal_ridge
Add a toroidal topography stat layerstat_toroidal_topography
Theoretical von Mises densitystat_uniform_circular stat_vonmises stat_wrapped_normal
Fitted von Mises densitystat_vonmises_fit
Von Mises mixture density layerstat_vonmises_mixture
Summarize circular posterior drawssummarise_circular_draws
Circular plot themestheme_circular theme_compass theme_rose
Compute toroidal flow datatoroidal_flow_data
Compute a conditional toroidal ridgetoroidal_ridge_data
Compute toroidal topography datatoroidal_topography_data
Watson-Williams test for equal circular meanswatson_williams_test
Simulated wind directionswind_directions