Potsdam Institute for Climate Impact Research (PIK)
Interdisciplinary Center for Dynamics of Complex Systems (University of Potsdam)
Cardiovascular Physics Group (Humboldt-Universität zu Berlin)
PIK Logo
TOCSY - Toolboxes for Complex Systems
PIK/ Antique/ Blue
Home Home
ACE - Nonlinear Regression Analysis ACE
Adaptive Filtering Procedure Adaptive Filtering
CoinCalc - Event Coincidence Analysis CoinCalc
COPRA - Constructing Proxy Records From Age Models COPRA
Cross Recurrence Plot Toolbox CRP Toolbox
Commandline Recurrence Plots Commandline RPs
Analyse Coupling of Transient Dynamics Coupling Analysis
Identification of Coupling Direction Coupling Direction
Inner Composition Alignment IOTA
Dynamical Invariants by Recurrence Plots K2
Toolbox for the analysis of non-equidistantly sampled time series NEST
DSProlog DSProlog
PECUZAL PECUZAL
Permutation Entropy PETROPY
pyunicorn ‐ UNIfied COmplex Network and Recurrence aNalysis toolbox pyunicorn
Symbolic Dynamics from Recurrence Plots RECGRAM
Recurrence Plots for MATLAB RP
Recurrence Structure Analysis RSA
Wavelet and Coherence Analysis SOWAS
System Identification Tool System Identification
Time Series Graph and Momentary Information Transfer Estimation TiGraMITe

PECUZAL

(for MATLAB® | Julia | Python)

PECUZAL Matlab

We introduce the PECUZAL automatic embedding of time series method for Matlab. It is solely based on the paper [kraemer2021]_ (Open Source), where the functionality is explained in detail. Here we give an introduction to its easy usage in three examples. Enjoy Embedding!

Getting started

There are two ways of using the proposed PECUZAL method:

  • Install as Toolbox. This is the easiest way and allows the usage of the the function pecuzal_embedding.m` independently from your current working directory. It gets treated as a built-in Matlab-function and you do not have to copy any files etc. For this simply download the 'pecuzal-embedding.mltbx' from this repository or from `Matlab-Central and double-click `pecuzal-embedding.mltbx` for installation. That's it.
  • You can also download this repository and copy the folder into the MATLAB user's directory. This is usually the user's "Documents" folder appended with "MATLAB" (you can find out using the function `userpath`). Add the toolbox by the `addpath` command, e.g., `addpath  /Documents/MATLAB/PECUZAL_Matlab` on a Linux system. For everyday use, copy this command to a `startup.m` file in the MATLAB user's directory.

NOTE

For performance reasons we recommend to use the implementation in the Julia language, in order to get fast results, especially in the multivariate case. Moreover, it is well documented and embedded in the DynamicalSystems.jl ecosystem. The computation times can be magnitudes higher than in the Julia implementation.

Documentation and basic usage

There is a documentation and a Matlab Live-Script available including some basic usage examples.

Citing and reference

If you enjoy this tool and find it valuable for your research please cite

or as BiBTeX-entry:

@article{Kraemer2021,
     doi = {10.1088/1367-2630/abe336},
     url = {https://doi.org/10.1088/1367-2630/abe336},
     year = 2021,
     month = {mar},
     publisher = {{IOP} Publishing},
     volume = {23},
     number = {3},
     pages = {033017},
     author = {K H Kraemer and G Datseris and J Kurths and I Z Kiss and J L Ocampo-Espindola and N Marwan},
     title = {A unified and automated approach to attractor reconstruction},
     journal = {New Journal of Physics},
     abstract = {We present a fully automated method for the optimal state space reconstruction from univariate and multivariate time series. The proposed methodology generalizes the time delay embedding procedure by unifying two promising ideas in a symbiotic fashion. Using non-uniform delays allows the successful reconstruction of systems inheriting different time scales. In contrast to the established methods, the minimization of an appropriate cost function determines the embedding dimension without using a threshold parameter. Moreover, the method is capable of detecting stochastic time series and, thus, can handle noise contaminated input without adjusting parameters. The superiority of the proposed method is shown on some paradigmatic models and experimental data from chaotic chemical oscillators.}
 }

Licence

This is program is free software and runs under MIT Licence.

Download

github.com/hkraemer/PECUZAL_Matlab

Authors

  • Hauke Kraemer


© 2004-2023 SOME RIGHTS RESERVED
University of Potsdam, Interdisciplinary Center for Dynamics of Complex Systems, Germany
Potsdam Institute for Climate Impact Research, Complexity Science, Germany

This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 2.0 Germany License.
Imprint, Data policy, Disclaimer, Accessibility statement

Please respect the copyrights! The content is protected by the Creative Commons License. If you use the provided programmes, text or figures, you have to refer to the given publications and this web site (tocsy.pik-potsdam.de) as well.

@MEMBER OF PROJECT HONEY POT
Spam Harvester Protection Network
provided by Unspam