glRunLength

[ XITE Reference Manual | XITE home ]

Contents


Name

glRunLength - Grey value distribution of run lengths

Syntax

glRunLength [<option>...] <inimage>

Description

The run length statistics can be used to extract texture information of an image from its grey level runs. Consecutive pixels of the same grey value, in a given direction (either horizontal or vertical), constitute a run. The numbers of runs of different lengths and grey values, arranged according to the lengths and grey levels, form a 2-D matrix called grey level run length matrix.

There are two possible directions to scan the image, either horizontal or vertical directions. The average of these two directions also can be chosen (option -aver).

Several features can be extracted from this matrix, using the options described below. If you don't specify any options for features, then the program will compute all the parameters.

Options

The first seven options are for the features which can be extracted from the GLRL matrix.

-sre
Short Run emphasis

-lre
Long Run emphasis

-gln
Grey Level Nonuniformity

-rln
Run Length Nonuniformity

-rp
Run Percentage

-sgre
Low Grey Level Run emphasis

-lgre
High Grey Level Run emphasis

-h
A header for the output is wanted.

-hori
Horizontal direction

-vert
Vertical direction

-aver
Consider both directions and take the average of them. (Default direction options is -hori.)

-heq
Histogram equalization of the input image.

-o filename
Run length matrix will be saved as an image in filename.

-qlevels quantization_levels Number of grey levels in the input will be grouped into given number of quantization levels. Default is 256.

Restrictions

inimage must have bands with pixel type unsigned byte.

See also

glcm(1), glcmParameter(1)

Author

Yogesan, BLAB, Ifi, UiO

Examples

 glRunLength mona.img
 glRunLength -h mona.img
 glRunLength -h -sre -rp -gln mona.img
 glRunLength -h -sre -o mona.out mona.img
 glRunLength -h -sre -o mona.out mona.img -qlevels 16
 glRunLength -h mona.img -qlevels 32
 glRunLength mona.img -aver

Id

$Id: glRunLength.c,v 1.27 1997/03/07 12:52:20 svein Exp $