Skip to content

Commit e59a693

Browse files
committed
few fixes in docs and added more detailed description for raven
1 parent d2f8363 commit e59a693

File tree

12 files changed

+329
-29
lines changed

12 files changed

+329
-29
lines changed
14.4 KB
Loading
44.5 KB
Loading
13.6 KB
Loading
23 KB
Loading
31.9 KB
Loading
55.4 KB
Loading
9.84 KB
Loading

docs/source/bibliography/references.bib

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,16 @@ @article{titarenko2010analytical
5858
year={2010},
5959
publisher={Elsevier}
6060
}
61+
@article{raven1998numerical,
62+
title={Numerical removal of ring artifacts in microtomography},
63+
author={Raven, Carsten},
64+
journal={Review of scientific instruments},
65+
volume={69},
66+
number={8},
67+
pages={2978--2980},
68+
year={1998},
69+
publisher={AIP Publishing}
70+
}
6171
@article{vo2015radial,
6272
title={Radial lens distortion correction with sub-pixel accuracy for X-ray micro-tomography},
6373
author={Vo, Nghia T and Atwood, Robert C and Drakopoulos, Michael},

docs/source/examples/pipeline1_FBP.ipynb

Lines changed: 184 additions & 8 deletions
Large diffs are not rendered by default.
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
.. method_raven_filter:
2+
3+
Raven filter
4+
^^^^^^^^^^^^^
5+
6+
**Description**
7+
8+
Raven filter is a part of the module :doc:`../../api/httomolibgpu.prep.stripe` for data correction. Raven filter is based on a FFT filter applied in sinogram space to minimise stripes leading to `Ring Artifacts <https://radiopaedia.org/articles/ring-artifact-2?lang=gb>`_ in reconstruction. See more about the filter in the original publication :cite:`raven1998numerical`.
9+
10+
**Where and how to use it:**
11+
12+
Raven filter can be used in pre-processing, i.e., before the reconstruction to remove the stripes present in the data.
13+
14+
**What are the adjustable parameters:**
15+
16+
Most important parameters are :code:`uvalue` and :code:`nvalue` that define the shape of the filter, as well as, :code:`vvalue`, the number of rows to be applied to the filter.
17+
18+
**Practical example:**
19+
20+
In this example we demonstrate how to apply Raven filter to the normalised projection data.
21+
22+
.. warning:: As with any pre-processing tool, one needs to be careful in applying Raven filter to data. Sub-optimal parameters can potentially lead to other artifacts introduced in the reconstruction and blurring.
23+
.. list-table::
24+
25+
26+
* - .. figure:: ../../_static/auto_images_methods/data_stripes_added_sino.png
27+
28+
Input (sinogram view) with the stripes added
29+
30+
- .. figure:: ../../_static/auto_images_methods/data_stripes_added_proj.png
31+
32+
Input (projection view) with the stripes added
33+
34+
* - .. figure:: ../../_static/auto_images_methods/raven_filter_sino.png
35+
36+
After applying Raven filter (sinogram)
37+
38+
- .. figure:: ../../_static/auto_images_methods/raven_filter_proj.png
39+
40+
After applying Raven filter (projection)
41+
42+
* - .. figure:: ../../_static/auto_images_methods/raven_filter_res_sino.png
43+
44+
Sinogram view of absolute residual between input and output
45+
46+
- .. figure:: ../../_static/auto_images_methods/raven_filter_res_proj.png
47+
48+
Projection view of absolute residual between input and output
49+
50+
51+
52+

0 commit comments

Comments
 (0)