Ana içeriğe geç

Sorun Giderme

Bu sayfa, MipMapEngine SDK kullanırken karşılaşılan yaygın sorunlar için tanı ve çözümler sağlar.

🔍 Tanı Araçları​

Sorunlarla karşılaştığınızda, lütfen önce aşağıdaki tanı araçlarını kullanın:

1. Yapılandırma Dosyası Doğrulama​

task_json_check.exe -task_json your_config.json

2. Donanım Kontrolü​

hardware_check.exe

3. Lisans Durumu​

license_manager.exe -info

📋 Yaygın Hatalar ve Çözümler​

Yapılandırma Dosyası Hataları​

Hata: JSON Ayrıştırma Başarısız​

Hata mesajı:

[ERROR] JSON parse failed: expected ',' or '}' at line 45

Sebep: JSON format hatası, genellikle eksik veya fazla virgül.

Çözüm:

  1. Sözdizimini kontrol etmek için JSON biçimlendirme araçlarını kullanın
  2. Son öğeden sonra virgül olmadığından emin olun
  3. Kapatılmamış parantezleri veya tırnak işaretlerini kontrol edin

Düzeltme örneği:

// Yanlış
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"},  // Son öğede virgül olmamalı
  ]
}

// Doğru
{
  "image_meta_data": [
    {"id": 1, "path": "image1.jpg"}
  ]
}

Hata: Görüntü Dosyası Bulunamadı​

Hata mesajı:

[ERROR] Image file not found: C:/images/DJI_0001.JPG

Sebep: Belirtilen görüntü yolu yanlış veya dosya mevcut değil.

Çözüm:

  1. Dosya yolu yazımını kontrol edin
  2. Dosyanın gerçekten var olduğunu onaylayın
  3. Doğru yol ayırıcısını kullanın (/ kullanılması önerilir)
  4. Mutlak yol kullanmayı deneyin

Yol örnekleri:

// Windows - Önerilen
"path": "C:/Projects/Images/DJI_0001.JPG"

// Windows - Bu da çalışır
"path": "C:\\Projects\\Images\\DJI_0001.JPG"

// Göreli yol
"path": "../images/DJI_0001.JPG"

Hata: Parametre Aralık Dışı​

Hata mesajı:

[ERROR] Invalid resolution_level: 5 (should be 1-3)

Sebep: Parametre değeri izin verilen aralıkta değil.

Çözüm: Parametre değerlerini kontrol edin ve düzeltin:

  • resolution_level: 1 (Yüksek), 2 (Orta), 3 (Düşük)
  • input_image_type: 1 (RGB), 2 (Multispektral), 3 (Kızılötesi)
  • coordinate_system.type: 1 (Projeksiyonlu), 2 (Coğrafi), 3 (Jeosantrik)

Görüntü İşleme Hataları​

Hata: Yetersiz Görüntü​

Hata mesajı:

[ERROR] Insufficient images for reconstruction. Minimum 5 images required, found 3.

Sebep: 3D yeniden yapılandırma için çok az görüntü.

Çözüm:

  • En az 5 görüntü sağlayın
  • Görüntüler arasında yeterli örtüşme sağlayın (önerilen >%60)
  • Herhangi bir görüntünün otomatik olarak filtrelenip filtrelenmediğini kontrol edin (günlüklere bakın)

Hata: GPS Bilgisi Yok​

Hata mesajı:

[WARNING] No GPS information found in image EXIF

Sebep: Görüntü EXIF'inde GPS bilgisi yok.

Çözüm:

  1. Özel POS verilerini kullanın:
{
  "id": 1,
  "path": "image.jpg",
  "meta_data": {
    "pos": [114.123, 22.456, 100.5],
    "pos_sigma": [0.5, 0.5, 1.0]
  }
}
  1. Konum kısıtlamalarını azaltın:
{
  "use_image_position_constraint": false
}

Çok Kameralı Yeniden Yapılandırma Sorunları​

Hata: Kamera Grubu Görüntü Sayısı Uyuşmazlığı​

Hata mesajı:

[ERROR] Camera group image count mismatch: nadir(50), oblique_f(48)

Sebep: Farklı kamera grupları arasında tutarsız görüntü sayısı.

Çözüm:

  1. Eksik görüntü olup olmadığını kontrol edin
  2. Çok kameralı senkron tetiklemenin düzgün çalıştığından emin olun
  3. Gruplama yapılandırmasını doğrulamak için task_json_check kullanın

Doğru gruplama örneği:

{
  "image_meta_data": [
    // Her konumda tüm kameralardan görüntüler olmalı
    {"id": 1, "path": "pos1/nadir.jpg", "group": "nadir"},
    {"id": 2, "path": "pos1/forward.jpg", "group": "forward"},
    {"id": 3, "path": "pos1/backward.jpg", "group": "backward"},
    // ... sonraki konum
    {"id": 4, "path": "pos2/nadir.jpg", "group": "nadir"},
    {"id": 5, "path": "pos2/forward.jpg", "group": "forward"},
    {"id": 6, "path": "pos2/backward.jpg", "group": "backward"}
  ]
}

Bellek ve Performans Sorunları​

Hata: Bellek Yetersiz​

Hata mesajı:

[ERROR] Out of memory. Required: 24GB, Available: 16GB

Sebep: Mevcut görevi işlemek için sistem belleği yetersiz.

Çözüm:

  1. Hassasiyet seviyesini düşürün:
{
  "resolution_level": 3  // Düşük hassasiyet kullan
}
  1. Bellek kullanımını sınırlayın:
{
  "min_avali_memory_size": 12.0  // 12GB ile sınırla
}
  1. Çıktı formatlarını azaltın:
{
  "generate_obj": true,
  "generate_osgb": false,  // Gereksiz çıktıları devre dışı bırak
  "generate_3d_tiles": false
}

Hata: GPU Belleği Yetersiz​

Hata mesajı:

[ERROR] CUDA out of memory. Tried to allocate 2.00 GiB

Sebep: GPU belleği yetersiz.

Çözüm:

  1. GPU kullanan diğer programları kapatın
  2. resolution_level'i düşürün
  3. Blok işleme kullanın (büyük projeler için)

Lisans Sorunları​

Hata: Geçersiz Lisans​

Hata mesajı:

[ERROR] Invalid license: License has expired

Çözüm:

  1. Lisans durumunu kontrol edin: license_manager.exe -info
  2. Sistem saatinin doğru olduğunu onaylayın
  3. Lisansı yeniden etkinleştirin
  4. Lisansı güncellemek için teknik destekle iletişime geçin

Hata: Virbox Servisi Çalışmıyor​

Hata mesajı:

[ERROR] Virbox service not running

Çözüm:

Windows：

# Servisi başlat
net start "Virbox Service"

# Servis durumunu kontrol et
sc query "Virbox Service"

Linux：

# Sürücüyü yükle
sudo modprobe virbox

# Sürücüyü kontrol et
lsmod | grep virbox

Çıktı Sonuç Sorunları​

Sorun: Modelde Delikler Var​

Olası sebepler:

  • Yetersiz görüntü örtüşmesi
  • Doku eksikliği olan alanlar (su yüzeyi, cam vb.)
  • Kötü görüntü kalitesi

Çözüm:

  1. Görüntü örtüşmesini %80'e çıkarın
  2. Yan görünümleri tamamlamak için eğik fotoğraflama kullanın
  3. Güçlü ışık veya gölge koşullarında çekim yapmaktan kaçının
  4. Bulanık görüntüleri kontrol edin ve kaldırın

Sorun: Bulanık Doku​

Olası sebepler:

  • Orijinal görüntüler bulanık
  • Uçuş yüksekliği çok fazla
  • Uygun olmayan kamera ayarları

Çözüm:

  1. Daha hızlı deklanşör hızı kullanın (≥1/1000s)
  2. Uçuş yüksekliğini azaltın
  3. Daha yüksek çözünürlüklü kamera kullanın
  4. Kamera odağının doğru olduğundan emin olun

Sorun: Koordinat Kayması​

Olası sebepler:

  • Yanlış koordinat sistemi ayarları
  • Kötü GPS doğruluğu
  • Kontrol noktaları kullanılmamış

Çözüm:

  1. Koordinat sistemi yapılandırmasını kontrol edin:
{
  "coordinate_system": {
    "type": 2,
    "label": "WGS 84",
    "epsg_code": 4326
  }
}
  1. Kontrol noktaları ekleyin:
{
  "gcp_path": "gcps.txt",
  "gcp_coor_sys": {
    "type": 3,
    "epsg_code": 32650  // Gerçekle tutarlılığı sağlayın
  }
}

🛠️ Gelişmiş Tanı​

Ayrıntılı Günlükleri Görüntüleme​

Günlük dosyası konumu: working_dir/log/log.txt

Anahtar bilgileri bulun:

# Hataları görüntüle
grep -i "error" log.txt

# Uyarıları görüntüle
grep -i "warning" log.txt

# İlerlemeyi görüntüle
grep "PROGRESS" log.txt

Performans Analizi​

Günlüklerde performans metriklerini bulun:

  • [TIMING] - Her aşama için zaman tüketimi
  • [MEMORY] - Bellek kullanımı
  • [GPU] - GPU kullanımı

Ara Sonuçları Kontrol Etme​

Sorunları bulmak için ara sonuçları kontrol edin:

  1. AT sonuçları: working_dir/AT/mvs.xml
  2. ROI aralığı: working_dir/milestones/roi.json
  3. Kalite raporu: working_dir/report/report.json

📞 Yardım Alma​

Yukarıdaki çözümler sorununuzu çözemezse:

  1. Tanı bilgilerini toplayın:

    • task_json_check çalıştırma çıktısı
    • Tam log.txt dosyası
    • Yapılandırma dosyası (hassas veriler kaldırılmış)
    • Sistem bilgileri (donanım yapılandırması)

  2. Sorunu gönderin:

    • GitHub Issues: [Proje Deposu]
    • Teknik destek e-postası: support@mipmap.com
    • Yukarıdaki tanı bilgilerini ekleyin

  3. Güncellemeleri kontrol edin:

    • Yeni bir sürüm olup olmadığını kontrol edin
    • Sürüm değişiklik günlüğünü inceleyin
    • Bilinen sorunlar listesini takip edin

Sürekli güncellenmektedir. Listelenmemiş sorunlarla karşılaşırsanız, lütfen teknik destekle iletişime geçin.