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].