CLASSpp Manual
Cosmology reference and developer manual
Loading...
Searching...
No Matches
DNCDMProxySpecies Class Reference

#include <dncdm_proxy_species.h>

+ Inheritance diagram for DNCDMProxySpecies:

Public Types

enum class  RtaForm
 
enum class  AlphaForm
 
- Public Types inherited from BaseSpecies
enum class  EnergyType
 

Public Member Functions

bool HasNcdm () const override
 
 DNCDMProxySpecies (std::unique_ptr< DNCDMSpecies > parent, std::unique_ptr< DarkRadiationSpecies > fermion, std::unique_ptr< DarkRadiationSpecies > boson, std::vector< double > q_d, std::vector< double > dq_d, DecayTransitionKernel::Config cfg, const background *pba, const BackgroundModule *bgm)
 
void SetBackgroundModule (const BackgroundModule *bgm) override
 
void RegisterBackgroundIndices (int &index_bg) override
 
void RegisterIntegrationIndices (int &index_bi) override
 
void SetBackgroundInitialConditions (const BackgroundICContext &ctx) override
 
void ComputeBackground (double a, const double *pvecback_B, double *pvecback) override
 
void BackgroundDerivs (double tau, const double *y, double *dy, const double *pvecback) override
 
void BackgroundDerivsDiagonal (double tau, const double *y, double *diag, const double *pvecback) override
 
void WriteBackgroundColumnTitles (BackgroundColumnWriter &w) const override
 
void WriteBackgroundData (const double *pvecback, BackgroundColumnWriter &w) const override
 
void AddCouplingDerivs (double tau, const double *y, double *dy, const perturb_parameters_and_workspace &ppaw) const override
 
void PerturbDerivsDiagonal (const BaseSpecies::PerturbLayout &base, double tau, const double *y, double *diag, const perturb_parameters_and_workspace &ppaw) const override
 
void PrintVariables (PerturbColumnWriter &writer, const BaseSpecies::PerturbLayout *base, double tau, const double *y, const PerturbationsModule &mod, const perturb_workspace *ppw) const override
 
double TransportRate (int l, const double *pvecback) const
 
int bg_rho_sec_index () const
 
const DecayTransitionKernel::Config & kernel_config () const
 
double TransportRate (int l, double a, const double *pvecback) const
 
double AlphaFor (int l, double X) const
 
double KappaStoredToBare () const
 
double BareFactor () const
 
double DaughterNumber (const double *f, bool boson) const
 
double DaughterRho (const double *f, double a, bool boson) const
 
- Public Member Functions inherited from DNCDMSector
double GetOmega0 () const override
 
- Public Member Functions inherited from CompositeSpecies
std::unique_ptr< BaseSpecies::PerturbLayout > CreatePerturbLayout () const override
 
void ApplyInitialConditions (const BaseSpecies::PerturbLayout &base, double *y, const PerturbIcContext &ctx) override
 
StressEnergyContribution StressEnergy (const BaseSpecies::PerturbLayout &base, const perturb_vector *pv, const double *y, const double *pvecback, const perturb_workspace *ppw) const override
 
void PerturbDerivs (const BaseSpecies::PerturbLayout &base, double tau, const double *y, double *dy, const perturb_parameters_and_workspace &ppaw) const override
 
void FillSources (const BaseSpecies::PerturbLayout &base, const double *y, const double *dy, PerturbSourceContext &ctx) const override
 
void WriteOutputColumns (PerturbColumnWriter &writer, const PerturbationsModule &mod, file_format fmt, TransferColumnSection section=TransferColumnSection::all) const override
 
void PerturbSynchronousToNewtonian (const BaseSpecies::PerturbLayout &base, double *y, const PerturbIcContext &ctx) override
 
void CopyPerturbationsAcrossSwitch (const BaseSpecies::PerturbLayout &old_base, const BaseSpecies::PerturbLayout &new_base, const double *old_y, double *new_y, const PerturbSwitchContext &ctx) const override
 
void RegisterTransferSourceIndices (int &index_tp, const SourceRequestContext &ctx) override
 
void AppendBudgetLines (const double *pvecback_today, double rho_crit, std::vector< BudgetLine > &out) const
 
bool SupportsExplicitPerturbationEvolver () const override
 
int MaxMultipole (const precision *ppr, bool tensors) const override
 
bool PrefersExponentialPerturbationEvolver () const override
 
bool SupportsExponentialPerturbationEvolver () const override
 
double GetRadiationOmega0 () const override
 
double DarkRadiationRhoToday (const double *pvecback_integration) const override
 
double NeutrinoOmega0 () const override
 
double NeffContribution (double z) const override
 
void PrintNeffInfo () const override
 
void PrintMassInfo () const override
 
void PrintBackgroundDetails (const double *pvecback_today, double rho_crit_today) const override
 
double TensorMasslessRelativisticRho (const double *pvecback) const override
 
double DeviationFromRadiation (const double *pvecback) const override
 
void WarnIfNonlinearUnreliable (double m_ev_threshold) const override
 
std::vector< double > FreeStreamingWavenumbers () const override
 
std::optional< double > ChildOmega0 (const std::string &name) const override
 
double BackgroundAIni (double a_proposed, double tol) const override
 
void SetThermodynamicsModule (const ThermodynamicsModule *thm) override
 
void SetPerturbs (const perturbs *ppt) override
 
void FinalizeBackground (double a, double H, const double *pvecback_B, double *pvecback) override
 
double Rho (const double *pvecback) const override
 
double P (const double *pvecback) const override
 
double PPrime (double a, double H, const double *pvecback_B, const double *pvecback) const override
 
double FreestreamingRho (const double *pvecback) const override
 
bool ClustersAsMatter () const override
 
bool IsColdMatterSpecies () const override
 
bool HasWarmMatter () const override
 
double NonClusteringOmega0 () const override
 
double ColdMatterRho (const double *pvecback) const override
 
double ColdMatterOmega0 () const override
 
void FinalizeMatterClassification () override
 
- Public Member Functions inherited from BaseSpecies
virtual std::optional< double > GetParam (const std::string &) const
 
virtual bool IsFreestreaming () const
 
bool IsPresent () const
 
int bg_rho_index () const
 
virtual void ProcessBackgroundTable (const double *, int, int, const double *)
 
virtual void PerturbVectorDerivs (const PerturbLayout &, double, const double *, double *, const perturb_parameters_and_workspace &) const
 
virtual void PerturbTensorDerivs (const PerturbLayout &, double, const double *, double *, const perturb_parameters_and_workspace &) const
 
virtual void ApplyTensorInitialConditions (const PerturbLayout &, double *, double, const double *) const
 
virtual void WriteTensorOutputColumnTitles (std::string &) const
 
virtual void ContributeTensorGwSource (const PerturbLayout &, double, const double *, perturb_workspace *) const
 
virtual int ApproximationCount () const
 
virtual int ApproximationRegimeAt (int, double, const double *) const
 
int ApproximationRegime (const perturb_workspace *ppw, int which=0) const
 
int ApproximationRegimeBefore (const PerturbSwitchContext &ctx, int which=0) const
 
virtual bool SupportsNewtonianGauge () const
 
virtual bool SupportsIsocurvatureInitialConditions () const
 
virtual double RhoPrimeOverRho (const double *pvecback, double a_prime_over_a) const
 
virtual void MarkUsedInSources (const PerturbLayout &, const perturb_workspace *, int *) const
 
virtual double BackgroundDensityOverH0Sq (double a, double H0) const
 
bool ClustersAsMatterCached () const
 
virtual double SourceSamplingRate (const double *) const
 

Static Public Member Functions

static const NCDMBaseSpecies::PerturbLayout & parent_layout (const BaseSpecies::PerturbLayout &my)
 
static Named Create (std::unique_ptr< DNCDMSpecies > parent, const SpeciesBuildContext &ctx)
 
static double CurlyF (double x)
 
static double PhiLO (double X)
 
static constexpr double AlphaL (int l)
 
static double AlphaLEff (int l, double X)
 
static constexpr double BetaL (int l)
 

Protected Member Functions

double DaughtersInitialRadiationOmega0 (double H0) const override
 
bool HasInverseDecays () const override
 
int n_parent () const
 
double BareFactorNumber (double a) const
 
- Protected Member Functions inherited from BaseSpecies
void ApplyFluidLikeNewtonianShift (double *y, int idx_delta, int idx_theta, const double *pvecback, const PerturbIcContext &ctx) const
 

Detailed Description

DNCDMProxySpecies: a cheap stand-in for the ν_H ↔ ν_l + φ composite (dr_representation = proxy).

WHY. The exact scheme (DNCDMInvSpecies) carries a resolved PSD for BOTH daughters in the perturbations — the overwhelming majority of a run's variables — and applies the linearised collision operator to every one of them at every k. At high Γ with a light parent that is orders of magnitude too slow for parameter estimation. The proxy keeps the physics the CMB actually sees and drops the rest:

BACKGROUND — kept essentially exact. The parent keeps its own q-grid; the two daughters keep PSDs on a COARSE grid, and the shipped DecayTransitionKernel drives all three. Nothing is re-derived, so number conservation, energy conservation and detailed balance still hold on the grid to machine precision — those identities are the kernel's, and are pinned in decay_kernel_test.cpp.

PERTURBATIONS — replaced by a relaxation-time (RTA) closure. The daughters become ONE integrated massless hierarchy each (DarkRadiationSpecies) instead of one hierarchy per momentum bin, and the linearised collision operator becomes two relaxation terms:

ℓ = 0, 1 exchange: each species' contrast relaxes toward the sector's common contrast at the rate the collision is actually reprocessing that species. Exactly conservative in δρ and (ρ+P)θ by construction (the target is the λ-weighted mean), so the Einstein equations never see a source they should not.

ℓ ≥ 2 damping: anisotropic stress and higher moments are damped at Γ_T,ℓ = a Γ⁰ (ρ_H/ρ_sec) [β_ℓ r₃ + α_ℓ r₅], with β_ℓ = ℓ(ℓ+1)/2 − 2 (BetaL), α_ℓ the momentum-integrated ℓ-dependence α_ℓ^eff(X) (dr_rta_alpha, see AlphaForm) and r₃, r₅ set by dr_rta_form.

Under the DEFAULT form the two exponents are not rivals: the γ⁻⁵ piece is what survives AT detailed balance (arXiv:2011.01502 §5, re-derived in arXiv:2203.09075), and the γ⁻³ piece is the Hannestad–Raffelt kinematic rate, which survives only in so far as the sector is OUT of balance — which is why its amplitude carries ε_ne, the background's own departure-from-balance order parameter (net/gross parent loss). arXiv:2203.09075 takes the stronger position that the γ⁻³ rate is not an ab initio result at all, so dr_rta_form = copw drops r₃ and keeps only that paper's γ⁻⁵ term. See RtaForm and TransportRate.

Children order (the child_layouts contract, #358): kParent=0, kFermion=1, kBoson=2 — the same order as DNCDMInvSpecies, so tooling that walks the sector does not have to branch on which representation built it.

Synchronous gauge only, no tensors, no fluid approximation — the same guards as the exact composite, for the same reasons. Calibration and the accuracy-vs-cost ladder: docs/superpowers/specs/2026-08-14-dncdm-proxy-representation.md.

Member Enumeration Documentation

◆ RtaForm

enum class DNCDMProxySpecies::RtaForm
strong

dr_rta_form: which transport rate the ℓ ≥ 2 damping uses.

kPowers is the fitted two-power form Γ_T/Γ = C₃ ε_ne^n₃ γ⁻³ + C₅ γ⁻⁵, with NO shut-off factor. It is a CALIBRATION of this code's own runs over the window they converge on, γ ∈ [2,15]. It was the default until kStructured replaced it.

⚠ It is a calibration, so it carries no statement outside that window. In particular it does NOT vanish as γ → 1: it saturates at C₅ (times the parent's energy fraction), where the physical rate must shut off because inverse decay is kinematically closed. The shut-off that the derivation actually has is 𝓕(X), after the momentum average – kCOPW carries it explicitly and for free. For m_νH = 0.3 eV recombination sits at γ ≈ 2.1, i.e. at the EDGE of the calibrated window, so this is a real boundary and not a remote corner.

kCOPW is the analytic prescription of Chen, Oldengott, Pierobon & Wong (arXiv:2203.09075) — eq. (13) with 𝓕 from eq. (14). A SINGLE γ⁻⁵ term carrying the paper's own (1/12) amplitude: no γ⁻³ piece (that paper argues against one) and no fitted normalisation, so dr_rta_C3 defaults to 0 and dr_rta_C5 to 1 under this form, and dr_rta_n3 is ignored outright.

It is the one form derived from first principles rather than fitted, which is why it is worth being able to run, but it is derived AT detailed balance and does not reproduce the measured γ-dependence inside the converged window; see TransportRate. kStructured (default) is the same two components written in the variable the derivation produces, X = a m_νH/T₀, rather than in powers of the parent's mean Lorentz factor: (1/12)[C₃ε^n₃ X³Φ₂(X) + C₅ X⁵Φ₄(X)]. It recovers γ⁻³ and γ⁻⁵ as X → 0 instead of assuming them, needs no shut-off factor because both Φ's die as e⁻ˣ, and fits the measured rate better than either (rel-rms 0.301 against 0.473). See PhiLO/PhiNLO and TransportRate.

◆ AlphaForm

enum class DNCDMProxySpecies::AlphaForm
strong

Which ℓ-dependence the γ⁻⁵ term carries (dr_rta_alpha).

kQuartic is arXiv:2203.09075 eq. (16), α_ℓ = (3ℓ⁴+2ℓ³−11ℓ²+6ℓ)/32 — the published prescription, and the default under kCOPW only.

kIntegrated (default under kStructured and kPowers) is the same collision integral with the ℓ-expansion NOT taken. α_ℓ is exact as the coefficient of the μ² term at fixed q₁ (checked to six digits for ℓ = 0…10), but the expansion behind it converges only for q₁/(a m_H) ≳ ℓ², and the momentum integral runs over the whole thermal distribution. Doing the integral first gives an ℓ-dependence that grows roughly as ℓ³ rather than ℓ⁴ and depends on X = a m_H/T₀: at X = 0.01 it is 3596 at ℓ = 17 against the published 8041, and at X = 0.1 it is 1207. Both are normalised to α_2 = 1, so C₅ is unaffected. See dncdm_proxy_alpha_eff.h.

⚠ Unlike dr_rta_C3 / dr_rta_n3, this applies to BOTH RtaForms: AlphaFor multiplies the γ⁻⁵ term on the common return path, whichever branch built it. kCOPW out of the box is still exactly the paper (its default IS the paper's quartic), and kCOPW with kIntegrated is deliberate rather than accidental – arguably the more self-consistent pairing, since kCOPW's ℓ = 2 normalisation X⁵𝓕(X) and α^eff's ℓ-ratio then come from the same momentum integral.

Constructor & Destructor Documentation

◆ DNCDMProxySpecies()

DNCDMProxySpecies::DNCDMProxySpecies ( std::unique_ptr< DNCDMSpecies >  parent,
std::unique_ptr< DarkRadiationSpecies >  fermion,
std::unique_ptr< DarkRadiationSpecies >  boson,
std::vector< double >  q_d,
std::vector< double >  dq_d,
DecayTransitionKernel::Config  cfg,
const background *  pba,
const BackgroundModule *  bgm 
)

q_d / dq_d are the shared daughter grid (log trapezoid, half-weight endpoints), built by Create so the kernel can take a view of a buffer this object owns for its whole life.

Member Function Documentation

◆ HasNcdm()

bool DNCDMProxySpecies::HasNcdm ( ) const
inlineoverridevirtual

The parent keeps its momentum-resolved hierarchy; only the daughters collapse.

Reimplemented from BaseSpecies.

◆ parent_layout()

static const NCDMBaseSpecies::PerturbLayout & DNCDMProxySpecies::parent_layout ( const BaseSpecies::PerturbLayout &  my)
inlinestatic

Layout: parent gets the NCDM per-q layout, both daughters the DR layout.

◆ Create()

Named DNCDMProxySpecies::Create ( std::unique_ptr< DNCDMSpecies >  parent,
const SpeciesBuildContext &  ctx 
)
static

Build from a pre-built parent. Called by DNCDM_DR_Species::CreateAll when dr_representation = proxy.

◆ SetBackgroundModule()

void DNCDMProxySpecies::SetBackgroundModule ( const BackgroundModule *  )
overridevirtual

Called by BackgroundModule after construction to provide access to its indices (index_bg_a_, index_bg_H_, etc.) and background state. Species that need it override this; default is no-op.

Reimplemented from CompositeSpecies.

◆ RegisterBackgroundIndices()

void DNCDMProxySpecies::RegisterBackgroundIndices ( int &  index_bg)
overridevirtual

Claim consecutive slots in pvecback. Called once during background_indices(). Implementation must assign index_bg_rho_ (and any other needed indices) and increment index_bg accordingly.

Reimplemented from CompositeSpecies.

◆ RegisterIntegrationIndices()

void DNCDMProxySpecies::RegisterIntegrationIndices ( int &  index_bi)
overridevirtual

Claim slots in the ODE integration vector y. Called during background_indices(). Default: no integrated variables (analytic species do not need this).

Reimplemented from CompositeSpecies.

◆ SetBackgroundInitialConditions()

void DNCDMProxySpecies::SetBackgroundInitialConditions ( const BackgroundICContext &  ctx)
overridevirtual

Set initial conditions for ODE-integrated background variables.

Parameters
ctxBackground initial-condition context (a_ini, rho_rad, and the integration vector to fill).

Reimplemented from CompositeSpecies.

◆ ComputeBackground()

void DNCDMProxySpecies::ComputeBackground ( double  a,
const double *  pvecback_B,
double *  pvecback 
)
overridevirtual

Compute species background quantities at scale factor a. pvecback_B is the current ODE integration vector. Write density (and any other owned quantities) into pvecback.

Reimplemented from CompositeSpecies.

◆ BackgroundDerivs()

void DNCDMProxySpecies::BackgroundDerivs ( double  tau,
const double *  y,
double *  dy,
const double *  pvecback 
)
overridevirtual

Contribute to dy/dtau for species with ODE-integrated background variables. pvecback already contains all evaluated background quantities. Default: nothing (species with analytic rho(a) don't override this).

Reimplemented from CompositeSpecies.

◆ BackgroundDerivsDiagonal()

void DNCDMProxySpecies::BackgroundDerivsDiagonal ( double  tau,
const double *  y,
double *  diag,
const double *  pvecback 
)
overridevirtual

The collision's per-bin self-coupling — the background system's whole stiffness (K/eps -> a*Gamma once the parent is non-relativistic). Reported so the exponential evolver integrates it exactly.

Reimplemented from CompositeSpecies.

◆ WriteBackgroundColumnTitles()

void DNCDMProxySpecies::WriteBackgroundColumnTitles ( BackgroundColumnWriter &  ) const
overridevirtual

Write this species' background column titles into writer. Called by BackgroundModule::background_output_titles(). Default: no-op (species with no background output need not override).

Reimplemented from BaseSpecies.

◆ WriteBackgroundData()

void DNCDMProxySpecies::WriteBackgroundData ( const double *  ,
BackgroundColumnWriter &   
) const
overridevirtual

Write this species' background data values into writer. pvecback is the full background vector at the current time step. Called by BackgroundModule::background_output_data(). Default: no-op.

Reimplemented from BaseSpecies.

◆ AddCouplingDerivs()

void DNCDMProxySpecies::AddCouplingDerivs ( double  tau,
const double *  y,
double *  dy,
const perturb_parameters_and_workspace &  ppaw 
) const
overridevirtual

Override in concrete subclasses to add coupling terms to dy after all children have written their free-streaming contributions. Default: no-op.

Reimplemented from CompositeSpecies.

◆ PerturbDerivsDiagonal()

void DNCDMProxySpecies::PerturbDerivsDiagonal ( const BaseSpecies::PerturbLayout &  base,
double  tau,
const double *  y,
double *  diag,
const perturb_parameters_and_workspace &  ppaw 
) const
overridevirtual

The RTA's Jacobian diagonal, -(nu_i + Gamma_T,l) per state variable. Reported so the exponential evolver can integrate the relaxation exactly rather than resolving it with the step size.

Reimplemented from CompositeSpecies.

◆ PrintVariables()

void DNCDMProxySpecies::PrintVariables ( PerturbColumnWriter &  writer,
const BaseSpecies::PerturbLayout *  base,
double  tau,
const double *  y,
const PerturbationsModule &  mod,
const perturb_workspace *  ppw 
) const
overridevirtual

k_output_values time series: the sector's total anisotropic stress a⁴Π_νφ ≡ a⁴·Σ_{i∈{H,l,φ}} (ρ̄_i+p̄_i)σ_i, plus its per-child decomposition.

Same column names and same construction as DNCDMInvSpecies::PrintVariables, so a proxy run and an exact run are readable by one analysis script — which is the only way the closure can be checked on the quantity it approximates. Composite-owned for the same reason: the children carry no valid collection_index_, so their layouts are reached through THIS composite's nested layout.

Reimplemented from CompositeSpecies.

◆ TransportRate() [1/2]

double DNCDMProxySpecies::TransportRate ( int  l,
const double *  pvecback 
) const

The transport rate Γ_T,ℓ (conformal, 1/Mpc) at the current background row.

◆ bg_rho_sec_index()

int DNCDMProxySpecies::bg_rho_sec_index ( ) const
inline

Where the two derived quantities TransportRate depends on sit in pvecback: the sector's total energy density and the departure-from-balance parameter.

◆ kernel_config()

const DecayTransitionKernel::Config & DNCDMProxySpecies::kernel_config ( ) const
inline

The background kernel's configuration, for asserting the input-layer defaults (balanced_gather, lumped_loss) in the unit test.

◆ TransportRate() [2/2]

double DNCDMProxySpecies::TransportRate ( int  l,
double  a,
const double *  pvecback 
) const

Same, with the scale factor passed in rather than read out of pvecback through the BackgroundModule. That indirection is the only thing in this function that needs a live module, so splitting it here is what lets the unit test check the rate against arXiv:2203.09075 eq. (13) on a hand-filled background row.

◆ CurlyF()

double DNCDMProxySpecies::CurlyF ( double  x)
static

𝓕(x) of arXiv:2203.09075 eq. (14) — ½e⁻ˣ[−1 + x − eˣ(x²−2)Γ(0,x)] — via that paper's own two-branch approximation, which avoids the incomplete gamma function. Past x ~ 40 the parent is so non-relativistic that inverse decays are shut and the whole term is irrelevant.

𝓕 ~ −ln x as x → 0, which is physical and must not be floored: the rate carries x⁵𝓕(x), so the product still vanishes. Public for the unit test, which holds both branches to the paper's error bars against an independent Γ(0,x).

◆ PhiLO()

double DNCDMProxySpecies::PhiLO ( double  X)
static

The two shape functions of kStructured, in closed form via Γ(0,X): Φ₂(X) = (1+X)e⁻ˣ − X²Γ(0,X) and Φ₄(X) = ½e⁻ˣ(X−1) + (1−X²/2)Γ(0,X). Φ₄ is 𝓕 evaluated exactly rather than through the paper's two-branch approximation, which CurlyF keeps because kCOPW's job is to be the paper as published. Φ₂(0) = 1; Φ₄ ~ ln(1/X). Public for the unit test.

The two shape functions of the structured form. Both are the SAME momentum integral one order apart –

Phi_n(X) = ∫₀^∞ du u³ e^(-√(u²+X²)) / (u²+X²)^(n/2),

which is what Barenboim et al.'s ∫dq₁ q₁³ e^(-ε₁/T₀) (am/ε₁)^n reduces to with u = q₁/T₀ and X = a m_νH/T₀. Substituting ε = √(u²+X²) turns each into a closed form, so neither needs quadrature:

Φ₂(X) = (1+X)e^(-X) − X² Γ(0,X)                    [LO,  Hannestad-Raffelt]
Φ₄(X) = ½e^(-X)(X−1) + (1 − X²/2) Γ(0,X)           [NLO, = 𝓕 of eq. (14)]

Verified against direct quadrature to 8 digits, and Φ₄ against eq. (14) to 8. Φ₂(0) = 1 and Φ₄ ~ ln(1/X), so X³Φ₂ → X³ ∝ γ⁻³ and X⁵Φ₄ → γ⁻⁵ ln(1/X) as X → 0: the two published asymptotes, recovered rather than assumed. Both carry e^(-√(u²+X²)) ≤ e^(-X), so BOTH shut off once the parent is non-relativistic – which is the entire reason this form exists.

◆ AlphaL()

static constexpr double DNCDMProxySpecies::AlphaL ( int  l)
inlinestaticconstexpr

α_ℓ of arXiv:2203.09075 eq. (16), the ℓ-dependence of the γ⁻⁵ term. α_0 = α_1 = 0 (the ℓ ≤ 1 collision integrals vanish identically by energy/momentum conservation), α_2 = 1, and it grows as ℓ⁴ — small angular scales are wiped out fastest at a fixed decay opening angle.

◆ AlphaLEff()

double DNCDMProxySpecies::AlphaLEff ( int  l,
double  X 
)
static

α_ℓ with the momentum integral done before the ℓ-expansion, tabulated against X = a m_H/T₀ and linearly interpolated in log X. Normalised to α_2 = 1, and clamped to the table's ends (below X = 10⁻⁶ it is flat to a per cent; above the top the rate carries X⁵𝓕(X), which has already died). Falls back to AlphaL outside the tabulated ℓ range.

◆ BetaL()

static constexpr double DNCDMProxySpecies::BetaL ( int  l)
inlinestaticconstexpr

β_ℓ = ℓ(ℓ+1)/2 − 2, the ℓ-dependence of the γ⁻³ term (proxynote eq. beta).

The O(μ) coefficient of the collision integral is ℓ(ℓ+1)/2 − 2 for the ν_H leg and IDENTICALLY the same for the ν_l/φ leg — which is why they cancel at balance — so the leakage inherits it. Unlike α_ℓ it is q₁-INDEPENDENT (checked over q₁ = 0.3…30), so the momentum integral leaves it alone and there is no X-dependent β^eff. It is 1 at ℓ = 2, so C₃ keeps its calibrated meaning.

Measured against the exact solve in the s₃ > 0.5 corner it is right at ℓ = 3 (ratio 1.00) and increasingly too steep above, turning over near ℓ = 8 — the pattern α_ℓ shows too, and here the momentum integral cannot explain it.

It is not selectable. The former alternative, ℓ(ℓ+1)/6, had no derivation (it is not in arXiv:2203.09075, which has no β_ℓ at all) and is 2x low at ℓ = 3.

◆ AlphaFor()

double DNCDMProxySpecies::AlphaFor ( int  l,
double  X 
) const
inline

The ℓ-dependence actually in force, honouring dr_rta_alpha.

◆ KappaStoredToBare()

double DNCDMProxySpecies::KappaStoredToBare ( ) const
inline

Stored -> bare occupation for the parent leg (#385): the kernel's band factor and (1±f) coefficients need bare per-dof occupation, the parent's slot holds deg_H-suppressed stored occupation. g_H = 2 is the parent's spin dof. Reads GetDeg() LIVE — shooting updates it between iterations.

◆ BareFactor()

double DNCDMProxySpecies::BareFactor ( ) const
inline

Density normalisation for a BARE-occupation grid moment: rho = BareFactor()

  • a^-4 * sum dq q^2 eps f. Equals DrPsdSpecies' g = 2 fermion factor by construction; the boson takes half of it (the kernel folds the g_H·g_l/g_phi = 2 ratio into its phi deposit, so the same f_phi with half the factor is the physical energy density).

◆ DaughterNumber()

double DNCDMProxySpecies::DaughterNumber ( const double *  f,
bool  boson 
) const

Comoving number of a daughter, in the kernel's bare grid units (no factor): sum dq q^2 f, halved for the boson.

BARE PER-DOF, and deliberately NOT weighted by n_daughter, unlike DaughterRho: its only use is as the denominator of the per-dof exchange rate nu_l, whose numerator is also per-dof. The published number COLUMN applies the weight at the point of publication instead.

◆ DaughterRho()

double DNCDMProxySpecies::DaughterRho ( const double *  f,
double  a,
bool  boson 
) const

Physical energy density of a daughter from its PSD, INCLUDING the species weight (n_daughter for the fermion, 1 for the boson – phi is always one species).

◆ DaughtersInitialRadiationOmega0()

double DNCDMProxySpecies::DaughtersInitialRadiationOmega0 ( double  H0) const
overrideprotectedvirtual

The daughters' initial populations as free radiation today, a^4 rho / H0^2. 0 when they start empty.

Implements DNCDMSector.

◆ HasInverseDecays()

bool DNCDMProxySpecies::HasInverseDecays ( ) const
inlineoverrideprotectedvirtual

The proxy is an inverse-decay sector by construction (Create refuses inverse_decays = no).

Implements DNCDMSector.

◆ n_parent()

int DNCDMProxySpecies::n_parent ( ) const
inlineprotected

Channel multiplicity: how many parent / daughter mass eigenstates the sector carries. See DecayTransitionKernel::Config::n_parent for the counting, and the design note for why the parent's is tied to deg.

◆ BareFactorNumber()

double DNCDMProxySpecies::BareFactorNumber ( double  a) const
protected

n = BareFactorNumber(a) * sum dq q^2 f: divides a published number column back into the bare grid moment the gross rate is expressed in.


The documentation for this class was generated from the following files: