Reconstruct3D - 3D Yeniden Yapılandırma

Genel Bakış

Reconstruct3D arayüzü, hava üçgenlemesi sonuçlarından 2D ve 3D modeller üretmek için kullanılır. Tipik olarak ReconstructAT ile birlikte tam yeniden yapılandırma iş akışını tamamlamak için kullanılır. Bu arayüz, birden fazla çıktı formatını, blok işlemeyi ve ayrıntılı parametre kontrolünü destekler.

Uygulanabilir Senaryolar

• Hava üçgenlemesi sonuçlarından 3D modeller üretmek
• Ortofoto ve dijital yüzey modelleri üretmek
• Büyük ölçekli veriler için blok yeniden yapılandırması
• Belirli çıktı formatlarına ihtiyaç

Arayüz Kullanımı

Komut Satırı Kullanımı

reconstruct_full_engine.exe -reconstruct_type 2 -task_json 3d_config.json

Parametre Açıklaması

• reconstruct_type: 2 olarak sabitlenmiş (Reconstruct3D'yi belirtir)
• task_json: Yapılandırma dosyası yolu

Yapılandırma Parametreleri

Gerekli Parametreler

Parametre	Tür	Açıklama
license_id	int	SDK lisans kodu, 9200 olarak birleştirilmiş
working_dir	string	Çalışma dizini (hava üçgenlemesi ile aynı olmalı)
gdal_folder	string	GDAL veri yolu
input_image_type	int	Görüntü türü: 1=RGB, 2=Çok spektral, 3=Kızılötesi
image_meta_data	JSON Array	Giriş görüntü metadata bilgileri
resolution_level	int	Yeniden yapılandırma doğruluğu: 1=Yüksek doğruluk, 2=Orta doğruluk, 3=Düşük doğruluk

İsteğe Bağlı Parametreler

Temel Parametreler

Parametre	Tür	Varsayılan	Açıklama
reconstruct_mode	int	0	Yeniden yapılandırma modu: 0=Genel sahne, 1=Çevreleyen sahne, 2=Elektrik hattı sahnesi
min_avali_memory_size	double	0	Minimum kullanılabilir bellek (GB), blok miktarını kontrol etmek için kullanılır
fast_mode	bool	false	Hızlı mod, verimliliği artırır ancak detayları azaltır
keep_undistort_images	bool	false	Bozulmamış görüntülerin tutulup tutulmayacağı

Çıktı Formatı Kontrolü

Parametre	Tür	Varsayılan	Açıklama
generate_osgb	bool	false	OSGB formatı 3D model üret
generate_3d_tiles	bool	false	3D Tiles (b3dm) formatı üret
generate_las	bool	false	LAS formatı nokta bulutu üret
generate_pc_ply	bool	false	PLY formatı nokta bulutu üret
generate_pc_osgb	bool	false	OSGB formatı nokta bulutu LOD üret
generate_pc_pnts	bool	false	pnts formatı nokta bulutu LOD üret
generate_obj	bool	false	OBJ formatı dokulu mesh üret
generate_ply	bool	false	PLY formatı dokulu mesh üret
generate_geotiff	bool	false	GeoTIFF formatı ortofoto üret
generate_tile_2D	bool	false	Ortofoto üzerinde fayans kesimi gerçekleştir
generate_2D_from_3D_model	bool	false	3D modelden 2D ortofoto üret

Gelişmiş Parametreler

Parametre	Tür	Varsayılan	Açıklama
use_draco_compression	bool	true	3D Tiles için Draco sıkıştırması kullanılıp kullanılmayacağı
tex_image_type_3dtiles	int	0	3D Tiles doku formatı: 0=JPEG, 1=WebP
use_gcj02	bool	false	Ortofoto fayanslarının GCJ02 koordinat sistemine dönüştürülüp dönüştürülmeyeceği
coordinate_system_3d	JSON	-	3D çıktı için koordinat sistemi
coordinate_system_2d	JSON	-	2D çıktı için koordinat sistemi
roi_for_2d	JSON	-	2D yeniden yapılandırma için ilgi alanı
roi_for_3d	JSON	-	3D yeniden yapılandırma için ilgi alanı
roi_coordinate_system	JSON	WGS84	ROI için koordinat sistemi

Veri Yapısı Açıklaması

Kamera Metaverileri

{
  "id": 1,                     // Benzersiz kamera kimliği
  "meta_data": {
    "camera_name": "Camera-1",    // Kamera adı
    "projection_model": 0,       // Projeksiyon modeli (isteğe bağlı)
    "width": 4000,              // Sensör genişliği (piksel)
    "height": 3000,             // Sensör yüksekliği (piksel)
    "parameters": [             // Kamera iç parametreleri (10 elemanlı dizi)
      // fx, fy, cx, cy, k1, k2, p1, p2, k3，placeholder_param
    ]
  }
}

ROI (İlgi Alanı)

{
  "boundary": [              // 2D poligon sınırı (saat yönünün tersine)
    [x1, y1],
    [x2, y2],
    [x3, y3]
    // ...
  ],
  "min_z": 100.0,           // Minimum yükseklik (isteğe bağlı)
  "max_z": 500.0            // Maksimum yükseklik (isteğe bağlı)
}

Çıktı Koordinat Sistemi Ayarları

{
  "coordinate_system_3d": {
    "type": 3,              // Projeksiyonlu koordinat sistemi
    "epsg_code": 32650      // UTM Zone 50N
  },
  "coordinate_system_2d": {
    "type": 2,              // Coğrafi koordinat sistemi
    "epsg_code": 4326       // WGS84
  }
}

Tam Yapılandırma Örnekleri

Temel 3D Yeniden Yapılandırma

{
  "license_id": 9200,
  "working_dir": "C:/Projects/3D_Task",
  "gdal_folder": "C:/MipMap/SDK/data",
  "input_image_type": 1,
  "resolution_level": 2,
  "image_meta_data": [
    {
      "id": 1,
      "path": "C:/Images/DJI_0001.JPG"
    },
    {
      "id": 2,
      "path": "C:/Images/DJI_0002.JPG"
    }
  ],
  "generate_osgb": true,
  "generate_3d_tiles": true,
  "generate_las": true,
  "generate_geotiff": true
}

Yüksek Hassasiyetli Yeniden Yapılandırma Yapılandırması

{
  "license_id": 9200,
  "working_dir": "C:/Projects/HighQuality_3D",
  "gdal_folder": "C:/MipMap/SDK/data",
  "input_image_type": 1,
  "resolution_level": 1,      // En yüksek doğruluk
  "reconstruct_mode": 0,      // Genel sahne
  "image_meta_data": [...],
  "generate_osgb": true,
  "generate_3d_tiles": true,
  "generate_obj": true,
  "generate_geotiff": true,
  "generate_tile_2D": true,
  "coordinate_system_3d": {
    "type": 3,
    "epsg_code": 32650        // UTM 50N
  },
  "coordinate_system_2d": {
    "type": 2,
    "epsg_code": 4326         // WGS84
  }
}

Büyük Ölçekli Veri Blok Yeniden Yapılandırması

{
  "license_id": 9200,
  "working_dir": "C:/Projects/LargeScale_3D",
  "gdal_folder": "C:/MipMap/SDK/data",
  "input_image_type": 1,
  "resolution_level": 2,
  "min_avali_memory_size": 16.0,  // Her bloğu maksimum 16GB bellek ile sınırla
  "image_meta_data": [...],
  "roi_for_3d": {
    "boundary": [
      [114.12, 22.12],
      [114.13, 22.12],
      [114.13, 22.13],
      [114.12, 22.13]
    ],
    "min_z": 0,
    "max_z": 500
  },
  "generate_3d_tiles": true,
  "use_draco_compression": true,
  "tex_image_type_3dtiles": 1    // WebP doku sıkıştırması kullan
}

Özel Sahne Yapılandırması

Çevreleyen Nesne Yeniden Yapılandırması

{
  "license_id": 9200,
  "working_dir": "C:/Projects/Object_3D",
  "gdal_folder": "C:/MipMap/SDK/data",
  "input_image_type": 1,
  "resolution_level": 1,
  "reconstruct_mode": 1,      // Çevreleyen sahne modu
  "image_meta_data": [...],
  "generate_obj": true,
  "generate_ply": true,
  "coordinate_system_3d": {
    "type": 1               // Yerel koordinat sistemi
  }
}

Sadece Ortofoto Üret

{
  "license_id": 9200,
  "working_dir": "C:/Projects/Ortho_Only",
  "gdal_folder": "C:/MipMap/SDK/data",
  "input_image_type": 1,
  "resolution_level": 2,
  "image_meta_data": [...],
  "generate_geotiff": true,
  "generate_tile_2D": true,
  "generate_2D_from_3D_model": true,
  "roi_for_2d": {
    "boundary": [...]       // Ortofoto kapsamını belirt
  },
  "coordinate_system_2d": {
    "type": 3,
    "epsg_code": 32650
  }
}

Çıktı Sonuçları

3D Model Çıktısı (products/3D/)

• model-osgb/ - OSGB formatı model ve LOD
• model-b3dm/ - 3D Tiles formatı (tileset.json ile)
• model-obj/ - OBJ formatı model ve dokular
• point-las/ - LAS formatı nokta bulutu
• point-ply/ - PLY formatı nokta bulutu
• point-osgb/ - OSGB formatı nokta bulutu LOD
• point-pnts/ - 3D Tiles nokta bulutu formatı

2D Ürün Çıktısı (products/2D/)

• geotiffs/ - GeoTIFF formatı ortofoto ve DSM
• dom_tiles/ - Ortofoto fayansları
• dsm_tiles/ - Dijital yüzey modeli fayansları

Ara Sonuçlar (milestones/)

• undistorted/ - Bozulmamış görüntüler (eğer tutulmuşsa)
• depth_maps/ - Derinlik haritaları
• mesh/ - Ara mesh verileri

Çözünürlük Seviyesi Açıklaması

Seviye	Açıklama	Göreceli İşleme Süresi	Uygulama Senaryoları
1	Ultra yüksek hassasiyet	3-5x	Profesyonel ölçüm, kültürel miras koruma
2	Yüksek hassasiyet	1x	Genel mühendislik uygulamaları
3	Hızlı önizleme	0.2-0.3x	Hızlı doğrulama, önizleme

Hassasiyet ve Verimlilik Dengesi

• resolution_level=1: En yüksek geometrik detay ve doku netliği
• resolution_level=2: Kalite ve verimliliği dengeler, çoğu uygulama için önerilir
• resolution_level=3: Hızlı işleme, ön doğrulama için uygun

En İyi Uygulamalar

1. Bellek Yönetimi

Büyük ölçekli veriler için:

{
  "min_avali_memory_size": 24.0,  // Mevcut belleğe göre ayarla
  "resolution_level": 2            // Hassasiyeti azaltmayı düşün
}

2. Çıktı Formatı Seçimi

• Web Görüntüleme: 3D Tiles + Draco sıkıştırması kullan
• CBS Analizi: GeoTIFF ve LAS üret
• Profesyonel Yazılım: OSGB formatı kullan
• Düzenleme ve İşleme: OBJ veya PLY dışa aktar

3. Koordinat Sistemi Ayarları

• 3D modeller tipik olarak projeksiyonlu koordinat sistemleri kullanır (ör. UTM)
• Ortofotolar, ihtiyaçlara göre coğrafi veya projeksiyonlu sistemler kullanabilir
• Web uygulamaları için WGS84 kullanmayı düşün

4. ROI Kullanımı

• Hava üçgenlemesinden üretilen ROI'yi temel olarak kullan
• İhtiyaçlara göre aralığı ayarla
• 2D ve 3D için ayrı ROI'ler ayarla

Performans Optimizasyonu

Hızlı İşleme

{
  "resolution_level": 3,
  "fast_mode": true,
  "generate_3d_tiles": true,  // Sadece gerekli formatları üret
  "use_draco_compression": true
}

Yüksek Kaliteli Çıktı

{
  "resolution_level": 1,
  "fast_mode": false,
  "keep_undistort_images": true,  // İnceleme için ara sonuçları tut
  "generate_obj": true,            // Yüksek kaliteli mesh üret
  "generate_geotiff": true
}

Sık Sorulan Sorular

S: "Hava üçgenlemesi sonuçları bulunamıyor" hatası

C: Şunları sağlayın:

• working_dir ReconstructAT'de kullanılanla aynı
• Hava üçgenlemesi başarıyla tamamlandı
• milestones dizini mvs.xml dosyası içeriyor

S: Bellek yetersizliği hatası

C:

• Bellek kullanımını sınırlamak için min_avali_memory_size ayarla
• resolution_level'ı azalt
• Ön bloklamak için DivideTiles kullan

S: Yanlış çıktı koordinatları

C:

• coordinate_system_3d/2d ayarlarını kontrol et
• ROI koordinat sisteminin verilerle eşleştiğini onayla
• GDAL veri yolunun doğru olduğunu doğrula

Sonraki Adımlar

• Çıktı Formatı Detaylarını kontrol et
• Büyük ölçekli veriler için Blok İşleme hakkında öğren
• Yeniden yapılandırma kalitesini optimize etmek için Temel Kavramları incele

---

Not: Reconstruct3D zengin çıktı seçenekleri sağlar. Önce düşük hassasiyetle doğrulamanız, sonra yüksek kaliteli yeniden yapılandırmaya geçmeniz önerilir.