| 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" >}} |