# Annotation Window Basics

## Nesne Tespiti İçin Veri Etiketleme <a href="#annotate-data-for-object-detection" id="annotate-data-for-object-detection"></a>

### İlk Bakış <a href="#first-look" id="first-look"></a>

{% hint style="info" %}
Bilgisayarınızda bir [Nvidia GPU](/turkish/giris/system-requirements.md) bulunmalı, [CUDA, CUDNN](/turkish/baslarken/installation-and-licensing.md#gpu-acceleration-cuda) kurulmuş olmalı ve [Module Downloader Window](/turkish/augelab-studio-arayuzu/external-features/module-downloader.md#installing-the-ai-bundle) üzerinden **AI bundle** yüklenmiş olmalıdır.
{% endhint %}

<figure><img src="/files/UA1Q24J24LNqzfUGInko" alt=""><figcaption></figcaption></figure>

AugeLab Studio Image Annotation Window, kullanıcıların görüntülerdeki ilgi nesnelerinin etrafına bounding box çizerek bunları belirli sınıflarla ilişkilendirmesine olanak tanır.

### Başlarken <a href="#getting-started" id="getting-started"></a>

Image Annotation Window'u açmak için üst menüden `AI Tools` ➡️ `Image Annotation` seçeneğine gidin.

Görüntü etiketlemesi için iki şeye ihtiyacınız vardır:

1. `classes.names` dosyası
2. Dataset (görüntü klasörü)

### Sınıf Dosyası <a href="#class-file" id="class-file"></a>

Verilerinizi etiketlemek için önce `classes.names` adlı bir dosyaya ihtiyacınız vardır; bu, normalde .names uzantılı düz bir metin dosyasıdır. Tipik bir sınıf dosyası örneği şöyle görünür:

```
Human
Dog
Cat
Cup
```

Böyle bir dosyanız yoksa, `Classes` bölümünü kullanarak kendi dosyanızı oluşturabilirsiniz:

<figure><img src="/files/b5cyrQfjtnnua7jo3aCr" alt="" width="250"><figcaption></figcaption></figure>

Kendi classes dosyanızı oluşturmak için:

1. Bir sınıf adı yazın
2. `+` ile sınıfı ekleyin.
3. `Save Classes` (üçüncü düğme) üzerine tıklayın ve klasör seçmeye hazır olun.

İstenmeyen sınıfları kaldırmak için `-` düğmesini kullanabilirsiniz.

### Görüntü Klasörü Yükleme <a href="#load-image-folder" id="load-image-folder"></a>

{% hint style="warning" %}
Dataset yolunuzda İngilizce olmayan karakterlerin bulunmadığından emin olun.
{% endhint %}

Ekranın üstündeki `Open Folder` düğmesine tıklayın ve tüm görüntülerinizi içeren klasörü seçin:

<figure><img src="/files/rEDYhUnSsY77uQCwqNGP" alt=""><figcaption></figcaption></figure>

`Open Folder`a tıkladıktan sonra bir diyalog penceresi açılacak ve sizden klasör ile bir sınıf dosyası seçmeniz istenecektir:

<figure><img src="/files/DDVuc0PBzhomAHaIFnUR" alt=""><figcaption></figcaption></figure>

Select Image from List: Görüntü klasörü yüklendikten sonra, kullanılabilir görüntülerin bir listesi gösterilir. Etiketlemek istediğiniz görüntüye tıklayın.

<figure><img src="/files/MLgzKMtk8lyRTsPWJWFE" alt="" width="563"><figcaption></figcaption></figure>

### Görüntüleri Etiketleme <a href="#annotating-images" id="annotating-images"></a>

Görüntü etiketleme çok basittir. Etiketlemek istediğiniz nesnenin sol üst köşesine tıklayın, fareyi sürükleyin ve işlemi bitirdiğinizde bırakın!

![Annotation Window](/files/WsPQMt7yTY4rn1VmsWXV)

Bounding box'lar nesnenin etrafını sıkıca sarmalı, çok fazla arka plan içermemelidir. Bu, modelin nesnenin ilgili özelliklerine odaklanmasına yardımcı olur.

{% tabs %}
{% tab title="Bad Annotation" %}

<figure><img src="/files/2CEaoiCgGYkAKqeuiaZE" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Good Annotation" %}

<figure><img src="/files/qPIOXpCyfkCjfQ5fek8T" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Dataset Panelini Kullanma <a href="#using-the-dataset-panel" id="using-the-dataset-panel"></a>

<figure><img src="/files/UEy8dG8MEzcUT7vrNwrw" alt=""><figcaption></figcaption></figure>

Dataset panelinde şu özellikler bulunur:

1. `Filter` fonksiyonu ile görüntüleri sınıflara göre filtreleyebilirsiniz:
   * `All` Etiketli ve etiketsiz tüm görüntüler
   * `Annotated` Etiketlenmiş görüntüler
   * `Empty` Etiketi olmayan görüntüler; yine de eğitime dahil edilir. Etiketlenmemiş nesneler eğitimi olumsuz etkileyebilir.
   * `Excluded` Etiket dosyası olmayan görüntüler; eğitim üzerinde hiçbir etkileri yoktur.
2. `Search` fonksiyonu ile görüntü isimlerine göre filtreleme yapabilirsiniz.

### Video Etiketleme <a href="#annotating-videos" id="annotating-videos"></a>

Pencerenin üst kısmındaki **Video** modu ile video dosyalarını da etiketleyebilirsiniz:

![](/files/hAkm0rqDsjXiOw3L4yfP)

Video moduna geçmek sizden bir dosya yolu isteyecektir. Video seçimi, klasör gibi video üzerinde etiketleme yapmanıza olanak tanır.

### Araçlar <a href="#tools" id="tools"></a>

Annotation Tool içinde veri seti hazırlarken size yardımcı olacak birkaç araç vardır:

#### Sınıf Sıklığı Analizi <a href="#class-frequency-analysis" id="class-frequency-analysis"></a>

Class Frequency Analysis'a tıklamak, datasetinizde kaç adet sınıf olduğunu analiz eder ve gösterir.

Bu, veri setinizin dengeli olup olmadığını kontrol etmek için faydalıdır.

#### Veri Setini Artırma (Augment Dataset) <a href="#augment-dataset" id="augment-dataset"></a>

AugeLab Studio otomatik olarak veri artırma işlemleri uygulayabilir. Augmentasyon, benzer verileri yapay olarak oluşturma işlemidir.

Bu konu [**Augmenting Your Dataset**](/turkish/one-cikan-ozellikler/annotate-data-for-object-detection/augment-dataset.md) sayfasında detaylı olarak ele alınmıştır.

## 🛠️ AI Vision Sorun Giderme

AI modelleriniz beklediğiniz gibi çalışmıyorsa, performansı ayarlamak için bu hızlı çözüm ipuçlarını kullanın.

<details>

<summary>🚫 "Hiçbir şey etiketlemiyor" (Sıfır Tespit)</summary>

AI çok "çekingen" davranıyorsa genellikle eşik veya açıklama sorunudur.

* **Confidence Threshold** değerini biraz düşürün.
* **Text Threshold** (Grounding DINO kullanıyorsanız) kelime eşleşmesinde daha az katı olacak şekilde azaltın.
* **Daha Spesifik Olun:** "part" yerine "silver metal bolt" ya da "red plastic cap" gibi görsel olarak açıklayıcı ifadeler kullanın.
* **Sınıf Listesini Kontrol Edin:** Node ayarlarında sınıf listenizin yüklü ve boş olmadığından emin olun.

</details>

<details>

<summary>📦 "Çok fazla yanlış kutu" (Yanlış Pozitifler)</summary>

Ekranda yanlış pozitifler fazlaysa modeli daha sıkı yapmanız gerekir.

* **Confidence Threshold** değerini artırın.
* **Text Threshold** değerini arttırarak görüntü ile prompt arasındaki eşleşmeyi sıkılaştırın.
* **Belirsiz İfadelerden Kaçının:** "object" veya "item" gibi geniş ifadeler yerine, parçanın benzersiz renk veya dokusunu tanımlayın.

</details>

<details>

<summary>❓ "YOLO modeli sınıfımı tespit etmiyor"</summary>

Standart YOLO modelleri belirli veri kümeleri üzerinde ön-eğitimlidir.

* **COCO Standardı:** Temel YOLO modelleri yalnızca 80 COCO kategorisini tanır. Etiketlerinizin tam olarak eşleştiğinden emin olun (ör. `person`, `cell phone`, `chair`, `bottle`).
* **Özel Gereksinimler:** Özel bir şey tespit etmeniz gerekiyorsa (ör. "çizilmiş devre kartı"), **Text-Prompt** modellerinden (Grounding DINO gibi) faydalanın veya **Custom YOLO** modeli eğitin.

</details>

<details>

<summary>🐌 "İşlem yavaş veya takılıyor"</summary>

Görsel modeller işlemci gereksinimi yüksektir.

* **İlk Çalıştırma Gecikmesi:** Modellerin indirilmesi ve belleğe yüklenmesi ilk çalıştırmada yavaş olabilir; bu normaldir.
* **Model Boyutu:** Grounding DINO Base ve OWLv2 Large yüksek doğruluk sağlar ancak “cihazayı yorar”. Daha hızlı sonuç için "Tiny" veya "Small" varyantlarını deneyin.
* **Donanım:** AugeLab'in **GPU**'nuzu kullandığından emin olun. Büyük AI modellerinin CPU'da çalıştırılması önemli gecikmelere yol açar.

</details>

***

#### 💡 Hâlâ takıldınız mı?

AugeLab Studio içindeki **AI Assistant**'ı deneyin. Kamera görünümünüzü ve kutuların şu an nasıl göründüğünü tarif edin; genellikle eşik değerleri için doğru ondalık değeri önerebilir.

Eşiklerle ilgili bir açıklama tablosu (Threshold Cheat Sheet) ister misiniz?]\(./augment-dataset.md)

{% hint style="warning" %}
Augmentation işlemi, etiketleme bittikten sonra yapılmalıdır.
{% endhint %}

{% hint style="warning" %}
Augmentation işlemi veri setinizin disk kullanımını yaklaşık 10 katına kadar artırabilir.
{% endhint %}

#### Görüntü Ön İşleme (Preprocess Image) <a href="#preprocess-image" id="preprocess-image"></a>

Preprocess Image aracı, pencerede gösterilen görüntülerin kontrast, parlaklık ve gamma ayarlarını değiştirmenize olanak sağlar. Çok karanlık veya çok parlak görüntülerle çalışırken bu özellik faydalıdır.

![](/files/nguvdq2EaeEe9s2j5PZR)

#### Sınıf ID Değiştir <a href="#change-class-id" id="change-class-id"></a>

Change Class Id aracı, tüm etiketlenmiş örnekleri farklı bir sınıfa değiştirmeye olanak tanır.

Bu araç, iki farklı veri setini birleştirirken işinize yarar.

![](/files/H2J1P72Y27XFj5DzyXnH)

#### Kısayollar ve Yardım <a href="#shortcuts-and-help" id="shortcuts-and-help"></a>

<details>

<summary>Kısayollar ve yardım için üst menüdeki `Help` düğmesine tıklayabilirsiniz.</summary>

* `D`: Sonraki görüntü veya kareyi göster.
* `A`: Önceki görüntü veya kareyi göster.
* `Shift + D`: 10 görüntü/kare ilerle.
* `Shift + A`: 10 görüntü/kare geri git.
* `W`: Sınıf seçimini azalt.
* `S`: Sınıf seçimini artır.
* `Shift + W`: Sınıf seçimini 3 azalt.
* `Shift + S`: Sınıf seçimini 3 artır.
* `X`: Son eklenen bounding box'u kaldır.
* `Shift + C`: Tüm anotasyonları temizle.
* `O`: Boş bir anotasyon dosyası ekle veya anotasyonları temizle.
* `P`: Anotasyonları kaldır ve dosyayı temizle.
* `M`: Görüntüyü başka bir klasöre taşı veya hariç bırak (Folder Mode sadece).
* `Shift + Delete`: Görüntüyü ve anotasyonunu bilgisayardan sil (Folder Mode sadece).

</details>

#### Özel AI Nesne Tespiti Modeli ile Eğitim <a href="#training-with-custom-ai-object-detection-model" id="training-with-custom-ai-object-detection-model"></a>

Özel bir nesne tespiti modeli eğitmek için lütfen [**Object Detection Train**](/turkish/one-cikan-ozellikler/train-custom-ai-models-with-training-window.md) sayfasına bakın.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/turkish/one-cikan-ozellikler/annotate-data-for-object-detection/annotation-window-how-to.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.