{"id":33281625,"url":"https://github.com/crp2a/dosivox","last_synced_at":"2026-03-01T02:31:54.300Z","repository":{"id":88495863,"uuid":"318498311","full_name":"crp2a/DosiVox","owner":"crp2a","description":"Dosimetric Simulations for Luminescence and ESR dating - :exclamation: This is a read-only mirror from https://gitlab.huma-num.fr/archeosciences/DosiVox","archived":false,"fork":false,"pushed_at":"2023-02-15T08:59:00.000Z","size":15217,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-17T13:08:09.895Z","etag":null,"topics":["archaeometry","dosimetry","geant4","geochronology","luminescence-dating","simulation"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crp2a.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-12-04T11:39:24.000Z","updated_at":"2025-09-29T10:46:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"fef5d76d-4026-4f2f-8c55-0c91b2d18117","html_url":"https://github.com/crp2a/DosiVox","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/crp2a/DosiVox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crp2a%2FDosiVox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crp2a%2FDosiVox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crp2a%2FDosiVox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crp2a%2FDosiVox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crp2a","download_url":"https://codeload.github.com/crp2a/DosiVox/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crp2a%2FDosiVox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29959050,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T01:47:18.291Z","status":"online","status_checked_at":"2026-03-01T02:00:07.437Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["archaeometry","dosimetry","geant4","geochronology","luminescence-dating","simulation"],"created_at":"2025-11-17T13:04:36.919Z","updated_at":"2026-03-01T02:31:54.258Z","avatar_url":"https://github.com/crp2a.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# DosiVox\n\n**DosiVox** (version 1.0) is a free software (GNU GPL-3 licence, see above) based on the [Geant4](http://geant4.org) C++ libraries (Agostinelli *et al.*, 2003; Allison *et al.*, 2006; Allison *et al.*, 2016) and responding to the [Geant4 Software Licence](http://cern.ch/geant4/license) (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 of voxelised models of archaeological 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 uses Pilot Text Files (PTF) to set the simulation geometry and parameters, allowing the creation of a simulation by writing or editing a text file -\u003e no skill in programming nor in Geant4 is required.\n\n**DosiVox** runs on a Linux system and was developed on a Scientific Linux (Red Hat) virtual machine available at \u003chttp://geant4.in2p3.fr/spip.php?rubrique8\u003e. As explained in Martin (2015): the alpha particle spectra (U_alpha, Th_alpha) 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 \u003chttp://www.nndc.bnl.gov\u003e) online database NuDat (version November 2009). In addition, the K gamma spectra (Kgamma) are constructed from NNDC online database NuDat (version January 2013; Kinsey *et al.*, 1996).\n\n## Installation\n\nYou can download the software as a zip from this [URL](http://github.com/crp2a/DosiVox/archive/master.zip).\n\nTo 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):\n\n``` shell\ngit clone https://github.com/crp2a/DosiVox.git\n```\n\nExtract the archive of your home folder. Run the Scientific Linux virtual machine in a Windows or OS-X operating system and extract the archive in the virtual machine's Home folder. More explanations are available in the DosiVox Installation Guide.\n\n## Usage\n### Setting a simulation with PTF\n\nModify any PTF present in the DosiVox/data folder respecting the file's layout. 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 a supplementary line unless it corresponds to data in agreement with the PTF layout. Detailed explanations are available in the DosiVox Manual.\n\n### Launch a simulation in DosiVox\n\nOpen a terminal localised in the `DosiVox/` folder. Detailed explanations are available in the DosiVox Manual.\n\n### Basic Commands\n\n#### Run DosiVox (in a terminal open in the `DosiVox/` folder)\n\nRun DosiVox without visualisation:\n``` shell\nbuild/DosiVox\n```\n\nRun the basic visualisation tool of DosiVox:\n``` shell\nbuild/DosiVox vis.mac\n```\n\nRun the visualisation of the DosiVox tool with the detectors displaying:\n``` shell\nbuild/DosiVox visdet.mac\n```\n\nWARNING: the displaying of detectors composed of a lot of geometrical elements can be costly for the computer resources \n\nUse `Ctrl + C` to abort the running simulation.\n\n#### Run DosiVox under the DosiVox visualisation tool (in the \"Session\" box of the visualisation tool)\n\nRun the simulation in the visualisation tool:\n``` shell\ncontrol/execute 1run.mac\n```\n\nWARNING: to avoid over-consumption of the computer resources, the run under the visualisation tool is limited to 1000 particles emitted\n\nExit the visualisation tool (it will exit the DosiVox session too):\n``` shell\nexit\n```\n\nTo move the displayed model, use the mouse left and scroll buttons on the display window and the keyboard arrows.  \n\n### Results\n\nResults 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:\n\n* `_error` for the listing of the killed particles,\n* `_probe` for the recording of the probe detector,\n* `_detectorN` for the N detector (N=1-\u003e sub-voxelised, N=2-\u003e single grain packing, N=3-\u003e successive grain packings),\n* `_grains` for the dose for each grain for detector 2 or 3. For detector 1, a 3D mapping is written as a text file in the `DosiVox/results/DoseMapping` folder. \n\nThese results text files can be opened with standard spreadsheets. Detailed explanations are available in the DosiVox DosiVox Manual.\n\n### Examples of PTF\n\nSome examples of PTF are provided with DosiVox, in the `DosiVox/data` folder:\n\n* `XPL0` creates two voxels filled respectively with clay and quartz. It simulates the alpha radioactivity of the U-series in the clay, allowing to record of the dose attenuation in the quartz with the probe detector.\n* `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.\n* `XPL1bis` creates a similar model than `XPL1`, but with a 20 x 20 x 20 grid.\n* `XPL2` creates a 20 x 20  20 voxels model with water, air and sediment-type materials to simulate gamma particles. Only the probe detector is defined\n* `XPL3` defines a single random packing of grains as a detector in a 20 x 20 x 20 grid, in addition to the probe detector. Beta particles of the Th-series are simulated.\n* `XPL3bis` uses the same configuration as `XPL3` but creates successive random packings of grains as detectors.\n* `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.\n* `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.\n\nDetailed explanations are available in the DosiVox Manual.\n\n## technical support\n\n* [Loïc MARTIN](loic.martin@u-bordeaux-montaigne.fr)\t\t\n* [Norbert MERCIER](norbert.mercier@u-bordeaux-montaigne.fr)\n\n## References\n\nAgostinelli *et al.*, 2003. Geant4—a simulation toolkit. *Nuclear Instruments and Methods in Physics Research Section A: Accelerators, Spectrometers, Detectors and Associated Equipment*, 506. \u003chttps://doi.org/10.1016/S0168-9002(03)01368-8\u003e\n\nAllison *et al.*, 2006. Geant4 developments and applications. *IEEE Transactions on Nuclear Science* 53. \u003chttps://doi.org/10.1109/TNS.2006.869826\u003e\n\nAllison, 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. \u003chttps://doi.org/10.1016/j.nima.2016.06.125\u003e\n\nMartin, 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). \u003chttp://ancienttl.org/ATL_33-1_2015/ATL_33-1_Martin_p1-10.pdf\u003e\n\nMartin, 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: characterisation and modelisation with the DosiVox software. *Radiation Measurement*, 81, 134-141. \u003chttps://doi.org/10.1016/j.radmeas.2015.02.008\u003e\n\nKinsey, 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 Jan 2013 \u003chttps://www.nndc.bnl.gov/nudat2/reCenter.jsp?z=50\u0026n=63\u003e\n\nKramida, A., Ralchenko, Yu., Reader, J., NIST ASD Team, 2018. NIST Atomic Spectra Database (version 5.0.0) \u003chttps://physics.nist.gov/asd\u003e [Nov 2012]. National Institute of Standards and Technology, Gaithersburg, MD. \u003chttps://doi.org/10.18434/T4W30F\u003e\n\nMartin, 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. \u003chttp://www.theses.fr/2015BOR30055\u003e\n\nRasband, W. S., 1997-2012. ImageJ, U.S. National Institutes of Health, Bethesda, Maryland, USA. \u003chttps://imagej.nih.gov/ij/\u003e\n\nSchneider, C. A., Rasband, W. S., Eliceiri, K. W., 2012. NIH Image to ImageJ: 25 years of image analysis. *Nature Methods*, 671. \u003chttps://doi.org/10.1038/nmeth.2089\u003e\n\n## License\n\nDosiVox is provided under the terms and conditions of the DosiVox Software License (GNU GPL-3).\n\nNeither 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](LICENSE) file for the full disclaimer and the limitation of liability.\n\nBy 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.\n\n1. Institut de Recherche sur les ArchéoMATériaux - Centre de Recherche en Physique Appliquée à l'Archéologie \u003chttp://www.iramat-crp2a.cnrs.fr\u003e\n2. Centre d'Etudes Nucléaires de Bordeaux Gradignan \u003chttp://www.cenbg.in2p3.fr\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrp2a%2Fdosivox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrp2a%2Fdosivox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrp2a%2Fdosivox/lists"}