EGSnrc C++ class library
Report PIRS-898 (2021)
Iwan Kawrakow, Ernesto Mainegra-Hing, Frederic Tessier, Reid Townson and Blake Walters
|
A parallel beam. More...
#include <egs_parallel_beam.h>
Public Member Functions | |
EGS_ParallelBeam (int Q, EGS_BaseSpectrum *Spec, EGS_BaseShape *Shape, const string &Name="", EGS_ObjectFactory *f=0) | |
Constructor. More... | |
EGS_ParallelBeam (EGS_Input *, EGS_ObjectFactory *f=0) | |
Constructor. More... | |
void | getPositionDirection (EGS_RandomGenerator *rndm, EGS_Vector &x, EGS_Vector &u, EGS_Float &wt) |
EGS_Float | getFluence () const |
bool | storeFluenceState (ostream &) const |
bool | setFluenceState (istream &) |
bool | isValid () const |
Public Member Functions inherited from EGS_BaseSimpleSource | |
EGS_BaseSimpleSource (int Q, EGS_BaseSpectrum *Spec, const string &Name="", EGS_ObjectFactory *f=0) | |
Constructor. More... | |
EGS_BaseSimpleSource (EGS_Input *input, EGS_ObjectFactory *f=0) | |
Construct a 'simple' particle source from the information pointed to by input. More... | |
~EGS_BaseSimpleSource () | |
Destructor. More... | |
virtual EGS_I64 | getNextParticle (EGS_RandomGenerator *rndm, int &Q, int &latch, EGS_Float &E, EGS_Float &wt, EGS_Vector &x, EGS_Vector &u) |
Sample the next source particle from the source probability distribution. More... | |
virtual EGS_Float | getEmax () const |
Get the maximum energy of the source. More... | |
int | getCharge () const |
Get the charge of the source. More... | |
virtual bool | storeState (ostream &data_out) const |
Store the source state to the data stream data_out. More... | |
virtual bool | addState (istream &data) |
Add the source state from the stream data to the current state. More... | |
virtual void | resetCounter () |
Reset the source to a state with zero sampled particles. More... | |
virtual bool | addFluenceData (istream &data) |
Add fluence data from the stream data to the current state. More... | |
virtual void | resetFluenceCounter () |
Reset the data related to the sampling of positions and directions to a state with zero sampled particles. More... | |
virtual bool | setState (istream &data) |
Set the source state according to the data in the stream data. More... | |
Public Member Functions inherited from EGS_BaseSource | |
EGS_BaseSource (const string &Name="", EGS_ObjectFactory *f=0) | |
Construct a source named Name. More... | |
EGS_BaseSource (EGS_Input *input, EGS_ObjectFactory *f=0) | |
Construct a source from the input pointed to by inp. More... | |
const char * | getSourceDescription () const |
Get a short description of this source. More... | |
virtual void | setSimulationChunk (EGS_I64 nstart, EGS_I64 nrun) |
Set the next simulation chunk to start at nstart and to consist of nrun particles. More... | |
virtual EGS_Float | getMu () |
Public Member Functions inherited from EGS_Object | |
EGS_Object (const string &Name="", EGS_ObjectFactory *f=0) | |
Create an EGS_Object named Name belonging to the object factory f. More... | |
EGS_Object (EGS_Input *inp, EGS_ObjectFactory *f=0) | |
Create an EGS_Object from the information pointed to by inp that belongs to object factory f. More... | |
const string & | getObjectName () const |
Get the object name. | |
void | setObjectName (const string &Name) |
Set the object name to Name. | |
const string & | getObjectType () const |
Get the object type. | |
virtual EGS_Object * | createObject (EGS_Input *inp) |
Create an object from the infromation pointed to by inp. More... | |
void | setName (EGS_Input *inp) |
Set the name of the object from the information provided by inp. More... | |
int | ref () |
Increase the reference count to this object. | |
int | deref () |
Decrease the reference count to this object. | |
void | setFactory (EGS_ObjectFactory *f) |
Set the factory to which the object belongs. More... | |
Protected Member Functions | |
void | setUp () |
Protected Member Functions inherited from EGS_BaseSimpleSource | |
virtual void | setLatch (int &latch) |
Protected Attributes | |
EGS_BaseShape * | shape |
The shape. | |
EGS_Vector | uo |
The direction of the particles. | |
Protected Attributes inherited from EGS_BaseSimpleSource | |
int | q |
The charge of this simple source. | |
EGS_BaseSpectrum * | s |
The energy spectrum of this source. | |
string | type |
A short description of the source type. | |
EGS_I64 | count |
Number of statistically independent particles delivered so far. | |
Protected Attributes inherited from EGS_BaseSource | |
string | description |
A short source description. More... | |
Protected Attributes inherited from EGS_Object | |
string | name |
The object name. | |
string | otype |
The object type. | |
int | nref |
Number of references to the object. | |
EGS_ObjectFactory * | factory |
The factory this object belongs to. | |
Additional Inherited Members | |
Static Public Member Functions inherited from EGS_BaseSource | |
static EGS_BaseSource * | createSource (EGS_Input *) |
Create sources from the information pointed to by input. More... | |
static EGS_BaseSource * | getSource (const string &Name) |
Get a pointer to the source named Name. More... | |
static void | addKnownSource (EGS_BaseSource *o) |
Add a known source object to the source factory. More... | |
static void | addKnownTypeId (const char *name) |
Add a known source object typeid to the source factory. More... | |
Static Public Member Functions inherited from EGS_Object | |
static string | getUniqueName (const EGS_Object *o=0) |
Create and return a unique object name. More... | |
static void | deleteObject (EGS_Object *o) |
Delete an object. More... | |
A parallel beam.
A parallel beam is a source that delivers particles all having the same direction with a position within any shape. Although planar shapes would make more sense for a parallel beam, due to the abstract nature of shapes, any shape can be used. A parallel beam is defined as follows:
:start source: library = egs_parallel_beam name = some_name :start shape: definition of the shape :stop shape: :start spectrum: definition of the spectrum :stop spectrum: direction = Ux Uy Uz charge = -1 or 0 or 1 for electrons or photons or positrons :stop source:
It is worth noting that the functionality of sources 0, 2, 10 and 13 from the RZ series of user codes and sources 0 and 1 in DOSXYZnrc can be reproduced with the parallel beam source from the EGSnrc C++ class library.
A simple example:
:start source definition: :start source: library = egs_parallel_beam name = my_source :start shape: type = cylinder radius = 1 height = 2 axis = 0 0 1 midpoint = 0 :stop shape: direction = 0 0 1 charge = 0 :start spectrum: type = monoenergetic energy = 6 :stop spectrum: :stop source: simulation source = my_source :stop source definition:
Definition at line 125 of file egs_parallel_beam.h.
EGS_ParallelBeam::EGS_ParallelBeam | ( | int | Q, |
EGS_BaseSpectrum * | Spec, | ||
EGS_BaseShape * | Shape, | ||
const string & | Name = "" , |
||
EGS_ObjectFactory * | f = 0 |
||
) |
Constructor.
Construct a parallel beam with charge Q and spectrum Spec from a shape Shape
Definition at line 135 of file egs_parallel_beam.h.
EGS_ParallelBeam::EGS_ParallelBeam | ( | EGS_Input * | input, |
EGS_ObjectFactory * | f = 0 |
||
) |
Constructor.
Construct a parallel beam from the information pointed to by inp.
Definition at line 40 of file egs_parallel_beam.cpp.
References EGS_BaseShape::createShape(), egsWarning, epsilon, EGS_Input::getInput(), EGS_BaseShape::getShape(), shape, EGS_Input::takeInputItem(), uo, EGS_Vector::x, EGS_Vector::y, and EGS_Vector::z.