You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.rst
+86-9Lines changed: 86 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,19 +1,21 @@
1
1
==================================
2
-
Irrad_Spectroscopy |travis-status|
2
+
Irrad_Spectroscopy |test-status|
3
3
==================================
4
4
5
5
Introduction
6
6
============
7
7
8
-
``irrad_spectroscopy`` is a package intended to do gammma spectroscopy of (proton) irradiated samples such as chips, sensors,
9
-
PCBs, etc. but can be also used for general gamma spectroscopy e.g. of radioactive sources. It consits of few independent
10
-
methods which togehter allow for a complete spectroscopic analysis of radioactive gamma-spectra. A step-by-step full spectroscopy
11
-
of an example spectrum can be found in the ``examples`` folder.
8
+
``ìrrad_spectroscopy`` is a package which provides functions for gamma and X-ray spectroscopy, including isotope identification, activity determination and spectral dose calculations.
9
+
Furthermore, it offers functions for calculating the gamma equivalent dose for given isotopes as a function of their initial activity.
10
+
11
+
The package was developed for spectroscopic analysis or proton-irradiated semiconductor devices but can be used to analyze various samples,
12
+
from radioactive sources to activated machine parts. It consits of few independent methods which togehter allow for a complete spectroscopic analysis, including plotting, of
13
+
radioactive gamma-spectra. A step-by-step full spectroscopy of an example spectrum can be found in the ``examples`` folder.
12
14
13
15
Installation
14
16
============
15
17
16
-
You have to have Python 2/3 with the following packages installed:
18
+
You have to have Python 3 with the following packages installed:
17
19
18
20
- numpy
19
21
- scipy
@@ -37,6 +39,9 @@ To finally install ``irrad_spectroscopy`` run the setup file
37
39
Example usage
38
40
=============
39
41
42
+
Full spectroscopy
43
+
-----------------
44
+
40
45
Check the ``examples`` folder for several measured data sets of different sources for calibration and analysis. A `Jupyter Notebook <http://jupyter.org/>`_
41
46
with a step-by-step analysis of an example spectrum of an irradiated chip is provided. Install jupyter and run
42
47
@@ -46,14 +51,86 @@ with a step-by-step analysis of an example spectrum of an irradiated chip is pro
46
51
47
52
in order to open the web interface.
48
53
54
+
Equivalent dose calculation
55
+
--------------------------
56
+
57
+
The package implements dose rate calculations for individual gamma lines as well as full gamma spectra of isotopes
58
+
for various materials (search materials in `this table <https://github.com/SiLab-Bonn/irrad_spectroscopy/blob/development/irrad_spectroscopy/tables/xray_coefficient_table.yaml>`_)
59
+
Dose rate calculations are implemented, assuming a point-like source!
60
+
61
+
Calculating dose rate of an individual gamma line in air:
62
+
63
+
.. code-block:: python
64
+
65
+
# Import
66
+
from irrad_spectroscopy.physics import gamma_dose_rate
67
+
68
+
# Get dose rate of single gamma line in uSv/h
69
+
# Zn65 line at 1115.564 keV, prob 50.60%, activity of 20 kBq at a distance of 100 cm in air
70
+
res = gamma_dose_rate(energy=1115.546,
71
+
probability=0.506,
72
+
activity=20e3,
73
+
distance=100,
74
+
material='air')
75
+
76
+
print(res) # Prints 1.515e-3 # uSv/h
77
+
78
+
Calculating the (integrated) gamma dose rate of an isotope in air:
79
+
80
+
.. code-block:: python
81
+
82
+
# Import
83
+
from irrad_spectroscopy.physics import isotope_dose_rate
84
+
85
+
# Zn65 with activity of 20 kBq at a distance of 100 cm in air
86
+
res = isotope_dose_rate(isotope='65_Zn',
87
+
activity=20e3,
88
+
distance=100,
89
+
material='air')
90
+
91
+
print(res) # Prints {'65_Zn': 1.515e-3} # uSv/h
92
+
93
+
# Zn65 with activity of 20 kBq at a distance of 100 cm in air
94
+
# integrated over 2000 hours
95
+
res = isotope_dose_rate(isotope='65_Zn',
96
+
activity=20e3,
97
+
distance=100,
98
+
material='air',
99
+
time=2000)
100
+
101
+
print(res) # Prints {'65_Zn': 2.66} # uSv
102
+
103
+
Calculating the gamma dose rate of multiple isotopes in air:
104
+
105
+
.. code-block:: python
106
+
107
+
# Import
108
+
from irrad_spectroscopy.physics import isotope_dose_rate
109
+
110
+
# Multiple isotopes (Zn65 and Be7) with different activities
111
+
# (20 kBq, 100kBq) at a distance of 100 cm in air
112
+
res = isotope_dose_rate(isotope=('65_Zn', '7_Be'),
113
+
activity=(20e3, 100e3),
114
+
distance=100,
115
+
material='air')
116
+
117
+
print(res) # Prints {'65_Zn': 1.515e-3, '7_Be': 0.73e-3} # uSv/h
118
+
49
119
Testing
50
120
=======
51
121
52
122
The code in this package has unit-tests. These tests contain a benchmark with actual gamma-spectroscopy data of
53
123
two calibrated, radioactive sources, namely 22-Na and 133-Ba. The activity reconstruction efficiencies for the
0 commit comments