mercurial.branches.alignment module

Cross-branch alignment dynamics with level coupling (MERCURIAL C).

class mercurial.branches.alignment.AlignmentEvent(branch_a: int, branch_b: int, position: numpy.ndarray, time: float, coupling_strength: float, duration: float)

Bases: object

Methods

coupling_envelope

branch_a: int

branch_b: int

coupling_envelope(t: float) → float

coupling_strength: float

duration: float

position: ndarray

time: float

class mercurial.branches.alignment.BranchAlignment(branch_levels: List[int], base_coupling: float = 0.1, alignment_threshold: float = 0.7, decay_length: float = 1.0, k_align: float = 1.0, S_crit: float = 10.0, tau_align: float = 1.0)

Bases: object

Implements alignment probability with cross‑level adjacency optimization.

Methods

alignment_probability(branch_i, branch_j, ...)

p_align = K_ij * base_similarity * exp(-(S_i+S_j)/k_align) No hard threshold – allows low probabilities for cross‑level.

alignment_dynamics
compute_transfer

__init__(branch_levels: List[int], base_coupling: float = 0.1, alignment_threshold: float = 0.7, decay_length: float = 1.0, k_align: float = 1.0, S_crit: float = 10.0, tau_align: float = 1.0)

Parameters:

branch_levelsList[int]

LADDER level for each branch.

base_couplingfloat

K_0 for same-level coupling.

alignment_thresholdfloat

Minimum similarity to consider alignment.

decay_lengthfloat

ℓ_adj for cross-level decay.

k_alignfloat

Boltzmann constant for entropy factor.

S_critfloat

Critical entropy threshold.

tau_alignfloat

Alignment decay time constant.

alignment_dynamics(lambda0: float, t: float) → float

alignment_probability(branch_i: int, branch_j: int, entropy_i: float, entropy_j: float, base_similarity: float = 1.0) → float

p_align = K_ij * base_similarity * exp(-(S_i+S_j)/k_align) No hard threshold – allows low probabilities for cross‑level.

compute_transfer(pattern_source: ndarray, coupling: float, mapping: ndarray | None = None, use_isomorphism: bool = True) → ndarray