class Blob -- Objek Blob#

Objek blob adalah attrtuple yang dikembalikan oleh Image.find_blobs(). Setiap blob mewakili wilayah piksel yang terhubung dan cocok dengan satu atau lebih ambang batas warna yang diteruskan ke find_blobs(). Objek ini memuat kotak pembatas blob, sentroid, jumlah piksel, perimeter, orientasi, metrik kepadatan area, set ambang batas yang cocok, persegi panjang pembatas rotasi area minimum, dan histogram proyeksi X/Y opsional.

Field dapat diakses berdasarkan nama atribut (blob.x) atau berdasarkan indeks (blob[0]). Objek ini tidak memiliki konstruktor publik.

class image.blob#

Panggil Image.find_blobs() untuk membuat objek ini.

Kotak pembatas dan sentroid#

x#: Koordinat x kiri atas kotak pembatas, dalam piksel. Integer. Indeks [0].

y#: Koordinat y kiri atas kotak pembatas, dalam piksel. Integer. Indeks [1].

w#: Lebar kotak pembatas, dalam piksel. Integer. Indeks [2].

h#: Tinggi kotak pembatas, dalam piksel. Integer. Indeks [3].

cx#: Koordinat x sentroid (rata-rata piksel blob), dibulatkan ke int. Integer. Indeks [4].

cy#: Koordinat y sentroid (rata-rata piksel blob), dibulatkan ke int. Integer. Indeks [5].

cxf#: Koordinat x sentroid sebagai float sub-piksel. Indeks [16].

cyf#: Koordinat y sentroid sebagai float sub-piksel. Indeks [17].

rect#: 4-tuple (x, y, w, h) dari kotak pembatas. Cocok untuk diteruskan langsung ke metode menggambar/memotong seperti Image.draw_rectangle() atau Image.crop(). Indeks [22].

Deskriptor bentuk#

pixels#: Jumlah piksel yang membentuk blob ini. Integer. Indeks [6].

area#: Luas kotak pembatas sejajar sumbu (w * h). Integer. Indeks [19].

density#: pixels / area -- fraksi kotak pembatas yang diisi oleh blob. Float dalam rentang 0.0 -- 1.0. Persegi panjang solid mendekati 1.0; garis diagonal tipis mendekati 0.0. Indeks [20].

perimeter#: Jumlah piksel pada perimeter luar blob. Integer. Indeks [10].

roundness#: Rasio sumbu minor terhadap sumbu mayor dari blob, dihitung dari momen orde kedua. Float dalam rentang 0.0 -- 1.0; 1.0 adalah lingkaran sempurna, 0.0 adalah garis. Indeks [11].

elongation#: 1.0 - roundness -- nilai dalam rentang 0.0 -- 1.0 di mana 0.0 adalah lingkaran sempurna dan 1.0 adalah garis. Indeks [18].

compactness#: (pixels * 4 * pi) / (perimeter * perimeter). Lingkaran memiliki perimeter terkecil untuk luas tertentu, sehingga metrik ini bernilai 1.0 untuk lingkaran sempurna dan menurun ketika blob menjadi lebih tidak beraturan atau memanjang. Float. Indeks [21].

rotation#: Orientasi blob dalam radian, diturunkan dari momen orde kedua. Float dalam rentang 0 hingga pi (sumbu simetris sehingga arahnya ambigu setelah pi). Paling akurat untuk blob yang memanjang -- untuk blob yang hampir bulat nilainya menjadi tidak stabil. Indeks [7].

Metadata ambang batas / penggabungan#

code#: Bitmap 32-bit dengan satu bit yang ditetapkan untuk setiap ambang batas warna (sebagaimana diteruskan ke Image.find_blobs()) yang cocok dengan blob ini. Dengan satu ambang batas, code == 1. Dengan blob multi-warna yang digabungkan (merge=True) lebih dari satu bit dapat ditetapkan. Indeks [8].

count#: Jumlah blob sumber yang digabungkan menjadi blob ini. 1 ketika merge=False; bisa lebih besar ketika merge=True. Indeks [9].

Sudut#

corners#: 4-tuple berisi tuple integer (x, y) untuk empat sudut ekstrem dari blob, diurutkan searah jarum jam mulai dari sudut kiri atas. Ini adalah sudut turunan kontur (titik-titik pada batas blob yang terjauh dari sentroid di empat diagonal). Indeks [14].

min_corners#: 4-tuple berisi tuple integer (x, y) untuk empat sudut persegi panjang pembatas berputar area minimum dari blob. Dikombinasikan dengan rotation, ini memberikan kecocokan paling ketat di sekitar blob. Indeks [15].

Histogram proyeksi#

x_hist_bins#: Daftar jumlah integer untuk histogram proyeksi sumbu-X (kolom) dari blob. Hanya diisi ketika find_blobs(...) dipanggil dengan x_hist_bins_max > 0; jika tidak, kosong. Indeks [12].

y_hist_bins#: Daftar jumlah integer untuk histogram proyeksi sumbu-Y (baris) dari blob. Hanya diisi ketika find_blobs(...) dipanggil dengan y_hist_bins_max > 0; jika tidak, kosong. Indeks [13].