source: trunk/source/processes/electromagnetic/utils/include/G4VEnergyLossProcess.hh @ 1340

Last change on this file since 1340 was 1340, checked in by garnier, 14 years ago

update ti head
File size: 36.1 KB
Line 
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// $Id: G4VEnergyLossProcess.hh,v 1.93 2010/10/14 16:27:35 vnivanch Exp $
27// GEANT4 tag $Name:
28//
29// -------------------------------------------------------------------
30//
31// GEANT4 Class header file
32//
33//
34// File name:     G4VEnergyLossProcess
35//
36// Author:        Vladimir Ivanchenko on base of Laszlo Urban code
37//
38// Creation date: 03.01.2002
39//
40// Modifications:
41//
42// 26-12-02 Secondary production moved to derived classes (V.Ivanchenko)
43// 20-01-03 Migrade to cut per region (V.Ivanchenko)
44// 24-01-03 Make models region aware (V.Ivanchenko)
45// 05-02-03 Fix compilation warnings (V.Ivanchenko)
46// 13-02-03 SubCutoffProcessors defined for regions (V.Ivanchenko)
47// 17-02-03 Fix problem of store/restore tables (V.Ivanchenko)
48// 26-02-03 Region dependent step limit (V.Ivanchenko)
49// 26-03-03 Add GetDEDXDispersion (V.Ivanchenko)
50// 09-04-03 Fix problem of negative range limit for non integral (V.Ivanchenko)
51// 13-05-03 Add calculation of precise range (V.Ivanchenko)
52// 21-07-03 Add UpdateEmModel method (V.Ivanchenko)
53// 12-11-03 G4EnergyLossSTD -> G4EnergyLossProcess (V.Ivanchenko)
54// 14-01-04 Activate precise range calculation (V.Ivanchenko)
55// 10-03-04 Fix problem of step limit calculation (V.Ivanchenko)
56// 30-06-04 make destructor virtual (V.Ivanchenko)
57// 05-07-04 fix problem of GenericIons seen at small cuts (V.Ivanchenko)
58// 03-08-04 Add DEDX table to all processes for control on integral range(VI)
59// 06-08-04 Clear up names of member functions (V.Ivanchenko)
60// 27-08-04 Add NeedBuildTables method (V.Ivanchneko)
61// 09-09-04 Bug fix for the integral mode with 2 peaks (V.Ivanchneko)
62// 08-11-04 Migration to new interface of Store/Retrieve tables (V.Ivanchenko)
63// 08-04-05 Major optimisation of internal interfaces (V.Ivanchenko)
64// 11-04-05 Use MaxSecondaryEnergy from a model (V.Ivanchenko)
65// 10-01-05 Remove SetStepLimits (V.Ivanchenko)
66// 10-01-06 PreciseRange -> CSDARange (V.Ivantchenko)
67// 13-01-06 Remove AddSubCutSecondaries and cleanup (V.Ivantchenko)
68// 20-01-06 Introduce G4EmTableType and reducing number of methods (VI)
69// 26-01-06 Add public method GetCSDARange (V.Ivanchenko)
70// 22-03-06 Add SetDynamicMassCharge (V.Ivanchenko)
71// 23-03-06 Use isIonisation flag (V.Ivanchenko)
72// 13-05-06 Add method to access model by index (V.Ivanchenko)
73// 14-01-07 add SetEmModel(index) and SetFluctModel() (mma)
74// 15-01-07 Add separate ionisation tables and reorganise get/set methods for
75//          dedx tables (V.Ivanchenko)
76// 13-03-07 use SafetyHelper instead of navigator (V.Ivanchenko)
77// 27-07-07 use stl vector for emModels instead of C-array (V.Ivanchenko)
78// 25-09-07 More accurate handling zero xsect in
79//          PostStepGetPhysicalInteractionLength (V.Ivanchenko)
80// 27-10-07 Virtual functions moved to source (V.Ivanchenko)
81// 15-07-08 Reorder class members for further multi-thread development (VI)
82//
83// Class Description:
84//
85// It is the unified energy loss process it calculates the continuous
86// energy loss for charged particles using a set of Energy Loss
87// models valid for different energy regions. There are a possibility
88// to create and access to dE/dx and range tables, or to calculate
89// that information on fly.
90
91// -------------------------------------------------------------------
92//
93
94#ifndef G4VEnergyLossProcess_h
95#define G4VEnergyLossProcess_h 1
96
97#include "G4VContinuousDiscreteProcess.hh"
98#include "globals.hh"
99#include "G4Material.hh"
100#include "G4MaterialCutsCouple.hh"
101#include "G4Track.hh"
102#include "G4EmModelManager.hh"
103#include "G4UnitsTable.hh"
104#include "G4ParticleChangeForLoss.hh"
105#include "G4EmTableType.hh"
106#include "G4PhysicsTable.hh"
107#include "G4PhysicsVector.hh"
108
109class G4Step;
110class G4ParticleDefinition;
111class G4VEmModel;
112class G4VEmFluctuationModel;
113class G4DataVector;
114class G4Region;
115class G4SafetyHelper;
116class G4VAtomDeexcitation;
117
118//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
119
120class G4VEnergyLossProcess : public G4VContinuousDiscreteProcess
121{
122public:
123
124  G4VEnergyLossProcess(const G4String& name = "EnergyLoss",
125                       G4ProcessType type = fElectromagnetic);
126
127  virtual ~G4VEnergyLossProcess();
128
129private:
130  // clean vectors and arrays
131  void Clean();
132
133  //------------------------------------------------------------------------
134  // Virtual methods to be implemented in concrete processes
135  //------------------------------------------------------------------------
136
137public:
138  virtual G4bool IsApplicable(const G4ParticleDefinition& p) = 0;
139 
140  virtual void PrintInfo() = 0;
141
142protected:
143
144  virtual void InitialiseEnergyLossProcess(const G4ParticleDefinition*,
145                                           const G4ParticleDefinition*) = 0;
146
147  //------------------------------------------------------------------------
148  // Methods with standard implementation; may be overwritten if needed
149  //------------------------------------------------------------------------
150
151  virtual G4double MinPrimaryEnergy(const G4ParticleDefinition*,
152                                    const G4Material*, G4double cut);
153
154  //------------------------------------------------------------------------
155  // Virtual methods implementation common to all EM ContinuousDiscrete
156  // processes. Further inheritance is not assumed
157  //------------------------------------------------------------------------
158
159public:
160
161  // prepare all tables
162  void PreparePhysicsTable(const G4ParticleDefinition&);
163
164  // build all tables
165  void BuildPhysicsTable(const G4ParticleDefinition&);
166
167  // build a table
168  G4PhysicsTable* BuildDEDXTable(G4EmTableType tType = fRestricted);
169
170  // build a table
171  G4PhysicsTable* BuildLambdaTable(G4EmTableType tType = fRestricted);
172
173  // summary printout after initialisation
174  void PrintInfoDefinition();
175
176  // Add subcutoff option for the region
177  void ActivateSubCutoff(G4bool val, const G4Region* region = 0);
178
179  // Activate deexcitation code for region
180  void ActivateDeexcitation(G4bool, const G4Region* region = 0);
181
182  // Step limit from AlongStep
183  G4double AlongStepGetPhysicalInteractionLength(const G4Track&,
184                                                 G4double  previousStepSize,
185                                                 G4double  currentMinimumStep,
186                                                 G4double& currentSafety,
187                                                 G4GPILSelection* selection);
188
189  // Step limit from cross section
190  G4double PostStepGetPhysicalInteractionLength(const G4Track& track,
191                                                G4double   previousStepSize,
192                                                G4ForceCondition* condition);
193
194  // AlongStep computations
195  G4VParticleChange* AlongStepDoIt(const G4Track&, const G4Step&);
196
197  // Sampling of secondaries in vicinity of geometrical boundary
198  void SampleSubCutSecondaries(std::vector<G4Track*>&, const G4Step&, 
199                               G4VEmModel* model, G4int matIdx); 
200
201  // PostStep sampling of secondaries
202  G4VParticleChange* PostStepDoIt(const G4Track&, const G4Step&);
203
204  // Store all PhysicsTable in files.
205  // Return false in case of any fatal failure at I/O 
206  G4bool StorePhysicsTable(const G4ParticleDefinition*,
207                           const G4String& directory,
208                           G4bool ascii = false);
209
210  // Retrieve all Physics from a files.
211  // Return true if all the Physics Table are built.
212  // Return false if any fatal failure.
213  G4bool RetrievePhysicsTable(const G4ParticleDefinition*,
214                              const G4String& directory,
215                              G4bool ascii);
216
217private:
218  // store a table
219  G4bool StoreTable(const G4ParticleDefinition* p, 
220                    G4PhysicsTable*, G4bool ascii,
221                    const G4String& directory, 
222                    const G4String& tname);
223
224  // retrieve a table
225  G4bool RetrieveTable(const G4ParticleDefinition* p, 
226                       G4PhysicsTable*, G4bool ascii,
227                       const G4String& directory, 
228                       const G4String& tname, 
229                       G4bool mandatory);
230
231  //------------------------------------------------------------------------
232  // Public interface to cross section, mfp and sampling of fluctuations
233  // These methods are not used in run time
234  //------------------------------------------------------------------------
235
236public:
237  // access to dispersion of restricted energy loss
238  G4double GetDEDXDispersion(const G4MaterialCutsCouple *couple,
239                             const G4DynamicParticle* dp,
240                             G4double length);
241
242  // Access to cross section table
243  G4double CrossSectionPerVolume(G4double kineticEnergy,
244                                 const G4MaterialCutsCouple* couple);
245
246  // access to cross section
247  G4double MeanFreePath(const G4Track& track);
248
249  // access to step limit
250  G4double ContinuousStepLimit(const G4Track& track,
251                               G4double previousStepSize,
252                               G4double currentMinimumStep,
253                               G4double& currentSafety);
254
255protected:
256
257  // implementation of the pure virtual method
258  G4double GetMeanFreePath(const G4Track& track,
259                           G4double previousStepSize,
260                           G4ForceCondition* condition);
261
262  // implementation of the pure virtual method
263  G4double GetContinuousStepLimit(const G4Track& track,
264                                  G4double previousStepSize,
265                                  G4double currentMinimumStep,
266                                  G4double& currentSafety);
267
268  //------------------------------------------------------------------------
269  // Run time method which may be also used by derived processes
270  //------------------------------------------------------------------------
271
272  // creeation of an empty vector for cross section
273  G4PhysicsVector* LambdaPhysicsVector(const G4MaterialCutsCouple*, 
274                                       G4double cut);
275
276  inline size_t CurrentMaterialCutsCoupleIndex() const;
277
278  inline G4double GetCurrentRange() const;
279
280  //------------------------------------------------------------------------
281  // Specific methods to set, access, modify models
282  //------------------------------------------------------------------------
283
284  // Select model in run time
285  inline void SelectModel(G4double kinEnergy);
286
287public:
288  // Select model by energy and region index
289  inline G4VEmModel* SelectModelForMaterial(G4double kinEnergy, 
290                                            size_t& idx) const;
291
292  // Add EM model coupled with fluctuation model for region, smaller value
293  // of order defines which pair of models will be selected for a given
294  // energy interval 
295  void AddEmModel(G4int, G4VEmModel*, 
296                  G4VEmFluctuationModel* fluc = 0,
297                  const G4Region* region = 0);
298
299  // Define new energy range for the model identified by the name
300  void UpdateEmModel(const G4String&, G4double, G4double);
301
302  // Assign a model to a process
303  void SetEmModel(G4VEmModel*, G4int index=1);
304 
305  // return the assigned model
306  G4VEmModel* EmModel(G4int index=1);
307 
308  // Access to models
309  G4VEmModel* GetModelByIndex(G4int idx = 0, G4bool ver = false);
310
311  G4int NumberOfModels();
312
313  // Assign a fluctuation model to a process
314  void SetFluctModel(G4VEmFluctuationModel*);
315 
316  // return the assigned fluctuation model
317  inline G4VEmFluctuationModel* FluctModel();
318   
319  //------------------------------------------------------------------------
320  // Define and access particle type
321  //------------------------------------------------------------------------
322
323protected:
324  inline void SetParticle(const G4ParticleDefinition* p);
325  inline void SetSecondaryParticle(const G4ParticleDefinition* p);
326
327public:
328  inline void SetBaseParticle(const G4ParticleDefinition* p);
329  inline const G4ParticleDefinition* Particle() const;
330  inline const G4ParticleDefinition* BaseParticle() const;
331  inline const G4ParticleDefinition* SecondaryParticle() const;
332
333  //------------------------------------------------------------------------
334  // Get/set parameters to configure the process at initialisation time
335  //------------------------------------------------------------------------
336
337  // Add subcutoff process (bremsstrahlung) to sample secondary
338  // particle production in vicinity of the geometry boundary
339  void AddCollaborativeProcess(G4VEnergyLossProcess*);
340
341  inline void SetLossFluctuations(G4bool val);
342  inline void SetRandomStep(G4bool val);
343
344  inline void SetIntegral(G4bool val);
345  inline G4bool IsIntegral() const;
346
347  // Set/Get flag "isIonisation"
348  inline void SetIonisation(G4bool val);
349  inline G4bool IsIonisationProcess() const;
350
351  // Redefine parameteters for stepping control
352  //
353  inline void SetLinearLossLimit(G4double val);
354  inline void SetMinSubRange(G4double val);
355  inline void SetLambdaFactor(G4double val);
356  inline void SetStepFunction(G4double v1, G4double v2);
357  inline void SetLowestEnergyLimit(G4double);
358
359  inline G4int NumberOfSubCutoffRegions() const;
360  inline G4int NumberOfDERegions() const;
361
362  //------------------------------------------------------------------------
363  // Specific methods to path Physics Tables to the process
364  //------------------------------------------------------------------------
365
366  void SetDEDXTable(G4PhysicsTable* p, G4EmTableType tType);
367  void SetCSDARangeTable(G4PhysicsTable* pRange);
368  void SetRangeTableForLoss(G4PhysicsTable* p);
369  void SetSecondaryRangeTable(G4PhysicsTable* p);
370  void SetInverseRangeTable(G4PhysicsTable* p);
371
372  void SetLambdaTable(G4PhysicsTable* p);
373  void SetSubLambdaTable(G4PhysicsTable* p);
374
375  // Binning for dEdx, range, inverse range and labda tables
376  inline void SetDEDXBinning(G4int nbins);
377  inline void SetLambdaBinning(G4int nbins);
378
379  // Binning for dEdx, range, and inverse range tables
380  inline void SetDEDXBinningForCSDARange(G4int nbins);
381
382  // Min kinetic energy for tables
383  inline void SetMinKinEnergy(G4double e);
384  inline G4double MinKinEnergy() const;
385
386  // Max kinetic energy for tables
387  inline void SetMaxKinEnergy(G4double e);
388  inline G4double MaxKinEnergy() const;
389
390  // Max kinetic energy for tables
391  inline void SetMaxKinEnergyForCSDARange(G4double e);
392
393  // Return values for given G4MaterialCutsCouple
394  inline G4double GetDEDX(G4double& kineticEnergy, const G4MaterialCutsCouple*);
395  inline G4double GetDEDXForSubsec(G4double& kineticEnergy, 
396                                   const G4MaterialCutsCouple*);
397  inline G4double GetRange(G4double& kineticEnergy, const G4MaterialCutsCouple*);
398  inline G4double GetCSDARange(G4double& kineticEnergy, const G4MaterialCutsCouple*);
399  inline G4double GetRangeForLoss(G4double& kineticEnergy, const G4MaterialCutsCouple*);
400  inline G4double GetKineticEnergy(G4double& range, const G4MaterialCutsCouple*);
401  inline G4double GetLambda(G4double& kineticEnergy, const G4MaterialCutsCouple*);
402
403  inline G4bool TablesAreBuilt() const;
404
405  // Access to specific tables
406  inline G4PhysicsTable* DEDXTable() const;
407  inline G4PhysicsTable* DEDXTableForSubsec() const;
408  inline G4PhysicsTable* DEDXunRestrictedTable() const;
409  inline G4PhysicsTable* IonisationTable() const;
410  inline G4PhysicsTable* IonisationTableForSubsec() const;
411  inline G4PhysicsTable* CSDARangeTable() const;
412  inline G4PhysicsTable* RangeTableForLoss() const;
413  inline G4PhysicsTable* InverseRangeTable() const;
414  inline G4PhysicsTable* LambdaTable();
415  inline G4PhysicsTable* SubLambdaTable();
416
417  //------------------------------------------------------------------------
418  // Run time method for simulation of ionisation
419  //------------------------------------------------------------------------
420
421  // access atom on which interaction happens
422  const G4Element* GetCurrentElement() const;
423
424  // sample range at the end of a step
425  inline G4double SampleRange();
426
427  // Set scaling parameters for ions is needed to G4EmCalculator
428  inline void SetDynamicMassCharge(G4double massratio, G4double charge2ratio);
429
430private:
431
432  // define material and indexes
433  inline void DefineMaterial(const G4MaterialCutsCouple* couple);
434
435  //------------------------------------------------------------------------
436  // Compute values using scaling relation, mass and charge of based particle
437  //------------------------------------------------------------------------
438
439  inline G4double GetDEDXForScaledEnergy(G4double scaledKinEnergy);
440  inline G4double GetSubDEDXForScaledEnergy(G4double scaledKinEnergy);
441  inline G4double GetIonisationForScaledEnergy(G4double scaledKinEnergy);
442  inline G4double GetSubIonisationForScaledEnergy(G4double scaledKinEnergy);
443  inline G4double GetScaledRangeForScaledEnergy(G4double scaledKinEnergy);
444  inline G4double GetLimitScaledRangeForScaledEnergy(G4double scaledKinEnergy);
445  inline G4double ScaledKinEnergyForLoss(G4double range);
446  inline G4double GetLambdaForScaledEnergy(G4double scaledKinEnergy);
447  inline void ComputeLambdaForScaledEnergy(G4double scaledKinEnergy);
448
449  // hide  assignment operator
450  G4VEnergyLossProcess(G4VEnergyLossProcess &);
451  G4VEnergyLossProcess & operator=(const G4VEnergyLossProcess &right);
452
453  // ======== Parameters of the class fixed at construction =========
454
455  G4EmModelManager*           modelManager;
456  G4SafetyHelper*             safetyHelper;
457
458  const G4ParticleDefinition* secondaryParticle;
459  const G4ParticleDefinition* theElectron;
460  const G4ParticleDefinition* thePositron;
461  const G4ParticleDefinition* theGenericIon;
462
463  G4PhysicsVector*            vstrag;
464
465  // ======== Parameters of the class fixed at initialisation =======
466
467  std::vector<G4VEmModel*>              emModels;
468  G4VEmFluctuationModel*                fluctModel;
469  G4VAtomDeexcitation*                  atomDeexcitation;
470  std::vector<const G4Region*>          scoffRegions;
471  std::vector<const G4Region*>          deRegions;
472  G4int                                 nSCoffRegions;
473  G4int                                 nDERegions;
474  G4bool*                               idxSCoffRegions;
475  G4bool*                               idxDERegions;
476
477  std::vector<G4VEnergyLossProcess*>    scProcesses;
478  G4int                                 nProcesses;
479
480  // tables and vectors
481  G4PhysicsTable*             theDEDXTable;
482  G4PhysicsTable*             theDEDXSubTable;
483  G4PhysicsTable*             theDEDXunRestrictedTable;
484  G4PhysicsTable*             theIonisationTable;
485  G4PhysicsTable*             theIonisationSubTable;
486  G4PhysicsTable*             theRangeTableForLoss;
487  G4PhysicsTable*             theCSDARangeTable;
488  G4PhysicsTable*             theSecondaryRangeTable;
489  G4PhysicsTable*             theInverseRangeTable;
490  G4PhysicsTable*             theLambdaTable;
491  G4PhysicsTable*             theSubLambdaTable;
492  G4double*                   theDEDXAtMaxEnergy;
493  G4double*                   theRangeAtMaxEnergy;
494  G4double*                   theEnergyOfCrossSectionMax;
495  G4double*                   theCrossSectionMax;
496
497  const G4DataVector*         theCuts;
498  const G4DataVector*         theSubCuts;
499
500  const G4ParticleDefinition* baseParticle;
501
502  G4int    nBins;
503  G4int    nBinsCSDA;
504
505  G4double lowestKinEnergy;
506  G4double minKinEnergy;
507  G4double maxKinEnergy;
508  G4double maxKinEnergyCSDA;
509
510  G4double linLossLimit;
511  G4double minSubRange;
512  G4double dRoverRange;
513  G4double finalRange;
514  G4double lambdaFactor;
515
516  G4bool   lossFluctuationFlag;
517  G4bool   rndmStepFlag;
518  G4bool   tablesAreBuilt;
519  G4bool   integral;
520  G4bool   isIon;
521  G4bool   isIonisation;
522  G4bool   useSubCutoff;
523  G4bool   useDeexcitation;
524
525protected:
526
527  G4ParticleChangeForLoss          fParticleChange;
528
529  // ======== Cashed values - may be state dependent ================
530
531private:
532
533  std::vector<G4DynamicParticle*>  secParticles;
534  std::vector<G4Track*>            scTracks;
535
536  const G4ParticleDefinition* particle;
537
538  G4VEmModel*                 currentModel;
539  const G4Material*           currentMaterial;
540  const G4MaterialCutsCouple* currentCouple;
541  size_t                      currentMaterialIndex;
542
543  G4int    nWarnings;
544
545  G4double massRatio;
546  G4double reduceFactor;
547  G4double chargeSqRatio;
548
549  G4double preStepLambda;
550  G4double fRange;
551  G4double preStepKinEnergy;
552  G4double preStepScaledEnergy;
553  G4double mfpKinEnergy;
554
555  G4GPILSelection  aGPILSelection;
556
557};
558
559// ======== Run time inline methods ================
560
561inline size_t G4VEnergyLossProcess::CurrentMaterialCutsCoupleIndex() const 
562{
563  return currentMaterialIndex;
564}
565
566//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
567 
568inline G4double G4VEnergyLossProcess::GetCurrentRange() const
569{
570  return fRange;
571}
572
573//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
574
575inline void G4VEnergyLossProcess::SelectModel(G4double kinEnergy)
576{
577  currentModel = modelManager->SelectModel(kinEnergy, currentMaterialIndex);
578  currentModel->SetCurrentCouple(currentCouple);
579}
580
581//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
582
583inline G4VEmModel* G4VEnergyLossProcess::SelectModelForMaterial(
584                   G4double kinEnergy, size_t& idx) const
585{
586  return modelManager->SelectModel(kinEnergy, idx);
587}
588
589//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
590
591inline void 
592G4VEnergyLossProcess::DefineMaterial(const G4MaterialCutsCouple* couple)
593{
594  if(couple != currentCouple) {
595    currentCouple   = couple;
596    currentMaterial = couple->GetMaterial();
597    currentMaterialIndex = couple->GetIndex();
598    mfpKinEnergy = DBL_MAX;
599  }
600}
601
602//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
603
604inline void G4VEnergyLossProcess::SetDynamicMassCharge(G4double massratio,
605                                                       G4double charge2ratio)
606{
607  massRatio     = massratio;
608  chargeSqRatio = charge2ratio;
609  reduceFactor  = 1.0/(chargeSqRatio*massRatio);
610}
611
612//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
613
614inline G4double G4VEnergyLossProcess::GetDEDXForScaledEnergy(G4double e)
615{
616  G4double x = ((*theDEDXTable)[currentMaterialIndex]->Value(e))*chargeSqRatio;
617  if(e < minKinEnergy) { x *= std::sqrt(e/minKinEnergy); }
618  return x;
619}
620
621//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
622
623inline G4double G4VEnergyLossProcess::GetSubDEDXForScaledEnergy(G4double e)
624{
625  G4double x = ((*theDEDXSubTable)[currentMaterialIndex]->Value(e))*chargeSqRatio;
626  if(e < minKinEnergy) { x *= std::sqrt(e/minKinEnergy); }
627  return x;
628}
629
630//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
631
632inline G4double G4VEnergyLossProcess::GetIonisationForScaledEnergy(G4double e)
633{
634  //G4double x = 0.0;
635  //  if(theIonisationTable) {
636  G4double x = ((*theIonisationTable)[currentMaterialIndex]->Value(e))*chargeSqRatio;
637  if(e < minKinEnergy) { x *= std::sqrt(e/minKinEnergy); }
638  //}
639  return x;
640}
641
642//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
643
644inline 
645G4double G4VEnergyLossProcess::GetSubIonisationForScaledEnergy(G4double e)
646{
647  //  G4double x = 0.0;
648  //if(theIonisationSubTable) {
649  G4double x = ((*theIonisationSubTable)[currentMaterialIndex]->Value(e))*chargeSqRatio;
650  if(e < minKinEnergy) { x *= std::sqrt(e/minKinEnergy); }
651  //}
652  return x;
653}
654
655//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
656
657inline G4double G4VEnergyLossProcess::GetScaledRangeForScaledEnergy(G4double e)
658{
659  G4double x = ((*theRangeTableForLoss)[currentMaterialIndex])->Value(e);
660  if(e < minKinEnergy) { x *= std::sqrt(e/minKinEnergy); }
661  return x;
662}
663
664//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
665
666inline G4double
667G4VEnergyLossProcess::GetLimitScaledRangeForScaledEnergy(G4double e)
668{
669  G4double x;
670
671  if (e < maxKinEnergyCSDA) {
672    x = ((*theCSDARangeTable)[currentMaterialIndex])->Value(e);
673    if(e < minKinEnergy) x *= std::sqrt(e/minKinEnergy);
674  } else {
675    x = theRangeAtMaxEnergy[currentMaterialIndex] +
676         (e - maxKinEnergyCSDA)/theDEDXAtMaxEnergy[currentMaterialIndex];
677  }
678  return x;
679}
680
681//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
682
683inline G4double G4VEnergyLossProcess::ScaledKinEnergyForLoss(G4double r)
684{
685  G4PhysicsVector* v = (*theInverseRangeTable)[currentMaterialIndex];
686  G4double rmin = v->Energy(0);
687  G4double e = 0.0; 
688  if(r >= rmin) { e = v->Value(r); }
689  else if(r > 0.0) {
690    G4double x = r/rmin;
691    e = minKinEnergy*x*x;
692  }
693  return e;
694}
695
696//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
697
698inline G4double G4VEnergyLossProcess::GetLambdaForScaledEnergy(G4double e)
699{
700  return chargeSqRatio*(((*theLambdaTable)[currentMaterialIndex])->Value(e));
701}
702
703//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
704
705inline G4double
706G4VEnergyLossProcess::GetDEDX(G4double& kineticEnergy,
707                              const G4MaterialCutsCouple* couple)
708{
709  DefineMaterial(couple);
710  return GetDEDXForScaledEnergy(kineticEnergy*massRatio);
711}
712
713//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
714
715inline G4double
716G4VEnergyLossProcess::GetDEDXForSubsec(G4double& kineticEnergy,
717                                                const G4MaterialCutsCouple* couple)
718{
719  DefineMaterial(couple);
720  return GetSubDEDXForScaledEnergy(kineticEnergy*massRatio);
721}
722
723//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
724
725inline G4double
726G4VEnergyLossProcess::GetRange(G4double& kineticEnergy,
727                               const G4MaterialCutsCouple* couple)
728{
729  G4double x = fRange;
730  if(kineticEnergy != preStepKinEnergy || couple != currentCouple) { 
731    DefineMaterial(couple);
732    if(theCSDARangeTable)
733      x = GetLimitScaledRangeForScaledEnergy(kineticEnergy*massRatio)
734        * reduceFactor;
735    else if(theRangeTableForLoss)
736      x = GetScaledRangeForScaledEnergy(kineticEnergy*massRatio)*reduceFactor;
737  }
738  return x;
739}
740
741//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
742
743inline G4double
744G4VEnergyLossProcess::GetCSDARange(G4double& kineticEnergy, 
745                                   const G4MaterialCutsCouple* couple)
746{
747  DefineMaterial(couple);
748  G4double x = DBL_MAX;
749  if(theCSDARangeTable)
750    x = GetLimitScaledRangeForScaledEnergy(kineticEnergy*massRatio)
751      * reduceFactor;
752  return x;
753}
754
755//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
756
757inline G4double
758G4VEnergyLossProcess::GetRangeForLoss(G4double& kineticEnergy,
759                                      const G4MaterialCutsCouple* couple)
760{
761  DefineMaterial(couple);
762  G4double x = DBL_MAX;
763  if(theRangeTableForLoss) 
764    x = GetScaledRangeForScaledEnergy(kineticEnergy*massRatio)*reduceFactor;
765  //  G4cout << "Range from " << GetProcessName()
766  //         << "  e= " << kineticEnergy << " r= " << x << G4endl;
767  return x;
768}
769
770//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
771
772inline G4double
773G4VEnergyLossProcess::GetKineticEnergy(G4double& range,
774                                       const G4MaterialCutsCouple* couple)
775{
776  DefineMaterial(couple);
777  G4double r = range/reduceFactor;
778  G4double e = ScaledKinEnergyForLoss(r)/massRatio;
779  return e;
780}
781
782//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
783
784inline G4double
785G4VEnergyLossProcess::GetLambda(G4double& kineticEnergy,
786                                const G4MaterialCutsCouple* couple)
787{
788  DefineMaterial(couple);
789  G4double x = 0.0;
790  if(theLambdaTable) { x = GetLambdaForScaledEnergy(kineticEnergy*massRatio); }
791  return x;
792}
793
794//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
795
796inline void G4VEnergyLossProcess::ComputeLambdaForScaledEnergy(G4double e)
797{
798  mfpKinEnergy  = theEnergyOfCrossSectionMax[currentMaterialIndex];
799  if (e <= mfpKinEnergy) {
800    preStepLambda = GetLambdaForScaledEnergy(e);
801
802  } else {
803    G4double e1 = e*lambdaFactor;
804    if(e1 > mfpKinEnergy) {
805      preStepLambda  = GetLambdaForScaledEnergy(e);
806      G4double preStepLambda1 = GetLambdaForScaledEnergy(e1);
807      if(preStepLambda1 > preStepLambda) {
808        mfpKinEnergy = e1;
809        preStepLambda = preStepLambda1;
810      }
811    } else {
812      preStepLambda = chargeSqRatio*theCrossSectionMax[currentMaterialIndex];
813    }
814  }
815}
816
817//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
818
819inline G4double G4VEnergyLossProcess::SampleRange()
820{
821  G4double e = amu_c2*preStepKinEnergy/particle->GetPDGMass();
822  G4double s = fRange*std::pow(10.,vstrag->Value(e));
823  G4double x = fRange + G4RandGauss::shoot(0.0,s);
824  if(x > 0.0) { fRange = x; }
825  return fRange;
826}
827
828// ======== Get/Set inline methods used at initialisation ================
829
830inline void G4VEnergyLossProcess::SetFluctModel(G4VEmFluctuationModel* p)
831{
832  fluctModel = p;
833}
834
835//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
836
837inline G4VEmFluctuationModel* G4VEnergyLossProcess::FluctModel()
838{
839  return fluctModel;
840}
841
842//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
843
844inline void G4VEnergyLossProcess::SetParticle(const G4ParticleDefinition* p)
845{
846  particle = p;
847}
848
849//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
850
851inline void G4VEnergyLossProcess::SetSecondaryParticle(const G4ParticleDefinition* p)
852{
853  secondaryParticle = p;
854}
855
856//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
857
858inline void G4VEnergyLossProcess::SetBaseParticle(const G4ParticleDefinition* p)
859{
860  baseParticle = p;
861}
862
863//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
864
865inline const G4ParticleDefinition* G4VEnergyLossProcess::Particle() const
866{
867  return particle;
868}
869
870//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
871
872inline const G4ParticleDefinition* G4VEnergyLossProcess::BaseParticle() const
873{
874  return baseParticle;
875}
876
877//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
878
879inline const G4ParticleDefinition* G4VEnergyLossProcess::SecondaryParticle() const
880{
881  return secondaryParticle;
882}
883
884//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
885
886inline void G4VEnergyLossProcess::SetLossFluctuations(G4bool val)
887{
888  lossFluctuationFlag = val;
889}
890
891//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
892
893inline void G4VEnergyLossProcess::SetRandomStep(G4bool val)
894{
895  rndmStepFlag = val;
896}
897
898//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
899
900inline void G4VEnergyLossProcess::SetIntegral(G4bool val)
901{
902  integral = val;
903}
904
905//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
906 
907inline G4bool G4VEnergyLossProcess::IsIntegral() const 
908{
909  return integral;
910}
911
912//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
913
914inline void G4VEnergyLossProcess::SetIonisation(G4bool val)
915{
916  isIonisation = val;
917  if(val) { aGPILSelection = CandidateForSelection; }
918  else    { aGPILSelection = NotCandidateForSelection; }
919}
920
921//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
922
923inline G4bool G4VEnergyLossProcess::IsIonisationProcess() const
924{
925  return isIonisation;
926}
927
928//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
929
930inline void G4VEnergyLossProcess::SetLinearLossLimit(G4double val)
931{
932  linLossLimit = val;
933}
934
935//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
936
937inline void G4VEnergyLossProcess::SetMinSubRange(G4double val)
938{
939  minSubRange = val;
940}
941
942//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
943
944inline void G4VEnergyLossProcess::SetLambdaFactor(G4double val)
945{
946  if(val > 0.0 && val <= 1.0) { lambdaFactor = val; }
947}
948
949//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
950
951void G4VEnergyLossProcess::SetStepFunction(G4double v1, G4double v2)
952{
953  dRoverRange = v1;
954  finalRange = v2;
955  if (dRoverRange > 0.999) { dRoverRange = 1.0; }
956  currentCouple = 0;
957  mfpKinEnergy  = DBL_MAX;
958}
959
960//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
961
962inline void G4VEnergyLossProcess::SetLowestEnergyLimit(G4double val)
963{
964  lowestKinEnergy = val;
965}
966
967//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
968
969inline G4int G4VEnergyLossProcess::NumberOfSubCutoffRegions() const
970{
971  return nSCoffRegions;
972}
973
974//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
975
976inline G4int G4VEnergyLossProcess::NumberOfDERegions() const
977{
978  return nDERegions;
979}
980
981//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
982
983inline void G4VEnergyLossProcess::SetDEDXBinning(G4int nbins)
984{
985  nBins = nbins;
986}
987
988//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
989
990inline void G4VEnergyLossProcess::SetLambdaBinning(G4int nbins)
991{
992  nBins = nbins;
993}
994
995//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
996
997inline void G4VEnergyLossProcess::SetDEDXBinningForCSDARange(G4int nbins)
998{
999  nBinsCSDA = nbins;
1000}
1001
1002//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1003
1004inline void G4VEnergyLossProcess::SetMinKinEnergy(G4double e)
1005{
1006  minKinEnergy = e;
1007}
1008
1009//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1010
1011inline G4double G4VEnergyLossProcess::MinKinEnergy() const
1012{
1013  return minKinEnergy;
1014}
1015
1016//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1017
1018inline void G4VEnergyLossProcess::SetMaxKinEnergy(G4double e)
1019{
1020  maxKinEnergy = e;
1021  if(e < maxKinEnergyCSDA) { maxKinEnergyCSDA = e; }
1022}
1023
1024//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1025
1026inline G4double G4VEnergyLossProcess::MaxKinEnergy() const
1027{
1028  return maxKinEnergy;
1029}
1030
1031//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1032
1033inline void G4VEnergyLossProcess::SetMaxKinEnergyForCSDARange(G4double e)
1034{
1035  maxKinEnergyCSDA = e;
1036}
1037
1038
1039//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1040
1041inline G4bool G4VEnergyLossProcess::TablesAreBuilt() const
1042{
1043  return  tablesAreBuilt;
1044}
1045
1046//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1047
1048inline G4PhysicsTable* G4VEnergyLossProcess::DEDXTable() const
1049{
1050  return theDEDXTable;
1051}
1052
1053//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1054
1055inline G4PhysicsTable* G4VEnergyLossProcess::DEDXTableForSubsec() const
1056{
1057  return theDEDXSubTable;
1058}
1059
1060//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1061
1062inline G4PhysicsTable* G4VEnergyLossProcess::DEDXunRestrictedTable() const
1063{
1064  return theDEDXunRestrictedTable;
1065}
1066
1067//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1068
1069inline G4PhysicsTable* G4VEnergyLossProcess::IonisationTable() const
1070{
1071  G4PhysicsTable* t = theDEDXTable;
1072  if(theIonisationTable) { t = theIonisationTable; } 
1073  return t;
1074}
1075
1076//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1077
1078inline G4PhysicsTable* G4VEnergyLossProcess::IonisationTableForSubsec() const
1079{
1080  G4PhysicsTable* t = theDEDXSubTable;
1081  if(theIonisationSubTable) { t = theIonisationSubTable; } 
1082  return t;
1083}
1084
1085//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1086
1087inline G4PhysicsTable* G4VEnergyLossProcess::CSDARangeTable() const
1088{
1089  return theCSDARangeTable;
1090}
1091
1092//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1093
1094inline G4PhysicsTable* G4VEnergyLossProcess::RangeTableForLoss() const
1095{
1096  return theRangeTableForLoss;
1097}
1098
1099//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1100
1101inline G4PhysicsTable* G4VEnergyLossProcess::InverseRangeTable() const
1102{
1103  return theInverseRangeTable;
1104}
1105
1106//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1107
1108inline G4PhysicsTable* G4VEnergyLossProcess::LambdaTable()
1109{
1110  return theLambdaTable;
1111}
1112
1113//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1114
1115inline G4PhysicsTable* G4VEnergyLossProcess::SubLambdaTable()
1116{
1117  return theSubLambdaTable;
1118}
1119
1120//....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
1121
1122#endif
Note: See TracBrowser for help on using the repository browser.