srfm::momentum Namespace Reference

Classes
class	BetaVelocity
	Normalised market velocity β = price_velocity / c_market. More...
class	EffectiveMass
	ADV-based effective mass proxy. More...
class	LorentzFactor
	Pre-computed Lorentz factor γ = 1/√(1−β²). Always ≥ 1.0. More...
class	MomentumProcessor
struct	MomentumSignal
	Input descriptor for a single relativistic momentum computation. More...
struct	RawSignal
	A raw (pre-correction) market signal value. More...
struct	RelativisticMomentum
	Result of applying relativistic momentum correction to a single signal. More...
struct	RelativisticSignal
	A gamma-corrected relativistic momentum signal. More...
class	RelativisticSignalProcessor

Functions
std::optional< LorentzFactor >	lorentz_gamma (BetaVelocity beta) noexcept
	Compute Lorentz factor γ = 1/√(1−β²).
std::optional< std::pair< double, LorentzFactor > >	apply_momentum_correction (double raw_signal, BetaVelocity beta, EffectiveMass m_eff) noexcept
	Apply relativistic momentum correction: p_rel = γ · m_eff · raw.
std::optional< BetaVelocity >	compose_velocities (BetaVelocity beta1, BetaVelocity beta2) noexcept
	Relativistic velocity composition: β_result = (β₁+β₂)/(1+β₁β₂).
std::optional< double >	inverse_transform (double dilated_value, BetaVelocity beta) noexcept
	Recover the proper (un-dilated) value: proper = dilated / γ.

Variables
constexpr double	BETA_MAX_SAFE = 0.9999

Function Documentation

apply_momentum_correction()

std::optional< std::pair< double, LorentzFactor > > srfm::momentum::apply_momentum_correction ( double  raw_signal, BetaVelocity  beta, EffectiveMass  m_eff  )

noexcept

Apply relativistic momentum correction: p_rel = γ · m_eff · raw.

Mirrors applyMomentumCorrection() from the SRFM C++ reference.

Parameters

raw_signal	Un-corrected market signal (any finite double).
beta	Validated normalised market velocity.
m_eff	ADV-based effective mass.

Returns

{adjusted_value, gamma} pair, or std::nullopt if γ fails.

Examples

/home/runner/work/Special-Relativity-in-Financial-Modeling/Special-Relativity-in-Financial-Modeling/src/momentum/momentum.hpp.

Definition at line 50 of file momentum.cpp.

compose_velocities()

std::optional< BetaVelocity > srfm::momentum::compose_velocities ( BetaVelocity  beta1, BetaVelocity  beta2  )

noexcept

Relativistic velocity composition: β_result = (β₁+β₂)/(1+β₁β₂).

Preserves the sub-luminal invariant.

Returns

std::nullopt if the composed result would be ≥ BETA_MAX_SAFE.

Examples

/home/runner/work/Special-Relativity-in-Financial-Modeling/Special-Relativity-in-Financial-Modeling/src/momentum/momentum.hpp.

Definition at line 60 of file momentum.cpp.

inverse_transform()

std::optional< double > srfm::momentum::inverse_transform ( double  dilated_value, BetaVelocity  beta  )

noexcept

Recover the proper (un-dilated) value: proper = dilated / γ.

Returns

std::nullopt if γ computation fails.

Examples

/home/runner/work/Special-Relativity-in-Financial-Modeling/Special-Relativity-in-Financial-Modeling/src/momentum/momentum.hpp.

Definition at line 68 of file momentum.cpp.

lorentz_gamma()

std::optional< LorentzFactor > srfm::momentum::lorentz_gamma ( BetaVelocity  beta )

noexcept

Compute Lorentz factor γ = 1/√(1−β²).

Parameters

beta	Validated normalised market velocity.

Returns

LorentzFactor with γ ≥ 1.0, or std::nullopt if result is non-finite (unreachable after BetaVelocity validation, but explicit for defence-in-depth).

Examples

/home/runner/work/Special-Relativity-in-Financial-Modeling/Special-Relativity-in-Financial-Modeling/src/momentum/momentum.hpp.

Definition at line 42 of file momentum.cpp.

Variable Documentation

BETA_MAX_SAFE

constexpr double srfm::momentum::BETA_MAX_SAFE = 0.9999

inlineconstexpr

Upper bound for safe β values. At β = 1.0 γ → ∞; values at or above this threshold are rejected to keep all arithmetic finite.

Examples

/home/runner/work/Special-Relativity-in-Financial-Modeling/Special-Relativity-in-Financial-Modeling/src/beta_calculator/beta_calculator.hpp, and /home/runner/work/Special-Relativity-in-Financial-Modeling/Special-Relativity-in-Financial-Modeling/src/momentum/momentum.hpp.

Definition at line 62 of file momentum.hpp.