Alignment

Bu fonksiyon bloğu, sıralı bir referans şablonlar (ROIs) seti ve bunlara karşılık gelen bounding box'lar kullanarak bir sahne görüntüsünü hizalar. Bu bloğu, sahne görüntüsünün bilinen bir referans düzeniyle eşleşmesi için öteleme ve dönme hatalarını düzeltmek amacıyla kullanın.

📥 Girdiler

Scene Image Hizalaması yapılacak görüntü. Tek bir (boş olmayan) görüntü sağlayın.

Reference ROIs Eşleştirme için kullanılan bir veya daha fazla sıralı şablon görüntü (liste olarak verin). Sıralama, bounding box'larla olan eşleşmeyi tanımlar.

Reference BBoxes Referans ROIs ile eşleşen bir veya daha fazla sıralı bounding box (liste olarak verin). Sıralama ROIs ile aynı olmalıdır.

📤 Çıktılar

Aligned Image Hesaplanan hizalama düzeltmesi uygulanmış olan sahne görüntüsü.

Translation Uygulanan öteleme düzeltmesi olarak (x, y) çifti.

Angle Uygulanan dönüş düzeltmesi (derece cinsinden).

🕹️ Kontroller

Mode Yalnızca öteleme (centroid kaydırması) veya öteleme artı açı (dönme + öteleme) kullanarak hizalamayı seçin. Sadece kaydırma gerekiyorsa Translation; döndürme düzeltmesi gerekiyorsa Translation + Angle kullanın.

Match Threshold % Her referans ROI için gereken minimum eşleşme skorunu ayarlayın. Daha yüksek değerler daha güçlü eşleşmeler gerektirir.

Include Flipped Eşleştirme sırasında ROI şablonlarının yatay olarak çevrilmiş hallerine izin vermek için açma/kapama (nesneler ayna görünümünde olabilir).

Method Şablon eşleştirme yöntemini seçin. Farklı yöntemler, referansların doku ve kontrastına bağlı olarak daha hızlı veya daha iyi sonuç verebilir.

Color Mode Gray (daha hızlı) veya BGR (renkli şablonlar için doğruluğu iyileştirebilir) arasında seçim yapın.

Tolerance (+/- px) Hizalamadan sonra kabul edilebilir artık (residual) için piksel toleransını ayarlayın. Daha gevşek eşleşmeleri kabul etmek için daha büyük, daha hassas hizalama için daha küçük değer kullanın.

🎨 Özellikler

• Sıralı referans eşleştirme: ROI ve bbox sırası, hizalamayı hesaplamak için kullanılan eşleşmeyi belirler.

• İki çalışma modu: yalnızca öteleme veya döndürme düzeltmesi için öteleme + açı.

• Ayna görünümlerle başa çıkmak için isteğe bağlı çevrilmiş şablon eşleştirme.

• Hız ve doğruluk dengesini ayarlamak için birden fazla eşleştirme yöntemi ve renk modu.

• Yapılandırma hatalarını önlemeye yardımcı olacak anlık doğrulama ile sayısal kontroller.

📊 Nasıl çalışır

• Blok, geçerli bir Scene Image ve eşleşen listelerdeki Reference ROIs ve Reference BBoxes gerektirir.

• Her ROI, sağlanan sıraya göre sahne ile eşleştirilir; karşılık gelen bbox beklenen konumu verir.

• Eşleşmeler Match Threshold % değerini sağlarsa blok, sahneyi hizalamak için gerekli öteleme (ve seçildiyse açı) hesaplanır.

• Blok, düzeltilmiş Aligned Image ile birlikte uygulanan Translation ve Angle çıktılarını döndürür.

• Girdiler eksik, boş veya ROI ile BBox sayıları eşleşmiyorsa blok hata mesajı verir ve düzeltilene kadar durur.

📝 Kullanım Talimatları

1. Net bir referans seti hazırlayın: sahnedeki sabit işaretleri benzersiz şekilde tanımlayan küçük şablon ROIs oluşturun.

2. ROI'lerle aynı sırada eşleşen bbox tanımlarını sağlayın.

3. Dönme düzeltmesi gerekip gerekmediğine göre Mode seçin.

4. Gerçek eşleşmeleri kabul edip kazara benzerlikleri reddetmek için Match Threshold % değerini ayarlayın.

5. Gerekirse, ayna görünümler ortaya çıkabiliyorsa Include Flipped seçeneğini etkinleştirin.

6. Bloğu çalıştırın ve sonuçları doğrulamak için Aligned Image ile sayısal çıktıları inceleyin.

💡 İpuçları ve Püf Noktaları

• Örnek bir görüntüden hassas referans şablonları oluşturmak için Image ROI veya Image ROI Select kullanın ve bunları Reference ROIs girdisine verin.

• Birden çok bölgeyi etkileşimli olarak tanımlamanız gerekiyorsa, birden fazla referans ROI kaydetmek için Image ROI Polygon Multi kullanın.

• Hizalama sonuçlarını görsel olarak doğrulamak isterseniz, Aligned Image çıktısını önizlemek için Show Image ile bağlayın.

• Dokulu sahnelerde daha sağlam eşleştirme için Color Modeu BGR olarak değiştirip farklı Method seçeneklerini deneyin.

• Otomatik şablon çıkarmaya ihtiyaç duyarsanız, örnekleri bulmak için Find Object kullanın ve raporlanan koordinatlardan ROI'ler türetin.

• Düzeltlenmiş kareleri saklamak istiyorsanız Image Logger veya Image Write ile aligned çıktıları kaydedin.

🛠️ Sorun Giderme

• ROI ile BBoxes eşleşmiyor Reference ROIs ve Reference BBoxes sayısının ve sırasının aynı olduğundan emin olun. Blok, eşleşmeyi tanımlamak için sıralamaya bağlıdır.

• Dönüş modu için yeterli referans yok Translation + Angle seçerseniz en az iki farklı referans sağlayın; aksi takdirde dönüş güvenilir şekilde çözülemez.

• Düşük eşleşme sayıları veya başarısız eşleşmeler Sahte pozitifler varsa Match Threshold % değerini yükseltin; gerçek referanslar kaçırılıyorsa biraz düşürün. Daha iyi sonuç için Method veya Color Mode seçeneklerini değiştirin.

• Hizalamadan sonra beklenmeyen artık değerler Küçük konumlama hataları kabul edilebilirse Tolerance (+/- px) değerini artırın; daha yüksek hassasiyet için referans ROI'lerinizi daha ayırt edici hale getirin.

• Görsel doğrulama Hizalama yanlış görünüyorsa hangi referansın eşleşemediğini teşhis etmek için ara şablonları ve Aligned Image önizlemesini Show Image ile kontrol edin.