G4MolecularConfiguration.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.          *
// ********************************************************************
//
//
// Author: Mathieu Karamitros (kara (AT) cenbg . in2p3 . fr) 
//
// WARNING : This class is released as a prototype.
// It might strongly evolve or even disapear in the next releases.
//
// History:
// -----------
// 10 Oct 2011 M.Karamitros created
//
// -------------------------------------------------------------------


#ifndef G4MolecularConfiguration_
#define G4MolecularConfiguration_ 1
#include <G4MoleculeDefinition.hh>
#include <map>
#include <vector>
#include <CLHEP/Utility/memory.h>

struct comparator;

class G4MolecularConfiguration;
class G4MoleculeDefinition;
class G4ElectronOccupancy;
class G4MolecularDecayChannel;

class G4MolecularConfiguration
{
public :

    // Static methods

    // Get for a given moleculeDefinition and a given electronic configuration, the mol conf
    static G4MolecularConfiguration* GetMolecularConfiguration(const G4MoleculeDefinition*,
            const G4ElectronOccupancy& electronOccupancy);

    // Get ground state electronic configuration
    static G4MolecularConfiguration* GetMolecularConfiguration(const G4MoleculeDefinition*);

    // Release memory of the mol conf manager
    static void DeleteManager();

    // Methods
    const G4MoleculeDefinition* GetDefinition() const;

    const G4String& GetName() const;

    G4int GetAtomsNumber() const;

    G4MolecularConfiguration* ExciteMolecule(G4int);

    G4MolecularConfiguration* IonizeMolecule(G4int);

    G4MolecularConfiguration* AddElectron(G4int orbit, G4int n =1);

    G4MolecularConfiguration* RemoveElectron(G4int,G4int number=1);

    G4MolecularConfiguration* MoveOneElectron(G4int /*orbit*/,G4int /*orbit*/);

    G4double GetNbElectrons() const;

    void PrintState() const;

    const std::vector <const G4MolecularDecayChannel*>* GetDecayChannel() const;

    G4int GetMoleculeID() const;

    inline void SetDiffusionCoefficient(G4double);

    inline G4double GetDiffusionCoefficient() const;

    inline void SetDecayTime(G4double);

    inline G4double GetDecayTime() const;

    inline void SetVanDerVaalsRadius(G4double);
    inline G4double GetVanDerVaalsRadius() const ;

    inline const G4ElectronOccupancy* GetElectronOccupancy() const;

    inline G4int GetCharge() const;

    inline void SetMass(G4double);

    inline G4double GetMass() const;

protected :
    G4MolecularConfiguration(const G4MoleculeDefinition*, const G4ElectronOccupancy&);
    G4MolecularConfiguration(const G4MolecularConfiguration&);
    G4MolecularConfiguration & operator=(G4MolecularConfiguration &right);
    ~G4MolecularConfiguration();
    G4MolecularConfiguration* ChangeConfiguration(const G4ElectronOccupancy& newElectronOccupancy);

    const G4MoleculeDefinition* fMoleculeDefinition;
    const G4ElectronOccupancy* fElectronOccupancy;

public:
    struct G4MolecularConfigurationManager
    {
        G4MolecularConfigurationManager(){;}
        ~G4MolecularConfigurationManager();

        typedef std::map<const G4MoleculeDefinition*, std::map<G4ElectronOccupancy, G4MolecularConfiguration*, comparator> > MolecularConfigurationTable;
        MolecularConfigurationTable fTable;
    };

protected:
    static G4ThreadLocal G4MolecularConfigurationManager* fgManager;

    static G4MolecularConfigurationManager* GetManager();

    G4double fDynDiffusionCoefficient;
    G4double fDynVanDerVaalsRadius;
    G4double fDynDecayTime;
    G4double fDynMass;
    G4int    fDynCharge;
    mutable G4String fName; // mutable allowed this member to be changed in const methods
};

struct comparator
{
    bool operator() (const G4ElectronOccupancy& occ1, const G4ElectronOccupancy& occ2) const
    {
        // Since this method is called a lot of time,
        // we retrieve only once the totOcc
        G4int totalOcc1 = occ1.GetTotalOccupancy() ;
        G4int totalOcc2 = occ2.GetTotalOccupancy() ;
        if ( totalOcc1!= totalOcc2)
        {
            return totalOcc1<totalOcc2;
        }
        else
        {
            G4int occupancy1 = -1 ;
            G4int occupancy2 = -1 ;
            const G4int sizeOrbit = occ1.GetSizeOfOrbit() ;
            for (G4int i=0; i<occ1.GetSizeOfOrbit();)
            {
                // Since this method is called a lot of time,
                // we retrieve only once the Occ

                occupancy1 = occ1.GetOccupancy(i);
                occupancy2 = occ2.GetOccupancy(i);

                if (occupancy1 != occupancy2)
                {
                    return occupancy1 < occupancy2;
                }
                else
                {
                    i++;
                    if (i >= sizeOrbit) return false;
                }
            }
        }
        return false;
    }
};


inline const G4MoleculeDefinition* G4MolecularConfiguration::GetDefinition() const
{
    return fMoleculeDefinition;
}

inline const G4ElectronOccupancy* G4MolecularConfiguration::GetElectronOccupancy() const
{
    return fElectronOccupancy ;
}

inline void G4MolecularConfiguration::SetDiffusionCoefficient(G4double dynDiffusionCoefficient)
{
    fDynDiffusionCoefficient = dynDiffusionCoefficient ;
}

inline G4double G4MolecularConfiguration::GetDiffusionCoefficient() const
{
    return fDynDiffusionCoefficient;
}

inline void G4MolecularConfiguration::SetDecayTime(G4double dynDecayTime)
{
    fDynDecayTime = dynDecayTime;
}

inline G4double G4MolecularConfiguration::GetDecayTime() const
{
    return fDynDecayTime;
}

inline void G4MolecularConfiguration::SetVanDerVaalsRadius(G4double dynVanDerVaalsRadius)
{
    fDynVanDerVaalsRadius = dynVanDerVaalsRadius ;
}

inline G4double G4MolecularConfiguration::GetVanDerVaalsRadius() const
{
    return fDynVanDerVaalsRadius;
}

inline G4int G4MolecularConfiguration::GetCharge() const
{
    return fDynCharge ;
}

inline void G4MolecularConfiguration::SetMass(G4double aMass)
{
    fDynMass = aMass ;
}

inline G4double G4MolecularConfiguration::GetMass() const
{
    return fDynMass;
}
#endif