Belle2::ParticleCopy Namespace Reference

Functions that create copies of Particles. More...

Functions
Particle *	copyParticle (const Particle *original)
	Function takes argument Particle and creates a copy of it and copies of all its (grand-)^n-daughters.
void	copyDaughters (Particle *mother)
	Function copies all (grand-)^n-daughter particles of the argument mother Particle.

Detailed Description

Functions that create copies of Particles.

Functions take existing Particle and create its copy ((grand)^n-daughter particles are copied as well).

Function Documentation

copyDaughters()

void copyDaughters

(

Belle2::Particle *

mother

)

Function copies all (grand-)^n-daughter particles of the argument mother Particle.

The copied particles are stored in the same StoreArray as the mother Particle and its original daughters. The indices of daughter particles in the mother Particle are replaced with the indices of copied daughter particles. The existing relations of the original daughter Particles are copied as well. Note that only the relation is copied and that the related object is not. Copy is related to the same object as the original one.

Parameters

mother

pointer to the mother Particle whose daughters are to be copied

Definition at line 56 of file ParticleCopy.cc.

{
  // If the particle has undergone Bremsstrahlung correction, removing its
  // daughters (the original lepton and potential photons) and then appending
  // the copied versions should not change its source type.
  // Or, if the particle's source is V0, it should be kept as V0 rather than changing to Composite.
  bool updateType = true;
  if (mother->hasExtraInfo("bremsCorrected") ||
      mother->getParticleSource() == Particle::EParticleSourceObject::c_V0)
    updateType = false;
 
  unsigned nDaughters = mother->getNDaughters();
  for (unsigned iOld_neverUsed = 0; iOld_neverUsed < nDaughters; iOld_neverUsed++) {
    // always accessing the first daughter of mother that is being updated
    const Particle* originalDaughter = mother->getDaughter(0);
    Particle* daughterCopy = copyParticle(originalDaughter);
 
    // remove original daughter from the beginning of the daughters' vector
    mother->removeDaughter(originalDaughter, updateType);
    // append copied daughter instead at the end of the daughters' vector
    mother->appendDaughter(daughterCopy, updateType);
  }
}

copyParticle()

Particle * copyParticle

(

const Particle *

original

)

Function takes argument Particle and creates a copy of it and copies of all its (grand-)^n-daughters.

The existing relations of the original Particle are copied as well. Note that only the relation is copied and that the related object is not. Copy is related to the same object as the original one.

Created copies are stored in the same StoreArray as the original Particle.

Parameters

original

pointer to the original Particle to be copied

Returns

returns pointer to the copied Particle

Definition at line 18 of file ParticleCopy.cc.

{
  StoreArray<Particle> array(original->getArrayName());
 
  // make a copy of a particle
  Particle* copy = array.appendNew(*original);
  copy->copyRelations(original);
  copy->writeExtraInfo("original_index", original->getArrayIndex());
 
  // Copy its daughters as well.
  // At this stage the copy of the particle
  // internally stores daughter indices of original.
  // Copy daughters as well.
  unsigned nDaughters = original->getNDaughters();
 
  // If the particle has undergone Bremsstrahlung correction, removing its
  // daughters (the original lepton and potential photons) and then appending
  // the copied versions should not change its source type.
  // Or, if the particle's source is V0, it should be kept as V0 rather than changing to Composite.
  bool updateType = true;
  if (copy->hasExtraInfo("bremsCorrected") ||
      copy->getParticleSource() == Particle::EParticleSourceObject::c_V0)
    updateType = false;
 
  for (unsigned iOld = 0; iOld < nDaughters; iOld++) {
    const Particle* originalDaughter = original->getDaughter(iOld);
 
    Particle* daughterCopy = copyParticle(originalDaughter);
 
    // remove original daughter
    copy->removeDaughter(originalDaughter, updateType);
    // append copied daughter instead
    copy->appendDaughter(daughterCopy, updateType);
  }
 
  return copy;
}