Debian Codegraph @

hugo/content/ref/instr/beam/_index.md

raw
1 +++
2 title = "Beam"
3 weight = 20
4 +++
5
6 ## Beam model
7
8 The incident beam must be specified for scattering simulations with 2D detector
9 (SAS and GISAS).
10 For other simulations, the beam is set internally according to the
11 given [scan](../scan) model.
12
13 To create a beam, use
14 ```python
15 beam = ba.Beam(intensity, wavelength, alpha, phi=0)
16 ```
17 For the wavelenth, use unit multiplier `*nm` or `*angstrom`.
18 For the grazing angle $\alpha\_\text{i}$, use unit multiplier `*deg`.
19
20 The azimuthal angle $\varphi\_\text{i}$ can be omitted,
21 as in most applications the default value 0 is pertinent.
22 If $\varphi\_\text{i}\ne0$ is used, then it is defined as the angle
23 between the incident half ray (with $x<0$, projected into the $xy$ plane)
24 and the $x$ axis. Conversely, $\varphi\_\text{f}$ is the angle between
25 the outgoing half ray ($x>0$, projected into the $xy$ plane)
26 and the $x$ axis so that scattering is by $\varphi\_\text{f}-\varphi\_\text{i}$.
27
28 After creation of a beam, additional properties can be set with
29 ```python
30 beam.setFootprint(footprint)
31 beam.setPolarization(polarization)
32 ```
33 For the arguments, see [footprint](footprint) and [polarization](../pol).
34
35 The beam intensity may appear inconsequential for specular simulations
36 because resulting reflectivities are normalized.
37 However, the intensity does influence the simulated [noise](/ref/sim/setup/bg).
38
39 {{% children %}}
40
41 #### History
42
43 The above definition of $\varphi\_\text{i,f}$ agrees with IsGisaxs
44 (Manual Fig. 2.1, where $\varphi$ is named $\theta$).
45 Prior to release 24, this was unclear in BornAgain, and
46 the computations of scattering and specular reflection were
47 inconsistent with each other for $\varphi\_\text{i}\ne0$.