Skip to content
This repository has been archived by the owner on Nov 5, 2020. It is now read-only.

Commit

Permalink
docs: add thoughts
Browse files Browse the repository at this point in the history
  • Loading branch information
paulmueller committed Sep 26, 2018
1 parent 220b36f commit 3977f05
Show file tree
Hide file tree
Showing 4 changed files with 78 additions and 21 deletions.
13 changes: 13 additions & 0 deletions docs/sec_qg_consistency_check.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
.. _sec_qg_consistency_check:


==========================================
Checking experimental data for consistency
==========================================

Changes with time
-----------------
any trend is bad; e.g. brightness: change in focus; area: sample changed



21 changes: 21 additions & 0 deletions docs/sec_qg_filtering.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
.. _sec_qg_filtering:


=========
Filtering
=========

Aspect ratio
------------
remove cell clusters

Orientation
-----------
only cells aligned with channel

Porosity
--------
Remove dirt



4 changes: 3 additions & 1 deletion docs/sec_quick_guides.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,6 @@ Quick Guides
:maxdepth: 2
:caption: Contents:

sec_qg_youngs_modulus
sec_qg_consistency_check
sec_qg_filtering
sec_qg_youngs_modulus
61 changes: 41 additions & 20 deletions docs/sec_rtdc_basics.rst
Original file line number Diff line number Diff line change
Expand Up @@ -51,36 +51,42 @@ contour and enables a quantification of porosity (convex to measured area ratio)
The porosity is often used for filtering, e.g. to remove high-porosity dirt
particles in a preprocessing step.

.. figure:: figures/area.png
.. figure:: figures/area.png

Visualization of porosity. (A) The measured contour (blue line) defines
the measured area (blue shade). The convex contour (red line) results
in an area (red shade) that is usually larger than the measured area.
(B) The porosity is the ratio between measured and convex contour. The
difference (the "pores") between the measured and convex areas is
indicated in green.
Visualization of porosity. (A) The measured contour (blue line) defines
the measured area (blue shade). The convex contour (red line) results
in an area (red shade) that is usually larger than the measured area.
(B) The porosity is the ratio between measured and convex contour. The
difference (the "pores") between the measured and convex areas is
indicated in green.

A porosity of 1 means that the measured contour is convex.
Note that the porosity can only assume values larger than 1. Also note that the
convex contour/area is computed on the same pixel grid as the measured contour/area
and is, as such, subject to pixelation artifacts.


Image brightness
----------------
Aspect ratio of bounding box
----------------------------

.. figure:: figures/aspect.jpg


Brightness within image
-----------------------
Quantifying the brightness values within the image contour yields
information on object properties such as homogeneity or density.
For instance, it has been shown that the quantities "mean brightness" and
"convex area" are sufficient to identify (and count) all major blood cells
in a drop of blood :cite:`Toepfner2018`.

.. figure:: figures/brightness.jpg
.. figure:: figures/brightness.jpg

Blood-classification with event brightness and cell size.
(A) Representative images of blood cell types acquired. Scale bar is 10 µm.
(B) Brightness versus cell size (area) scatter plot with cell types labeled
according to the color scheme in (A).
Figure and caption adapted from Toepfner et al. [1]_.
Blood-classification with event brightness and cell size.
(A) Representative images of blood cell types acquired. Scale bar is 10 µm.
(B) Brightness versus cell size (area) scatter plot with cell types labeled
according to the color scheme in (A).
Figure and caption adapted from Toepfner et al. [1]_.

In addition to the average
brightness values, ShapeOut also has access to the standard deviation of the
Expand All @@ -105,17 +111,32 @@ derive a value for elasticity in RT-DC :cite:`Mietke2015` :cite:`Mokbel2017`.
As a convenient measure for elasticity, isoelasticity lines are often
employed to visualize stiffness.

.. figure:: figures/deform.jpg
.. figure:: figures/deform.jpg

(A) Typical deformation versus cell size scatter plot. The color scale
indicates event density.
(B) Isoelasticity lines derived from numerical simulations indicate
trends in stiffness.
(A) Typical deformation versus cell size scatter plot. The color scale
indicates event density.
(B) Isoelasticity lines derived from numerical simulations indicate
trends in stiffness.

Note that it is also possible to directly
:ref:`access the Young's modulus in ShapeOut <sec_qg_youngs_modulus>`.


Fluorescence
------------
:cite:`Rosendahl2018`


Inertia ratio
-------------
also principal inertia ratio


Volume
------




.. [1] *Detection Of Human Disease Conditions By Single-Cell Morpho-Rheological
Phenotyping Of Whole Blood* by Toepfner et al.,
Expand Down

0 comments on commit 3977f05

Please sign in to comment.