---

ParticlePropertySvc.h

Go to the documentation of this file.

// $Header: /nfs/slac/g/glast/ground/cvs/GaudiSvc/src/ParticlePropertySvc/ParticlePropertySvc.h,v 1.1.1.2 2001/04/18 18:32:50 tlindner Exp $
#ifndef PARTICLEPROPERTYSVC_PARTICLEPROPERTYSVC_H
#define PARTICLEPROPERTYSVC_PARTICLEPROPERTYSVC_H

// Include Files
#include "GaudiKernel/Service.h"
#include "GaudiKernel/IParticlePropertySvc.h"

// Forward declarations
template <class TYPE> class SvcFactory;

//------------------------------------------------------------------
//
// ClassName:   ParticlePropertySvc
//  
// Description: This service provides access to particle properties.
//              The settable property of this service is the 
//              ParticlePropertiesFile, an ASCII file containing the 
//              list of properties for the particles.
//              The default file is: 
//                $LHCBDBASE/cdf/particle.cdf
//              or if $LHCBDBASE is not defined
//                particle.cdf
//
// Author:      Iain Last
// Changes:     G.Corti 8/11/1999 : change default file from
//              $CDF/particle.cdf to $LHCBDBASE/cdf/particle.cdf on Unix 
//              and use environment variable also on WinNT
//              Also introduce finding of particle by StdHepID
//
//------------------------------------------------------------------

class ParticlePropertySvc : public Service, virtual public IParticlePropertySvc {

public:  
  // typedefs for container type
  typedef ParticleProperty* mapped_type;
  typedef std::map< int, mapped_type, std::less<int> > MapID;
  typedef std::map< std::string, mapped_type, std::less<std::string> > MapName;
  typedef std::map< int, mapped_type, std::less<int> > MapStdHepID;
  typedef IParticlePropertySvc::VectPP VectPP;
  typedef IParticlePropertySvc::const_iterator const_iterator;
  typedef IParticlePropertySvc::iterator iterator;

  // Inherited Service overrides:
  // Initialise the service.
  virtual StatusCode initialize();
  
  // Finalise the service.
  virtual StatusCode finalize();
  
  // Query the interfaces.
  //   Input: riid, Requested interface ID
  //          ppvInterface, Pointer to requested interface
  //   Return: StatusCode indicating SUCCESS or FAILURE.
  // N.B. Don't forget to release the interface after use!!!
  virtual StatusCode queryInterface( const IID& riid, void** ppvInterface );
  
  // Service type.
  virtual const IID& type() const;
  
  // IParticlePropertySvc interface overrides:
  // Create a new particle property.
  //   Input: particle, String name of the particle.
  //          geantId, Geant3 ID of the particle.
  //          jetsetId, Jetset ID of the particle.
  //          type, Geant3 particle tracking type.
  //          charge, Particle charge (/e).
  //          mass, Particle mass (GeV).
  //          tlife, Particle lifetime (s).   
  //   Return: StatusCode - SUCCESS if the particle property was added.
  virtual StatusCode push_back( const std::string& particle,
                                int geantId, int jetsetId, int type, 
                                double charge, double mass, double tlife );
  
  // Create a new particle property.
  //   Input: pp, a particle property class.
  //   Return: StatusCode - SUCCESS if the particle property was added.
  virtual StatusCode push_back( ParticleProperty* pp );
  
  // Get a const reference to the begining of the container.
  virtual const_iterator begin() const;

  // Get a const reference to the end of the container.
  virtual const_iterator end() const;  

  // Get the container size.
  virtual int size() const;

  // Retrieve a property by geant3 id.
  virtual ParticleProperty* find( int geantId );

  // Retrieve a property by particle name.
  virtual ParticleProperty* find( const std::string& name );

  // Retrieve a property by StdHep id
  virtual ParticleProperty* findByStdHepID( int stdHepId );

  // Erase a property by geant3 id.
  virtual StatusCode erase( int geantId );

  // Erase a property by particle name.
  virtual StatusCode erase( const std::string& name );

  // Erase a property by StdHep id ???
  virtual StatusCode eraseByStdHepID( int stdHepId );

protected:
  
  // Standard Constructor.
  //   Input:  name   String with service name
  //   Input:  svc    Pointer to service locator interface
  ParticlePropertySvc( const std::string& name, ISvcLocator* svc );
  
  // Destructor.
  virtual ~ParticlePropertySvc();

private:
  // Allow SvcFactory to instantiate the service.
  friend class SvcFactory<ParticlePropertySvc>;
  
  // Text file parsing routine. 
  StatusCode parseFile();       
  
  std::string m_filename;        // Filename of the particle properties file  
  VectPP      m_vectpp;          // Vector of all particle properties
  MapID       m_idmap;           // Map for geant IDs
  MapName     m_namemap;         // Map for particle names
  MapStdHepID m_stdhepidmap;     // Map for StdHep Ids
};

#endif

---