Tracker.h

Go to the documentation of this file.

//
// Class Tracker
//  Track particles or bunches.
//  An abstract base class for all visitors capable of tracking particles
//  through a beam element.
//  [P]
//  Phase space coordinates (in this order):
//  [DL]
//  [DT]x:[DD]
//    horizontal displacement (metres).
//  [DT]p_x/p_r:[DD]
//     horizontal canonical momentum (no dimension).
//  [DT]y:[DD]
//    vertical displacement (metres).
//  [DT]p_y/p_r:[DD]
//    vertical canonical momentum (no dimension).
//  [DT]delta_p/p_r:[DD]
//    relative momentum error (no dimension).
//  [DT]v*delta_t:[DD]
//    time difference delta_t w.r.t. the reference frame which moves with
//    uniform velocity
//  [P]
//    v_r = c*beta_r = p_r/m
//  [P]
//    along the design orbit, multiplied by the instantaneous velocity v of
//    the particle (metres).
//  [/DL]
//  Where
//  [DL]
//  [DT]p_r:[DD]
//    is the constant reference momentum defining the reference frame velocity.
//  [DT]m:[DD]
//    is the rest mass of the particles.
//  [/DL]
//  Other units used:
//  [DL]
//  [DT]reference momentum:[DD]
//    electron-volts.
//  [DT]accelerating voltage:[DD]
//    volts.
//  [DT]separator voltage:[DD]
//    volts.
//  [DT]frequencies:[DD]
//    hertz.
//  [DT]phase lags:[DD]
//    multiples of (2*pi).
//  [/DL]
//
// Copyright (c) 200x - 2020, Paul Scherrer Institut, Villigen PSI, Switzerland
// All rights reserved
//
// This file is part of OPAL.
//
// OPAL is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// You should have received a copy of the GNU General Public License
// along with OPAL. If not, see <https://www.gnu.org/licenses/>.
//
#ifndef CLASSIC_Tracker_HH
#define CLASSIC_Tracker_HH
 
#include "Algorithms/AbstractTracker.h"
#include "PartBunch/PartBunch.h"
#include "Algorithms/PartData.h"
 
#include "Utilities/ClassicField.h"
 
class BMultipoleField;
class Euclid3D;
class OpalParticle;
 
class Tracker : public AbstractTracker {
public:
    //  The beam line to be tracked is [b]bl[/b].
    //  The particle reference data are taken from [b]data[/b].
    //  The particle bunch is initially empty.
    //  If [b]backBeam[/b] is true, the beam runs from s = C to s = 0.
    //  If [b]backTrack[/b] is true, we track against the beam.
    Tracker(const Beamline&, const PartData&, bool backBeam, bool backTrack);

    //  The beam line to be tracked is [b]bl[/b].
    //  The particle reference data are taken from [b]data[/b].
    //  The particle bunch is taken from [b]bunch[/b].
    //  If [b]backBeam[/b] is true, the beam runs from s = C to s = 0.
    //  If [b]backTrack[/b] is true, we track against the beam.
    Tracker(const Beamline&, PartBunch_t* bunch, const PartData&, bool backBeam, bool backTrack);
 
    virtual ~Tracker();

    const PartBunch_t* getBunch() const;

    void addToBunch(const OpalParticle&);

    //~ void setBunch(const PartBunch &);

    //  This override calls the component to track the bunch.
    virtual void visitComponent(const Component&);

    virtual void setNumBunch(short){};

    virtual short getNumBunch() {
        return 0;
    }
 
    // standing wave structures
    FieldList cavities_m;
 
    const Beamline& itsBeamline_m;
 
protected:
    PartBunch_t* itsBunch_m;
    //  typedef PartBunch::iterator iterator;
 
private:
    // Not implemented.
    Tracker();
    Tracker(const Tracker&);
    void operator=(const Tracker&);
};
 
#endif  // CLASSIC_Tracker_HH