Otomatik Etiketleme
Magic annotation, AI modelleri kullanarak sınırlayıcı kutuları (bounding box) otomatik oluşturmanıza yardımcı olur; böylece veri etiketleme çok daha hızlı olur.
Pratik bir iş akışı için tasarlanmıştır:
Modeli ve prompt’ları bir kez yapılandırın
Kaliteyi doğrulamak için bir resmi otomatik etiketleyin
Tüm veri setini toplu olarak otomatik etiketleyin
Hataları gözden geçirip düzeltin
Gereksinimler
Magic annotation en hızlı NVIDIA GPU ile çalışır.
Bir NVIDIA GPU bulunan bir bilgisayara ihtiyacınız var
CUDA ve cuDNN kurulu olmalıdır
Gerekli AI modüllerini Module Downloader penceresinden indirin
İlk Bakış

(Magic annotation'ı ✨ düğmesiyle açın (veya T tuşuna basın).)
Magic annotation'ı iki şekilde açabilirsiniz:
Mevcut resmi otomatik etiketlemek için
Ttuşuna basın (kaydedilmiş ayarlarınızı kullanır)Classes panelindeki ✨ düğmesine tıklayarak Magic annotation ayarlar penceresini açın
Magic annotation'ı ilk kez kullandığınızda, AugeLab Studio sizden ayarlarınızı yapılandırmanızı isteyecektir. Bu ayarlar kaydedilir ve ✨ düğmesine tıklayarak her zaman değiştirilebilir.
Başlamadan Önce (Önerilen)
Magic annotation için bir veri setine ve sınıf listesine ihtiyacınız var.
Image Annotation Window içinde veri seti klasörünüzü yükleyin
classes.namesdosyanızı yükleyin (veya oluşturun)
Annotation Window’u daha önce kullanmadıysanız, önce ana etiketleme kılavuzunu takip edin.
Magic annotation Penceresini Açma
AI Tools → Image Annotation açın
Veri setinizi ve class dosyanızı yükleyin
Classes panelinde ✨ düğmesine tıklayın
Bu, Magic annotation Settings penceresini açar.

Adım 1 — Model Seçimi
Model Selection içinde desteklenen dedektörlerden birini seçin.
Text-prompt modelleri (özelleştirilmiş sınıflar için önerilir)
Bu modeller sınıf açıklamalarınızı (text prompts) kullanarak nesneleri tespit eder:
Grounding DINO Tiny: iyi bir varsayılan, daha hızlı
Grounding DINO Base: daha doğru, daha ağır (GPU şiddetle önerilir)
OWLv2 Base Ensemble: genel amaçlı iyi model
OWLv2 Large Ensemble: daha doğru, daha ağır (GPU şiddetle önerilir)
Sınıflarınız standart COCO sınıfları değilse veya nesneyi doğal dil ile tanımlamak istiyorsanız bunları kullanın.
YOLO modelleri (hızlı, fakat sınıf eşleşmesi önemlidir)
YOLO modelleri YOLO/OpenCV DNN özelliği mevcut olduğunda görünür:
YOLOv4 (COCO)
YOLOv4 Tiny (COCO)
Bu modeller metin açıklamaları kullanmaz. COCO sınıf isimlerini kullanırlar.
YOLO (COCO) modelleri için, COCO sınıf isimleri dataset sınıf isimlerinizle tam olarak eşleşmelidir.
Örnek: sınıfınız person ise kesinlikle person olmalıdır (ör. human değil).
Özel YOLOv4 modeli
Kendi YOLOv4 modeliniz varsa, Custom YOLOv4 Model seçin ve sağlayın:
Weights dosyası (
.weights)Config dosyası (
.cfg)Names dosyası (
.names)
Adım 2 — Eşikleri Ayarlama
Confidence Threshold
Bir tespitin etiket haline gelmesi için ne kadar emin olması gerektiğini kontrol eder.
Yüksek değerler → daha az kutu, genelde daha temiz sonuç
Düşük değerler → daha fazla kutu, ama daha fazla yanlış pozitif
Başlangıç için iyi bir değer %30'dur.
Grounding DINO: Box Threshold ve Text Threshold
Bunlar sadece Grounding DINO modellerinde görünür:
Box Threshold: kutu güvenine ne kadar sıkı davranılacağını belirler
Text Threshold: metin–nesne eşleştirmesinin ne kadar sıkı olacağını belirler
Yönlendirme:
Çok fazla yanlış kutu varsa → önce Text Threshold artırın
Kutular gevşek veya çok genişse → Box Threshold artırın
Hiç tespit yoksa → eşikleri kademeli düşürün
Adım 3 — Daha İyi Sınıf Açıklamaları Yazma (Text-Prompt Modeller)
Text-prompt model seçtiyseniz, bir Class Descriptions tablosu görürsünüz.

(Class Descriptions tablosu (prompt olarak kullanılır).)
Neden önemli: açıklama, modelin nesnenizi bulmak için kullandığı prompt’tur.
İyi açıklamalar:
Görsel ve spesifik olmalı (renk, şekil, malzeme)
Gerçek görüntülerinize göre tanımlı olmalı (arka plan, aydınlatma, yönelim)
Örnekler:
boltyerine →silver bolt on a black conveyor beltcupyerine →white paper cup, top viewlabelyerine →rectangular sticker label on a cardboard box
Ayrıca kullanabilirsiniz:
Use Class Names ile prompt’ları sınıf isimlerine sıfırlama
Clear All ile baştan başlama
İpucu: İki sınıf benzer görünüyorsa, farkı vurgulayacak şekilde açıklamayı özelleştirin.
Örnek: scratch on metal surface vs oil stain on metal surface.
Adım 4 — Annotation Modunu Seçin (Önemli)
Magic annotation, daha önce etiketlenmiş görüntülerle başa çıkmak için üç modu destekler:
Override: mevcut annotation dosyalarını değiştirir
Add: yeni tespitleri mevcut annotasyonlara ekler
Skip: zaten annotasyonu olan görüntüleri işlemez
Önerilen kullanım:
Baştan başlıyorsanız veya her şeyi yeniden etiketliyorsanız Override seçin
Mevcut etiketleri tamamlamak istiyorsanız Add seçin
Kısmen etiketlenmiş bir dataset’i düzgünleştiriyorsanız ve üzerine yazmak istemiyorsanız Skip seçin
Magic annotation'ı Çalıştırma
Annotate Current (tek resim)
Önce Annotate Current kullanın.
Bu, prompt’larınızın iyi olduğunu, eşiklerin makul olduğunu ve kutuların doğru göründüğünü doğrulamak için en güvenli yoldur.
Sonuçlar iyi değilse, prompt/threshold ayarlarını düzeltin ve tekrar deneyin.
Batch Annotate All (tüm dataset)
Mevcut resim iyi görünüyorsa Batch Annotate All tuşuna basın.
İlerleme penceresi şunları gösterir:
mevcut durum (model yükleniyor / işleniyor)
ilerleme çubuğu
kalan tahmini süre (ETA)
Herhangi bir zamanda iptal edebilirsiniz.

(Batch Magic annotation ilerleme ve ETA.)
Sonuçları Gözden Geçirme ve Düzeltme
Magic annotation etiketlemeyi hızlandırmak içindir; gözden geçirmeyi kaldırmaz.
Otomatik etiketlemeden sonra:
Görüntüleri hızlıca tarayarak bariz hataları yakalayın
Yanlış kutuları düzeltin (yanlış sınıf, yanlış boyut)
Yanlış pozitifleri kaldırın
Kaçırılan nesneleri gerekirse manuel ekleyin
Tekrarlayan hatalar görürseniz, durun, prompt/threshold ayarlarını değiştirin ve yeniden çalıştırın.
Eğer AI modelleriniz beklediğiniz gibi davranmıyorsa, performansı ayarlamak için bu hızlı düzeltme seçeneklerini deneyin.
🚫 "Hiçbir şey etiketlemiyor" (Sıfır Tespit)
AI çok "çekingen" davranıyorsa genelde eşik veya açıklama sorunudur.
Confidence düşürün: Confidence Threshold’u biraz düşürün (örn. birkaç puan).
Metin hassasiyeti: Grounding DINO için Text Threshold değerini düşürün, böylece kelime eşleşmesine daha esnek davranır.
Daha spesifik olun: "part" yerine "silver metal bolt" veya "red plastic cap" gibi görsel tanımları kullanın.
Listeleri kontrol edin: class listenizin gerçekten node ayarlarında yüklü olup olmadığını doğrulayın; boş olmamalı.
📦 "Çok fazla yanlış kutu" (Hayalet Tespitler)
Ekranınız yanlış pozitiflerle doluysa, modelin "sıkılığı" artırılmalıdır.
Confidence artırın: Confidence Threshold’u yükseltin.
Metin sıkılığı: Text Threshold’u artırarak görüntü ile prompt arasındaki eşleşmeyi sıkılaştırın.
Belirsizliği kaldırın: "object" veya "item" gibi geniş prompt’lardan kaçının. AI gölgeleri "parts" olarak etiketliyorsa, parçanın benzersiz renklerini veya dokusunu açıkça tanımlayın.
❓ "YOLO modeli sınıfımı algılamıyor"
Standart YOLO modelleri belirli veri setleri üzerinde önceden eğitilmiştir.
COCO Standardı: Temel YOLO modelleri yalnızca 80 COCO kategorisini tanır. Etiketleriniz tam olarak eşleşmelidir (ör.
person,cell phone,chair,bottle).Özel ihtiyaçlar: Belirli bir şeyi tespit etmeniz gerekiyorsa (ör. "çizik bir devre kartı"), Text-Prompt (Grounding DINO gibi) modele geçin veya Custom YOLO eğitimi yapın.
🐌 "İşlem yavaş veya takılıyor"
Görsel modeller hesaplama açısından maliyetlidir.
İlk çalıştırma gecikmesi: Modeller indirilirken ve belleğe alınırken ilk sefer genelde yavaştır; bu normaldir.
Model boyutu: Grounding DINO Base ve OWLv2 Large yüksek doğruluk sunar fakat "ağırdır". Daha hızlı sonuç için "Tiny" veya "Small" varyantını deneyin.
Donanım: AugeLab'ın GPU kullandığından emin olun. Büyük AI modellerini CPU’da çalıştırmak belirgin gecikmeye yol açar.
💡 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şikler için tam ondalık değer önerebilir.
Eğer isterseniz, size Confidence ve Text eşikleri arasındaki farkı tam olarak açıklayan bir "Threshold Cheat Sheet" tablosu oluşturabilirim — ister misiniz?
Notlar
Magic annotation ayarları
Ttuşuna bastığınızda kaydedilir ve tekrar kullanılır.Planınız/izinleriniz offline Magic annotation için sınırlamalar içeriyorsa, araç toplu işleme sırasında limitleri aştığınızda işlemi engelleyebilir.
Last updated