Changeset 572 in svn for trunk/Utilities/HepMC/interface/GenParticle.h

Timestamp:

Nov 2, 2011, 5:39:26 PM (13 years ago)

Author:

cp3-support

Message:

upgrade HepMC to version 2.06.05

File:

• trunk/Utilities/HepMC/interface/GenParticle.h (modified) (4 diffs)

trunk/Utilities/HepMC/interface/GenParticle.h

@@ -30 +30 @@
 #include "Polarization.h"
 #include "SimpleVector.h"
+#include "IteratorRange.h"
 #include <iostream>
 #ifdef _WIN32
@@ -43 +44 @@
     class GenEvent; 
 
+    class GenParticleProductionRange;
+    class ConstGenParticleProductionRange;
+    class GenParticleEndRange;
+    class ConstGenParticleEndRange;
 
     //! The GenParticle class contains information about generated particles
@@ -119 +124 @@
         ///
         /// The barcode is the particle's reference number, every vertex in the
-        ///  event has a unique barcode. Particle barcodes are positive numbers,
-        ///  vertex barcodes are negative numbers.
+        /// event has a unique barcode. Particle barcodes are positive numbers,
+        /// vertex barcodes are negative numbers.
+        /// 
+        /// Please note that the barcodes are intended for internal use within 
+        /// HepMC as a unique identifier for the particles and vertices.
+        /// Using the barcode to encode extra information is an abuse of 
+        /// the barcode data member and causes confusion among users. 
+        /// 
         int                  barcode() const; //!< particle barcode
+        
+        /// Convenience method.  Returns true if status==1
+        bool                 is_undecayed() const;
+        /// Convenience method.  Returns true if status==2
+        bool                 has_decayed() const;
+        /// Convenience method.  Returns true if status==4
+        /// Note that using status 4 for beam particles is a new convention which
+        /// may not have been implemented by the code originating this GenEvent.
+        bool                 is_beam() const;
+
+        /// incoming particle range
+        GenParticleProductionRange particles_in( IteratorRange range = relatives );
+        /// incoming particle range
+        ConstGenParticleProductionRange particles_in( IteratorRange range = relatives ) const;
+        /// outgoing particle range
+        GenParticleEndRange particles_out( IteratorRange range = relatives );
+        /// outgoing particle range
+        ConstGenParticleEndRange particles_out( IteratorRange range = relatives ) const;
 
         /////////////////////
@@ -225 +254 @@
     inline void GenParticle::set_barcode_( int bc ) { m_barcode = bc; }
 
+    inline bool GenParticle::is_undecayed() const {
+        return ( m_status==1 ) ?  true : false;
+    }
+    inline bool GenParticle::has_decayed() const {
+        return ( m_status==2 ) ?  true : false;
+    }
+    inline bool GenParticle::is_beam() const {
+        return ( m_status==4 ) ?  true : false;
+    }
+
 } // HepMC