The examples shown here suppose that TRAX
has correctly been setup, in particular the necessary environment variables
(such as
$TRAX) point to the correct locations.
Also known as depth dose distribution.
Run
exec $TRAX/TUTOR/evaladose.exec
or
exec $TRAX/TUTOR/evaladose.exec '/tmp/'
The second example will place the output files in the /tmp
directory.
Also known as y-distribution and z-distribution.
Run
exec $TRAX/TUTOR/evalmdose.exec
or
exec $TRAX/TUTOR/evalmdose.exec '/tmp/'
The second example will place the output files in the /tmp
directory.
Run
exec $TRAX/TUTOR/evalout.exec
or
exec $TRAX/TUTOR/evalout.exec '/tmp/'
The second example will place the output files in the /tmp
directory.
A simple case:
exec $TRAX/TUTOR/dboxy.exec '' noxy '' '' e- 999 1000 0
This will calculate the development of radicals after the passage of a 999 keV electron,
averaging 1000 primary electrons. The output will be the G-value as a function of time,
stored in a
gd-file.
Note that this a simple demo, producing a few ten thousand initial OH-radicals,
which takes a few hundred seconds to calculate.
For being statistically significant, on the order of at least 100000 initial OH-radicals will be necessary.
Run
exec $TRAX/TUTOR/evalrdose.exec
or
exec $TRAX/TUTOR/evalrdose.exec '/tmp/'
The second example will place the output files in the /tmp
directory.
Run
exec $TRAX/TUTOR/evalrzdose.exec
or
exec $TRAX/TUTOR/evalrzdose.exec '/tmp/'
The second example will place the output files in the /tmp
directory.
Example:
exec $TRAX/TUTOR/evalspheredose.exec '' keV00100 1 10000 0.10E-4
Simulates the dose distribution of 10000 electrons of 1 keV energy emitted from a point source.
Results are recorded up to 0.10E-4 cm and placed in file
evalspheredose.keV00100.gd
Run
exec $TRAX/TUTOR/evaltespc.exec
or
exec $TRAX/TUTOR/evaltespc.exec '/tmp/'
The second example will place the output files in the /tmp
directory.
This is an example for a volmode evaluation.
Running:
exec $TRAX/TUTOR/evalvolmode.exec '/tmp/' 00500 500 30
will accumlate the energy spectrum of 500 electrons of 00500E1 keV (== 5 MeV) electrons emitted
under 30 degree within a box.
Running:
exec $TRAX/TUTOR/linetrack.exec
or
exec $TRAX/TUTOR/linetrack.exec '/tmp/'
The second example will place the output files in the /tmp
directory.
Running:
exec $TRAX/TUTOR/pointtrack.exec
or
exec $TRAX/TUTOR/pointtrack.exec '/tmp/'
The second example will place the output files in the /tmp
directory.
Run
exec $TRAX/TUTOR/evalusr.exec
or
exec $TRAX/TUTOR/evalusr.exec '/tmp/' -64
The second example will build the user function in 64-bit mode and
will place the output files in the /tmp
directory.
At present reasonably well supported only for the
evalrcal command.
Two different modes are possible:
Multithreading on a single computer or independent runs distributed on a compute cluster.
Both have advantages and drawbacks.
In particular it has to be ensured that the random number sequence is unique
for each parallel run, i.e. each run starts with a different seed and the
sequences do not overlap.
- Multithreading:
In general enabled by the /threads() parameter of the respective command.
Advantage: only single versions of output files, random number partitioning handled internally.
Disadvantage: only moderate speed-up.
- Distributed runs:
Advantage:
Speed-up potentially as large as the number of machines used.
Disadvantages:
Multiple output files have to be collected and combined.
Proper handling of random number generation has to be specified by the user.
For the latter purpose, the random number sequence can be prepared via the
random/paralleljob() option
at the beginning of your simulation exec.
Example for the
evalrcal command and 4 distributed parallel jobs:
In your preferred batch system run, as separate jobs
trax-64 -s -c "exec '$TRAX/TUTOR/gmscv.exec' '' 1"
trax-64 -s -c "exec '$TRAX/TUTOR/gmscv.exec' '' 2"
trax-64 -s -c "exec '$TRAX/TUTOR/gmscv.exec' '' 3"
trax-64 -s -c "exec '$TRAX/TUTOR/gmscv.exec' '' 4"
When all jobs are done, use
trax-64 -s -c "evalrcal gmscv.pj?.pOO005.e-.keV500.run025.gvalue.gd / collect gvalue outfile(gmscv.pOO005.e-.keV500.run025.gvalue.gd)"
to combine the created partial G-value files into the final result.
Run
exec $TRAX/TUTOR/dblmd.exec
or
exec $TRAX/TUTOR/dblmd.exec '/tmp/'
The second example will place the output files in the /tmp
directory.
Last updated: M.Kraemer,
$Id: traxhowto.html,v 1.7 2026/01/20 21:53:32 kraemer Exp $