CLASSpp Manual
Cosmology reference and developer manual
Loading...
Searching...
No Matches
dr_psd_species.h
1#pragma once
2#include <algorithm>
3#include <memory>
4#include <string>
5#include <string_view>
6#include <vector>
7
8#include "../species/ncdm_base_species.h"
9#include "../species/species_build_context.h"
10#include "background.h"
11#include "decay_transition_kernel.h" // Statistics
12
13class BackgroundModule;
14
55 public:
56 static constexpr std::string_view kTypeName = "dr_psd";
57 static constexpr double kFFloor = 1e-100; // positivity floor on f (gains dominate at low q)
58
70 const std::string& instance_name,
71 const NcdmSettings& settings,
72 const background* pba,
73 const BackgroundModule* bgm,
74 Statistics stat,
75 double kinematic_q_max = 0.);
76
81 static constexpr double kQMaxMargin = 1.05;
82
83 static std::vector<Named> CreateAll(const SpeciesBuildContext& ctx); // standalone dr_psd
84
85 // ── Index / grid accessors for the composite (Phase 3/4) ───────────────────
86 Statistics statistics() const {
87 return stat_;
88 }
107 int bg_index(int iq) const {
108 return (q_sampling_ == QSampling::Linear) ? (iq + 1) * refine_ - 1 : iq * refine_;
109 }
110
111 int bi_f_index() const {
112 return index_bi_f_;
113 }
114 int bg_f_index() const {
115 return index_bg_f_;
116 }
117 int bg_dfdlnq_index() const {
118 return index_bg_dfdlnq_;
119 }
120 const std::vector<double>& q_bg() const {
121 return q_bg_;
122 }
123 const std::vector<double>& dq_bg() const {
124 return dq_bg_;
125 }
126 const std::vector<double>& dq() const {
127 return dq_;
128 }
131 int refine() const {
132 return refine_;
133 }
134
140 void PinTemperature(double T);
141
152 void SetSpeciesMultiplicity(int n);
153
154 // ── Background ─────────────────────────────────────────────────────────────
155 void RegisterBackgroundIndices(int& index_bg) override;
156 void RegisterIntegrationIndices(int& index_bi) override;
157 void SetBackgroundInitialConditions(const BackgroundICContext& ctx) override;
158 void ComputeBackground(double a, const double* pvecback_B, double* pvecback) override;
159
162 double InitialRadiationOmega0(double H0) const;
163
164 double Rho(const double* pvecback) const override {
165 return pvecback[index_bg_rho_];
166 }
167 double P(const double* pvecback) const override {
168 return pvecback[index_bg_p_];
169 }
175 double Number(const double* pvecback) const {
176 return pvecback[index_bg_number_];
177 }
178 double PPrime(double a,
179 double H,
180 const double* pvecback_B,
181 const double* pvecback) const override {
182 return a * H * (pvecback[index_bg_pseudo_p_] - 5. * pvecback[index_bg_p_]);
183 }
184
186 void WriteBackgroundData(const double* pvecback, BackgroundColumnWriter& w) const override;
187
188 // ── Decay-product neutrality overrides (mirror wdm_decay_product.h:148-167) ──
189 // The daughter's sector density is owned by the composite; standalone it is a
190 // massless, always-relativistic free-streaming bath.
191 double GetOmega0() const override {
192 return 0.;
193 }
194 double NeutrinoOmega0() const override {
195 return 0.;
196 }
197 double NeffContribution(double /*z*/) const override {
198 return 0.;
199 }
200 bool IsFreestreaming() const override {
201 return true;
202 }
203 double BackgroundAIni(double a_proposed, double /*tol*/) const override {
204 return a_proposed; // massless: always relativistic, no early-start constraint
205 }
206 double DeviationFromRadiation(const double* /*pvecback*/) const override {
207 return 0.;
208 }
209
210 // ── Reduced-moment perturbation representation (dr_reduced_moments) ─────────
234 void SetReducedBasis(int n_moments,
235 const std::vector<double>& psi,
236 const std::vector<double>& gnorm,
237 double q_ref,
238 double alpha0);
239 int reduced_moments() const {
240 return reduced_moments_;
241 }
242 bool reduced() const {
243 return reduced_moments_ > 0;
244 }
250 const double* y,
251 int l) const {
252 if (reduced_moments_ < 2 || l > layout.l_max) {
253 return 0.;
254 }
255 const double m0 = y[layout.index_per_q[0] + l];
256 const double m1 = y[layout.index_per_q[1] + l];
257 return red_q_ref_ * (m1 + red_alpha0_ * m0);
258 }
260 void ReducedProject(const double* fq, double* m) const;
262 void ReducedDriver(const double* pvecback, double* D) const;
266 static constexpr int kMaxReducedMoments = 12;
267
268 // ── Perturbations ──────────────────────────────────────────────────────────
269 void RegisterPerturbationIndices(BaseSpecies::PerturbLayout& base,
270 perturb_vector* pv,
271 const precision* ppr,
272 int& index_pt,
273 const perturb_workspace* ppw,
274 int gauge) override;
276 double tau,
277 const double* y,
278 double* dy,
279 const perturb_parameters_and_workspace& ppaw) const override;
281 double* y,
282 const PerturbIcContext& ctx) override;
284 const perturb_vector* pv,
285 const double* y,
286 const double* pvecback,
287 const perturb_workspace* ppw) const override;
289 const double* y,
290 const double* dy,
291 PerturbSourceContext& ctx) const override;
293 PerturbColumnWriter& writer,
294 const PerturbationsModule& mod,
295 file_format fmt,
296 TransferColumnSection section = TransferColumnSection::all) const override;
297
301 perturb_vector* /*pv*/,
302 const precision* /*ppr*/,
303 int& /*index_pt*/,
304 const perturb_workspace* /*ppw*/,
305 int /*gauge*/) override {}
308 double* /*y*/,
309 const PerturbIcContext& /*ctx*/) override {}
310
317 std::string ColumnLabel() const {
318 return name() + (stat_ == Statistics::Fermion ? "_l" : "_phi");
319 }
320
321 protected:
326 double GetDlnf0Dlnq(int iq, const double* pvecback) const override {
327 const int ibg = bg_index(iq); // PT loop index -> BG column (exact subsample)
328 return pvecback[index_bg_dfdlnq_ + ibg] / std::max(pvecback[index_bg_f_ + ibg], kFFloor);
329 }
330
331 private:
334 static Statistics ParseStatistics(FileContent* pfc, const std::string& instance_name);
335
340 static double PerSpeciesDeg(Statistics stat) {
341 return (stat == Statistics::Fermion ? 2.0 : 1.0) / pow(2 * _PI_, 3);
342 }
343
346 void BuildLogTrapezoidGrids();
347
364 void BuildLinearTrapezoidGrids();
365
369 double ThermalF0(double q) const;
370
371 // Frozen reduced-moment basis; empty unless SetReducedBasis was called. See the
372 // public block above for why it is frozen and what the coordinates mean.
373 int reduced_moments_ = 0;
374 std::vector<double> red_psi_; // reduced_moments_ * q_size, row-major in the moment
375 std::vector<double> red_gnorm_; // diagonal Gram
376 double red_q_ref_ = 1.;
377 double red_alpha0_ = 0.;
378
379 const background* pba_ = nullptr;
380 Statistics stat_ = Statistics::Fermion;
386 double f_ini_ = 0.;
387
391 enum class QSampling { Log, Linear };
392 QSampling q_sampling_ = QSampling::Log;
393
394 // Log-trapezoid grid parameters. Only the BACKGROUND grid has free endpoints;
395 // the perturbation grid inherits them exactly (q_[0]=q_bg_[0], q_.back()=q_bg_
396 // .back()) and differs only in step: h_pt = refine_·h_bg.
397 // (Linear sampling ignores q_min_bg_ — see BuildLinearTrapezoidGrids.)
398 double q_min_bg_ = 1e-3, q_max_bg_ = 1e2;
399 int N_q_bg_ = 100;
400 int refine_ = 1; // dr_bg_refine: N_bg−1 = refine_·(N_pt−1); 1 = one grid
401 int N_q_ = 100; // derived in BuildLogTrapezoidGrids, never read from input
402
403 std::vector<double> dq_; // pt-grid cell widths (half-weight endpoints, step h_pt)
404 std::vector<double> dq_bg_; // bg-grid cell widths
405
406 int index_bg_number_ = -1;
407 int index_bg_pseudo_p_ = -1;
408 int index_bg_f_ = -1;
409 int index_bg_dfdlnq_ = -1;
410 int index_bi_f_ = -1;
411 // Running severity of the negative occupations ComputeBackground sees on STORED
412 // rows, i.e. before kFFloor hides them; they drive the one-per-decade warning
413 // there and nothing else. Mutable because ComputeBackground is logically const on
414 // the species; same pattern and same reasoning as DNCDMSpecies' negative_f_rows_.
415 mutable double worst_negative_rel_ = 0.; // |f|/peak of the worst excursion
416 mutable double announced_negative_rel_ = 0.;
417
418 public:
419};
Definition base_species.h:33
Definition dr_psd_species.h:54
double ReducedEnergyAtL(const NCDMBaseSpecies::PerturbLayout &layout, const double *y, int l) const
Definition dr_psd_species.h:249
bool IsFreestreaming() const override
Definition dr_psd_species.h:200
double GetDlnf0Dlnq(int iq, const double *pvecback) const override
Definition dr_psd_species.h:326
double GetOmega0() const override
Definition dr_psd_species.h:191
void ApplyInitialConditions(const BaseSpecies::PerturbLayout &base, double *y, const PerturbIcContext &ctx) override
Definition dr_psd_species.cpp:605
double P(const double *pvecback) const override
Definition dr_psd_species.h:167
double NeutrinoOmega0() const override
Definition dr_psd_species.h:194
void ReducedDriver(const double *pvecback, double *D) const
Definition dr_psd_species.cpp:480
void SetReducedBasis(int n_moments, const std::vector< double > &psi, const std::vector< double > &gnorm, double q_ref, double alpha0)
Definition dr_psd_species.cpp:468
double DeviationFromRadiation(const double *) const override
Definition dr_psd_species.h:206
void WriteOutputColumns(PerturbColumnWriter &writer, const PerturbationsModule &mod, file_format fmt, TransferColumnSection section=TransferColumnSection::all) const override
Definition dr_psd_species.cpp:785
void WriteBackgroundColumnTitles(BackgroundColumnWriter &w) const override
Definition dr_psd_species.cpp:428
double PPrime(double a, double H, const double *pvecback_B, const double *pvecback) const override
Definition dr_psd_species.h:178
double InitialRadiationOmega0(double H0) const
Definition dr_psd_species.cpp:330
void PinTemperature(double T)
Definition dr_psd_species.cpp:167
void ReducedProject(const double *fq, double *m) const
Definition dr_psd_species.cpp:496
StressEnergyContribution StressEnergy(const BaseSpecies::PerturbLayout &base, const perturb_vector *pv, const double *y, const double *pvecback, const perturb_workspace *ppw) const override
Definition dr_psd_species.cpp:664
void SetSpeciesMultiplicity(int n)
Definition dr_psd_species.cpp:172
void RegisterTensorPerturbationIndices(BaseSpecies::PerturbLayout &, perturb_vector *, const precision *, int &, const perturb_workspace *, int) override
Definition dr_psd_species.h:300
std::string ColumnLabel() const
Definition dr_psd_species.h:317
int bg_index(int iq) const
Definition dr_psd_species.h:107
int refine() const
Definition dr_psd_species.h:131
void ComputeBackground(double a, const double *pvecback_B, double *pvecback) override
Definition dr_psd_species.cpp:343
static constexpr double kQMaxMargin
Definition dr_psd_species.h:81
void SetBackgroundInitialConditions(const BackgroundICContext &ctx) override
Definition dr_psd_species.cpp:316
double NeffContribution(double) const override
Definition dr_psd_species.h:197
double BackgroundAIni(double a_proposed, double) const override
Definition dr_psd_species.h:203
static constexpr int kMaxReducedMoments
Definition dr_psd_species.h:266
double Rho(const double *pvecback) const override
Definition dr_psd_species.h:164
void RegisterBackgroundIndices(int &index_bg) override
Definition dr_psd_species.cpp:300
void PerturbDerivs(const BaseSpecies::PerturbLayout &base, double tau, const double *y, double *dy, const perturb_parameters_and_workspace &ppaw) const override
Definition dr_psd_species.cpp:533
void PerturbSynchronousToNewtonian(const BaseSpecies::PerturbLayout &, double *, const PerturbIcContext &) override
Definition dr_psd_species.h:307
double Number(const double *pvecback) const
Definition dr_psd_species.h:175
void FillSources(const BaseSpecies::PerturbLayout &base, const double *y, const double *dy, PerturbSourceContext &ctx) const override
Definition dr_psd_species.cpp:724
void RegisterIntegrationIndices(int &index_bi) override
Definition dr_psd_species.cpp:311
void WriteBackgroundData(const double *pvecback, BackgroundColumnWriter &w) const override
Definition dr_psd_species.cpp:438
Definition parser.h:23
Definition ncdm_base_species.h:43
Definition perturb_source_context.h:63
#define _PI_
Definition constants.h:7
Definition perturbations.h:253
Definition perturbations.h:347
file_format
Definition precision.h:56
Definition background_ic_context.h:11
Definition base_species.h:106
Definition base_species.h:421
Definition ncdm_base_species.h:72
Definition perturb_source_context.h:125
Definition perturb_source_context.h:103
Definition species_build_context.h:58
Definition perturbations_module.h:380
Definition precision.h:79