dcnum.feat.feat_texture
=======================

.. py:module:: dcnum.feat.feat_texture

.. autoapi-nested-parse::

   Feature computation: Haralick texture features



Submodules
----------

.. toctree::
   :maxdepth: 1

   /autoapi/dcnum/feat/feat_texture/common/index
   /autoapi/dcnum/feat/feat_texture/tex_all/index


Attributes
----------

.. autoapisummary::

   dcnum.feat.feat_texture.haralick_names


Functions
---------

.. autoapisummary::

   dcnum.feat.feat_texture.haralick_texture_features


Package Contents
----------------

.. py:data:: haralick_names
   :value: ['tex_asm_avg', 'tex_asm_ptp', 'tex_con_avg', 'tex_con_ptp', 'tex_cor_avg', 'tex_cor_ptp',...


.. py:function:: haralick_texture_features(mask, image=None, image_bg=None, image_corr=None)

   Compute Haralick texture features

   The following texture features are excluded

   - feature 6 "Sum Average", which is equivalent to `2 * bright_bc_avg`
     since dclab 0.44.0
   - feature 10 "Difference Variance", because it has a functional
     dependency on the offset value and since we do background correction,
     we are not interested in it
   - feature 14, because nobody is using it, it is not understood by
     everyone what it actually is, and it is computationally expensive.

   This leaves us with the following 11 texture features (22 if you count
   avg and ptp):
   https://earlglynn.github.io/RNotes/package/EBImage/Haralick-Textural-Features.html

   - 1. `tex_asm`: (1) Angular Second Moment
   - 2. `tex_con`: (2) Contrast
   - 3. `tex_cor`: (3) Correlation
   - 4. `tex_var`: (4) Variance
   - 5. `tex_idm`: (5) Inverse Difference Moment
   - 6. `tex_sva`: (7) Sum Variance
   - 7. `tex_sen`: (8) Sum Entropy
   - 8. `tex_ent`: (9) Entropy
   - 9. `tex_den`: (11) Difference Entropy
   - 10. `tex_f12`: (12) Information Measure of Correlation 1
   - 11. `tex_f13`: (13) Information Measure of Correlation 2