Skip to main content

epix

PyPI version shields.io CodeFactor DOI

Electron and Photon Instructions generator for XENON

The job of epix is to load XENONnT Geant4 MC data and produce inputs for wfsim, using nestpy for the quanta generation and DBSCAN for the clustering of the individual steps.

Installation

With all requirements fulfilled (e.g., on top of the XENONnT montecarlo_environment):

pip install epix

or install in editable mode from source:

git clone https://github.com/XENONnT/epix
pip install -e epix

Usage

Only an input file is needed to run epix:

bin/run_epix --InputFile <path_and_filename>

The other keyword arguments are:

Argument Description Default
--Detector Detector to be used. Has to be defined in epix.detectors XENONnT
--DetectorConfigOverride Config file to overwrite default epix.detectors settings; see examples in the configs folder in epix.detectors
--CutOnEventid If selected, the next two arguments act on the G4 event id, and not the entry number (default) false
--EntryStart First event to be read 0
--EntryStop How many entries from the ROOT file you want to process all
--MicroSeparation DBSCAN clustering distance (mm) 0.005
--MicroSeparationTime Clustering time (ns) 10
--TagClusterBy decide if you tag the cluster (particle type, energy depositing process) according to first interaction in it (time) or most energetic (energy) energy
--MaxDelay Time after which we cut the rest of the event (ns) 1e7
--MaxEnergy Upper range for energy selection in sensitive volume (keV) inf
--MinEnergy Lower range for energy selection in sensitive volume (keV) -1
--YieldModel Model for yield/quanta generation (nest / bbf / beta) nest
--ClusterMethod Microclustering method (dbscan / betadecay / brem) dbscan
--SourceRate Event rate for event separation
- 0 for no time shift (G4 time remains)
- -1 for clean time shift between events
- >0 (Hz) for random spacing
0
--CutNeutron Add if you want to filter only nuclear recoil events (maximum ER energy deposit 10 keV) false
--JobNumber Job number in full chain simulation. Offset is computed as JobNumber * n_simulated_events/SourceRate, where n_simulated_events is read from file. 0
--OutputPath Output file path Same directory as input file
--Debug Tell epix if you want timing outputs false

0.3.8 (2024-02-23)

  • Propagate defaults for energy range arguments (#82)

0.3.7 (2024-02-08)

  • Selection based on total energy deposit in sensitive volume (#76)
  • Fix cut_by_eventid again (#80)

0.3.6 (2024-01-15)

  • Fix G4 event number selection with cut_by_eventid (#75)
  • np.int is deprecated (#78)
  • Fix epix to allow version bump (#77)

0.3.5 (2023-09-13)

  • Custom microclustering and beta-yields generator (#73)

0.3.4 (2023-03-28)

  • Fix calculation for cluster weighted average time (#65)
  • Add zenodo badge

0.3.3 (2023-01-09)

  • Specify not working numba in req. file (#62)
  • Install scikit-learn (#63)

0.3.2 (2022-08-15)

  • First implementation of BBF quanta generator (#57)

0.3.1 (2022-06-15)

  • Save primary particle position (#56)
  • Set arg defaults (#55)

0.3.0 (2022-05-20)

  • Add NR filter before quanta generation (#53)
  • Update energy selection for Kr83m model (#52)

0.2.2 (2021-10-31)

  • Fixed field map loading (#50)

0.2.1 (2021-10-30)

  • Update efield handler to maps format (#49)

0.2.0 (2021-10-28)

  • Fix clustering indexing (#45)
  • Treatment for empty data (#40)
  • Fix for NEST interaction classification parameters (#44)
  • Enable CSV input (#42)

0.1.3 (2021-07-27)

  • Tuning clustering defaults (#39)
  • Return statement for removed excitons (#38)
  • Added local field and number of excitons (#34)

0.1.2 (2021-06-09)

  • Add sklearn to requirements (#31)
  • Fix Kr83m NEST-related issues (#30)

0.1.1 (2021-04-09)

  • Automatic PyPi upload (#24)
  • PyPi and codefactor integration

0.1.0 (2021-03-30)

  • E-Field format change (#23)
  • strax interface (#19)

0.0.6 (2021-02-12)

  • Set e- recoil type as default (#15)

0.0.5 (2021-02-08)

  • Change detector naming (#13)

0.0.4 (2021-02-08)

  • New Efield format loading (#11)
  • Store NEST id as recoil type (#10)

0.0.3 (2021-01-26)

  • Clustering and event separation (#6)

0.0.2 (2021-01-25)

  • Added detector volumes (#8)

0.0.1 (2020-01-21)

  • Initial working release as python package

Metadata

Release files for epix 0.3.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for epix 0.3.8
File Size Uploaded
epix-0.3.8.tar.gz 31.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for epix 0.3.8
File Interpreter ABI Platform
epix-0.3.8-py3-none-any.whl Python 3 none any Details

Total release size: 65.1 kB

Release files / epix-0.3.8.tar.gz

Download URL epix-0.3.8.tar.gz
Size 31.4 kB
Tags Source
SHA-256 checksum
How to use checksums
96f33d91a3362e6a9afa4bc63bff76c1826cfd160bbcc11ca40d5a6e6bdce857
BLAKE2b-256 checksum
How to use checksums
1263d919e3d3d10a0d54221d2bcad268e34836a8e74af2b3e80cb7a30d846af3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/4.0.2 CPython/3.11.8

Release files / epix-0.3.8-py3-none-any.whl

Download URL epix-0.3.8-py3-none-any.whl
Size 33.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
68d0fe743c7187a93e91428b605bdf37b65a3b34d2ee105437c4d6b6cbae0f99
BLAKE2b-256 checksum
How to use checksums
9d303e0d32543fcddaebda176bd079ec9f04e6c004f18827a5ba39ab6f5831da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/4.0.2 CPython/3.11.8

Release history Release notifications | RSS feed

This release

0.3.8 This release

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page