{"id":13570823,"url":"https://github.com/DynamicsAndNeuralSystems/pyspi","last_synced_at":"2025-04-04T07:32:13.974Z","repository":{"id":40309306,"uuid":"267236019","full_name":"DynamicsAndNeuralSystems/pyspi","owner":"DynamicsAndNeuralSystems","description":"Comparative analysis of pairwise interactions in multivariate time series.","archived":false,"fork":false,"pushed_at":"2024-08-27T07:06:06.000Z","size":61025,"stargazers_count":212,"open_issues_count":8,"forks_count":27,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-12-26T22:20:49.095Z","etag":null,"topics":["complex-networks","complex-systems","multivariate-analysis","multivariate-timeseries","pairwise-interactions","time-series","time-series-analysis"],"latest_commit_sha":null,"homepage":"https://time-series-features.gitbook.io/pyspi/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DynamicsAndNeuralSystems.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-27T06:12:32.000Z","updated_at":"2024-12-20T18:27:22.000Z","dependencies_parsed_at":"2023-12-05T05:28:32.545Z","dependency_job_id":"24a9e29c-3cfa-4bf0-8650-5aaa29cf58c2","html_url":"https://github.com/DynamicsAndNeuralSystems/pyspi","commit_stats":null,"previous_names":["dynamicsandneuralsystems/pyspi","olivercliff/pyspi"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DynamicsAndNeuralSystems%2Fpyspi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DynamicsAndNeuralSystems%2Fpyspi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DynamicsAndNeuralSystems%2Fpyspi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DynamicsAndNeuralSystems%2Fpyspi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DynamicsAndNeuralSystems","download_url":"https://codeload.github.com/DynamicsAndNeuralSystems/pyspi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246742573,"owners_count":20826357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["complex-networks","complex-systems","multivariate-analysis","multivariate-timeseries","pairwise-interactions","time-series","time-series-analysis"],"created_at":"2024-08-01T14:00:55.424Z","updated_at":"2025-04-04T07:32:08.967Z","avatar_url":"https://github.com/DynamicsAndNeuralSystems.png","language":"Python","funding_links":[],"categories":["📦 Packages","Python"],"sub_categories":["Python"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource srcset=\"img/pyspi_logo_darkmode.png\" media=\"(prefers-color-scheme: dark)\"\u003e\n    \u003cimg src=\"img/pyspi_logo.png\" alt=\"pyspi logo\" height=\"200\"/\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\u003cem\u003epyspi\u003c/em\u003e: Python Toolkit of Statistics for Pairwise Interactions\u003c/h1\u003e\n\n\n\n\u003cp align=\"center\"\u003e\n \t\u003ca href=\"https://zenodo.org/badge/latestdoi/601919618\"\u003e\u003cimg src=\"https://zenodo.org/badge/601919618.svg\" height=\"20\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.gnu.org/licenses/gpl-3.0\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-GPLv3-blue.svg\" height=\"20\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/DynamicsAndNeuralSystems/pyspi/actions/workflows/run_unit_tests.yaml\"\u003e\u003cimg src=\"https://github.com/DynamicsAndNeuralSystems/pyspi/actions/workflows/run_unit_tests.yaml/badge.svg\" height=\"20\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://twitter.com/compTimeSeries\"\u003e\u003cimg src=\"https://img.shields.io/twitter/url/https/twitter.com/compTimeSeries.svg?style=social\u0026label=Follow%20%40compTimeSeries\" height=\"20\"/\u003e\u003c/a\u003e\u003cbr\u003e\n    \u003ca href=\"https://www.python.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/Python-3.8%20|%203.9%20|%203.10%20|%203.11%20|%203.12-3776AB.svg?style=flat\u0026logo=python\u0026logoColor=white\" alt=\"Python 3.8 | 3.9 | 3.10 | 3.11 | 3.12\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n_pyspi_ is a comprehensive python library for computing statistics of pairwise interactions (SPIs) from multivariate time-series (MTS) data.\nThe toolbox provides easy access to hundreds of methods for evaluating the relationship between pairs of time series, from simple statistics (like correlation) to advanced multi-step algorithms (like Granger causality).\nThe code is licensed under the [GNU GPL v3 license](http://www.gnu.org/licenses/gpl-3.0.html) (or later).\n\n**Feel free to reach out for help with real-world applications.**\nFeedback is much appreciated through [issues](https://github.com/DynamicsAndNeuralSystems/pyspi/issues), or [pull requests](https://github.com/DynamicsAndNeuralSystems/pyspi/pulls).\n\n| Section       | Description           |\n|:--------------|:----------------------|\n| [Installation](#installation-)       | Installing _pyspi_ and its dependencies                      |\n| [Getting Started](#getting-started-) | A quick introduction on how to get started with _pyspi_      |\n| [SPI Descriptions](#spi-descriptions-) | A link to the full table of SPIs and detailed descriptions   |\n| [Documentation](#documentation)     | A link to our API reference and full documentation on GitBooks |\n| [Contributing to _pyspi_](#contributing-to-pyspi-) | A guide for community members willing to contribute to _pyspi_ |\n| [Acknowledgement](#acknowledgement-) | A citation for _pyspi_ for scholarly articles                |\n| [Our Contributors](#our-contributors-) | A summary of our primary contributors                        |\n\u003chr style=\"border-top: 3px solid #bbb;\"\u003e\n\n## Installation 📥\nThe simplest way to get the _pyspi_ package up and running is to install the package using `pip install`. \nFor access to the full library of SPIs, the code requires GNU's [Octave](https://octave.org/download) to be installed on your system.\n\n#### 1. Pre-Install Octave (Optional)\nWhile you can safely install _pyspi_ without first installing `Octave`, you will not have access to the full library of SPIs\n\n#### 2. Create a conda environment (Optional, Recommended)\nWhile you can also install _pyspi_ outside of a conda environment, it depends on a lot of user packages that may make managing dependencies quite difficult. \nSo, we would also recommend installing pyspi in a conda environment. Firstly, create a fresh conda environment:\n```\nconda create -n pyspi python=3.9.0\n```\nOnce you have created the environment, activate it using `conda activate pyspi`.\n\n#### 3. Install with _pip_\nUsing `pip` for [`pyspi`](https://pypi.org/project/pyspi/):\n```\npip install pyspi\n```\n\nFor a more detailed guide on how to install _pyspi_, as well as how you can use _pyspi_ without first installing Octave, \nplease see the [full documentation](https://time-series-features.gitbook.io/pyspi/installation/installing-pyspi).\nAdditionally, we provide a comprehensive [troubleshooting guide](https://time-series-features.gitbook.io/pyspi/installation/troubleshooting) for users who encounter issues installing _pyspi_ on their system,\nas well as [alternative installation options](https://time-series-features.gitbook.io/pyspi/installation/alternative-installation-options). \n\n## Getting Started 🚀\n\nOnce you have installed _pyspi_, you can learn how to apply the package by checking out the [walkthrough tutorials](https://time-series-features.gitbook.io/pyspi/usage/walkthrough-tutorials) in our documentation.  Click any of the examples below to access the tutorials in our full documentation:\n\n- [Simple demonstration](https://time-series-features.gitbook.io/pyspi/usage/walkthrough-tutorials/getting-started-a-simple-demonstration)\n\n- [Finance: stock price time series](https://time-series-features.gitbook.io/pyspi/usage/walkthrough-tutorials/finance-stock-price-time-series)\n\n\n- [Neuroimaging: fMRI time series)](https://time-series-features.gitbook.io/pyspi/usage/walkthrough-tutorials/neuroimaging-fmri-time-series)\n\n### Advanced Usage\nFor advanced users, we offer several additional guides in the [full documentation](https://time-series-features.gitbook.io/pyspi/usage/advanced-usage) on how you can distribute your _pyspi_ jobs across PBS clusters, as well as how you can construct your own subsets of SPIs. \n\n## SPI Descriptions 📋\nTo access a table with a high-level overview of the _pyspi_ library of SPIs, including their associated identifiers, see the [table of SPIs](https://time-series-features.gitbook.io/pyspi/spis/table-of-spis) in the full documentation.\nFor detailed descriptions of each SPI, as well as its associated estimators, we provide a full breakdown in the [SPI descriptions](https://time-series-features.gitbook.io/pyspi/spis/spi-descriptions) page of our documentation. \n\n## Documentation\nThe full documentation is hosted on [GitBooks](https://time-series-features.gitbook.io/pyspi/). \nUse the following links to quickly access some of the key sections:\n\n- [Full installation guide](https://time-series-features.gitbook.io/pyspi/installation)\n- [Troubleshooting](https://time-series-features.gitbook.io/pyspi/installation/troubleshooting)\n- [Alternative installation options](https://time-series-features.gitbook.io/pyspi/installation/alternative-installation-options)\n- [Usage guide](https://time-series-features.gitbook.io/pyspi/usage)\n- [Distributing _pyspi_ computations](https://time-series-features.gitbook.io/pyspi/usage/advanced-usage/distributing-calculations-on-a-cluster)\n- [Table of SPIs and descriptions](https://time-series-features.gitbook.io/pyspi/spis)\n- [FAQ](https://time-series-features.gitbook.io/pyspi/usage/faq)\n- [API Reference](https://time-series-features.gitbook.io/pyspi/api-reference)\n- [Development guide](https://time-series-features.gitbook.io/pyspi/development)\n\n## Contributing to _pyspi_ 👨‍👨‍👦‍👦\nContributions play a vital role in the continual development and enhancement of _pyspi_, a project built and enriched through community collaboration.\nIf you would like to contribute to _pyspi_, or explore the many ways in which you can participate in the project, please have a look at our \ndetailed [contribution guidelines](https://time-series-features.gitbook.io/pyspi/development/contributing-to-pyspi) about how to proceed.\nIn contributing to _pyspi_, all participants are expected to adhere to our [code of conduct](https://time-series-features.gitbook.io/pyspi/development/code-of-conduct).\n\n### SPI Wishlist\nWe strive to provide the most comprehensive toolkit of SPIs. If you have ideas for new SPIs or suggestions for improvements to existing ones, we are eager to hear from and collaborate with you! \nAny pairwise dependence measure, provided it is accompanied by a published research paper, typically falls within the scope for consideration in the \n_pyspi_ library.\nYou can access our SPI wishlist via the [projects tab](https://github.com/DynamicsAndNeuralSystems/pyspi/projects) in this repo to open a request.\n\n## Acknowledgement 👍\n\nIf you use this software, please read and cite this article:\n\n- \u0026#x1F4D7; O.M. Cliff, A.G. Bryant, J.T. Lizier, N. Tsuchiya, B.D. Fulcher. [Unifying pairwise interactions in complex dynamics](https://doi.org/10.1038/s43588-023-00519-x), _Nature Computational Science_ (2023).\n\nNote that [preprint](https://arxiv.org/abs/2201.11941) and [free-to-read](https://rdcu.be/dn3JB) versions of this article are available.\n\n\u003cdetails closed\u003e\n    \u003csummary\u003eClick here for a BibTex reference:\u003c/summary\u003e\n\n```\n@article{Cliff2023:UnifyingPairwiseInteractions,\n\ttitle = {Unifying pairwise interactions in complex dynamics},\n\tvolume = {3},\n\tissn = {2662-8457},\n\turl = {https://www.nature.com/articles/s43588-023-00519-x},\n\tdoi = {10.1038/s43588-023-00519-x},\n\tnumber = {10},\n\tjournal = {Nature Computational Science},\n\tauthor = {Cliff, Oliver M. and Bryant, Annie G. and Lizier, Joseph T. and Tsuchiya, Naotsugu and Fulcher, Ben D.},\n\tmonth = oct,\n\tyear = {2023},\n\tpages = {883--893},\n}\n```\n\n\u003c/details\u003e\n\n## Other highly comparative toolboxes 🧰\nIf you are interested in trying other highly comparative toolboxes like _pyspi_, see the below list:\n\n- [_hctsa_](https://github.com/benfulcher/hctsa), the _highly comparative time-series analysis_ toolkit, computes over 7000 time-series features from univariate time series.\n- [_hcga_](https://github.com/barahona-research-group/hcga), a _highly comparative graph analysis_ toolkit, computes several thousands of graph features directly from any given network.\n\n\n## Our Contributors 🌟\nWe are thankful for the contributions of each and everyone who has helped make this project better. \nWhether you've added a line of code, improved our documentation, or reported an issue, your contributions are greatly appreciated! \nBelow are some of the leading contributors to _pyspi_:\n\n\u003ca href=\"https://github.com/DynamicsAndNeuralSystems/pyspi/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=DynamicsAndNeuralSystems/pyspi\" /\u003e\n\u003c/a\u003e\n\n## License 🧾\n_pyspi_ is released under the [GNU General Public License](https://www.gnu.org/licenses/gpl-3.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDynamicsAndNeuralSystems%2Fpyspi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDynamicsAndNeuralSystems%2Fpyspi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDynamicsAndNeuralSystems%2Fpyspi/lists"}