DosiVox (version 1.0) is a free software (GNU GPL3 licence, see above) based on the Geant4 C++ libraries (Agostinelli et al., 2003; Allison et al., 2006; Allison et al., 2016) and responding to the Geant4 Software Licence (version Geant4 10.1). It is developed by L. Martin, N. Mercier and S. Incerti at the IRAMAT-CRP2A[1] and the CENBG[2]. DosiVox allows constructing voxelised models of archeological objects and simulating the radioactivity for dose calculation with a Monte-Carlo approach (Martin et al., 2015a; Martin et al., 2015b; Martin 2015). These dose calculations can be used in the context of trapped charge dating. DosiVox use Pilot Text Files (PTF) to set the simulation geometry and parameters, allowing to create simulation by writing or editing a text file -> no skill in programming nor in Geant4 are required.
DosiVox runs on Linux system and was developped on a Scientific Linux (Red Hat) virtual machine available at http://geant4.in2p3.fr/spip.php?rubrique8. As explained in Martin (2015): the alpha particle specta (Uapha, Thalpha) are constructed from the NIST online database (version 5.0.0, october 2012; Kramida et al., 2018); the beta particle spectra (Ubeta, Thbeta, Kbeta) and the gamma particle spectra (Ugamma, Thgamma) are based on the data from the NNDC (Brookhaven National Laboratory, USA http://www.nndc.bnl.gov) online database NuDat (version november 2009). In addition, the K gamma spectra (Kgamma) is constructed from NNDC online database NuDat (version january 2013; Kinsey et al., 1996).
You can download the software as a zip from from this URL.
To download the package source as you see it on GitHub, for offline browsing, use this line at the shell prompt (assuming you have Git installed on your computer):
git clone https://github.com/crp2a/DosiVox.git
Extract the archive your home folder. In a Windows or OS-X operating system, run the Scientific Linux virtual machine and extract the archive in the virtual machine Home folder. More explanations are available in the DosiVox Installation Guide.
Modify any PTF present in the DosiVox/data folder respecting the layout of the file. The texts after the "#" symbol are comments describing the data of the line. All data must be separated by at least a space. Do not add supplementary line unless it corresponds to data in agreement with the PTF layout. detailed explanations are available in the DosiVox Manual.
Open a terminal localized in the DosiVox/
folder. Detailed explanations are available in the DosiVox Manual.
Run DosiVox without visualization:
build/DosiVox
Run the basic visualization toolt of DosiVox:
build/DosiVox vis.mac
Run the visualization of DosiVox tool with the detectors displaying:
build/DosiVox visdet.mac
WARNING: the displaying of detectors composed of lot of geometrical elements can be costful for the computer ressources
Use Ctrl + C
to abort the running simulation.
Run the simulation in the visualization tool:
control/execute 1run.mac
WARNING: in order to avoid an over-consumption of the computer ressources, the run under the visualization tool are limited to 1000 particles emitted
Exit the visualization tool (it will exit the DosiVox session too):
exit
To move the displayed model, use the mouse left and scroll buttons on the display window, and the keyboard arrows.
Results of simulations are written as text files in the DosiVox/results folder with the prefix defined in the corresponding PTF. Suffixes corresponding to the detector and data type are added to the results files:
_error
for the listing of the killed particles,_probe
for the recording of the probe detector,_detectorN
for the N detector (N=1-> sub-voxelised, N=2-> single grain packing, N=3-> successive grain packings),_grains
for the dose for each grain for the detector 2 or 3. For the detector 1, a 3D mapping is written as text file in theDosiVox/results/DoseMapping
folder.
These results text files can be open with common spreadsheets. Detailed explanations are available in the DosiVox DosiVox Manual.
Some example of PTF are provided with DosiVox, in the DosiVox/data
folder:
XPL0
creates two voxels filled respectively by clay and quartz. It simulates the alpha radioactivity of the U-series in the clay, allowing to record the dose attenuation in the quartz with the probe detector.XPL1
is a PTF for creating a simple voxelisation as a 3 x 3 x 3 grid and only the probe detector. beta particles of the U-series are simulated.XPL1bis
creates a similar model thanXPL1
, but with a 20 x 20 x 20 grid.XPL2
creates a 20 x 20 20 voxels model with water, air and sediment type materials, for simulation of gamma particles. Only the probe detector is definedXPL3
defines a single random packing of grains as detector in a 20 x 20 x 20 grid, in addition to the probe detector. Beta particles of the Th-series are simulated.XPL3bis
uses the same configuration asXPL3
but creating successive random packings of grains as detectors.XPL4
defines a sub-voxelisation of 20 x 20 x 20 as detector in a voxel of the main 20 x 20 x 20 grid. Alpha particles of the U-series are simulated in this model.XPL5
used the sub-voxelised detector to model a flint in a 120 x 250 x 101 sub-voxels grid. Beta particles of the U-series are simulated, and only the doses in the sub-voxels representing the flint are mapped.
Detailed explanations are available in the DosiVox Manual.
Agostinelli et al., 2003. Geant4—a simulation toolkit. Nuclear Instruments and Methods in Physics Research Section A: Accelerators, Spectrometers, Detectors and Associated Equipment, 506. https://doi.org/10.1016/S0168-9002(03)01368-8
Allison et al., 2006. Geant4 developments and applications. IEEE Transactions on Nuclear Science 53. https://doi.org/10.1109/TNS.2006.869826
Allison, J., et al., 2016. Recent developments in Geant4. Nuclear Instruments and Methods in Physics Research Section A: Accelerators, Spectrometers, Detectors and Associated Equipment 835, 186-225. https://doi.org/10.1016/j.nima.2016.06.125
Martin, L., Incerti, S., Mercier, N., 2015a. DosiVox : Implementing Geant 4-based software for dosimetry simulations relevant to luminescence and ESR dating techniques. Ancient TL, 33(1). http://ancienttl.org/ATL_33-1_2015/ATL_33-1_Martin_p1-10.pdf
Martin, L., Mercier, N., Incerti, S., Lefrais, Y., Pecheyran, C., Guerin, G., Jarry, M., Bruxelles, L., Bon, F., Pallier C., 2015b. Dosimetric study of sediments at the Beta dose rate scale: characterization and modelization with the DosiVox software. Radiation Measurement, 81, 134-141. https://doi.org/10.1016/j.radmeas.2015.02.008
Kinsey, R. R., Dunford, C. L., Tuli, J. K., Burrows, T. W., 1996. The NUDAT/PCNUDAT Program for Nuclear Data. 9th International Symposium of Capture Gamma-Ray Spectroscopy and Related Topics (Budapest, Hungary; October 1996). Data extracted from the NUDATdatabase, version nov 2009 and janv 2013 https://www.nndc.bnl.gov/nudat2/reCenter.jsp?z=50&n=63
Kramida, A., Ralchenko, Yu., Reader, J., NIST ASD Team, 2018. NIST Atomic Spectra Database (version 5.0.0) https://physics.nist.gov/asd [Nov 2012]. National Institute of Standards and Technology, Gaithersburg, MD. https://doi.org/10.18434/T4W30F
Martin, L., 2015. Caractérisation et modélisation d'objets archéologiques en vue de leur datation par des méthodes paléo-dosimétriques : simulation des paramètres dosimétriques sous Geant4. Thèse de doctorat en Physique des archéomatériaux. Pessac: Université Bordeaux-Montaigne, 304p. http://www.theses.fr/2015BOR30055
Rasband, W. S., 1997-2012. ImageJ, U.S. National Institutes of Health, Bethesda, Maryland, USA. https://imagej.nih.gov/ij/
Schneider, C. A., Rasband, W. S., Eliceiri, K. W., 2012. NIH Image to ImageJ: 25 years of image analysis. Nature Methods, 671. https://doi.org/10.1038/nmeth.2089
DosiVox is provided under the terms and conditions of the DosiVox Software License (GNU GPL3).
Neither the authors of this software system, nor their employing institutes, nor the agencies providing financial support for this work make any representation or warranty, express or implied, regarding this software system or assume any liability for its use. Please see the LICENSE file for the full disclaimer and the limitation of liability.
By using, copying, modifying or distributing the software (or any work based on the software) you agree to acknowledge its use in resulting acceptance of all terms of the DosiVox Software license.
- Institut de Recherche sur les ArchéoMATériaux - Centre de Recherche en Physique Appliquée à l'Archéologie http://www.iramat-crp2a.cnrs.fr
- Centre d'Etudes Nucléaires de Bordeaux Gradignan http://www.cenbg.in2p3.fr