complexeva

Fast, low-memory complexity measures for 1D time series (EEG, MEG, physiology).

pip install complexeva  # Python 3.14+

import numpy
import complexeva

signal = numpy.random.randn(1000)   # one signal, shape (time,)
complexeva.hfd(signal)              # one float

batches

Pass every signal at once with time on the last axis; you get one value per signal, in the shape of the other axes. Each value is identical to calling the measure on that signal alone.

eeg = numpy.random.randn(64, 1000)              # (channels, time)
complexeva.hfd(eeg)                             # shape (64,)

study = numpy.random.randn(20, 64, 1000)        # (subjects, channels, time)
complexeva.sample_entropy(study)                # shape (20, 64)

recording = numpy.random.randn(1000, 64)        # time first? put time last
complexeva.dfa(recording.T)                     # shape (64,)

windows = numpy.lib.stride_tricks.sliding_window_view(signal, 200)[::10]  # (windows, 200), no copy
complexeva.permutation_entropy(windows)         # one value per window

Batches work for hfd, dfa, permutation_entropy, sample_entropy and numeric lempel_ziv; the rest take one signal. A non-finite sample raises an error naming its full index; a constant signal gives NaN in its place. NUMBA_NUM_THREADS limits the threads.

measures

	measure	input	paper
	Higuchi fractal dimension hfd, hfd_hilbert	(…, time) numeric; hfd_hilbert 1D	Higuchi 1988; Varley 2020
	Lempel–Ziv complexity lempel_ziv, lempel_ziv_hilbert	(…, time) numeric; Hilbert and binary string 1D	Kaspar & Schuster 1987; Schartner 2017
	sample entropy sample_entropy	(…, time) numeric	Richman & Moorman 2000
	permutation entropy permutation_entropy	(…, time) numeric	Bandt & Pompe 2002
	detrended fluctuation analysis dfa	(…, time) numeric	Peng 1994
	largest Lyapunov exponent lyapunov_exponent	1D numeric	Rosenstein 1993
	compression complexity compression_complexity	1D array	Cilibrasi & Vitányi 2005

speed and memory vs other packages

Batches, against a loop of antropy calls (NUMBA_NUM_THREADS sets the thread count):

validation

potential icons

A	B	C

licence

MIT