EGSnrc C++ class library
Report PIRS-898 (2021)
Iwan Kawrakow, Ernesto Mainegra-Hing, Frederic Tessier, Reid Townson and Blake Walters
|
A point source. More...
#include <egs_point_source.h>
Public Member Functions | |
EGS_PointSource (int Q, EGS_BaseSpectrum *Spec, const EGS_Vector &Xo, const string &Name="", EGS_ObjectFactory *f=0) | |
Constructor. More... | |
EGS_PointSource (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 () |
Sets up the source type and description. | |
Protected Member Functions inherited from EGS_BaseSimpleSource | |
virtual void | setLatch (int &latch) |
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... | |
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. | |
A point source.
A point source is a special case of an isotropic source . The only reasons it is provided as a separate source is that, being a very simple source, it was implemented first to test the framework of dynamically loading particle sources and that its definition is slightly simpler than the definition of an isotropic source:
:start source: library = egs_point_source name = some_name position = Px, Py, Pz :start spectrum: definition of the spectrum :stop spectrum: charge = -1 or 0 or 1 for electrons or photons or positrons :stop source:
A simple example:
:start source definition: :start source: library = egs_point_source name = my_source position = 0 0 0 :start spectrum: type = monoenergetic energy = 1 :stop spectrum: charge = 0 :stop source: simulation source = my_source :stop source definition:
Definition at line 110 of file egs_point_source.h.
EGS_PointSource::EGS_PointSource | ( | int | Q, |
EGS_BaseSpectrum * | Spec, | ||
const EGS_Vector & | Xo, | ||
const string & | Name = "" , |
||
EGS_ObjectFactory * | f = 0 |
||
) |
Constructor.
Construct a point source with charge Q, spectrum Spec and position Xo. The source object takes ownership of the spectrum.
Definition at line 122 of file egs_point_source.h.
EGS_PointSource::EGS_PointSource | ( | EGS_Input * | input, |
EGS_ObjectFactory * | f = 0 |
||
) |
Constructor.
Construct a point source from the information pointed to by inp.
Definition at line 40 of file egs_point_source.cpp.
References egsWarning, EGS_Input::getInput(), and setUp().