label2idx() - Image Processing

pixelIndexList = label2idx(L) converts
the regions described by the label matrix L into
the 1-by-N cell array of linear indices pixelIndexList. Code Generation support:
Yes.MATLAB® Function Block support: No.

Syntax

pixelIndexList = label2idx(L) example

Example

Calculate Pixel Index List for Small Label MatrixOpen This Example
Create a small sample matrix containing three regions.BW = logical([1 1 1 0 0 0 0 0
              1 1 1 0 1 1 0 0
              1 1 1 0 1 1 0 0
              1 1 1 0 0 0 0 0
              1 1 1 0 0 0 1 0
              1 1 1 0 0 0 1 0
              1 1 1 0 0 1 1 0
              1 1 1 0 0 0 0 0]);
Create a label matrix from this sample image.L = bwlabel(BW)

L =

     1     1     1     0     0     0     0     0
     1     1     1     0     2     2     0     0
     1     1     1     0     2     2     0     0
     1     1     1     0     0     0     0     0
     1     1     1     0     0     0     3     0
     1     1     1     0     0     0     3     0
     1     1     1     0     0     3     3     0
     1     1     1     0     0     0     0     0

Get a linear index list of all the pixels in each region. The function returns a cell array with an element for each region it finds in the label matrix.pixelIndexList = label2idx(L)

pixelIndexList = 

    [24x1 double]    [4x1 double]    [4x1 double]

Examine one of the pixel index lists returned. For example, look at the second cell in the returned cell array. It contains the linear indices for all the pixels in the region labeled "2". The upper left corner of the region is pixel BW(2,5), which is the 34th pixel in linear indexing.pixelIndexList{2}

ans =

    34
    35
    42
    43

Output / Return Value

Limitations

Alternatives / See Also

Reference