findstructureintime/Time-Series-Analysis: First release of Time-Series-Analysis package

This code package contains four Matlab code modules with sample examples introduced in the paper, Finding Structure in Time: Visualizing and Analyzing Behavioral Time Series. These code modules aim to facilitate behavioral researchers to interpret and analyze high-density multi-modal behavior data, namely, to:

1. visualize the raw behavioral time series,
2. describe the distributional structure of temporal events: Burstiness calculation. This is a method to quantify the temporal regularity of occurrence of events (Goh & Barabási, 2008),
3. characterize the nonlinear dynamics over multiple timescales with Cross-Recurrence Quantification Analysis (CRQA) (Zbilut, Giuliani & Webber, 1998),
4. and quantify the directional relations among a set of interdependent multimodal behavioral variables with Granger Causality Granger, 1969; Bressler & Seth, 2011). The four methods are complementary to each other, yet each module is standalone. Users can use any specific module as desired.

The scripts run on Matlab version 2018a and later versions. Matlab is available on all three main types of operating systems: Windows, macOS, and Linux. While Matlab is not free and open source which presents limitations to our users, many institutions offer Matlab for free. One can check this following website to see if a free campus license is available (all links provided in README.md on github repository). Alternatively, users can install and run our code modules on GNU Octave which is open source and runs on GNU/Linux, macOS, BSD, and Windows.