HaralickTextureExtraction - Haralick Texture Extraction
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Computes textures on every pixel of the input image selected channel

Detailed description
--------------------

This application computes Haralick, advanced and higher order textures on a mono band image

Parameters
----------

This section describes in details the parameters available for this application. Table [#]_ presents a summary of these parameters and the parameters keys to be used in command-line and programming languages. Application key is *HaralickTextureExtraction* .

.. [#] Table: Parameters table for Haralick Texture Extraction.

+----------------+----------------------------------+--------------------------+
|Parameter Key   |Parameter Name                    |Parameter Type            |
+================+==================================+==========================+
|in              |Input Image                       |Input image               |
+----------------+----------------------------------+--------------------------+
|channel         |Selected Channel                  |Int                       |
+----------------+----------------------------------+--------------------------+
|step            |Computation step                  |Int                       |
+----------------+----------------------------------+--------------------------+
|ram             |Available RAM (Mb)                |Int                       |
+----------------+----------------------------------+--------------------------+
|parameters      |Texture feature parameters        |Group                     |
+----------------+----------------------------------+--------------------------+
|parameters.xrad |X Radius                          |Int                       |
+----------------+----------------------------------+--------------------------+
|parameters.yrad |Y Radius                          |Int                       |
+----------------+----------------------------------+--------------------------+
|parameters.xoff |X Offset                          |Int                       |
+----------------+----------------------------------+--------------------------+
|parameters.yoff |Y Offset                          |Int                       |
+----------------+----------------------------------+--------------------------+
|parameters.min  |Image Minimum                     |Float                     |
+----------------+----------------------------------+--------------------------+
|parameters.max  |Image Maximum                     |Float                     |
+----------------+----------------------------------+--------------------------+
|parameters.nbbin|Histogram number of bin           |Int                       |
+----------------+----------------------------------+--------------------------+
|texture         |Texture Set Selection             |Choices                   |
+----------------+----------------------------------+--------------------------+
|texture simple  |Simple Haralick Texture Features  | *Choice*                 |
+----------------+----------------------------------+--------------------------+
|texture advanced|Advanced Texture Features         | *Choice*                 |
+----------------+----------------------------------+--------------------------+
|texture higher  |Higher Order Texture Features     | *Choice*                 |
+----------------+----------------------------------+--------------------------+
|out             |Output Image                      |Output image              |
+----------------+----------------------------------+--------------------------+
|inxml           |Load otb application from xml file|XML input parameters file |
+----------------+----------------------------------+--------------------------+
|outxml          |Save otb application to xml file  |XML output parameters file|
+----------------+----------------------------------+--------------------------+

**Input Image**: The input image to compute the features on.

**Selected Channel**: The selected channel index.

**Computation step**: Step (in pixels) to compute output texture values. The first computed pixel position is shifted by (step-1)/2 in both directions.

**Available RAM (Mb)**: Available memory for processing (in MB).

**[Texture feature parameters]**: This group of parameters allows one to define texture parameters.

- **X Radius**: X Radius.
- **Y Radius**: Y Radius.
- **X Offset**: X Offset.
- **Y Offset**: Y Offset.
- **Image Minimum**: Image Minimum.
- **Image Maximum**: Image Maximum.
- **Histogram number of bin**: Histogram number of bin.

**Texture Set Selection**: Choice of The Texture Set. Available choices are: 

- **Simple Haralick Texture Features**: This group of parameters defines the 8 local Haralick texture feature output image.    The image channels are: Energy, Entropy, Correlation, Inverse Difference Moment,    Inertia, Cluster Shade, Cluster Prominence and Haralick Correlation.
- **Advanced Texture Features**: This group of parameters defines the 10 advanced texture feature output image.    The image channels are: Mean, Variance, Dissimilarity, Sum Average, Sum Variance,    Sum Entropy, Difference of Entropies, Difference of Variances, IC1 and IC2.
- **Higher Order Texture Features**: This group of parameters defines the 11 higher order texture feature output image.    The image channels are: Short Run Emphasis, Long Run Emphasis, Grey-Level Nonuniformity, Run Length Nonuniformity, Run Percentage,     Low Grey-Level Run Emphasis, High Grey-Level Run Emphasis, Short Run Low Grey-Level Emphasis, Short Run High Grey-Level Emphasis,     Long Run Low Grey-Level Emphasis and Long Run High Grey-Level Emphasis.

**Output Image**: Output image containing the selected texture features.

**Load otb application from xml file**: Load otb application from xml file.

**Save otb application to xml file**: Save otb application to xml file.



Example
-------

To run this example in command-line, use the following: 
::

	otbcli_HaralickTextureExtraction -in qb_RoadExtract.tif -channel 2 -parameters.xrad 3 -parameters.yrad 3 -texture simple -out HaralickTextures.tif

To run this example from Python, use the following code snippet: 

::

	#!/usr/bin/python

	# Import the otb applications package
	import otbApplication

	# The following line creates an instance of the HaralickTextureExtraction application 
	HaralickTextureExtraction = otbApplication.Registry.CreateApplication("HaralickTextureExtraction")

	# The following lines set all the application parameters:
	HaralickTextureExtraction.SetParameterString("in", "qb_RoadExtract.tif")

	HaralickTextureExtraction.SetParameterInt("channel", 2)

	HaralickTextureExtraction.SetParameterInt("parameters.xrad", 3)

	HaralickTextureExtraction.SetParameterInt("parameters.yrad", 3)

	HaralickTextureExtraction.SetParameterString("texture","simple")

	HaralickTextureExtraction.SetParameterString("out", "HaralickTextures.tif")

	# The following line execute the application
	HaralickTextureExtraction.ExecuteAndWriteOutput()

Limitations
~~~~~~~~~~~

None

Authors
~~~~~~~

This application has been written by OTB-Team.

See Also
~~~~~~~~

These additional resources can be useful for further information: 
  | otbScalarImageToTexturesFilter, otbScalarImageToAdvancedTexturesFilter and otbScalarImageToHigherOrderTexturesFilter classes