summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorMatthias Vogelgesang <matthias.vogelgesang@kit.edu>2016-12-19 16:45:54 +0100
committerMatthias Vogelgesang <matthias.vogelgesang@kit.edu>2016-12-19 16:45:54 +0100
commit0e3cca9cb63656c88bb336de42c54bfadc16d827 (patch)
tree56044c90af5ffe5b139e611a776e879b8d83cd4e /docs
parent533e69d20e675aafcbe65057390bd3c37e22f966 (diff)
downloadufo-filters-0e3cca9cb63656c88bb336de42c54bfadc16d827.tar.gz
ufo-filters-0e3cca9cb63656c88bb336de42c54bfadc16d827.tar.bz2
ufo-filters-0e3cca9cb63656c88bb336de42c54bfadc16d827.tar.xz
ufo-filters-0e3cca9cb63656c88bb336de42c54bfadc16d827.zip
Add documentation for some undocumented tasks
Diffstat (limited to 'docs')
-rw-r--r--docs/filters.rst182
1 files changed, 182 insertions, 0 deletions
diff --git a/docs/filters.rst b/docs/filters.rst
index 80f7d33..b1a9ef0 100644
--- a/docs/filters.rst
+++ b/docs/filters.rst
@@ -19,6 +19,7 @@ Binarization
Any values above the threshold are set to one all others to zero.
+
Clipping
--------
@@ -34,6 +35,7 @@ Clipping
Maximum value, all values higher than `max` are set to `max`.
+
Arithmetic expressions
----------------------
@@ -56,6 +58,26 @@ Arithmetic expressions
Arithmetic expression with math functions supported by OpenCL.
+Statistics
+----------
+
+.. gobj:class:: measure
+
+ Measure basic image properties with GSL.
+
+ .. gobj:prop:: metric:string
+
+ Metric, one of ``std``, ``min`` or ``max``.
+
+ .. gobj:prop:: axis:int
+
+ Along which axis to measure (-1, all).
+
+ .. gobj:prop:: pass-through:boolean
+
+ ``TRUE`` if data should be copied to next output.
+
+
.. _generic-opencl-ref:
@@ -215,6 +237,59 @@ Cropping
Start cropping from the center outwards.
+Polar transformation
+--------------------
+
+.. gobj:class:: polar-coordinates
+
+ Transformation between polar and cartesian coordinate systems.
+
+ When transforming from cartesian to polar coordinates the origin is in the
+ image center (:gobj:prop:`width` / 2, :gobj:prop:`height` / 2). When
+ transforming from polar to cartesian coordinates the origin is in the image
+ corner (0, 0).
+
+ .. gobj:prop:: width:uint
+
+ Final width after transformation.
+
+ .. gobj:prop:: height:uint
+
+ Final height after transformation.
+
+ .. gobj:prop:: direction: string
+
+ Conversion direction from ``polar_to_cartesian``.
+
+
+
+Multi-stream
+============
+
+Interpolation
+-------------
+
+.. gobj:class:: interpolate
+
+ Interpolates incoming data from two compatible streams, i.e. the task
+ computes :math:`(1 - \alpha) s_1 + \alpha s_2` where :math:`s_1` and
+ :math:`s_2` are the two input streams and :math:`\alpha` a blend factor.
+ :math:`\alpha` is :math:`i / (n - 1)` for :math:`n > 1`, :math:`n` being
+ :gobj:prop:`number` and :math:`i` the current iteration.
+
+ .. gobj:prop:: number:uint
+
+ Number of total input stream length.
+
+
+Subtract
+--------
+
+.. gobj:class:: subtract
+
+ Subtract data items of the second from the first stream.
+
+
Filters
=======
@@ -277,6 +352,26 @@ Averaging
Number of averaged images to output. By default one image is generated.
+Statistics
+----------
+
+.. gobj:class:: flatten
+
+ Flatten input stream by reducing with operation based on the given mode.
+
+ .. gobj:prop:: mode:string
+
+ Operation, can be either ``min``, ``max``, ``sum`` and ``median``.
+
+.. gobj:class:: flatten-inplace
+
+ Faster inplace operating variant of the ``flatten`` task.
+
+ .. gobj:prop:: mode:enum
+
+ Operation, can be either ``min``, ``max`` and ``sum``.
+
+
Slicing
-------
@@ -429,6 +524,23 @@ Frequency filtering
gaussian.
+Zeropadding
+-----------
+
+.. gobj:class:: zeropad
+
+ Add zeros in the center of sinogram using :gobj:prop:`oversampling`
+ to manage the amount of zeros which will be added.
+
+ .. gobj:prop:: oversampling:uint
+
+ Oversampling coefficient.
+
+ .. gobj:prop:: center-of-rotation:float
+
+ Center of rotation of sample.
+
+
Reconstruction
==============
@@ -622,6 +734,62 @@ Laminographic backprojection
``lamino-angle``, ``roll-angle``.
+Fourier interpolation
+---------------------
+
+.. gobj:class:: dfi-sinc
+
+ Computes the 2D Fourier spectrum of reconstructed image using 1D Fourier
+ projection of sinogram (fft filter must be applied before). There are no
+ default values for properties, therefore they should be assigned manually.
+
+ .. gobj:prop:: kernel-size:uint
+
+ The length of kernel which will be used in
+ interpolation.
+
+ .. gobj:prop:: number-presampled-values:uint
+
+ Number of presampled values which will be used to calculate
+ ``kernel-size`` kernel coefficients.
+
+ .. gobj:prop:: roi-size:int
+
+ The length of one side of region of Interest.
+
+ .. gobj:prop:: angle-step:double
+
+ Increment of angle in radians.
+
+
+Center of rotation
+------------------
+
+.. gobj:class:: center-of-rotation
+
+ Compute the center of rotation of input sinograms.
+
+ .. gobj:prop:: angle-step:double
+
+ Step between two successive projections.
+
+ .. gobj:prop:: center:double
+
+ The calculated center of rotation.
+
+
+Sinogram offset shift
+---------------------
+
+.. gobj:class:: cut-sinogram
+
+ Shifts the sinogram given a center not centered to the input image.
+
+ .. gobj:prop:: center-of-rotation:float
+
+ Center of rotation of specimen.
+
+
Phase retrieval
---------------
@@ -755,3 +923,17 @@ Monitoring
If set print the given numbers of items on stdout as hexadecimally
formatted numbers.
+
+
+Sleep
+-----
+
+.. gobj:class:: sleep
+
+ Wait :gobj:prop:`time` seconds before continuing. Useful for debugging
+ throughput issues.
+
+ .. gobj:prop:: time:double
+
+ Time to sleep in seconds.
+