Circular Statistics for JASP

This is a circular statistics module for JASP. It can be installed additionally to the JASP core module. It provides basic methods in the JASP GUI such that analyses can be run without the need for programming. The underlying R code is based on the package circular by U. Lund et al..

Prerequisites

An installed JASP version >= 0.11 (it needs to support dynamic modules).

Installing

The following works for JASP version 0.11. The process may vary for higher versions of JASP because dynamic modules are still beta in JASP version 0.11.

• Download the source CircularStatistics.tar.gz from the latest release to your local file system.
• Open JASP.
• Go to Preferences -> Advanced -> Enable Developer mode (beta)
• Click the + button in the main ribbon and select install module.
• Select the downloaded CircularStatistics.tar.gz.

That's it! The module and all it's R dependencies will be installed automatically.

You can now load a dataset in JASP as usual and start the analysis.

How to use it

You can use the submenus of Circular Statistics to run descriptive analysis (such as plotting) or hypothesis tests. Most important is that you specify the period of your data for each analysis. This can be done in every submenu separately. A documentation of the functionalities can be found in the GUI itself. Just press the information button in the submenus. A toy data set to play with is the ElNino.csv. A commented example analysis for this data set can be found here. To look at it, just open the ElNino.jasp file in JASP.

Developed With

• QtCreator
• RStudio

Contributing

If you would like to contribute to the module, you can use JASP as a development tool:

• Download, fork, or clone the CircularStatistics repo.
• Open JASP and go to preferences.
• Go to Advanced.
• Set the development path to the CircularStatistics repo.
• Then click the + button in the main ribbon.
• Click Install Development Module.

There you go! Any changes made to the GUI or the R code will be reflected in JASP immediately. For further details we refer to the JASP development documentation.

Authors

• Aaron Bahde and Philipp Berens

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE.md file for details.

Acknowledgments

Special thanks go to the JASP team of the University of Amsterdam who supported this project at any time. The compatibility of this module with the JASP core is due to their refactoring of the JASP design.

The inspiration for this module was given by Philipp Berens and his publication CircStat: A Matlab Toolbox for Circular Statistics.