pmodevalue

Measures the pixel value that occurs the most frequenlty in an image, region map or graph.

Synopsis

pmodevalue [-m mask] [im_in|-] [col_out|-]

Description

pmodevalue returns the pixel value that occurs the most frequenlty in the input image or region map or graph im_in. if im_in is an image, the mode value is the most frequent color on each band. If im_in is a region map, the mode value is the most frequent label value. If im_in is a graph, the mode value is the most frequent node value.

The mode values for each band are stored in the collection col_out.

Inputs

im_in: an image, a region map or a graph.

Outputs

col_out: a collection of float values.

Result

Returns the mode value (for the first band only). This value can be get using operator pstatus.

Examples

Measures the mode of the tangram.pan (Unix version):

   pmodevalue tangram.pan col.pan
   val=`pstatus`
   echo "Mode = $val"

Measures the mode of the tangram.pan (MsDos version):

   pmodevalue tangram.pan col.pan
   call pstatus
   call pset val
   echo Mode = %val%

C++ prototype

Float PModeValue( const Img2duc &im_in, Collection & col_out );

Version française

Recherche de la valeur de pixel la plus fréquente dans une image (un graphe ou une carte de régions).

Author: Régis Clouard