| 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$. |