Debian Codegraph @

hugo/content/ref/instr/beam/footprint/index.md

raw
1 +++
2 title = "Footprint"
3 weight = 10
4 +++
5
6 ### Footprint correction
7
8 The footprint effect originates from the angle-dependent intersection
9 of a finite beam with a finite sample.
10 It should be considered for all scanning simulations.
11
12 {{< galleryscg >}}
13 {{< figscg src="/img/draw/FootprintScheme.png" width="350px">}}
14 {{< /galleryscg >}}
15
16 When taking into account footprint correction, there are two possible options for the
17 beam shape in `BornAgain`:
18
19 * Square beam --- the beam has sharp edges and square cross-section,
20 its intensity is uniformly distributed.
21 * Gaussian beam --- the beam is infinite in space, while its intensity has Gaussian
22 distribution along the radius of the beam.
23
24 The footprint correction for square beam is defined by
25 `FootprintSquare` command, which has the signature
26
27 ```python
28 footprint = FootprintSquare(beam_to_sample_width_ratio)
29 ```
30
31 Here `footprint` is an object later passed to the simulation, while `beam_to_sample_width_ratio`
32 defines the ratio between the widths of beam and sample.
33
34 In the case of the Gaussian beam the footprint object is created with
35
36 ```python
37 footprint = FootprintGauss(beam_to_sample_width_ratio)
38 ```
39
40 The command signature is exactly the same as in the case with the square beam,
41 but the beam width required for `beam_to_sample_width_ratio`
42 is now defined as the beam diameter associated with the intensity level equal to $I_0 \cdot e^{-\frac{1}{2}}$,
43 where $I_0$ is the on-axis (maximal) intensity.
44
45 Footprint can be applied for both scan and single beam positions:
46
47 ```python
48 beam.setFootprint(footprint) # for scattering
49 scan.setFootprint(footprint) # for specular and offspec
50 ```
51
52 In example below a square beam is considered, with `beam_to_sample_width_ratio` being equal to $0.01$.
53 The incident angle range was made rather small in this example
54 (from $0.0$ to $0.6$ degrees) in order to emphasize
55 the footprint impact at small incident angles.
56 In other respects this example exactly matches the
57 [reflectometry simulation tutorial](/ref/sim/class/specular).
58
59 {{< galleryscg >}}
60 {{< figscg src="/img/auto/specular/FootprintCorrection.png" width="450px">}}
61 {{< /galleryscg >}}
62
63 {{< show-ex file="specular/FootprintCorrection.py" >}}