delaynet: Reconstruct and analyse delay propagation networks

Delaynet is a Python package for reconstructing and analysing delay functional networks from time series. It offers:

• Detrending and data preparation utilities
• Multiple connectivity measures with unified p-value output and optimal lag selection
• End-to-end network reconstruction and analysis tooling

Documentation: https://delaynet.readthedocs.io/
Repository: https://github.com/cbueth/delaynet
Issues: https://github.com/cbueth/delaynet/issues

Installation

pip install delaynet

Python 3.11–3.13 are supported.

Quickstart

import numpy as np
import delaynet as dn

# Example data: 5 nodes, 300 time points
rng = np.random.default_rng(1520)
data = rng.standard_normal((300, 5))

# Pairwise connectivity (Granger causality) with lag search up to 10
pval, lag = dn.connectivity(data[:, 0], data[:, 1], metric="gc", lag_steps=10)

# Reconstruct network (p-value matrix and lag matrix)
weights, lags = dn.reconstruct_network(data, connectivity_measure="gc", lag_steps=5)

---

Highlights

• Unified connectivity and reconstruction workflow

  • Consistent p-value output across connectivity measures and automatic best-lag selection
  • New reconstruct_network function producing p-value and lag matrices for directed delay networks

• Network analysis module

  • Pruning by statistical significance or multiple-comparison control
  • Core metrics: centralities, link density, reciprocity, transitivity, global efficiency; isolated nodes

• Performance and robustness

  • Parallel execution support for reconstruction; progress tracking in both sequential and parallel modes
  • High test coverage and cross-platform CI

• Data and documentation

  • Synthetic data generators (including transportation-oriented scenarios)
  • Structured guides and API reference covering detrending, connectivity, reconstruction, and analysis

Notable changes and compatibility

• Terminology update: “normalisation” → “detrending” throughout the API and docs
• Entropy-based connectivity API simplified (direct keyword arguments; deprecated kwargs dicts removed)
• Symbolization submodule removed
• Requires Python ≥ 3.11

Links

• Documentation: https://delaynet.readthedocs.io/
• Changelog: https://delaynet.readthedocs.io/en/latest/changelog/
• Issues: https://github.com/cbueth/delaynet/issues

License

BSD-3-Clause