Ergodicity Library: A \proglang Python Toolkit for Stochastic-Process Simulation, Time-Average Diagnostics, and Agent-Based Experiments

Ihor Kendiukhov University of Tübingen · 2026

Read Ergodicity Library: A \proglang Python Toolkit for Stochastic-Process Simulation, Time-Average Diagnostics, and Agent-Based Experiments by Ihor Kendiukhov University of Tübingen (2026) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2605-13607.txt.

Introduction

Ihor Kendiukhov presents ergodicity, an open-source Python toolkit for computational work on stochastic dynamics. The package joins three layers often split across ad hoc scripts: process specs and simulators, plus analysis and fitting tools, and agent-based tests. It stresses non-ergodicity, time-average ways, heavy-tailed flows, and decision making under uncertainty. The article covers the software rather than new theory, with worked examples from heavy-tailed spread to partial stochastic differential equation work.

Catalog record

CREATORIhor Kendiukhov University of Tübingen
YEAR2026
COLLECTIONPAPERS
FORMATTXT
FILE SIZE15550
LICENSEhttp://creativecommons.org/licenses/by/4.0/
RIGHTSCC BY
SOURCEarXiv

Source: https://arxiv.org/abs/2605.13607

Browse the full library · About the Tower of Babel

Full text

The opening of the work, from the library's hosted text:

Ergodicity Library: A \proglang Python Toolkit for Stochastic-Process Simulation, Time-Average Diagnostics, and Agent-Based Experiments Ihor Kendiukhov University of Tübingen Abstract \Plainauthor Ihor Kendiukhov \Plaintitle Ergodicity Library: A Python Toolkit for Stochastic-Process Simulation, Time-Average Diagnostics, and Agent-Based Experiments \Shorttitle Ergodicity Library in \proglang Python \Abstract \pkg ergodicity is an open-source \proglang Python library for computational work on stochastic dynamics, with particular emphasis on non-ergodicity, time-average behavior, heavy-tailed processes, and decision making under uncertainty. The package brings together three layers that are often split across ad hoc scripts: process definitions and simulators, analysis and fitting tools, and agent-based experimentation. This article documents the implemented software rather than presenting new stochastic theory. We describe the package architecture, the supported process families, the analysis workflow, and the practical boundaries of the current implementation. We also provide fully reproducible examples covering heavy-tailed ensemble spread, multiplicative Levy growth diagnostics, adaptive-memory mean reversion, preasymptotic fluctuation analysis, and partial stochastic differential equation simulation. The package is positioned as an integration layer on top of the scientific \proglang Python stack, reducing the amount of glue code required to move from process specification to diagnostics and comparative experiments. \Keywords research software, stochastic processes, heavy tails, ergodicity, time averages, \proglang Python \Plainkeywords research software, stochastic processes, heavy tails, ergodicity, time averages, Python \Address Ihor Kendiukhov University of Tübingen Tübingen, Germany E-mail: 1 Introduction: Computational stochastic workflows in \proglang Python Research on stochastic systems often requires chaining together tasks that are usually scattered across notebooks and one-off scripts: simulating candidate processes, estimating summary statistics, comparing time and ensemble behavior, fitting distributional families, and iterating on decision rules. In practice, the fragmentation cost is substantial. General-purpose scientific libraries provide strong numerical primitives, but they do not by themselves impose a coherent workflow for ergodicity-sensitive questions ( 8 ; 23 ; 17 ; 10 ; 18 ) . Reproducibility guidance in computational science has repeatedly highlighted the same failure mode: the logic of an analysis becomes distributed across disconnected scripts, environment assumptions, and undocumented plotting steps ( 20 ; 24 ; 25 ; 1 ; 11 ; 14 ) . \pkg ergodicity was developed to reduce that integration burden ( 13 ; 12 ) . The library is motivated by questions where time averages and ensemble expectations can diverge, especially under multiplicative or heavy-tailed dynamics ( 21 ; 22 ) . Rather than targeting a single model class, it organizes simulation, diagnostics, and decision-oriented experimentation around a shared process abstraction. This manuscript is a software paper in the Journal of Statistical Software sense. The goal is to document what the package implements, how it is organized, and what kinds of computational studies it supports. The emphasis is on software design, reproducible examples, and the relationship between the package and the surrounding scientific \proglang Python ecosystem. 2 Package scope and design goals The current implementation is best understood as an integrated stochastic-computing toolkit with three explicit design goals. 1. Provide reusable abstractions for a broad family of stochastic processes rather than isolated simulators. 2. Couple simulation closely to diagnostics such as fitting, preasymptotic analysis, and symbolic or numerical helper routines. 3. Support experiments in which stochastic dynamics and adaptive decision rules interact in the same software environment. These goals lead to a layered structure with three main package areas: process simulation, analytical tools, and agents. Table 1 summarizes the high-level architecture. Component Main contents Role in a research workflow \code ergodicity.process Process classes, stochastic increments, multiplicative and memory-dependent variants, constructor helpers Define stochastic hypotheses and generate trajectories under alternative assumptions \code ergodicity.tools Fitting, evaluation, preasymptotics, symbolic helpers, multiprocessing, automation, partial stochastic differential equation simulation Quantify behavior, compare model families, and automate repeated analyses \code ergodicity.agents Utility-based agents, portfolio abstractions, agent pools, evolutionary optimization, machine-learning-oriented routines Explore decision rules and interacting adaptive systems built on stochastic environments Table 1: High-level package architecture. A central design choice is the use of a shared process hierarchy. User-facing simulation workflows are exposed through related classes such as \code Process, \code ItoProcess, \code NonItoProcess, and custom-process scaffolding. This allows common operations such as simulation, plotting, and summary extraction to be reused across multiple stochastic families while still supporting model-specific increment definitions. 3 Processes, diagnostics, and software interfaces 3.1 Process families The process layer covers a wide span of model families. In the current codebase, these include Brownian and Wiener-type models, Levy-stable processes, Poisson-driven dynamics, multiplicative geometric variants, memory-dependent processes, fractional or multifractional variants, and selected multivariate process classes. The purpose is not to claim exhaustive coverage of stochastic modeling, but to provide a practical working set that spans additive and multiplicative dynamics, light-tailed and heavy-tailed increments, and memoryless versus adaptive behavior ( 26 ; 19 ; 9 ; 4 ; 15 ; 6 ) . 3.2 Analytical and diagnostic tooling The tools layer is where the package differentiates itself from a minimal simulator. In addition to standard numerical summaries, the package includes distribution-fitting utilities, evaluation helpers, symbolic support routines, preasymptotic diagnostics, automation and multiprocessing wrappers, and a partial stochastic differential equation simulator. This arrangement is valuable when a user needs to move quickly from a new process specification to a diagnostic comparison without re-implementing the surrounding infrastructure. 3.3 Agents and decision-oriented routines The agents layer extends the library beyond passive trajectory generation. It contains utility-based agents, portfolio abstractions over process ensembles, interacting agent pools, and evolutionary or machine-learning-oriented optimization routines. These capabilities connect the stochastic-process layer to decision-making workflows and to broader agent-based modeling practice ( 2 ; 7 ) . In the current package, however, this is also the part most sensitive to optional dependency complexity. 3.4 A minimal interface example A typical workflow starts from process construction and ends with an ensemble diagnostic. The following abbreviated example is representative of the package API. {Code} from ergodicity.process.basic import BrownianMotion from ergodicity.process.multiplicative import GeometricLevyProcess bm = BrownianMotion(drift=0.0, scale=1.0) glp = GeometricLevyProcess(alpha=1.55, beta=0.2, scale=0.35, loc=0.02) brownian = bm.simulate(t=3.0, timestep=0.01, num_instances=240, plot=False, save=False) heavy_tailed = glp.simulate(t=4.0, timestep=0.01, num_instances=360, plot=False, save=False) At this level the package aims to keep the workflow consistent across process classes. Downstream diagnostics can then consume the same simulation outputs without reshaping the entire analysis around each model family. 4 Reproducible examples All figures in this section are generated by the standalone replication script \code article.py included with the submission. The script uses the packaged source snapshot and writes all graphics into the local \code figures/ directory. The examples were selected to show software functionality rather than to serve as standalone scientific claims. 4.1 Gaussian versus heavy-tailed ensemble spread Figure 1 compares ensemble fan charts for Brownian motion and a Levy-stable process under comparable discretization. The point is not simply that the heavy-tailed model is more variable. More importantly, the geometry of the quantile bands becomes less regular and less well represented by Gaussian intuition, which matters for downstream diagnostics and model selection ( 16 ; 3 ; 5 ) . Figure 1: Quantile fan charts for Brownian and Levy-stable ensembles. The heavy-tailed process produces a broader and less regular spread geometry over the same horizon. 4.2 Heavy-tailed multiplicative growth diagnostics The multiplicative example in Figure 2 is built from a Geometric Levy process. The left panel shows trajectory intermittency on a log scale; the right panel compares arithmetic

Read the complete text