{"id":24327910,"url":"https://github.com/temken/damascus-crust","last_synced_at":"2025-09-27T12:31:24.528Z","repository":{"id":185887110,"uuid":"121413611","full_name":"temken/DaMaSCUS-CRUST","owner":"temken","description":"Dark Matter Simulation Code for Underground Scatterings - Crust Edition","archived":false,"fork":false,"pushed_at":"2023-03-02T19:18:24.000Z","size":3974,"stargazers_count":8,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2023-08-03T15:59:51.272Z","etag":null,"topics":["astroparticle-physics","dark-matter","montecarlo-simulation","particle-physics","physics-simulation","simulation","trajectory-simulator"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/temken.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":"2018-02-13T17:34:39.000Z","updated_at":"2023-08-03T15:59:54.765Z","dependencies_parsed_at":"2024-08-12T13:19:18.402Z","dependency_job_id":null,"html_url":"https://github.com/temken/DaMaSCUS-CRUST","commit_stats":null,"previous_names":["temken/damascus-crust"],"tags_count":3,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/temken%2FDaMaSCUS-CRUST","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/temken%2FDaMaSCUS-CRUST/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/temken%2FDaMaSCUS-CRUST/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/temken%2FDaMaSCUS-CRUST/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/temken","download_url":"https://codeload.github.com/temken/DaMaSCUS-CRUST/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234435226,"owners_count":18832093,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["astroparticle-physics","dark-matter","montecarlo-simulation","particle-physics","physics-simulation","simulation","trajectory-simulator"],"created_at":"2025-01-17T22:17:59.455Z","updated_at":"2025-09-27T12:31:18.507Z","avatar_url":"https://github.com/temken.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/temken/DaMaSCUS-CRUST.svg?branch=main)](https://travis-ci.org/temken/DaMaSCUS-CRUST)\n[![codecov](https://codecov.io/gh/temken/DaMaSCUS-CRUST/branch/main/graph/badge.svg)](https://codecov.io/gh/temken/DaMaSCUS-CRUST)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n# DaMaSCUS - CRUST\n\n\u003ca href=\"http://ascl.net/1803.001\"\u003e\u003cimg src=\"https://img.shields.io/badge/ascl-1803.001-blue.svg?colorB=262255\" alt=\"ascl:1803.001\" /\u003e\u003c/a\u003e\n[![DOI](https://zenodo.org/badge/121413611.svg)](https://zenodo.org/badge/latestdoi/121413611)\n[![arXiv](https://img.shields.io/badge/arXiv-1802.04764-B31B1B.svg)](https://arxiv.org/abs/1802.04764)\n[![arXiv](https://img.shields.io/badge/arXiv-1905.06348-B31B1B.svg)](https://arxiv.org/abs/1905.06348)\n \nDark Matter Simulation Code for Underground Scatterings - Crust Edition\n\nDaMaSCUS-CRUST Version 1.2.0 02/03/2023\n\n\u003cimg src=\"https://user-images.githubusercontent.com/29034913/57919204-adef1600-7898-11e9-9464-bfd496eeb95b.png\" width=\"800\"\u003e\n\n## GENERAL NOTES\n\n- DaMaSCUS-CRUST is a MC simulator of dark matter (DM) particle trajectories through the Earth crust, atmosphere and/or additional shielding layers undergoing elastic scatterings on nuclei. \n- It is a tool to systematically determine the critical cross-section of strongly interacting DM, above which a given experiment loses detection sensitivity. As a final result it returns a precise exclusion band.\n- Users can easily change the layer structure in the config file and define layers by their density, thickness, and composition.\n- Both nuclear recoil and electron scattering experiments are included. User can also define a generic semiconductor experiment with a silicon or germanium target right in the configuration file.\n- There are a number of different DM-nucleus interaction types implemented, e.g. contact or light mediator interactions.\n- Two MC rare-event techniques can be invoked to speed up the simulations: Importance Sampling and Geometric Importance Splitting. Both can be (de-)activated and adjusted in the configuration file.\n- DaMaSCUS-CRUST is written in C++ and fully parallelized (openMPI).\n\nFor the underlying physics we refer to the corresponding papers, [[arXiv:1802.04764]](https://arxiv.org/abs/1802.04764) and [[arXiv:1905.06348]](https://arxiv.org/abs/1905.06348).\n\n## CONTENT\n\nThe included folders are:\n\n- *bin/*: This folder contains the configuration files and the executables after compilation.\n- *build/*: This folder contains all object files.\n- *detectors/*: Detector specific data, such as tabulated efficiencies or recoil energy data are stored here.\n- *include/*: All header files can be found here. Necessary 3rd party libraries can also be placed here.\n- *results/*: The resulting limits are saved in this folder.\n- *src/*: Here you find the source code of DaMaSCUS-CRUST.\n\n\n## INSTALLATION AND USAGE\n\n### Dependencies:\n\nBefore the code can be compiled, these dependencies need to be taken care of:\n\n- **libconfig v1.6**: For the input configuration files we use the *libconfig* library. Note that we need at least version 1.6. [(Link)](https://hyperrealm.github.io/libconfig/)\n- **MPI**: For parallelization we use the Message Passing Interface [(Link)](https://www.open-mpi.org)\n\nFor the installation of the dependencies, it might be useful to take a look at the travis script.\n\n### Installation:\n\nThe code can be compiled using the makefile. It might be necessary to adjust the compiler lines and the path to the libraries\n\n```\n#Compiler and compiler flags\nCXX := mpic++\nCXXFLAGS := -Wall -std=c++11 \nLIB := -lconfig++\nINC := -I include\n(...)\n```\n\nAfter that simply run\n```\nmake\n```\nfrom the root directory in the terminal to compile DaMaSCUS-CRUST.\n\nRunning\n```\nmake clean\n```\ndeletes all objective files and executables.\n\n### Usage:\n\nAfter successful compilation there is only one final step before running the program: Adjusting the configuration file in */bin/*. This file specifies all the input parameter, the mass scan range, the experiment of interest, the shielding layer structure, the interaction type,... . This should be rather self-explanatory. However note that *libconfig* is not very forgiving with regards to the input parameter type. For example it might complain if an input parameter of type double is given as “1” instead of “1.0”.\n\nAfterwards the program starts by\n\n```\nmpirun -n N DaMaSCUS-CRUST config.cfg\n```\nwhere N is the number of MPI processes.\n\nAfter a successful run, the resulting constraints can be plotted with the included *Mathematica* notebook */Plot.nb*.\n\n**New in version 1.1.1**: Alternative, the user may also directly compute the underground DM speed distribution for a given mass, cross section, speed cutoff and sample size via command line arguments. The config file is still necessary to define the interaction, shielding layers, rare event techniques, etc..  \n\nExample: For a DM mass of 500 MeV, a nucleon cross section of 1e-31 cm^2, a minimum speed of 100 km/sec, and a sample size of 10000, the user can run  \n\n```\nmpirun -n N DaMaSCUS-CRUST config.cfg 0.5 1e-31 100 10000  \n```  \n\nNote: The minimum speed and sample size are *optional* command line arguments. The default value for v_Min is 0, whereas the default choice for the sample size is taken from the config file.  \n\nThe resulting speed distribution is saved in the folder /results/*Simulation_ID*.\n\n## CITING DaMaSCUS-CRUST\n\nIf you decide to use this code, please cite\n\n\u003eEmken, T. \u0026 Kouvaris, C., 2018, DaMaSCUS-CRUST, Astrophysics Source Code Library, record [[ascl:1803.001]](https://ascl.net/1803.001)\n\nBibTex entry:\n\n```\n@software{DaMaSCUScrust,\n  author = {Emken, Timon},\n  title = {{Dark Matter Simulation Code for Underground Scatterings - Crust Edition~(DaMaSCUS-CRUST) [Code, v1.2.0]}},\n  year         = {2018},\n  publisher    = {Zenodo},\n  version      = {v1.2.0},\n  doi          = {DOI:10.5281/zenodo.2846400},\n  url          = {https://doi.org/10.5281/zenodo.2846400},\n  howpublished={Astrophysics Source Code Library record \\href{https://ascl.net/1803.001}{[ascl:1803.001]}. The code can be found under \\url{https://github.com/temken/damascus-crust}. Version 1.2.0 is archived as \\href{https://doi.org/10.5281/zenodo.2846400}{DOI:10.5281/zenodo.2846400}}\n}\n```\n\nPlease cite the original publications as well.\n\n\u003eEmken, T. , Essig, R., Kouvaris, C., \u0026 Sholapurkar, M., Direct Detection of Strongly Interacting Sub-GeV Dark Matter via Electron Recoils, [JCAP 1909 (2019) no.09, 070](https://iopscience.iop.org/article/10.1088/1475-7516/2019/09/070),[[arXiv:1905.06348]](https://arxiv.org/abs/1905.06348).\n\n\u003eEmken, T.\u0026 Kouvaris, C., How blind are underground and surface detectors to strongly interacting Dark Matter?, [Phys.Rev. D97 (2018) no.11, 115047 ](https://journals.aps.org/prd/abstract/10.1103/PhysRevD.97.115047), [[arXiv:1802.04764]](https://arxiv.org/abs/1802.04764).\n\n## AUTHORS \u0026 CONTACT\n\nThe authors of DaMaSCUS-CRUST are Timon Emken and Chris Kouvaris.\n\nFor questions, bug reports or other suggestions please open an [issue on GitHub](https://github.com/temken/DaMaSCUS-CRUST/issues).\n\n## LICENCE\n\nThis project is licensed under the MIT License - see the LICENSE file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftemken%2Fdamascus-crust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftemken%2Fdamascus-crust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftemken%2Fdamascus-crust/lists"}