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 [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 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.