Blob osztály – Blob objektum

A blob objektum egy attrtuple, amelyet az Image.find_blobs() ad vissza. Minden folt képpontok egy összefüggő tartományát képviseli, amely megfelelt a find_blobs() metódusnak átadott egy vagy több színküszöbértéknek. Az objektum összefogja a folt határoló dobozát, súlypontját, képpontszámát, kerületét, tájolását, terület-sűrűségi metrikáit, a foltot eltaláló küszöbértékek halmazát, az elforgatott minimális területű téglalapot, valamint az opcionális X/Y vetületi hisztogramokat.

A mezők elérhetők attribútumnév szerint (blob.x) vagy index szerint (blob[0]). Az objektumnak nincs nyilvános konstruktora.

class image.blob

Az objektum létrehozásához hívd meg az Image.find_blobs() metódust.

Határoló doboz és súlypont

x

A határoló doboz bal felső sarkának x koordinátája képpontban. Egész szám. Index: [0].

y

A határoló doboz bal felső sarkának y koordinátája képpontban. Egész szám. Index: [1].

w

A határoló doboz szélessége képpontban. Egész szám. Index: [2].

h

A határoló doboz magassága képpontban. Egész szám. Index: [3].

cx

A súlypont x koordinátája (a folt képpont-átlaga) egészre kerekítve. Egész szám. Index: [4].

cy

A súlypont y koordinátája (a folt képpont-átlaga) egészre kerekítve. Egész szám. Index: [5].

cxf

A súlypont x koordinátája szubpixeles lebegőpontos számként. Index: [16].

cyf

A súlypont y koordinátája szubpixeles lebegőpontos számként. Index: [17].

rect

A határoló doboz (x, y, w, h) 4-es tuple-je. Közvetlenül átadható rajzoló/vágó metódusoknak, például az Image.draw_rectangle() vagy az Image.crop() metódusnak. Index: [22].

Alakleírók

pixels

Az ezt a foltot alkotó képpontok száma. Egész szám. Index: [6].

area

A tengelyekkel illesztett határoló doboz területe (w * h). Egész szám. Index: [19].

density

pixels / area – a határoló doboznak a folt által kitöltött hányada. Lebegőpontos szám a 0.0 – 1.0 tartományban. A tömör téglalap megközelíti az 1.0 értéket; egy vékony átlós vonal a 0.0 értékhez közelít. Index: [20].

perimeter

A folt külső kerületén lévő képpontok száma. Egész szám. Index: [10].

roundness

A folt kistengelyének és nagytengelyének aránya, a másodrendű momentumaiból számítva. Lebegőpontos szám a 0.0 – 1.0 tartományban; az 1.0 tökéletes kört, a 0.0 vonalat jelent. Index: [11].

elongation

1.0 - roundness – érték a 0.0 – 1.0 tartományban, ahol a 0.0 tökéletes kört, az 1.0 pedig vonalat jelent. Index: [18].

compactness

(pixels * 4 * pi) / (perimeter * perimeter). Egy adott területhez a körnek van a legkisebb kerülete, ezért ez a metrika tökéletes kör esetén 1.0, és csökken, ahogy a folt egyenetlenebbé vagy megnyúltabbá válik. Lebegőpontos szám. Index: [21].

rotation

A folt tájolása radiánban, a másodrendű momentumaiból levezetve. Lebegőpontos szám a 0 és pi közötti tartományban (a tengely szimmetrikus, így az irány pi felett kétértelmű). Megnyúlt foltok esetén a legpontosabb – közel kör alakú foltoknál az érték zajossá válik. Index: [7].

Küszöbérték / összevonás metaadatok

code

32 bites bittérkép, amelyben minden színküszöbértékhez (ahogyan az Image.find_blobs() metódusnak átadtad), amelynek ez a folt megfelelt, egy bit van beállítva. Egyetlen küszöbérték esetén code == 1. Összevont többszínű foltok (merge=True) esetén több bit is be lehet állítva. Index: [8].

count

Az ebbe összevont forrásfoltok száma. 1, ha merge=False; nagyobb lehet, ha merge=True. Index: [9].

Sarkok

corners

A folt négy szélső sarkát megadó (x, y) egész szám párokból álló 4-es tuple, az óramutató járásával megegyezően rendezve a bal felső saroktól kezdve. Ezek a kontúrból származtatott sarkok (a folt határvonalának a súlyponttól négy átló mentén legtávolabbi pontjai). Index: [14].

min_corners

A folt minimális területű elforgatott határoló téglalapjának négy sarkát megadó (x, y) egész szám párokból álló 4-es tuple. A rotation értékkel kombinálva ezek adják a foltra legszorosabban illeszkedő keretet. Index: [15].

Vetületi hisztogramok

x_hist_bins

A folt X-tengely (oszlop) vetületi hisztogramjának egész értékű számlálóiból álló lista. Csak akkor van feltöltve, ha a find_blobs(...) metódust x_hist_bins_max > 0 értékkel hívták meg; egyébként üres. Index: [12].

y_hist_bins

A folt Y-tengely (sor) vetületi hisztogramjának egész értékű számlálóiból álló lista. Csak akkor van feltöltve, ha a find_blobs(...) metódust y_hist_bins_max > 0 értékkel hívták meg; egyébként üres. Index: [13].