GNU Octave ile iki kanallı cross-correlation/Cross-PSD faz gürültüsü ölçümünü simüle eden araştırma projesi.
Aktif geliştirme alanı:
phasedetector with cross correlation optimized/Yeni kod, deney ve dokümantasyon çalışmaları yalnız bu klasörde yapılır.
phasedetector with cross correlation/geçmiş karşılaştırmaları için tutulan legacy koddur.
Model, aynı DUT sinyalini kullanan iki ölçüm kanalını bağımsız referanslarla karıştırır. Kanalların kompleks cross-spektrumları çok sayıda Monte Carlo iterasyonu boyunca lineer alanda ortalanır. Amaç, ortak DUT faz gürültüsünü korurken kanallara özgü referans gürültüsünü ortalamayla bastırmaktır.
Aktif akış şu işlemleri uygular:
DUT + Ref1/Ref2 üretimi
-> iki mixer kanalı
-> Butterworth LPF
-> faz detektörü kazanç normalizasyonu
-> settling ve DC kaldırma
-> /K_pd normalizasyonu ve asin
-> kompleks Cross-PSD
-> iterasyon ortalaması
-> log-bin ve DUT periodogramı karşılaştırması
- GNU Octave
- Octave
signalpaketi (butterve filtreleme için) - Grafik üretilecekse kullanılabilir bir Octave graphics toolkit
Paket kurulumu yalnız ilk kez gerekir:
pkg install -forge signalrun_simulation.m, Octave altında signal paketini ilk çağrıda otomatik
yükler. Aktif kod Octave'a özgü time() ve MAT kayıt seçenekleri kullandığı
için MATLAB desteği şu anda doğrulanmış değildir.
Octave'ı repo kökünde açın ve tek koşu betiğini çalıştırın:
active_dir = fullfile(pwd, "phasedetector with cross correlation optimized");
run(fullfile(active_dir, "run_single.m"));Varsayılan tek koşu N=100000 ve 200 iterasyon kullanır. Daha kısa bir
kontrol için run_single.m içindeki değerleri geçici olarak küçültün veya
aktif klasör README'sindeki küçük doğrudan API örneğini kullanın.
| Dosya | Kullanım | Kalıcı çıktı |
|---|---|---|
run_single.m |
Tek config çalıştırır ve iki spektrumu çizer | Yok; results workspace'te kalır |
run_comparisons.m |
LPF, RMS, iterasyon ve log-bin taramaları | results/ altında MAT, CSV ve PNG |
run_iterations.m |
Büyük iterasyon sayısı taraması | results/ altında MAT, CSV ve PNG |
replot_results.m |
Kayıtlı bir sweep'i simülasyonsuz yeniden çizer | Karşılaştırma PNG'si |
export_decade_errors.m |
Kayıtlı bir sweep'in dekad bazlı MAE tablosu | results/<koşu>/decade_mae.csv |
run_simulation.m |
Programatik API: results = run_simulation(config) |
Yok |
Parametre şeması, üç giriş betiğinin farklı varsayılan profilleri, çıktı alanları ve yeniden çizim kullanımı için aktif uygulama kılavuzuna bakın.
.
├── README.md
├── MEMORY_BANK.md
├── CHANGES.md
├── phasedetector with cross correlation optimized/ # aktif uygulama
├── archive/ # legacy ve eski deneyler
│ ├── phasedetector with cross correlation/ # legacy referans
│ ├── phasedetector with cross correlation optimized/ # 2026-08-28 öncesi kopya
│ ├── root_scripts/ (*.m) / root_extras/
│ └── README.md
├── sunum/
└── .opencode/ # opsiyonel geliştirme desteği
MEMORY_BANK.md: sonraki çalışma oturumu için güncel durum, kararlar, riskler ve öncelikli işler.CHANGES.md: projenin kronolojik değişiklik kaydı.archive/runtime bağımlılığı değildir; sunum fonksiyonumake_presentation_plotskaldırıldı..opencode/opsiyonel araç dokümanıdır; simülasyonu çalıştırmak için gerekli değildir.
Sweep çıktıları aktif klasördeki results/ dizinine yazılır. Bu dizin,
.mat, görsel ve arşiv dosyaları Git'e gönderilmez. Kaynak kod, Markdown
dokümanları ve metin tabanlı yapılandırmalar izlenir.
Bu nedenle temiz bir clone:
- geçmiş yerel deneylerin ham MAT/PNG dosyalarını içermez;
replot_results.mkullanmadan önce yerel bir sweep sonucu gerektirir;- rapordaki tarihli sonuçları koddan yeniden üretebilir, ancak mevcut zaman tabanlı RNG nedeniyle aynı bit düzeyinde sonucu garanti etmez.
- RNG her faz gürültüsü çağrısında zaman tabanlı yeniden seed edilir; koşular birebir tekrarlanamaz ve seed bilgisi sonuç dosyasına kaydedilmez.
- Otomatik test ve kontrollü performans benchmark'ı yoktur.
- MAE şu anda LPF geçiş bandıyla sınırlandırılmadan ortak pozitif frekans aralığının tamamında hesaplanır.
- Sweep'ler seri çalışır; büyük iterasyon listeleri uzun sürebilir.
run_single.m,run_comparisons.mverun_iterations.mfarklı parametre profilleri kullanır.
Yeni bir çalışma oturumunda sırasıyla:
README.mdveMEMORY_BANK.mddosyalarını okuyun.git statusile çalışma ağacını kontrol edin.- Yalnız
phasedetector with cross correlation optimized/altında çalışın. - Önce küçük bir
run_simulationsmoke testi yapın. - Algoritmik değişikliklerde
MEMORY_BANK.mdveCHANGES.mddosyalarını aynı commit içinde güncelleyin.
Bu repoda henüz açık bir lisans tanımlanmamıştır. Lisans eklenene kadar kodun yeniden dağıtım ve kullanım hakları ayrıca değerlendirilmelidir.