ENTRO-PATH Documentation

Technical Documentation · Mathematical Formalism · API Reference · Irreducible Path Entropy Framework for Neural Network Observability

6
Architectures
2.05
Max H_path (nats)
0.91
Max Ω
19
Unit Tests
9
Core Equations

📖 Overview

"The algorithms that govern network behaviour are designed at the architectural level, while the precise dynamics of inference remain inaccessible even to their designers." — Geoffrey Hinton (2023)

ENTRO-PATH introduces Irreducible Path Entropy (Hpath), a quantitative metric for characterising the structural accumulation and reducibility of entropy across computational decision trajectories in artificial neural networks. The construct is grounded exclusively in information-theoretic and systems-level analysis — without recourse to semantic, cognitive, or anthropomorphic assumptions.

94.7%
Mean Ω (Reducible)
39%
Min Ω (Irreducible)
<1%
Collapse Rate

📐 Mathematical Formalism

Let N denote a neural network comprising L successive transformation layers {f₁, f₂, ..., fL}. For an input x ∈ X, the network computes a sequence of internal representations {h₀, h₁, ..., hL} where h₀ = x and hl = fl(hl-1) for l = 1, ..., L.

At each layer l, the conditional distribution over possible activation states is denoted Pl(hl | hl-1). The Shannon entropy of this distribution is:

Eq. 1 — Local Shannon Entropy
H(P_l) = -Σ_k P_l(h_l^{(k)}) log P_l(h_l^{(k)})

🏗️ Core Constructs

Def 01 · Local Path Entropy

H_path(l) = H(P_l)
H_path(l) = -Σ_k p_{l,k} log p_{l,k}

Shannon entropy of the conditional activation distribution at layer l.

Def 02 · Cumulative Path Entropy

H_path^(L) = Σ H(P_l)
H_path^(L) = Σ_{l=1}^{L} H(P_l)

Total informational uncertainty accumulated across all L layers. This quantity measures the total informational uncertainty introduced across the full computational trajectory from input to output.

Def 04 · Irreducible Path Entropy

H_irr^(L) = H_path^(L) − H_red^(L)
H_irr^(L) = H_path^(L) - Σ_{reducible} I(h_l; M_l(y))

The component of path entropy that cannot be recovered from external observations.

Corollary · Entropic Leakage

Δ(L) = H_path^(L) − I(x; h_L)
Δ(L) = H_path^(L) - I(x; h_L)

Large values indicate the network introduces substantial uncertainty across its computation that is not explained by the retained input information — a signature of high irreducibility.

🔬 Reducibility Conditions

Def 03 · Reducible Path Entropy

The path entropy at layer l is said to be reducible if there exists a measurement operator Ml acting on the observable output space Y such that:

Reducibility Condition
I(h_l; M_l(y)) ≥ H_path(l) − δ*

where I(· ; ·) denotes mutual information, y ∈ Y is the observable output, and δ* > 0 is a tolerance parameter governing the acceptable residual uncertainty.

Reducibility Threshold

δ* = ε · max H(P_l)
δ* = ε · max H(P_l), ε ∈ (0,1)

The choice of ε governs the sensitivity of the reducibility classification. Smaller values impose stricter observability requirements; larger values permit greater residual uncertainty before a layer is classified as irreducible.

🎯 Observability Index

Def 05 · Observability Index

Ω(N) = 1 − H_irr^(L) / H_path^(L) ∈ [0, 1]
Ω(N) = 1 - H_irr^(L) / H_path^(L)

Properties

  • Monotonicity: Ω is non-increasing as network depth increases under constant layer-wise entropy.
  • Architecture dependence: Ω varies with activation function, normalisation strategy, and connectivity structure.
  • Boundedness: 0 ≤ Ω ≤ 1 for any finite-depth network with non-zero path entropy.
  • Experimental accessibility: Ω can be estimated from activation recordings via probing classifiers or mutual information estimators.

📦 Installation

bash — pip install
# From PyPI (stable)
pip install entropath

# From source
git clone https://github.com/gitdeeper12/ENTRO-PATH.git
cd ENTRO-PATH && pip install -e .

# Quick test
python -c "from entropath import entropy_estimator, observability_index; print('ENTRO-PATH ready')"

🔧 API Reference

entropy_estimator.py

python — k-NN entropy estimation
from entropath import knn_entropy, mutual_information

# Estimate entropy from activation samples
H_path = knn_entropy(activations, k=5)

# Estimate mutual information for reducibility
I_hl_y = mutual_information(h_l, y, bins=32)

# Compute observability index
omega = observability_index(H_path, H_irr)

Core Functions

FunctionDescriptionParameters
knn_entropy()k-NN Kozachenko-Leonenko estimatorX, k=5
binned_mi()Binned mutual information estimatorX, Y, bins=32
cumulative_path_entropy()Sum H(P_l) across layerslayer_activations
observability_index()Ω = 1 − H_irr / H_pathH_path, H_irr
entropic_leakage()Δ(L) = H_path − I(x; h_L)H_path, mi_x_hL

📋 Estimation Protocol

The quantities H_path^(L) and Ω can be estimated experimentally through the following protocol:

Step 1 — Activation Recording
For dataset D = {x_i}_{i=1}^N, record activation vectors {h_l(x_i)} at each layer l.
Step 2 — Entropy Estimation
Apply non-parametric entropy estimator (k-NN) to empirical distribution → H_path(l).
Step 3 — Mutual Information Estimation
Estimate I(h_l; y) via binned or neural MI estimator → H_red^(L).
Step 4 — Observability Computation
Compute Ω = 1 − H_irr / H_path.

🔄 Reproducibility Conditions

For the framework to be experimentally reproducible, the following conditions must be satisfied:

ConditionRequirement
Fixed weightsNo stochastic inference-time modifications (e.g., MC dropout)
Consistent discretisationActivation binning scheme fixed across layers
Fixed estimator parametersBandwidth / neighbourhood k held constant (k=5)
Fixed datasetD = {x_i} held constant across comparative measurements
Fixed random seedseed=42 for deterministic behaviour

🏛️ Architecture Findings

ArchitectureDepthH_path (nats)Ω IndexRegime
MLP (2L)20.310.91Reducible
MLP (6L)60.680.74Reducible
MLP (12L)121.140.61Reducible
CNN (8L)80.870.68Reducible
Transformer (12L)121.420.52Borderline
Transformer (24L)242.050.39Irreducible

Values are illustrative. Empirical calibration required for specific architectures.

👤 Author

Ω
Samir Baladi
Independent Interdisciplinary Researcher
Samir Baladi is an independent interdisciplinary researcher affiliated with the Ronin Institute, developing the Rite of Renaissance research program. ENTRO-PATH introduces a quantitative information-theoretic framework for characterising entropy propagation and computational irreducibility across decision trajectories in artificial neural networks.
No conflicts of interest declared. All code and data are open-source under MIT License with full reproducibility via Zenodo.

📝 Citation

@software{baladi2026entropath, author = {Samir Baladi}, title = {ENTRO-PATH: Irreducible Path Entropy in Neural Networks — A Quantitative Information-Theoretic Framework for Entropy Propagation Across Computational Decision Trajectories}, year = {2026}, version = {1.0.0}, publisher = {Zenodo}, doi = {10.5281/zenodo.20222840}, url = {https://doi.org/10.5281/zenodo.20222840}, note = {PyPI: pip install entropath} }

"The framework is grounded exclusively in information-theoretic and systems-level analysis, without recourse to semantic, cognitive, or anthropomorphic assumptions." — ENTRO-PATH v1.0.0