Temel Esaslar

Bu bölüm, Setuav Standardı boyunca kullanılan teknik standartları tanımlar ve farklı uygulamalar arasında tutarlılık sağlar.

Terminoloji: Normative ve Non-normative

Normative: Bir dosyanın standartla uyumlu sayılması için izlenmesi zorunlu olan kurallar.
Non-normative: Açıklayıcı notlar, örnekler veya uygulama tavsiyeleri; bağlam sağlar ancak zorunlu değildir.

Koordinat Sistemi

Setuav, sabit bir gövde koordinat çerçevesi kullanır (dokümantasyonda genellikle SETUAV_BODY olarak anılır):

Eksen	Yön	Açıklama
Origin	Burun Ucu	Gövdenin en uç ön noktası (x=0, y=0, z=0).
+X	Arka (Aft)	Burun ucundan kuyruğa doğru artar.
+Y	Sağ	Sağ taraf (sağ el kuralı).
+Z	Yukarı	Dikey olarak yukarı doğru artar.

Aynalama (Mirroring): Varsayılan olarak, XZ-düzlemi (Y = 0) boyunca simetri varsayılır.

Pozisyon ve Rotasyon Yapısı

Standart boyunca, bileşen pozisyonları ve rotasyonları tutarlı bir iç içe (nested) yapı kullanılarak tanımlanır:

position:
  x: 0    # mm, X-ekseni boyunca pozisyon
  y: 0    # mm, Y-ekseni boyunca pozisyon
  z: 0    # mm, Z-ekseni boyunca pozisyon

rotation:
  x: 0    # deg, X-ekseni etrafında rotasyon (roll)
  y: 0    # deg, Y-ekseni etrafında rotasyon (pitch)
  z: 0    # deg, Z-ekseni etrafında rotasyon (yaw)

Rotasyon Konvansiyonu: Rotasyonlar her eksen etrafındaki açılar olarak belirtilir:

rotation.x (roll): X-ekseni (boylamsal) etrafında rotasyon
rotation.y (pitch): Y-ekseni (yanal) etrafında rotasyon
rotation.z (yaw): Z-ekseni (dikey) etrafında rotasyon

Tüm rotasyonlar sağ el kuralını takip eder.

Birimler

Belirsizliği önlemek için, standart bir dosyadaki tüm sayısal değerler (şemada aksi belirtilmedikçe) şu birimleri kullanmalıdır:

Nicelik	Birim	Sembol
Uzunluk	Milimetre	`mm`
Açı	Derece	`deg`
Kütle	Gram	`g`
Kuvvet	Newton	`N`
Hız	Metre / saniye	`m/s`
Güç	Watt	`W`
Akım	Amper	`A`
Enerji	Watt-saat	`Wh`
Zaman (Endurance)	Saat	`h`

Modüler Dosyalar ve Referanslar

Projeler, tekrar kullanılabilirlik için birden fazla dosyaya bölünebilir.

Referans Özelliği: ref anahtarı harici bir dosyayı işaret etmek için kullanılır.
Yol Çözümleme (Path Resolution): Yol, her zaman referansı içeren dosyanın bulunduğu dizine göre relative olarak çözülür.

Örnek:

geometry:
  fuselage:
    ref: "./parts/fuselage_v1.yaml"

Dosya Tipleri ve Ayrımı

Setuav Standardı iki ana dosya tipi tanımlar:

Tasarım Dosyaları (design.yaml): Aracın fiziksel özelliklerini, geometrisini ve bileşenlerini tanımlar. Normative şema: schemas/design.json.
Rapor Dosyaları (report.yaml): Bir tasarım üzerinde yapılan analizlerin sayısal sonuçlarını içerir. Normative şema: schemas/report.json.

Bu ayrım, mühendislik girdisi ile analiz çıktısını net bir şekilde birbirinden ayırır.