core/persona/motor.py

79 lines
2.7 KiB
Python

"""
Persona as a CGA motor — a rigid screw motion on the generation manifold.
M = T * R where:
T = translator versor (persona's position in concept space)
R = rotor (persona's characteristic rotation)
Applying persona: F_voiced = M * F * reverse(M)
This is a versor product. Persona application is algebraically closed.
No weight overlay. No post-hoc bias. No separate correction pass.
"""
import numpy as np
from algebra.versor import versor_apply, normalize_to_versor
from algebra.cl41 import geometric_product, reverse, basis_vector, N_COMPONENTS
class PersonaMotor:
def __init__(self, translator: np.ndarray, rotor: np.ndarray):
"""
translator: a versor encoding translational bias in CGA
rotor: a versor encoding rotational character
Both must satisfy versor_condition < 1e-6.
"""
self.M = normalize_to_versor(
geometric_product(
np.asarray(translator, dtype=np.float32),
np.asarray(rotor, dtype=np.float32),
)
)
def apply(self, F: np.ndarray) -> np.ndarray:
"""Apply persona to field F. Returns M * F * reverse(M)."""
return versor_apply(self.M, F)
def compose(self, other: "PersonaMotor") -> "PersonaMotor":
"""
Compose two persona motors: M_combined = self.M * other.M
Used to blend persona layers (base persona + session persona).
"""
result = PersonaMotor.__new__(PersonaMotor)
result.M = normalize_to_versor(geometric_product(self.M, other.M))
return result
@classmethod
def identity(cls) -> "PersonaMotor":
"""The identity motor — applies no transformation."""
inst = cls.__new__(cls)
inst.M = np.zeros(N_COMPONENTS, dtype=np.float32)
inst.M[0] = 1.0
return inst
@classmethod
def from_concept_vector(cls, concept: np.ndarray) -> "PersonaMotor":
"""
Build a persona motor from a 3D concept vector in R^3.
Embeds as a CGA translator: T = 1 + (1/2) * t * e_inf
where e_inf = e+ + e- (the point at infinity in CGA).
"""
concept = np.asarray(concept, dtype=np.float32)
assert len(concept) == 3
e_inf = basis_vector(3) + basis_vector(4) # e+ + e-
t_blade = np.zeros(N_COMPONENTS, dtype=np.float32)
for i in range(3):
t_blade += concept[i] * geometric_product(basis_vector(i), e_inf)
translator = np.zeros(N_COMPONENTS, dtype=np.float32)
translator[0] = 1.0
translator += 0.5 * t_blade
rotor = np.zeros(N_COMPONENTS, dtype=np.float32)
rotor[0] = 1.0
return cls(
normalize_to_versor(translator),
normalize_to_versor(rotor),
)