ATLAS Offline Software
SystemOfUnits.py
Go to the documentation of this file.
1 
15 
16 # This script is a direct adaptation of CLHEP/Units/SystemOfUnits.h
17 # and the following is the originial CLHEP comment:
18 #
19 # -----
20 # HEP coherent system of Units
21 #
22 # This file has been provided to CLHEP by Geant4 (simulation toolkit for HEP).
23 #
24 # The basic units are :
25 # millimeter (millimeter)
26 # nanosecond (nanosecond)
27 # Mega electron Volt (MeV)
28 # positron charge (eplus)
29 # degree Kelvin (kelvin)
30 # the amount of substance (mole)
31 # luminous intensity (candela)
32 # radian (radian)
33 # steradian (steradian)
34 #
35 # Below is a non exhaustive list of derived and pratical units
36 # (i.e. mostly the SI units).
37 # You can add your own units.
38 #
39 # The SI numerical value of the positron charge is defined here,
40 # as it is needed for conversion factor : positron charge = e_SI (coulomb)
41 #
42 # The others physical constants are defined in the header file :
43 # PhysicalConstants.h
44 #
45 # Authors: M.Maire, S.Giani
46 #
47 # History:
48 #
49 # 06.02.96 Created.
50 # 28.03.96 Added miscellaneous constants.
51 # 05.12.97 E.Tcherniaev: Redefined pascal (to avoid warnings on WinNT)
52 # 20.05.98 names: meter, second, gram, radian, degree
53 # (from Brian.Lasiuk@yale.edu (STAR)). Added luminous units.
54 # 05.08.98 angstrom, picobarn, microsecond, picosecond, petaelectronvolt
55 # 01.03.01 parsec
56 # 06.20.25 e_SI
57 # -----
58 
59 #
60 # Length [L]
61 #
62 millimeter = 1.0
63 millimeter2 = millimeter * millimeter
64 millimeter3 = millimeter * millimeter * millimeter
65 
66 centimeter = 10.0 * millimeter
67 centimeter2 = centimeter * centimeter
68 centimeter3 = centimeter * centimeter * centimeter
69 
70 meter = 1000.0 * millimeter
71 meter2 = meter * meter
72 meter3 = meter * meter * meter
73 
74 kilometer = 1000.0 * meter
75 kilometer2 = kilometer * kilometer
76 kilometer3 = kilometer * kilometer * kilometer
77 
78 parsec = 3.0856775807e16 * meter
79 
80 micrometer = 1.0e-6 * meter
81 nanometer = 1.0e-9 * meter
82 angstrom = 1.0e-10 * meter
83 fermi = 1.0e-15 * meter
84 
85 barn = 1.0e-28 * meter2
86 millibarn = 1.0e-3 * barn
87 microbarn = 1.0e-6 * barn
88 nanobarn = 1.0e-9 * barn
89 picobarn = 1.0e-12 * barn
90 
91 liter = 1.0e3 * centimeter3
92 L = liter
93 dL = 1.0e-1 * liter
94 cL = 1.0e-2 * liter
95 mL = 1.0e-3 * liter
96 
97 # symbols
98 mm = millimeter
99 mm2 = millimeter2
100 mm3 = millimeter3
101 
102 cm = centimeter
103 cm2 = centimeter2
104 cm3 = centimeter3
105 
106 m = meter
107 m2 = meter2
108 m3 = meter3
109 
110 km = kilometer
111 km2 = kilometer2
112 km3 = kilometer3
113 
114 pc = parsec
115 
116 #
117 # Angle
118 #
119 radian = 1.0
120 milliradian = 1.0e-3 * radian
121 degree = (3.14159265358979323846 / 180.0) * radian
122 
123 steradian = 1.0
124 
125 # symbols
126 rad = radian
127 mrad = milliradian
128 sr = steradian
129 deg = degree
130 
131 #
132 # Time [T]
133 #
134 nanosecond = 1.0
135 second = 1.0e9 * nanosecond
136 millisecond = 1.0e-3 * second
137 microsecond = 1.0e-6 * second
138 picosecond = 1.0e-12 * second
139 femtosecond = 1.0e-15 * second
140 
141 hertz = 1.0 / second
142 kilohertz = 1.0e3 * hertz
143 megahertz = 1.0e6 * hertz
144 
145 # symbols
146 ns = nanosecond
147 s = second
148 ms = millisecond
149 us = microsecond
150 ps = picosecond
151 
152 #
153 # Electric charge [Q]
154 #
155 eplus = 1.0 # positron charge
156 e_SI = 1.602176634e-19 # positron charge in coulomb
157 coulomb = eplus / e_SI # coulomb = 6.24150 e+18 * eplus
158 
159 #
160 # Energy [E]
161 #
162 megaelectronvolt = 1.0
163 electronvolt = 1.0e-6 * megaelectronvolt
164 kiloelectronvolt = 1.0e-3 * megaelectronvolt
165 gigaelectronvolt = 1.0e3 * megaelectronvolt
166 teraelectronvolt = 1.0e6 * megaelectronvolt
167 petaelectronvolt = 1.0e9 * megaelectronvolt
168 
169 joule = electronvolt / e_SI # joule = 6.24150 e+12 * MeV
170 
171 # symbols
172 MeV = megaelectronvolt
173 eV = electronvolt
174 keV = kiloelectronvolt
175 GeV = gigaelectronvolt
176 TeV = teraelectronvolt
177 PeV = petaelectronvolt
178 
179 #
180 # Mass [E][T^2][L^-2]
181 #
182 kilogram = joule * second * second / (meter * meter)
183 gram = 1.0e-3 * kilogram
184 milligram = 1.0e-3 * gram
185 
186 # symbols
187 kg = kilogram
188 g = gram
189 mg = milligram
190 
191 #
192 # Power [E][T^-1]
193 #
194 watt = joule / second # watt = 6.24150 e+3 * MeV/ns
195 
196 #
197 # Force [E][L^-1]
198 #
199 newton = joule / meter # newton = 6.24150 e+9 * MeV/mm
200 
201 #
202 # Pressure [E][L^-3]
203 #
204 hep_pascal = newton / m2 # pascal = 6.24150 e+3 * MeV/mm3
205 pascal = hep_pascal # a trick to avoid warnings
206 bar = 100000 * pascal # bar = 6.24150 e+8 * MeV/mm3
207 atmosphere = 101325 * pascal # atm = 6.32420 e+8 * MeV/mm3
208 
209 #
210 # Electric current [Q][T^-1]
211 #
212 ampere = coulomb / second # ampere = 6.24150 e+9 * eplus/ns
213 milliampere = 1.0e-3 * ampere
214 microampere = 1.0e-6 * ampere
215 nanoampere = 1.0e-9 * ampere
216 
217 #
218 # Electric potential [E][Q^-1]
219 #
220 megavolt = megaelectronvolt / eplus
221 kilovolt = 1.0e-3 * megavolt
222 volt = 1.0e-6 * megavolt
223 
224 #
225 # Electric resistance [E][T][Q^-2]
226 #
227 # ohm = 1.60217e-16*(MeV/eplus)/(eplus/ns)
228 ohm = volt / ampere
229 
230 #
231 # Electric capacitance [Q^2][E^-1]
232 #
233 # farad = 6.24150e+24 * eplus/Megavolt
234 farad = coulomb / volt
235 millifarad = 1.0e-3 * farad
236 microfarad = 1.0e-6 * farad
237 nanofarad = 1.0e-9 * farad
238 picofarad = 1.0e-12 * farad
239 
240 #
241 # Magnetic Flux [T][E][Q^-1]
242 #
243 weber = volt * second # weber = 1000*megavolt*ns
244 
245 #
246 # Magnetic Field [T][E][Q^-1][L^-2]
247 #
248 tesla = volt * second / meter2 # tesla =0.001*megavolt*ns/mm2
249 
250 gauss = 1.0e-4 * tesla
251 kilogauss = 1.0e-1 * tesla
252 
253 #
254 # Inductance [T^2][E][Q^-2]
255 #
256 # henry = 1.60217e-7*MeV*(ns/eplus)**2
257 henry = weber / ampere
258 
259 #
260 # Temperature
261 #
262 kelvin = 1.0
263 
264 #
265 # Amount of substance
266 #
267 mole = 1.0
268 
269 #
270 # Activity [T^-1]
271 #
272 becquerel = 1.0 / second
273 curie = 3.7e10 * becquerel
274 kilobecquerel = 1.0e3 * becquerel
275 megabecquerel = 1.0e6 * becquerel
276 gigabecquerel = 1.0e9 * becquerel
277 millicurie = 1.0e-3 * curie
278 microcurie = 1.0e-6 * curie
279 Bq = becquerel
280 kBq = kilobecquerel
281 MBq = megabecquerel
282 GBq = gigabecquerel
283 Ci = curie
284 mCi = millicurie
285 uCi = microcurie
286 
287 #
288 # Absorbed dose [L^2][T^-2]
289 #
290 gray = joule / kilogram
291 kilogray = 1.0e3 * gray
292 milligray = 1.0e-3 * gray
293 microgray = 1.0e-6 * gray
294 
295 #
296 # Luminous intensity [I]
297 #
298 candela = 1.0
299 
300 #
301 # Luminous flux [I]
302 #
303 lumen = candela * steradian
304 
305 #
306 # Illuminance [I][L^-2]
307 #
308 lux = lumen / meter2
309 
310 #
311 # Miscellaneous
312 #
313 perCent = 0.01
314 perThousand = 0.001
315 perMillion = 0.000001