G4SPSRandomGenerator.hh

Go to the documentation of this file.

//
// ********************************************************************
// * License and Disclaimer                                           *
// *                                                                  *
// * The  Geant4 software  is  copyright of the Copyright Holders  of *
// * the Geant4 Collaboration.  It is provided  under  the terms  and *
// * conditions of the Geant4 Software License,  included in the file *
// * LICENSE and available at  http://cern.ch/geant4/license .  These *
// * include a list of copyright holders.                             *
// *                                                                  *
// * Neither the authors of this software system, nor their employing *
// * institutes,nor the agencies providing financial support for this *
// * work  make  any representation or  warranty, express or implied, *
// * regarding  this  software system or assume any liability for its *
// * use.  Please see the license in the file  LICENSE  and URL above *
// * for the full disclaimer and the limitation of liability.         *
// *                                                                  *
// * This  code  implementation is the result of  the  scientific and *
// * technical work of the GEANT4 collaboration.                      *
// * By using,  copying,  modifying or  distributing the software (or *
// * any work based  on the software)  you  agree  to acknowledge its *
// * use  in  resulting  scientific  publications,  and indicate your *
// * acceptance of all terms of the Geant4 Software license.          *
// ********************************************************************
//
///////////////////////////////////////////////////////////////////////////////
//
// MODULE:        G4SPSRandomGenerator.hh
//
// Version:      1.0
// Date:         5/02/04
// Author:       Fan Lei 
// Organisation: QinetiQ ltd.
// Customer:     ESA/ESTEC
//
///////////////////////////////////////////////////////////////////////////////
//
// CHANGE HISTORY
// --------------
//
// 26/10/2004 F Lei
//    Created separated the theta, phi generators for position distributions.
//
// Version 1.0, 05/02/2004, Fan Lei, Created.
//    Based on the G4GeneralParticleSource class in Geant4 v6.0
//
///////////////////////////////////////////////////////////////////////////////
//
// Class Description:
//
// Special random number generator used by G4GeneralParticleSource to allow 
// biasing applied at the lowest level for all distributions.
//
///////////////////////////////////////////////////////////////////////////////
//
// MEMBER FUNCTIONS
// ----------------
//
// G4SPSRandomGenerator ()
//    Constructor: Initializes variables
//
// ~G4SPSRandomGenerator ()
//    Destructor: 
//
// void SetXBias(G4ThreeVector)
//    Allows the user to re-distribute the random
//    numbers used to generate x co-ordinates.
//
// void SetYBias(G4ThreeVector)
//    Allows the user to re-distribute the random
//    numbers used to generate y co-ordinates.
//
// void SetZBias(G4ThreeVector)
//    Allows the user to re-distribute the random
//    numbers used to generate z co-ordinates.
//
// void SetThetaBias(G4ThreeVector)
//    Allows the user to re-distribute the random
//    numbers used to generate values of theta.
//
// void SetPhiBias(G4ThreeVector)
//    Allows the user to re-distribute the random
//    numbers used to generate values of phi.
//
// void SetPosThetaBias(G4ThreeVector)
//    Allows the user to re-distribute the random
//    numbers used to generate values of theta for position distribution.
//
// void SetPosPhiBias(G4ThreeVector)
//    Allows the user to re-distribute the random
//    numbers used to generate values of phi for position distribution.
//
// void SetEnergyBias(G4ThreeVector)
//    Allows the user to re-distribute the random
//    numbers used to generate the energies.
//
// G4double GenRandX()
//    Generates the random number for x, with or without biasing.
//
// G4double GenRandY()
//    Generates the random number for y, with or without biasing.
//
// G4double GenRandZ()
//    Generates the random number for z, with or without biasing.
//
// G4double GenRandTheta()
//    Generates the random number for theta, with or without biasing.
//
// G4double GenRandPhi()
//    Generates the random number for phi, with or without biasing.
//
// G4double GenRandEnergy()
//    Generates the random number for energy, with or without biasing.
//
// G4double GenRandPosTheta()
//    Generates the random number for theta, with or without biasing for position distribution.
//
// G4double GenRandPosPhi()
//    Generates the random number for phi, with or without biasing for position distribution.
//
//  inline G4double GetBiasWeight()
//    Returns the weight change after biasing
// 
//  void ReSetHist(G4String);
//    Re-sets the histogram for user defined distribution
//
// void SetVerbosity(G4int)
//    Sets the verbosity level.
//
///////////////////////////////////////////////////////////////////////////////
//
#ifndef G4SPSRandomGenerator_h
#define G4SPSRandomGenerator_h 1
 
#include "G4PhysicsOrderedFreeVector.hh"
#include "G4DataInterpolation.hh"
 
class G4SPSRandomGenerator {
public:
    G4SPSRandomGenerator();
    ~G4SPSRandomGenerator();
 
    //  static G4SPSRandomGenerator* getInstance ();
 
    // Biasing Methods
    void SetXBias(G4ThreeVector);
    void SetYBias(G4ThreeVector);
    void SetZBias(G4ThreeVector);
    void SetThetaBias(G4ThreeVector);
    void SetPhiBias(G4ThreeVector);
    void SetEnergyBias(G4ThreeVector);
    void SetPosThetaBias(G4ThreeVector);
    void SetPosPhiBias(G4ThreeVector);
    G4double GenRandX();
    G4double GenRandY();
    G4double GenRandZ();
    G4double GenRandTheta();
    G4double GenRandPhi();
    G4double GenRandEnergy();
    G4double GenRandPosTheta();
    G4double GenRandPosPhi();
 
    inline void SetIntensityWeight(G4double weight) {
        bweights[8] = weight;
    }
    ;
 
    inline G4double GetBiasWeight() {
        return bweights[0] * bweights[1] * bweights[2] * bweights[3]
                * bweights[4] * bweights[5] * bweights[6] * bweights[7]
                * bweights[8];
    }
    ;
 
    // method to re-set the histograms
    void ReSetHist(G4String);
 
    // Set the verbosity level.
    void SetVerbosity(G4int a) {
        verbosityLevel = a;
    }
    ;
 
private:
 
    //  static G4SPSRandomGenerator  *instance;
 
    G4bool XBias, IPDFXBias;
    G4PhysicsOrderedFreeVector XBiasH;
    G4PhysicsOrderedFreeVector IPDFXBiasH;
    G4bool YBias, IPDFYBias;
    G4PhysicsOrderedFreeVector YBiasH;
    G4PhysicsOrderedFreeVector IPDFYBiasH;
    G4bool ZBias, IPDFZBias;
    G4PhysicsOrderedFreeVector ZBiasH;
    G4PhysicsOrderedFreeVector IPDFZBiasH;
    G4bool ThetaBias, IPDFThetaBias;
    G4PhysicsOrderedFreeVector ThetaBiasH;
    G4PhysicsOrderedFreeVector IPDFThetaBiasH;
    G4bool PhiBias, IPDFPhiBias;
    G4PhysicsOrderedFreeVector PhiBiasH;
    G4PhysicsOrderedFreeVector IPDFPhiBiasH;
    G4bool EnergyBias, IPDFEnergyBias;
    G4PhysicsOrderedFreeVector EnergyBiasH;
    G4PhysicsOrderedFreeVector IPDFEnergyBiasH;
    G4bool PosThetaBias, IPDFPosThetaBias;
    G4PhysicsOrderedFreeVector PosThetaBiasH;
    G4PhysicsOrderedFreeVector IPDFPosThetaBiasH;
    G4bool PosPhiBias, IPDFPosPhiBias;
    G4PhysicsOrderedFreeVector PosPhiBiasH;
    G4PhysicsOrderedFreeVector IPDFPosPhiBiasH;
 
    G4double alpha;   // for biasing energy
 
    G4double bweights[9]; //record x,y,z,theta,phi,energy,posThet,posPhi,intensity weights
 
    // Verbosity
    G4int verbosityLevel;
 
    G4PhysicsOrderedFreeVector ZeroPhysVector; // for re-set only
 
};
 
#endif