This version, which has been integrated into the SPENVIS web-site, allows the user to execute MULASSIS remotely without the need to install Geant4 and the MULASSIS code on his/her local computer. However, users preferring a local version of this tool can download the source code from the ESA European Space Software Repository[1] website.
The latest version of MULASSIS installed in SPENVIS is v1.23 compiled with geant4-09-05-patch-02.
Users can go to any particular input page and enter their settings. After they are done, they can hit the button and return to the main model page. Once they are satisfied with all their input they can use the button to generate the macro file. Pressing the button will start the calculation and bring up the results page.
As the model uses a Monte-Carlo simulation-based code, execution times can be very long. In order to guarantee the consistency between the different models available in the SPENVIS system (e.g. particle spectrum vs. total ionising dose), the user project is 'blocked' while running the multi-layered shielding simulation, but navigation remains possible. The execution is limited to ten minutes of CPU-time on the simulation machine. If the MULASSIS run exceeds this limit, the simulation will be terminated and intermediate results returned to the user.
The default geometry is a single planar slab geometry with 26 layers (the boundaries are equivalent to the default SHIELDOSE thicknesses, but the geometry as a whole isn't). The material for the default geometry is Aluminium.
When a user defined geometry is chosen, the page includes a table with the choice of a planar slabspherical geometry, and the number of layers to use. The next lines of the table are created dynamically, depending on the number of layers. For each layer, the user can define the material to use, the thickness (with units), and the colour to use in the graphical representation. For the material, there are four defaults defined: Vacuum, Air, Aluminium and Silicon. Pressing the button in the header of the table opens the material definition page and allows the user to choose other materials or define new materials.
The next option is to get some graphical representation of the chosen geometry. This can be made in two formats, i.e. PostScript or VRML (available only if number of layers is less than ten), with or without particle tracks. Note that no particle tracks would be represented in the graphics file if more than hundred primary particles are requested for the simulation.
Users can employ the material definition tool to either specify their own material or make use of the predefined lists.
This information is recorded in a separated macro file (GPS macro file) that is executed inside the MULASSIS main macro.
More recently, a new Geant4 physics list QBBC has been created dedicated for space applications, radiation biology and radiation protection. It includes combinations of BIC, BIC-Ion, BERT, CHIPS, QGSP and FTFP models and has higher precision than the others for many hadron-ion and ion-ion interactions in a wide energy range [Ivantchenko et al., 2012].
Based on the user’s selection for the incident particle, SPENVIS automatically selects the appropriate physics scenario. For pure EM interactions (e.g. incident gamma or electron) the Geant4 Option 3 (emstandard_opt3) is used. This standard EM physics list is optimised for medical and space applications. Otherwise, the physics list QBBC is used to simulate additional hadronic interactions. Finally, note that for geantinos no physics scenario is required.
The general principles in Geant4 regarding secondary particle production cuts are the following:
More specifically in MULASSIS one can group the shield layers into different regions and apply different cuts to each region. Again, region cuts-in-range can be defined as a single cut for gamma, electron and positron productions, or different cuts for each type of the three particles. In addition the user can group the GDML geometry volumes into different regions and apply different cuts to each region.
Note that the default is no region cuts-in-range and the default values for the global cuts-in-range length is 1 µm.
where n1 and n2 are calculated by the SPENVIS Geant4 “source particles tool” and recorded in the generated macro file (NORM_FACTOR_SPECTRUM and NORM_FACTOR_ANGULAR aliases in the GPS macro file).
Finally, when the geometry refers to a spherical shell the normalisation factor requires an additional term in order to take into consideration the integration over the surface of the source sphere. In other words, one needs to divide the above formula by a factor of 4πR2.
The user can make only one analysis at a time. For more analyses new runs are needed.
The report file spenvis_mlr.txt contains details of the inputs and outputs. The log file spenvis_mlp.txt records the output from MULASSIS to stdout and stderr. The output file spenvis_mlo.txt containing tabulated results (fluence, NID, dose or PHS) for the selected analysis. The graphics files spenvis_ml.wrl and spenvis_ml.eps show the 3D geometry or the shield cross section.
spenvis_mlr.txt
spenvis_mlp.txt
spenvis_mlo.txt
spenvis_ml.wrl
spenvis_ml.eps
spenvis_mul.wrl
spenvis_mul.eps
To generate plots, select the plot type(s), options and graphics format, and click the button. The current page will be updated with the newly generated plot files.