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 [1] presents a summary of these parameters and the parameters keys to be used in command-line and programming languages. Application key is HaralickTextureExtraction .

[1]Table: Parameters table for Haralick Texture Extraction.
Parameter Key Parameter Type Parameter Description
in Input image Input image
channel Int Int
step Int Int
ram Int Int
parameters Group Group
parameters.xrad Int Int
parameters.yrad Int Int
parameters.xoff Int Int
parameters.yoff Int Int
parameters.min Float Float
parameters.max Float Float
parameters.nbbin Int Int
texture Choices Choices
texture simple Choice Simple Haralick Texture Features
texture advanced Choice Advanced Texture Features
texture higher Choice Higher Order Texture Features
out Output image Output image
inxml XML input parameters file XML input parameters file
outxml XML output parameters 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 9 advanced texture feature output image. The image channels are: Mean, Variance, 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