| Geant4 Cross Reference |
1 //
2 // ********************************************************************
3 // * License and Disclaimer *
4 // * *
5 // * The Geant4 software is copyright of the Copyright Holders of *
6 // * the Geant4 Collaboration. It is provided under the terms and *
7 // * conditions of the Geant4 Software License, included in the file *
8 // * LICENSE and available at http://cern.ch/geant4/license . These *
9 // * include a list of copyright holders. *
10 // * *
11 // * Neither the authors of this software system, nor their employing *
12 // * institutes,nor the agencies providing financial support for this *
13 // * work make any representation or warranty, express or implied, *
14 // * regarding this software system or assume any liability for its *
15 // * use. Please see the license in the file LICENSE and URL above *
16 // * for the full disclaimer and the limitation of liability. *
17 // * *
18 // * This code implementation is the result of the scientific and *
19 // * technical work of the GEANT4 collaboration. *
20 // * By using, copying, modifying or distributing the software (or *
21 // * any work based on the software) you agree to acknowledge its *
22 // * use in resulting scientific publications, and indicate your *
23 // * acceptance of all terms of the Geant4 Software license. *
24 // ********************************************************************
25 //
26 // ABLAXX statistical de-excitation model
27 // Jose Luis Rodriguez, UDC (translation from ABLA07 and contact person)
28 // Pekka Kaitaniemi, HIP (initial translation of ablav3p)
29 // Aleksandra Kelic, GSI (ABLA07 code)
30 // Davide Mancusi, CEA (contact person INCL)
31 // Aatos Heikkinen, HIP (project coordination)
32 //
33
34 #pragma once
35
36 #include "globals.hh"
37 #include <memory>
38
39 #include "G4AblaDataDefs.hh"
40 #include "G4AblaRandom.hh"
41
42 /**
43 * Class containing ABLA++ de-excitation code.
44 */
45
46 class G4Abla {
47
48 public:
49 /**
50 * This constructor is used by standalone test driver and the Geant4
51 * interface.
52 *
53 * @param aHazard random seeds
54 * @param aVolant data structure for ABLA output
55 * @param aVarNtp data structure for transfering ABLA output to Geant4
56 * interface
57 */
58 G4Abla(G4VarNtp *aVarntp);
59
60 /**
61 * Basic destructor.
62 */
63 ~G4Abla() = default;
64
65 /// \brief Dummy copy constructor
66 G4Abla(G4Abla const &other);
67
68 /// \brief Dummy assignment operator
69 G4Abla &operator=(G4Abla const &other);
70
71 /**
72 * Set verbosity level.
73 */
74 void setVerboseLevel(G4int level);
75
76 /**
77 * Main interface to the de-excitation code.
78 *
79 * @param nucleusA mass number of the nucleus
80 * @param nucleusZ charge number of the nucleus
81 * @param excitationEnergy excitation energy of the nucleus
82 * @param angularMomentum angular momentum of the nucleus (produced as output
83 * by INCL4)
84 * @param momX momentum x-component
85 * @param momY momentum y-component
86 * @param momZ momentum z-component
87 * @param eventnumber number of the event
88 */
89 void DeexcitationAblaxx(G4int nucleusA, G4int nucleusZ,
90 G4double excitationEnergy, G4double angularMomentum,
91 G4double momX, G4double momY, G4double momZ,
92 G4int eventnumber);
93
94 /**
95 * Main interface to the de-excitation code for hyper-nuclei.
96 *
97 * @param nucleusA mass number of the nucleus
98 * @param nucleusZ charge number of the nucleus
99 * @param excitationEnergy excitation energy of the nucleus
100 * @param angularMomentum angular momentum of the nucleus (produced as output
101 * by INCL)
102 * @param momX momentum x-component
103 * @param momY momentum y-component
104 * @param momZ momentum z-component
105 * @param eventnumber number of the event
106 * @param nucleusS is the strange number
107 */
108 void DeexcitationAblaxx(G4int nucleusA, G4int nucleusZ,
109 G4double excitationEnergy, G4double angularMomentum,
110 G4double momX, G4double momY, G4double momZ,
111 G4int eventnumber, G4int nucleusS);
112
113 // Evaporation
114 public:
115 /**
116 * Initialize ABLA evaporation code.
117 *
118 */
119 void initEvapora();
120
121 /**
122 * Initialize ABLA parameters.
123 *
124 */
125 void SetParameters();
126 void SetParametersG4(G4int z, G4int a);
127
128 /**
129 * Coefficient of collective enhancement including damping
130 * Input: z,a,bet,sig,u
131 * Output: qr - collective enhancement factor
132 * See junghans et al., nucl. phys. a 629 (1998) 635
133 * @param z charge number
134 * @param a mass number
135 * @param bet beta deformation
136 * @param sig perpendicular spin cut-off factor
137 * @param u Energy
138 * @return Coefficient of collective enhancement
139 */
140 void qrot(G4double z, G4double a, G4double bet, G4double sig, G4double u,
141 G4double *qr);
142
143 /**
144 * Model de la goutte liquide de c. f. weizsacker.
145 * usually an obsolete option
146 */
147 void mglw(G4double a, G4double z, G4double *el);
148
149 /**
150 * Mglms
151 */
152 void mglms(G4double a, G4double z, G4int refopt4, G4double *el);
153
154 /**
155 *
156 */
157 G4double spdef(G4int a, G4int z, G4int optxfis);
158
159 /**
160 * Calculation of fissility parameter
161 */
162 G4double fissility(G4int a, G4int z, G4int ny, G4double sn, G4double slam,
163 G4int optxfis);
164
165 /**
166 * Main evaporation routine.
167 */
168 void evapora(G4double zprf, G4double aprf, G4double *ee_par, G4double jprf,
169 G4double *zf_par, G4double *af_par, G4double *mtota_par,
170 G4double *vleva_par, G4double *vxeva_par, G4double *vyeva_par,
171 G4int *ff_par, G4int *fimf_par, G4double *fzimf, G4double *faimf,
172 G4double *tkeimf_par, G4double *jprfout, G4int *inttype_par,
173 G4int *inum_par, G4double EV_TEMP[indexpart][6],
174 G4int *iev_tab_temp_par, G4int *nblam0);
175
176 /**
177 * Calculation of particle emission probabilities.
178 */
179 void direct(G4double zprf, G4double a, G4double ee, G4double jprf,
180 G4double *probp_par, G4double *probd_par, G4double *probt_par,
181 G4double *probn_par, G4double *probhe_par, G4double *proba_par,
182 G4double *probg_par, G4double *probimf_par, G4double *probf_par,
183 G4double *problamb0_par, G4double *ptotl_par, G4double *sn_par,
184 G4double *sbp_par, G4double *sbd_par, G4double *sbt_par,
185 G4double *sbhe_par, G4double *sba_par, G4double *slamb0_par,
186 G4double *ecn_par, G4double *ecp_par, G4double *ecd_par,
187 G4double *ect_par, G4double *eche_par, G4double *eca_par,
188 G4double *ecg_par, G4double *eclamb0_par, G4double *bp_par,
189 G4double *bd_par, G4double *bt_par, G4double *bhe_par,
190 G4double *ba_par, G4double *sp_par, G4double *sd_par,
191 G4double *st_par, G4double *she_par, G4double *sa_par,
192 G4double *ef_par, G4double *ts1_par, G4int, G4int inum,
193 G4int itest, G4int *sortie, G4double *tcn, G4double *jprfn_par,
194 G4double *jprfp_par, G4double *jprfd_par, G4double *jprft_par,
195 G4double *jprfhe_par, G4double *jprfa_par,
196 G4double *jprflamb0_par, G4double *tsum_par, G4int NbLam0);
197
198 /**
199 * Calculation of fission and the particle emission probabilities after
200 * fission.
201 */
202 void fission(G4double AF, G4double ZF, G4double EE, G4double JPRF,
203 G4double *VX1_FISSION, G4double *VY1_FISSION,
204 G4double *VZ1_FISSION, G4double *VX2_FISSION,
205 G4double *VY2_FISSION, G4double *VZ2_FISSION, G4int *ZFP1,
206 G4int *AFP1, G4int *SFP1, G4int *ZFP2, G4int *AFP2, G4int *SFP2,
207 G4int *imode, G4double *VX_EVA_SC, G4double *VY_EVA_SC,
208 G4double *VZ_EVA_SC, G4double EV_TEMP[indexpart][6],
209 G4int *IEV_TAB_FIS, G4int *NbLam0);
210
211 /**
212 * Calculation of lorentz's boost
213 */
214 void lorentz_boost(G4double VXRIN, G4double VYRIN, G4double VZRIN,
215 G4double VXIN, G4double VYIN, G4double VZIN,
216 G4double *VXOUT, G4double *VYOUT, G4double *VZOUT);
217
218 /**
219 * Calculation of unstable nuclei
220 */
221 void unstable_nuclei(G4int AFP, G4int ZFP, G4int *AFPNEW, G4int *ZFPNEW,
222 G4int &IOUNSTABLE, G4double VX, G4double VY, G4double VZ,
223 G4double *VP1X, G4double *VP1Y, G4double *VP1Z,
224 G4double BU_TAB_TEMP[indexpart][6], G4int *ILOOP);
225
226 /**
227 * Calculation of unstable nuclei tke
228 */
229 void unstable_tke(G4double AIN, G4double ZIN, G4double ANEW, G4double ZNEW,
230 G4double VXIN, G4double VYIN, G4double VZIN, G4double *V1X,
231 G4double *V1Y, G4double *V1Z, G4double *V2X, G4double *V2Y,
232 G4double *V2Z);
233
234 /**
235 * Calculation of tke for breakup fragments
236 */
237 void tke_bu(G4double Z, G4double A, G4double ZALL, G4double AAL, G4double *VX,
238 G4double *VY, G4double *VZ);
239
240 /**
241 * Calculation of the angular momentum of breakup fragments
242 * according to Goldhaber model
243 */
244 void AMOMENT(G4double AABRA, G4double APRF, G4int IMULTIFR, G4double *PX,
245 G4double *PY, G4double *PZ);
246
247 /**
248 * Calculation of particle emission barriers.
249 */
250 void barrs(G4int Z1, G4int A1, G4int Z2, G4int A2, G4double *sBARR,
251 G4double *sOMEGA);
252
253 /**
254 * Calculation of particle emission between the saddle and scission point.
255 */
256 void evap_postsaddle(G4double A, G4double Z, G4double E_scission_pre,
257 G4double *E_scission_post, G4double *A_scission,
258 G4double *Z_scission, G4double &vx_eva, G4double &vy_eva,
259 G4double &vz_eva, G4int *NbLam0_par);
260
261 /**
262 * Calculation of imfs.
263 */
264 void imf(G4double ACN, G4double ZCN, G4double TEMP, G4double EE,
265 G4double *ZIMF, G4double *AIMF, G4double *BIMF, G4double *SBIMF,
266 G4double *TIMF, G4double JPRF);
267
268 /**
269 * Calculation of omega at saddle point.
270 */
271 void fomega_sp(G4double AF, G4double Y, G4double *MFCD, G4double *sOMEGA,
272 G4double *sHOMEGA);
273
274 /**
275 * Calculation of omega at ground state.
276 */
277 void fomega_gs(G4double AF, G4double ZF, G4double *K1, G4double *sOMEGA,
278 G4double *sHOMEGA);
279
280 /**
281 * Calculation of tunnelling effect in fission.
282 */
283 G4double tunnelling(G4double A, G4double ZPRF, G4double Y, G4double EE,
284 G4double EF, G4double TEMP, G4double DENSG,
285 G4double DENSF, G4double ENH_FACT);
286
287 /**
288 * Calculation of fission width at the saddle point according to B&W.
289 */
290 void fission_width(G4double ZPRF, G4double A, G4double EE, G4double BS,
291 G4double BK, G4double EF, G4double Y, G4double *GF,
292 G4double *TEMP, G4double JPR, G4int IEROT,
293 G4int FF_ALLOWED, G4int OPTCOL, G4int OPTSHP,
294 G4double DENSG);
295
296 /**
297 * Calculation of unbound nuclei.
298 */
299 void unbound(G4double SN, G4double SP, G4double SD, G4double ST, G4double SHE,
300 G4double SA, G4double BP, G4double BD, G4double BT, G4double BHE,
301 G4double BA, G4double *PROBF, G4double *PROBN, G4double *PROBP,
302 G4double *PROBD, G4double *PROBT, G4double *PROBHE,
303 G4double *PROBA, G4double *PROBIMF, G4double *PROBG,
304 G4double *ECN, G4double *ECP, G4double *ECD, G4double *ECT,
305 G4double *ECHE, G4double *ECA);
306
307 /**
308 * Calculation of the fission distribution.
309 */
310 void fissionDistri(G4double &a, G4double &z, G4double &e, G4double &a1,
311 G4double &z1, G4double &e1, G4double &v1, G4double &a2,
312 G4double &z2, G4double &e2, G4double &v2,
313 G4double &vx_eva_sc, G4double &vy_eva_sc,
314 G4double &vz_eva_sc, G4int *NbLam0_par);
315
316 /**
317 * Calculation of even-odd effects in fission.
318 */
319 void even_odd(G4double r_origin, G4double r_even_odd, G4int &i_out);
320
321 /**
322 * Functions for the fission model.
323 */
324 G4double umass(G4double z, G4double n, G4double beta);
325 G4double ecoul(G4double z1, G4double n1, G4double beta1, G4double z2,
326 G4double n2, G4double beta2, G4double d);
327 G4double Uwash(G4double E, G4double Ecrit, G4double Freduction,
328 G4double gamma);
329 G4double frldm(G4double z, G4double n, G4double beta);
330 G4double eflmac_profi(G4double a, G4double z);
331 G4double gausshaz(G4int k, G4double xmoy, G4double sig);
332 G4double haz(G4int k);
333
334 /**
335 * Level density parameters.
336 */
337 void densniv(G4double a, G4double z, G4double ee, G4double ef, G4double *dens,
338 G4double bshell, G4double bs, G4double bk, G4double *temp,
339 G4int optshp, G4int optcol, G4double defbet, G4double *ecor,
340 G4double jprf, G4int ifis, G4double *qr);
341
342 /**
343 * Calculation of the fission probability modified by transient time effects.
344 */
345 void part_fiss(G4double BET, G4double GP, G4double GF, G4double Y,
346 G4double TAUF, G4double TS1, G4double TSUM, G4int *CHOICE,
347 G4double ZF, G4double AF, G4double FT, G4double *T_LAPSE,
348 G4double *GF_LOC);
349
350 G4double func_trans(G4double TIME, G4double ZF, G4double AF, G4double BET,
351 G4double Y, G4double FT, G4double T_0);
352
353 /**
354 * This subroutine calculates the ordinary legendre polynomials of
355 * order 0 to n-1 of argument x and stores them in the vector pl.
356 * They are calculated by recursion relation from the first two
357 * polynomials.
358 * Written by A.J.Sierk LANL t-9 February, 1984
359 */
360 void lpoly(G4double x, G4int n, G4double pl[]);
361
362 /**
363 * This function will calculate the liquid-drop nuclear mass for spheri
364 * configuration according to the preprint NUCLEAR GROUND-STATE
365 * MASSES and DEFORMATIONS by P. Mo"ller et al. from August 16, 1993 p.
366 * All constants are taken from this publication for consistency.
367 */
368 G4double eflmac(G4int ia, G4int iz, G4int flag, G4int optshp);
369
370 /**
371 * Procedure for calculating the pairing correction to the binding
372 * energy of a specific nucleus.
373 */
374 void appariem(G4double a, G4double z, G4double *del);
375
376 /**
377 * PROCEDURE FOR CALCULATING THE PARITY OF THE NUMBER N.
378 * RETURNS -1 IF N IS ODD AND +1 IF N IS EVEN
379 */
380 void parite(G4double n, G4double *par);
381
382 /**
383 * RISE TIME IN WHICH THE FISSION WIDTH HAS REACHED
384 * 90 PERCENT OF ITS FINAL VALUE
385 */
386 G4double tau(G4double bet, G4double homega, G4double ef, G4double t);
387
388 /**
389 * KRAMERS FAKTOR - REDUCTION OF THE FISSION PROBABILITY
390 * INDEPENDENT OF EXCITATION ENERGY
391 */
392 G4double cram(G4double bet, G4double homega);
393
394 /**
395 * CALCULATION OF THE SURFACE BS OR CURVATURE BK OF A NUCLEUS
396 * RELATIVE TO THE SPHERICAL CONFIGURATION
397 * BASED ON MYERS, DROPLET MODEL FOR ARBITRARY SHAPES
398 */
399 G4double bipol(G4int iflag, G4double y);
400
401 /**
402 * THIS SUBROUTINE RETURNS THE BARRIER HEIGHT BFIS, THE
403 * GROUND-STATE ENERGY SEGS, IN MEV, AND THE ANGULAR MOMENTUM
404 * AT WHICH THE FISSION BARRIER DISAPPEARS, LMAX, IN UNITS OF
405 * H-BAR, WHEN CALLED WITH INTEGER AGUMENTS IZ, THE ATOMIC
406 * NUMBER, IA, THE ATOMIC MASS NUMBER, AND IL, THE ANGULAR
407 * MOMENTUM IN UNITS OF H-BAR. (PLANCK'S CONSTANT DIVIDED BY
408 * 2*PI).
409 */
410 void barfit(G4int iz, G4int ia, G4int il, G4double *sbfis, G4double *segs,
411 G4double *selmax);
412
413 /**
414 * Calculation of decay widths for light particles.
415 */
416 G4double width(G4double AMOTHER, G4double ZMOTHER, G4double APART,
417 G4double ZPART, G4double TEMP, G4double B1, G4double SB1,
418 G4double EXC);
419
420 /**
421 * Calculation of penetration factors for light charged particles.
422 */
423 G4double pen(G4double A, G4double ap, G4double omega, G4double T);
424
425 /**
426 * Calculation of mean value of orbital angular momentum.
427 */
428 void lorb(G4double AMOTHER, G4double ADAUGHTER, G4double LMOTHER,
429 G4double EEFINAL, G4double *LORBITAL, G4double *SIGMA_LORBITAL);
430
431 /**
432 * Calculation of BS and BK for the nuclear-level density.
433 */
434 void bsbkbc(G4double A, G4double Z, G4double *BS, G4double *BK, G4double *BC);
435
436 /**
437 * Special functions used for the emission of particles.
438 */
439 G4double erf(G4double x);
440
441 G4double gammp(G4double a, G4double x);
442
443 void gcf(G4double *gammcf, G4double a, G4double x, G4double gln);
444
445 void gser(G4double *gamser, G4double a, G4double x, G4double gln);
446
447 G4double fvmaxhaz(G4double T);
448
449 G4double fvmaxhaz_neut(G4double x);
450
451 /**
452 * Random numbers.
453 */
454 void standardRandom(G4double *rndm, G4long *seed);
455
456 /**
457 * LOGARITHM OF THE GAMM FUNCTION
458 */
459 G4double gammln(G4double xx);
460
461 /**
462 * DISTRIBUTION DE MAXWELL
463 */
464 G4double fd(G4double E);
465
466 /**
467 *FONCTION INTEGRALE DE FD(E)
468 */
469 G4double f(G4double E);
470
471 /**
472 * tirage aleatoire dans une maxwellienne
473 */
474 G4double fmaxhaz(G4double T);
475
476 /**
477 * tirage aleatoire dans une maxwellienne
478 */
479 G4double fmaxhaz_old(G4double T);
480
481 /**
482 * Random generator according to the
483 powerfunction y = x**(lambda) in the range from xmin to xmax
484 */
485 G4int IPOWERLIMHAZ(G4double lambda, G4int xmin, G4int xmax);
486
487 /**
488 *
489 */
490 void guet(G4double *x_par, G4double *z_par, G4double *find_par);
491
492 /**
493 * Limits of existing nuclei
494 */
495 void isostab_lim(G4int z, G4int *nmin, G4int *nmax);
496
497 /**
498 * Fill the data array for INCL
499 */
500 void FillData(G4int IMULTBU, G4int IEV_TAB);
501
502 /**
503 * Separation energies of lambda
504 */
505 G4double gethyperseparation(G4double A, G4double Z, G4int ny);
506
507 /**
508 * Separation energies of for other particles for hypernuclei
509 */
510 G4double getdeltabinding(G4double a, G4int nblamb);
511 G4double gethyperbinding(G4double A, G4double Z, G4int ny);
512
513 public:
514 // Utils
515 G4int min(G4int a, G4int b);
516 G4double min(G4double a, G4double b);
517 G4int max(G4int a, G4int b);
518 G4double max(G4double a, G4double b);
519 G4double DSIGN(G4double a, G4double b);
520 G4int ISIGN(G4int a, G4int b);
521 G4int nint(G4double number);
522 G4int secnds(G4int x);
523 G4int mod(G4int a, G4int b);
524 G4double dmod(G4double a, G4double b);
525 G4double dint(G4double a);
526 G4int idint(G4double a);
527 G4int idnint(G4double value);
528 G4double utilabs(G4double a);
529 G4double dmin1(G4double a, G4double b, G4double c);
530
531 private:
532 G4int verboseLevel;
533 G4int ilast;
534 G4double T_freeze_out_in;
535 G4int IEV_TAB_SSC;
536 G4double BU_TAB[indexpart][12], EV_TAB[indexpart][6], EV_TAB_SSC[indexpart][6];
537 G4int gammaemission;
538 G4double T_freeze_out;
539 std::unique_ptr<G4Ald> ald;
540 std::unique_ptr<G4Ec2sub> ec2sub;
541 std::unique_ptr<G4Ecld> ecld;
542 std::unique_ptr<G4Mexp> masses;
543 std::unique_ptr<G4Fb> fb;
544 std::unique_ptr<G4Fiss> fiss;
545 std::unique_ptr<G4Opt> opt;
546 G4VarNtp *varntp;
547 G4int Ainit, Zinit, Sinit;
548 };
549