Pyriodicity
Efficient periodicity length detection for univariate signals in Python. You can check the supported detection methods in the API Reference.
Installation
To install pyriodicity, simply run:
pip install pyriodicity
To install the latest development version, you can run:
pip install git+https://github.com/iskandergaba/pyriodicity.git
Usage
Please refer to the package documentation for more information.
For this example, start by loading Mauna Loa Weekly Atmospheric CO2 Data from statsmodels and downsampling its data to a monthly frequency.
>>> from statsmodels.datasets import co2
>>> data = co2.load().data
>>> data = data.resample("ME").mean().ffill()
Use Autoperiod to find the list of periodicity lengths in this data, if any.
>>> from pyriodicity import Autoperiod
>>> Autoperiod.detect(data)
array([12])
The detected periodicity length is 12 which suggests a strong yearly seasonality given that the data has a monthly frequency.
We can also use online detection methods for data streams as follows.
>>> from pyriodicity import OnlineACFPeriodicityDetector
>>> data_stream = (sample for sample in data.values)
>>> detector = OnlineACFPeriodicityDetector(window_size=128)
>>> for sample in data_stream:
... periods = detector.detect(sample)
>>> 12 in periods
True
All the supported periodicity detection methods can be used in the same manner as in the examples above with different optional parameters. Check the API Reference for more details.
References
- Hyndman, R.J., & Athanasopoulos, G. (2021). Forecasting: principles and practice, 3rd edition, OTexts: Melbourne, Australia. OTexts.com/fpp3. Accessed on 09-15-2024.
- Vlachos, M., Yu, P., & Castelli, V. (2005). On periodicity detection and Structural Periodic similarity. Proceedings of the 2005 SIAM International Conference on Data Mining. doi.org/10.1137/1.9781611972757.40.
- Puech, T., Boussard, M., D'Amato, A., & Millerand, G. (2020). A fully automated periodicity detection in time series. In Advanced Analytics and Learning on Temporal Data: 4th ECML PKDD Workshop, AALTD 2019, Würzburg, Germany, September 20, 2019, Revised Selected Papers 4 (pp. 43-54). Springer International Publishing. doi.org/10.1007/978-3-030-39098-3_4.
- Toller, M., Santos, T., & Kern, R. (2019). SAZED: parameter-free domain-agnostic season length estimation in time series data. Data Mining and Knowledge Discovery, 33(6), 1775-1798. doi.org/10.1007/s10618-019-00645-z.
- Wen, Q., He, K., Sun, L., Zhang, Y., Ke, M., & Xu, H. (2021, June). RobustPeriod: Robust time-frequency mining for multiple periodicity detection. In Proceedings of the 2021 international conference on management of data (pp. 2328-2337). doi.org/10.1145/3448016.3452779.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pyriodicity-0.8.0.tar.gz.
File metadata
- Download URL: pyriodicity-0.8.0.tar.gz
- Upload date:
- Size: 18.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
22e0958f06852ac8e70374d394d5fb7db09b53b6994cb405d4e6612f5472af2a
|
|
| MD5 |
69488db5e6728e05abb1fc69310f5bb9
|
|
| BLAKE2b-256 |
748aaaa987e0d22e2e6c7db2b656ac3932e420490f763dc267e7e0af85cd35d7
|
File details
Details for the file pyriodicity-0.8.0-py3-none-any.whl.
File metadata
- Download URL: pyriodicity-0.8.0-py3-none-any.whl
- Upload date:
- Size: 30.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
68262865b40f5273a549ab81a4bba1ccaf45f021920d42aafa471810252cfdae
|
|
| MD5 |
00653943300f126b2b8f1478c246303f
|
|
| BLAKE2b-256 |
a141374fb1867f5bceab07fd6abf3e44e3fbd5171264de83bcc13bb6648ee2fa
|
