Archi-Civilarchi-civil.com
Savunabileceğiniz Hesaplar · HES-03  |  Güven: A

Ana Sayfa / Yazılar / Savunabileceğiniz Hesaplar HES-03

İşaret ve Yön Kuralları: Hesaplardaki En Sessiz Hata

Bir azimut güneyden mi ölçülür, kuzeyden mi? Pozitif kesme gerilmesi saat yönünde mi döndürür, tersine mi? Bu sorular basit görünür; ama bu sitenin denetiminde bulunan hataların beşi tam olarak bu sorulardan çıktı. Ve hiçbiri formül hatası değildi.

Güven: A Motor: engine/solar-geometry.js Test: tests/solar-geometry.test.js Okuma: ~9 dk Son doğrulama: 2026-10-21 English: read in English
Hesap aracını aç → Tüm yazılar →

1. Formülsüz hata

Bir mühendislik hesabındaki hataların çoğu yanlış bir formülden gelmez. Formül doğrudur; ama iki parça, aynı büyüklüğü farklı bir kuralla okur. Biri açıyı kuzeyden ölçer, öteki güneyden. Biri saat yönünün tersini pozitif sayar, öteki saat yönünü. İki parça da kendi içinde doğrudur; birleştikleri yerde sonuç yanlıştır.

2. Beş örnek

archi-civil.com'un denetiminde bu türden beş durum bulundu:

NeredeSöylenen kuralUygulanan kuralSonuç
Güneş azimutuGüneyden ölçülür, doğu negatifKuzeyden ölçülüyorduÖğlede 180° (doğrusu 0°)
Kinetik cepheCephe yönü: 0 = güneyGüneş kuzeyden ölçülüyorduGüney cephe yaz öğlesinde "güneş arkada"
Mohr dairesiEtiket: "pozitif τ = saat yönü"Motor: pozitif τ saat yönünün tersine döndürürEtikete uyan kullanıcı asal doğrultuyu yanlış bulur
Konsol kirişMetin: "Ma saat yönünde"Fizik: ankastre moment saat yönünün tersineSerbest cisim diyagramı yanlış çizilir
Referans çözücüUç momenti: saat yönünün tersi +Tepki formülünde işaret ters yazıldıDoğru sayfa %107 hatalı göründü

Beşinin ortak noktası, hatanın ne kodun içinde ne de formülde olması. Hata iki şeyin arasında: bir kural ile o kuralı kullanan hesap arasında, bir motor ile onu anlatan etiket arasında.

3. Neden bu kadar sessiz?

İşaret ve yön hataları çoğu zaman makul görünen sonuçlar üretir. Güneş azimutu 180° çıktığında bu bir sayıdır, bir hata mesajı değil. Ters işaretli bir moment, büyüklüğü doğru olduğu için ilk bakışta doğru görünür. Bu yüzden bu hatalar ne programı çökertir ne de "olmayacak" bir değer üretir; yalnızca yanlış bir karar verdirir.

İkinci neden, testlerin de aynı kuralla yazılmasıdır. Kinetik cephe testi güney cepheyi 180° ile temsil ediyordu, yani motorun yanlış kuralını paylaşıyordu (bkz. HES-01). Kuralı paylaşan bir test, kural hatasını göremez.

4. Sınırda kural yazmak

En etkili önlem, kuralı her sınırda açıkça yazmaktır: bir fonksiyonun girdi ve çıktısında, bir arayüz etiketinde, bir tablonun başlığında. Güneş motorundaki alanın adı "azimuthFromSouth" idi; yani kural adın içindeydi. Hata, adın söylediği ile hesabın yaptığının ayrışmasıydı. Kural yazılı olduğu için hata bulunabildi.

Düzeltmelerde aynı ilke uygulandı: Güneş ve kinetik cephe motorları artık "güneyden, doğu negatif, batı pozitif" kuralını hem kod yorumunda hem arayüz etiketinde aynı sözcüklerle söylüyor. Cross örneğinde ise sonuçların işaret kuralı metnin içine açıkça eklendi: "uç momenti kuralı, FEM ile aynı (sol uç −, sağ uç +)".

5. Fiziksel gerçeklerle sınamak

Kural hatalarını yakalamanın en güvenilir yolu, kuraldan bağımsız fiziksel gerçeklerle sınamaktır:

Bu gerçeklerin her biri artık sitenin testlerinde bir denetim olarak yer alıyor.

6. Kontrol listesi

  1. Her açı için: Nereden ölçülüyor? Hangi yön pozitif?
  2. Her kuvvet ve moment için: Hangi işaret çekme, hangisi basınç? Hangi yön pozitif dönme?
  3. Kural, değeri gösteren etikette yazıyor mu?
  4. Test, kuralı koddan bağımsız bir fiziksel gerçekle sınıyor mu?
  5. İki parça birleşiyorsa (motor ve arayüz, iki motor, motor ve test), ikisi aynı kuralı mı kullanıyor?
Sitede deneyin: güneş–gölge aracında saati 12:00 yapın; azimut 0° (tam güney) görünmelidir.

Kaynaklar

  1. archi-civil.com sürüm notları (README), v565, v566, v569, v571: işaret ve yön kuralı hataları ve düzeltmeleri.
  2. Duffie, J. A. ve Beckman, W. A. (2013). Solar Engineering of Thermal Processes, 4. baskı, Bölüm 1 (güneş açıları ve işaret kuralları). Wiley.
  3. Beer, F. P., Johnston, E. R., DeWolf, J. T. ve Mazurek, D. F. Mechanics of Materials, Bölüm 7 (gerilme dönüşümü ve Mohr dairesi). McGraw-Hill.

Yazıdaki sayılar sitenin motorlarıyla üretilmiştir; yönetmelik değerleri kaynak madde numarasıyla verilmiştir.

archi-civil.com — İşaret ve Yön Kuralları: Hesaplardaki En Sessiz Hata · HES-03 ·