> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/turkish/fonksiyon-bloklari/blocks-reference/image-transformations/transformation-filters/alignment.md).

# 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 <a href="#inputs" id="inputs"></a>

`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 <a href="#outputs" id="outputs"></a>

`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 <a href="#controls" id="controls"></a>

`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 <a href="#features" id="features"></a>

* 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 <a href="#evaluation" id="evaluation"></a>

* 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ı <a href="#usage" id="usage"></a>

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ı <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Ö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 Mode`u `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 <a href="#troubleshooting" id="troubleshooting"></a>

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