GridFreq

Türkiye ve Kıta Avrupası Şebeke Frekansı Analiz Platformu

GridFreq, TEİAŞ Türkiye günlük şebeke frekansı verileri ile Kıta Avrupası · Netztransparenz frekans verilerini aynı statik web uygulamasında inceleyen, karşılaştıran ve analiz eden bir frekans kalite platformudur. GitHub Pages üzerinde çalışır ve ana canlı uygulama adresi https://gridfreq.com/ olarak yapılandırılmıştır. Tarayıcı doğrudan TEİAŞ veya Netztransparenz sistemlerine bağlanmaz. Otomatik indirme, normalizasyon, kalite kontrolü ve yayınlama işleri GitHub Actions ve yerel Python betikleriyle yapılır.

Kısa Durum

• Ana uygulama: frekans_rapor_v1.html
• Ana canlı uygulama: https://gridfreq.com/
• GitHub Pages custom domain: gridfreq.com
• Eski GitHub Pages adresi: https://murathany90.github.io/frekans/ yalnızca platform/fallback adresidir.
• Yayın girişi: index.html
• Marka ve ikon paketi: assets/brand/
• Frekans bölgeleri görünümü: assets/frequency-regions.json, assets/frequency-countries.json, assets/frequency-regions-map.svg, assets/frequency-regions.mjs
• Web uygulaması manifesti: site.webmanifest
• Ana başlık bağlantısı: üst bardaki GridFreq ikon ve yazısı https://gridfreq.com/ adresine gider.
• SEO ve alan adı dosyaları: CNAME, robots.txt, sitemap.xml, 404.html
• Günlük veri kaynağı açıklaması: Günlük sekmesindeki Bilgi düğmesi ile açılan "Veri Kaynakları ve Yöntem" penceresi.
• Günlük grafik etkileşim durumu: katman seçimi ve zoom aralığı oturum boyunca sessionStorage içinde saklanır.
• Canlı Frekans sekmesi: Kıta Avrupası canlı/gecikmeli frekans verisini GridRadar üzerinden gösterir.
• Analiz çekirdeği: assets/analysis-core.mjs
• Canlı Frekans ön yüzü: assets/live-frequency.js, assets/live-frequency.css
• Canlı Frekans Worker'ı: live-frequency-worker/
• Statik veri kökü: data/
• GitHub Pages çıktısı: dist/
• TEİAŞ son otomatik kaynak: scripts/fetch_teias.py
• Netztransparenz son otomatik kaynak: scripts/fetch_netztransparenz.py
• Netztransparenz OAuth istemcisi: scripts/netztransparenz_client.py

Mevcut manifest özetinde TEİAŞ ve Netztransparenz günleri ayrı tutulur. Türkiye ve Kıta Avrupası · Netztransparenz günleri birebir aynı takvim aralığında olmak zorunda değildir; uygulama ortak günleri karşılaştırma için, tekil kaynak günlerini ise tek kaynak grafiği ve tek kaynak analizleri için kullanır.

Mimari

Uygulama tek HTML dosyası etrafında çalışan statik bir ön yüz ve önceden optimize edilmiş veri dosyalarından oluşur.

• frekans_rapor_v1.html: Sekmeler, grafikler, takvim, veri yükleme UI'ı, günlük karşılaştırma ve analiz ekranları.
• assets/analysis-core.mjs: Veri kalitesi, temel istatistik, RoCoF, Welch PSD, spektrogram, çapraz korelasyon, koherens ve sentetik sinyal yardımcıları.
• assets/analysis-worker.mjs: Ağır analizlerin Web Worker üzerinde çalıştırılması.
• assets/echarts.min.js: CDN erişimi yoksa kullanılan yerel ECharts yedeği.
• assets/brand/: GridFreq SVG logo, favicon, mobil ikonlar ve sosyal paylaşım kartı.
• assets/frequency-regions.json: Frekans bölgesi kataloğu; Kıta Avrupası senkron bölgesini, nominal frekans bilgisini, izleme bandını ve kaynak referanslarını tanımlar.
• assets/frequency-countries.json: Bölge içindeki ülke etiketleri ve uygulama kaynak eşleşmeleri. Dahili kaynak anahtarları teias ve netztransparenz olarak korunur.
• assets/frequency-regions-map.svg: Dış harita kütüphanesi kullanmadan, yüksek çözünürlüklü Kıta Avrupası PNG silüetiyle gösterilen tek odaklı etkileşimli SVG frekans bölgesi haritası.
• assets/frequency-regions.mjs: Elektriksel zaman sapması hesabı için küçük yardımcı modül.
• assets/live-frequency.js: Canlı Frekans sekmesini, 60 saniyelik frontend yenileme davranışını, GridRadar durum kartlarını ve 24 saatlik 60 saniye özet grafiğini yönetir.
• live-frequency-worker/: GridRadar tokenını tarayıcıdan uzak tutan Cloudflare Worker + SQLite Durable Object canlı veri katmanı.
• site.webmanifest: Mobil ana ekrana ekleme ve PWA ikon tanımları.
• scripts/normalize_frequency.py: Günlük frekans paketini üretir, int16 binary yazar, dakika/saat özetlerini oluşturur ve manifestleri üretir.
• scripts/build_site.py: GitHub Pages için dist/ klasörünü oluşturur.
• scripts/validate_frequency.py: Veri boyutu, manifest tutarlılığı ve kalite uyarılarını kontrol eder.

Uygulama Sekmeleri ve Kullanım Akışı

Frekans Bölgeleri

Frekans Bölgeleri sekmesi artık varsayılan ilk ekrandır. Hash route karşılığı #/regions?country=TR biçimindedir. Bu görünüm, Kıta Avrupası 50 Hz senkron frekans bölgesini yüksek çözünürlüklü PNG silüet tabanlı tek SVG harita üzerinde gösterir ve ölçüm verisi bulunan Türkiye · TEİAŞ ile Kıta Avrupası · Netztransparenz kaynaklarını uygulamanın günlük veri kataloğuna bağlar. Kıta Avrupası mavi/turkuaz bölge silüetiyle, Türkiye ise kırmızı TEİAŞ vurgusuyla gösterilir.

Görünümde seçilebilen kaynak bağlamları:

• Türkiye · TEİAŞ: TEİAŞ günlük frekans verisiyle günlük grafik ve analizlere bağlanır.
• Kıta Avrupası: Netztransparenz üzerinden yayımlanan Kıta Avrupası senkron bölgesi frekans serisini temsil eder.

Bölge paneli seçili sistem, veri kaynağı, son veri tarihi, manifest aralığı, nominal frekans, izleme bandı ve zaman dilimi bilgilerini özetler. Kıta Avrupası kataloğu Baltık ülkelerinin 9 Şubat 2025 sonrası Kıta Avrupası senkron bölgesiyle senkron çalıştığını bilgi amaçlı gösterir. Harita ve mobil seçim listesi aynı merkezi katalogdan üretilir; GridRadar, Mapbox, Leaflet veya başka bir harita SDK’sı kullanılmaz. SVG haritasındaki başlık ve açıklama metinleri Türkçe/İngilizce dil değişiminde güncellenir. Türkçe kontrol katmanı kartlarında FCR, aFRR ve mFRR yerine sırasıyla PFK, SFK ve Tersiyer terminolojisi kullanılır; İngilizce arayüzde uluslararası FCR, aFRR ve mFRR adları korunur.

Elektriksel zaman sapması kartı mevcut optimize günlük .frequency.i16 dosyalarından hesaplanır. Hesaplama ∫(f − 50 Hz) / 50 Hz dt yaklaşımını kullanır; eksik veya geçersiz örnekler gerçek veri gibi doldurulmaz ve kapsama oranına yansıtılır. Varsayılan hesap son mevcut gün içindir; son ay seçimi aynı ay içindeki mevcut günlük dosyaları kullanır. Özel dönem için Analiz sekmesindeki tarih aralığı araçları kullanılmalıdır.

Frekans Bölgeleri sekmesindeki hızlı düğmeler:

• Günlük grafiği aç: Ölçüm verisi olan seçili sistemin son mevcut gününe gider.
• Analize git: Seçili kaynağı Analiz sekmesine taşır ve temel istatistik analizi için tarih alanını doldurur.
• Veri durumuna git: Veri sekmesindeki otomatik veri ve kaynak sağlık kartlarına geçer.

Canlı Frekans

Canlı Frekans sekmesi Kıta Avrupası · GridRadar frekans görünümünü sunar. Bu görünümde canlı/gecikmeli Kıta Avrupası verisi GridRadar tarafından sağlanır; tarihsel/günlük Kıta Avrupası verisi ise Netztransparenz kataloğunda kalır. Başlıkta ve kaynak alanında ayrım açıkça gösterilir: Tarihsel/Günlük Kıta Avrupası verisi Netztransparenz, canlı/gecikmeli Kıta Avrupası verisi GridRadar.

GridRadar kaynağı için kullanılan metrik frequency-ucte-median-1s değeridir. Kaynak 1 saniye kaynak çözünürlüğü ile gelir, sayfada yaklaşık 15 dakika gecikme bilgisiyle sunulur ve son 24 saatlik görünüm 60 saniyelik özet seri üzerinden çizilir. Ana grafik ham 1 saniyelik 24 saatlik veri indirme yüzeyi değildir; son 1 saat görünümü Worker'ın en fazla 1 saatle sınırlı resolution=1s sorgusundan, son 6 saat ve son 24 saat görünümleri normalde 60 saniyelik özet tampondan beslenir. 6/24 saat grafiğinde görünür pencere 15 dakika veya altına yakınlaştırıldığında yalnızca ilgili dar aralık için 1 saniyelik seri alınır ve aynı aralık tekrar sorgulanırsa ön yüz cache'i kullanılır.

Canlı veri katmanı Cloudflare Worker + SQLite Durable Object mimarisiyle çalışır. Worker GridRadar tokenını tarayıcıya göndermeden veri toplar, SQLite Durable Object içinde 24 saatlik döner veri tamponu tutar ve GitHub Pages ön yüzüne güvenli REST endpointleri sunar. Ön yüz sekme görünürken yaklaşık 60 saniyelik frontend yenileme yapar; sekme arka plandayken polling durur, sekmeye dönülünce kaçırılan status/özet bilgiler yeniden alınır. Ölçüm yaşı 20 dakikaya kadar normal, 20-30 dakika arası gecikmeli, 30 dakikadan eskiyse veri akışı kesintili olarak gösterilir.

GridRadar veri kullanım bildirimi Canlı Frekans sekmesinde görünürdür. Veriler yalnızca kişisel, ticari olmayan ve fonlanmamış akademik araştırma amaçlarıyla görüntülenmek üzere sunulur; ticari veya profesyonel kullanım için GridRadar’dan önceden uygun kullanım izni alınmalıdır. Ticari veya profesyonel kullanım için GridRadar bağlantısı üzerinden iletişime geçilmelidir.

Günlük

Günlük sekmesi tarih seçimi, zaman hizalama, grafik katmanları ve 24 saatlik frekans grafiği için ana ekrandır. Tarih seçicide Türkiye, Kıta Avrupası · Netztransparenz veya ikisinde birden bulunan günler gösterilir. Gün yalnızca Kıta Avrupası verisine sahipse bu seri tekil olarak çizilir; Türkiye verisi boş kalır. Ortak günlerde Türkiye ve Kıta Avrupası serileri aynı grafik üzerinde karşılaştırılır.

Günlük sekmesindeki ana kontroller:

• Tarih seçici: Gün, önceki/sonraki gün butonları ve takvim noktaları.
• Zaman eşleştirme: UTC - otomatik, Aynı yerel saat, Manuel saat farkı.
• Grafik katmanları: Fark katmanı ve Maks/Min zarfı.
• Yenile: Seçili günü yeniden hesaplar.
• Grafik sıfırla: Yakınlaştırmayı günlük görünüme döndürür ve katman seçimlerini varsayılan duruma alır.
• Bilgi: Türkiye · TEİAŞ ve Kıta Avrupası · Netztransparenz kaynaklarını, çözünürlükleri, güncel veri durumunu ve işleme yöntemini açıklayan erişilebilir modal pencereyi açar.

Günlük grafik üstünde ilk iki bilgi kartı görünüm bağlamını taşır:

• Görünüm: 24 saat • dakikalık, saatlik yakınlaştırmada ise örneğin 11:00–12:00 • 3.600 saniye.
• Rapor tarihi: Grafiğin ve rapor bağlamının seçili takvim günü.

Masaüstünde bu kartların yanında son Türkiye verisi, son Kıta Avrupası verisi ve son ortak gün kartları görünmeye devam eder. Mobilde gereksiz dikey alanı azaltmak için yalnızca Görünüm ve Rapor tarihi kartları gösterilir; kaynak güncelliği bilgileri Veri sekmesindeki sağlık kartlarında ve Bilgi penceresinde korunur.

Mobil Günlük sekmesi 320-430 px genişliklerde iki satırlı kompakt kontrol düzeni kullanır:

• Birinci satır: önceki gün, tarih seçimi, sonraki gün.
• İkinci satır: ayarlar, yenile, grafik sıfırla ve bilgi.

Bu düzen yatay sayfa kaydırması üretmeden çalışacak şekilde tasarlanmıştır. Dar ekranlarda bazı düğmeler ikon ağırlıklı görünür, ancak erişilebilir adları korunur.

Veri Kaynakları ve Yöntem penceresi masaüstünde ortalanmış modal, mobilde ekranı taşırmayan alt sayfa/tam ekran uyumlu görünüm olarak çalışır. Pencere role="dialog" ve aria-modal="true" kullanır; açıldığında odak pencereye taşınır, Tab odağı içeride kalır, Escape ve kapatma düğmesi ile kapanır, kapanınca odak yeniden Bilgi düğmesine döner. İçerik Türkiye · TEİAŞ, Kıta Avrupası · Netztransparenz, zaman/çözünürlük, veri işleme/kalite, teknik not, resmî kaynak bağlantıları ve güncel durum bölümlerine ayrılmıştır. Güncel durum alanı mümkün olduğunda data/status.json ve manifest bilgilerinden dinamik üretilir; status dosyası okunamazsa modal çökmeden "Güncel durum bilgisi alınamadı." mesajı gösterir.

Kaynak terminolojisi bilinçli olarak ayrılmıştır. İngilizce arayüzde de ülke adı Türkiye olarak kullanılır. Netztransparenz verisi standart ENTSO-E Transparency API'sinden doğrudan alınmış gibi sunulmaz; Alman TSO'larının resmî ortak portalı üzerinden yayımlanan Kıta Avrupası senkron bölgesi frekansı olarak açıklanır. Modal içindeki resmî kaynak bağlantıları TEİAŞ, TEİAŞ günlük frekans sayfası, Netztransparenz saniyelik frekans sayfası ve ENTSO-E resmî sitesiyle sınırlıdır; GridFreq GitHub deposu resmî kaynak bağlantıları arasında gösterilmez.

Analiz

Analiz sekmesi seçili gün veya tarih aralığı üzerinde bilimsel analizleri çalıştırır. Filtre barı günlük sekmedeki kontrol yapısına benzer biçimde kompakt tutulur: tarih, kaynak, analiz tipi ve çalıştır/iptal kontrolleri aynı hizada yer alır. Gelişmiş bölümde tarih modu, saat aralığı, çözünürlük, hizalama, bant sınırları, eşik ve pencere parametreleri bulunur.

Kaynak seçenekleri:

• Türkiye: TEİAŞ serisini tek başına analiz eder.
• Kıta Avrupası · Netztransparenz: Netztransparenz serisini tek başına analiz eder.
• Türkiye + Kıta Avrupası: Ortak veri gerektiren çift kaynak görünümü.
• Türkiye − Kıta Avrupası: İki kaynak arasındaki fark bileşeni.
• Ortak bileşen: İki serinin ortak mod davranışı.
• Diferansiyel bileşen: Yerel farklılaşma davranışı.

Tarih modları:

• Tek gün
• Tarih aralığı
• Son 7 ortak gün
• Son 30 ortak gün
• Ay seçimi
• Özel saat

Analiz sekmesi kaynak ve analiz türü uyumluluğunu baştan denetler. Tek kaynak seçiliyken çapraz korelasyon ve koherens gibi iki eşlenmiş seri gerektiren analizler devre dışı bırakılır; geçersiz seçenekler yalnızca hata üretmek yerine seçim listesinden pasifleştirilir ve kısa bir bilgi notu i bilgi düğmesine taşınır. Çalıştırma anında aynı doğrulama tekrar yapılır, böylece DOM manipülasyonu ile geçersiz kombinasyon seçilse bile analiz başlamaz.

Çözünürlük seçimi de analiz türüne göre güvenli hale getirilmiştir. auto, 1s, 10s, 1m ve 1h seçenekleri gerçek seri çözünürlüğü, örnekleme frekansı, Nyquist frekansı, analiz edilebilir maksimum bant, yeniden örnekleme yöntemi ve eksik veri oranı ile birlikte değerlendirilir. Bant sınırı veya pencere/segment değeri seçili çözünürlükle uyumsuzsa analiz çalıştırılmaz ve kullanıcıya kısa, teknik neden gösterilir.

Raporlar

Raporlar sekmesi son analiz sonucundan rapor ön izlemesi, JSON çıktısı ve olay CSV çıktısı üretir. Rapor dili Türkçe/İngilizce seçilebilir. Çıktılar tarayıcıda üretilir; sunucuya rapor gönderilmez.

PDF/yazdırma akışı printReport() üzerinden yönetilir. Yazdırma sırasında body.print-report sınıfı eklenir ve yalnızca #tab-reports rapor konteyneri görünür kalır; Günlük, Analiz ve Veri sekmeleri PDF çıktısına karışmaz. Analiz grafiği yazdırma öncesi geçici PNG görüntüsüne dönüştürülerek rapor DOM'una eklenir, afterprint ve güvenli zaman aşımı sonrasında geçici sınıflar ve .print-chart-snapshot öğeleri temizlenir.

Veri

Veri sekmesi otomatik katalog durumu, son TEİAŞ tarihi, son Kıta Avrupası tarihi, Netztransparenz kaynak yöntemi, kaynak sağlık kartları, eksik gün sayısı ve manuel CSV yükleme alanlarını gösterir. Manuel yükleme halen desteklenir ve tarayıcı belleğinde çalışır.

Kaynak sağlık kartları artık Günlük grafiğin üstünü kalabalıklaştırmaz; GitHub Pages Otomatik Veri paneli içinde yer alır. Türkiye · TEİAŞ ve Kıta Avrupası · Netztransparenz için son başarılı kontrol, son mevcut veri, veri gecikmesi, durum, eksik veya henüz yayımlanmamış günler, kaynak yöntemi, kalite skoru ve son hata ayrı ayrı gösterilir. "Workflow başarılı" ile "veri güncel" aynı şey olarak sunulmaz; veri gecikmesi normal yayın gecikmesi, beklenenden uzun gecikme, indirme/doğrulama hatası veya henüz yayımlanmamış durumlarıyla ayrıca belirtilir.

Grafik Yapısı

Günlük frekans grafiği

Günlük grafik ECharts ile çizilir. Tam gün görünümünde 86.400 saniyelik veri doğrudan çizilmek yerine dakika ortalamalarına indirgenir. Bu, grafiği hızlı ve okunabilir tutar. İstatistikler ise saniyelik serilerden hesaplanır.

Grafik katmanları:

• Türkiye frekansı
• Kıta Avrupası frekansı
• Türkiye − Kıta Avrupası farkı
• Türkiye minimum/maksimum zarfı
• Kıta Avrupası minimum/maksimum zarfı

Saatlik matris ve 15 dakikalık heatmap grafiğe bağlıdır. Saat veya çeyrek saat seçildiğinde saniyelik detay görünümü açılır. Çift tıklama günlük görünüme geri döndürür. Grafik araç çubuğu tam ekran, PNG indirme ve yakınlaştırma sıfırlama kontrolleri içerir.

Grafik katman tercihleri oturum boyunca korunur. Kullanıcı efsaneden Türkiye, Kıta Avrupası veya fark serisini kapattığında; gün değiştirme, günlük/saatlik görünüme geçme, çözünürlük değiştirme veya zaman eksenini yenileme sonrasında aynı katman seçimi korunur. Zoom aralığı da mümkün olduğunda korunur. Bu durum frequencyChartSessionState anahtarıyla sessionStorage içinde tutulur. Grafik Sıfırla düğmesi hem zoom'u tam güne döndürür hem de katmanları tanımlı varsayılan görünüme alır.

Grafik ve UI araç ipuçları tek yüksek kontrastlı tooltip sistemiyle gösterilir. #appTooltip genel buton, KPI ve metrik açıklamalarını; #hourMatrixTooltip saatlik matris hücrelerini gösterir. Tooltipler masaüstünde hover/focus ile, mobilde dokunma/focus ile açılır; ekran kenarlarına göre otomatik konumlanır ve yatay taşma üretmez.

KPI kartları

Günlük hesap sonrası KPI alanı şu metrikleri gösterir:

• Türkiye ortalaması
• Kıta Avrupası ortalaması
• Türkiye ortalama mutlak sapma
• Kıta Avrupası ortalama mutlak sapma
• Bias
• MAE/RMSE
• Korelasyon
• Eşlenmiş veri oranı

Her KPI kartında kısa açıklama tooltip'i bulunur. Tooltip metinleri metriğin anlamını ve birimini açıklar; örneğin ortalama değerler Hz, ortalama mutlak sapma ve MAE mHz, korelasyon birimsiz katsayı, ortak veri ise eşlenmiş örnek oranı olarak belirtilir. Mobilde günlük grafik altındaki KPI alanı dört temel kartla sadeleşir: Türkiye ortalaması, Kıta Avrupası ortalaması, Türkiye ortalama mutlak sapma ve Kıta Avrupası ortalama mutlak sapma. Bias, MAE/RMSE, korelasyon ve eşlenmiş veri oranı masaüstünde görünür kalır; mobilde bilgi yoğunluğunu azaltmak için gizlenir.

Saatlik istatistik matrisi

Saatlik istatistik matrisi her saat için ortalama, minimum, maksimum, bias, MAE ve benzeri metrikleri gösterir. Masaüstünde tablo hücreleri seçilebilir ve hover/focus tooltipleriyle saat aralığı, metrik adı, değer ve birim okunabilir. Metrik adlarında da kısa açıklama tooltipleri vardır; Türkiye Ort., Türkiye Min, Bias, MAE, Korelasyon gibi satırlar boş veya yalnızca koyu zeminli tooltip üretmez.

Mobilde geniş tablo yerine saat seçici ve kompakt metrik kartları kullanılır. Seçili saat değiştirildiğinde detay kartları güncellenir; tüm saatler için kompakt heatmap düğmeleri kalır. Tooltipler dokunma ile açılır ve 320-430 px ekranlarda ekran dışına taşmayacak şekilde sınırlanır.

Analiz grafikleri

Analiz sekmesindeki grafik tipi seçilen analize göre değişir. Veri kalitesi, istatistik, RoCoF, PSD, çapraz korelasyon ve trend sonuçları çizgi grafik üretir. Spektrogram ısı haritası üretir. Osilasyon adayı analizi, bant geçiren bileşeni ve eşik üstü aralıkları gösterir.

Analiz Laboratuvarı

Analizler assets/analysis-core.mjs ve gerekirse assets/analysis-worker.mjs üzerinden çalışır. Büyük hesaplar ana UI iş parçacığını kilitlememek için Web Worker yoluna devredilir.

Ön yüzde analysisRegistry yapısı her analiz türünün başlığını, açıklamasını, izin verilen kaynaklarını, izin verilen çözünürlüklerini, parametrelerini, KPI kartlarını, tablo kolonlarını, yöntem metnini ve sınırlamalarını tanımlar. Bu nedenle analiz seçimi değiştiğinde sayfa başlığı, açıklama, parametre paneli, grafik tipi, sonuç tablosu ve rapor bölümü birlikte değişir. Örneğin veri kapsama analizinde osilasyon tablosu veya baskın frekans kolonları gösterilmez; olay üretmeyen analizlerde uygun özet tablo veya "olay tablosu yok" durumu kullanılır.

Parametre paneli hızlı analiz ve uzman kullanımını ayırır. Varsayılan görünüm önerilen parametrelerle tek tıkla çalıştırmaya uygundur. details.analysis-advanced-panel açıldığında pencere tipi, pencere uzunluğu, örtüşme, detrend, filtre tipi/derecesi, bant, eşik, minimum olay süresi, yeniden örnekleme ve eksik veri yöntemi gibi uzman parametreler yalnızca seçili analiz için anlamlıysa görünür.

Veri kapsama

analyzeDataQuality geçerli örnek sayısı, eksik örnek, yinelenen zaman damgası, en uzun boşluk, sabit kalan seri süresi ve ani sıçrama sayısı üretir. Veri kalitesi denetimlerinde özellikle eksik saniyeler ve uzun boşluklar izlenir.

Temel istatistikler

computeBasicStats ortalama, medyan, minimum, maksimum, standart sapma, varyans, RMS sapma, ortalama mutlak sapma, yüzde birlikler, çarpıklık, basıklık, bant içinde kalma oranı ve bant ihlali süresi üretir.

Bant ihlali

Bant ihlali analizi nominal frekanstan uzaklaşan veya ayarlanan bant dışına çıkan aralıkları olay olarak çıkarır. Olay listesinde başlangıç, bitiş, süre, değer ve sınıflandırma gösterilir.

RoCoF

RoCoF analizi frekansın zamana göre değişim hızını hesaplar. Desteklenen yöntemler merkezi fark, filtreli türev ve hareketli regresyon yaklaşımıdır. rocofThreshold eşiği üstündeki aralıklar olay olarak raporlanır.

Welch PSD

Welch PSD analizi frekans serisini pencereli segmentlere böler, pencereleme ve FFT sonrası güç spektral yoğunluğu üretir. Baskın frekanslar ve bant enerjileri analiz sonucuna eklenir.

Spektrogram

Spektrogram kısa zamanlı Fourier dönüşümü mantığıyla zaman-frekans enerji dağılımı üretir. Bu görünüm, gün içinde belirli saatlerde güçlenen salınım bantlarını görmeyi kolaylaştırır.

Osilasyon adayı

Osilasyon adayı analizi bant geçiren FIR filtre, kayan pencere ve mHz eşikleme kullanır. bandMin, bandMax, oscThreshold, windowSec, stepSec, filterTaps ve minDuration parametreleri sonucu belirler.

Çapraz korelasyon

Çapraz korelasyon Türkiye ve Kıta Avrupası ortak günlerinde çalışır. İki seri arasındaki en iyi gecikme, korelasyon büyüklüğü ve ortak mod göstergesi hesaplanır.

Koherens ve faz

Koherens ve faz analizi iki seri arasındaki frekans alanı ilişkisini inceler. computeMagnitudeSquaredCoherence ve computeCrossPowerSpectralDensity ile ortak bant davranışı, faz farkı ve koherens tepe noktaları çıkarılır.

Günlük trend

Günlük trend analizi seçilen tarih aralığında günlük istatistikleri tekrarlar ve RMS sapma gibi metriklerin zamana göre değişimini gösterir.

Otomatik İndirme Süreçleri

Otomatik veri indirme işleri GitHub Actions üzerinde sunucudan sunucuya çalışır. Tarayıcı uygulaması doğrudan veri kaynaklarına istek atmaz. Bu tasarım CORS, gizli anahtar ve kaynak site erişim sınırlarını ön yüzde taşımamak için tercih edilmiştir.

TEİAŞ otomatik güncelleme

TEİAŞ keşfi scripts/discover_teias.py ile yapılır. Betik https://www.teias.gov.tr/gunluk-frekans-bilgisi sayfasının gallery API yanıtını okur ve gerçek dosya indirme URL'lerini keşfeder. Dosya UUID'leri sabitlenmez.

İndirme ve normalizasyon akışı:

1. .github/workflows/teias_daily_update.yml Türkiye saatiyle 10:15, 12:15, 15:15 ve 18:15 olacak şekilde 15 7,9,12,15 * * * UTC cron ile çalışır.
2. scripts/fetch_teias.py --lookback-days 14 --discovery-retries 5 --discovery-timeout 90 --discovery-delay 3 --download-retries 5 --download-timeout 180 son 14 günü tekrar tarar; TEİAŞ gallery API veya dosya indirme aşaması zaman aşımı/geçici yavaşlık yaşarsa artan bekleme süresiyle yeniden dener.
3. Dosya ZIP ise açılır; CSV/TXT içeriği parse_teias_csv ile ayrıştırılır.
4. Önceki sha256 ile yeni veri karşılaştırılır; revizyon varsa previousSha256 ve revisionDetected meta alanları yazılır.
5. write_day_outputs günlük .frequency.i16, minute.json, hourly.json, meta.json dosyalarını üretir.
6. scripts/build_daily_files.py ve scripts/validate_frequency.py manifest ve kalite kontrolünü yeniler.
7. Testler geçerse data/ ve reports/ değişiklikleri bot commit'i olarak push edilir.

Başarısızlıkta data/status.json güncellenir ve automation/teias-update etiketli tekil GitHub issue açılır veya mevcut issue'ya yorum eklenir. Sonraki başarılı koşuda issue kapatılır.

Netztransparenz otomatik güncelleme

Netztransparenz için yapılandırma config/netztransparenz.json içindedir. OAuth akışı scripts/netztransparenz_client.py tarafından yönetilir. Workflow secret adları:

• NETZTRANSPARENZ_CLIENT_ID
• NETZTRANSPARENZ_CLIENT_SECRET

Workflow akışı:

1. .github/workflows/netztransparenz_daily_update.yml her gün Türkiye saatiyle 10:30 ve 18:30 kontrollerine denk gelen 30 7,15 * * * UTC cron ile çalışır.
2. Secret adları ve env var varlığı kontrol edilir.
3. python scripts/netztransparenz_client.py --check ile OAuth token check yapılır.
4. scripts/fetch_netztransparenz.py çalıştırılır.
5. Public Swagger içinde doğrulanmış saniyelik frekans API endpoint'i bulunursa api yolu denenir.
6. Doğrulanmış endpoint yoksa veya --source auto fallback gerektirirse resmi ZIP indirme yolu kullanılır.
7. Kullanılan kaynak yöntemi meta ve status dosyalarında api, official_zip veya manual olarak tutulur. Güncel üretim akışında doğrulanmış yöntem official_zip yoludur.
8. İçerik HTML/login sayfası, MW birimi veya beklenmeyen schema ise reddedilir.
9. Europe/Berlin yerel zamanı UTC gün indekslerine normalize edilir; DST geçiş günleri local_second_to_day_index ile korunur.
10. En fazla 4 saniyelik kısa boşluklar doldurulabilir; uzun boşluklar eksik kalır.
11. Veri 45-55 Hz bandı, medyanın 50 Hz çevresi, duplicate oranı ve tarih kapsamı ile doğrulanır.
12. Testler, build ve secret scan geçerse data/ ve reports/ değişiklikleri bot commit'i olarak push edilir.

Workflow manuel tetiklenebilir:

gh workflow run netztransparenz_daily_update.yml `
  -f date_from=2026-07-01 `
  -f date_to=2026-07-12 `
  -f source=auto `
  -f dry_run=false

Desteklenen CLI örnekleri:

python scripts/fetch_netztransparenz.py --from 2026-07-01 --to 2026-07-12 --source auto --fill-missing
python scripts/fetch_netztransparenz.py --from 2026-07-01 --to 2026-07-02 --source zip --dry-run
python scripts/netztransparenz_client.py --check

Başarısızlıkta automation/netztransparenz-update etiketli tekil GitHub issue açılır veya güncellenir. not_yet_published durumları hata issue'su açmaz.

Manuel import

Manuel Netztransparenz CSV importu korunur:

python scripts/import_netztransparenz.py --input "incoming\netztransparenz\2026\Frequenz_20260601_20260630.csv"

Manuel import sourceMethod: manual olarak meta üretir. Yeni otomatik ZIP/API günleri ise sourceMethod: official_zip veya sourceMethod: api olarak görünür.

Veri Şeması ve Optimize Dosya Yapısı

Optimize veriler data/<source>/<year>/<month>/ altında tutulur.

Her gün için dosyalar:

• <YYYYMMDD>.frequency.i16: 86.400 saniyelik frekans serisinin int16 binary hali.
• <YYYYMMDD>.minute.json: Dakikalık özetler.
• <YYYYMMDD>.hourly.json: Saatlik özetler.
• <YYYYMMDD>.meta.json: Kaynak URL, hash, örnek sayıları, kalite, zaman dilimi, sourceMethod ve HTTP bilgileri.

Manifest dosyaları:

• data/manifest.json: Tam eski uyumluluk manifesti.
• data/manifest-summary.json: Hafif özet manifest.
• data/manifest/2026.json: Yıl shard manifesti.
• data/<source>/2026/index.json: Kaynak-yıl indeksi.
• data/status.json: Otomatik güncelleme ve kaynak sağlık durumu.

Binary encoding:

• Temel değer: 50 Hz
• Ölçek: 10.000
• Eksik değer: -32768
• Normal gün boyutu: yaklaşık 172.800 byte

Kalite alanları eksik örnek, geçersiz satır, duplicate, frekans bandı dışı örnek, coverage ve kalite puanı içerir. invalid veya kritik kalite durumundaki günler diskte kalabilir ancak aktif availableDates listesine alınmaz.

GitHub Actions ve Yayın Akışı

Ana workflow dosyaları:

• .github/workflows/teias_daily_update.yml: TEİAŞ otomatik veri güncellemesi.
• .github/workflows/netztransparenz_daily_update.yml: Netztransparenz otomatik veri güncellemesi.
• .github/workflows/deploy-live-frequency-worker.yml: GridRadar canlı/gecikmeli frekans Worker deploy'u.
• .github/workflows/deploy_pages.yml: GitHub Pages build ve deploy.
• .github/workflows/frontend_tests.yml: Playwright ve frontend statik testleri.
• .github/workflows/validate_data.yml: Veri ve analiz testleri.
• .github/workflows/backfill_2026.yml: 2026 backfill desteği.

GitHub Pages yayını için repository ayarlarında Pages source olarak GitHub Actions seçilmelidir. deploy_pages.yml build sırasında python scripts/build_site.py çalıştırır ve dist/ klasörünü Pages artifact olarak yükler. Kök CNAME dosyası gridfreq.com değerini taşır ve build sırasında dist/CNAME olarak kopyalanır. Ana canonical adres https://gridfreq.com/ değeridir; www.gridfreq.com adresinin ana domaine yönlenmesi DNS ve GitHub Pages tarafında yapılır.

Custom domain ayarı GitHub arayüzünde Settings > Pages > Custom domain alanına gridfreq.com yazılarak kullanıcı tarafından yapılır. Enforce HTTPS ayarı da aynı arayüzden etkinleştirilmelidir. DNS kayıtları repo dışında TürkTicaret panelinde yönetilir; DNS doğrulama tokenları, registrar ayarları, secret değerleri veya nameserver bilgileri repoda tutulmaz. Ham CSV/ZIP kaynakları, incoming/, cache/, test artifactleri ve geçici dosyalar Pages çıktısına konmaz.

Deploy workflow'u uygulama, veri, marka ve SEO dosyaları değiştiğinde tetiklenecek şekilde tutulur. CNAME, robots.txt, sitemap.xml, 404.html, site.webmanifest ve assets/brand/ değişiklikleri build çıktısına dahil edilir. robots.txt yalnızca ana sitemap adresini gösterir; sitemap.xml gerçek statik rota olan https://gridfreq.com/ adresini içerir.

Marka paketi 50 Hz Grid Pulse konseptine göre üretilmiştir. assets/brand/favicon.svg metinsiz sembol ikon olarak kalır; gridfreq-logo.svg ve gridfreq-logo-horizontal.svg GridFreq markasını taşır. PNG/ICO ikonları, Apple touch icon, maskable Android ikon ve gridfreq-social-card.png sosyal paylaşım görseli build sırasında dist/assets/brand/ altına kopyalanır. HTML head alanı canonical, Open Graph, Twitter card, favicon ve site.webmanifest bağlantılarını göreli varlık yollarıyla içerir.

Yerel Çalıştırma

cd C:\yazilim_projeler\zfrekans_rapor
python -m http.server 8080

Tarayıcı:

http://127.0.0.1:8080/frekans_rapor_v1.html

Sık Kullanılan Komutlar

TEİAŞ son günleri çek:

python scripts/fetch_teias.py --lookback-days 14 --discovery-retries 5 --discovery-timeout 90 --discovery-delay 3 --download-retries 5 --download-timeout 180

Netztransparenz eksik günleri doldur:

python scripts/fetch_netztransparenz.py --source auto --fill-missing

Manifest ve site üret:

python scripts/build_daily_files.py
python scripts/build_site.py

Veri doğrula:

python scripts/validate_frequency.py

Testler

python -m pytest tests
node tests/frontend_static_smoke.mjs
node tests/frontend_prompt2_static.mjs
node tests/frontend_prompt3_static.mjs
node tests/frontend_prompt4_static.mjs
node tests/frontend_prompt5_static.mjs
node tests/frontend_prompt6_static.mjs
node tests/frontend_brand_static.mjs
node tests/frontend_public_sharing_static.mjs
node tests/frontend_source_labels_static.mjs
node tests/frontend_regions_static.mjs
node tests/frontend_hash_routing_static.mjs
node tests/frontend_data_sources_modal_static.mjs
node tests/frontend_netztransparenz_status_static.mjs
node tests/readme_documentation_static.mjs
node tests/workflow_static_smoke.mjs
node tests/netztransparenz_workflow_static.mjs
node tests/frequency_regions_time_deviation.mjs
node tests/synthetic_signal_analysis.mjs
node tests/spectral_methods.mjs
python scripts/validate_frequency.py
python scripts/build_site.py

Playwright smoke için:

python -m http.server 8080
$env:APP_URL="http://127.0.0.1:8080/frekans_rapor_v1.html"
node tests/frontend_smoke_playwright.mjs
node tests/frontend_germany_only_daily_playwright.mjs
node tests/frontend_initial_load_playwright.mjs
node tests/frontend_prompt5_playwright.mjs
node tests/frontend_prompt6_playwright.mjs
node tests/frontend_data_sources_modal_playwright.mjs
node tests/frontend_daily_mobile_compact_playwright.mjs
node tests/frontend_chart_state_tooltips_playwright.mjs
node tests/frontend_hash_routing_playwright.mjs
node tests/frontend_regions_playwright.mjs

Test kapsamı parser, timezone hizalama, int16 encode/decode, manifest üretimi, otomatik workflow statikleri, Netztransparenz OAuth istemci davranışı, analiz çekirdeği, grafik UI kontrolleri ve README dokümantasyon kapsamını içerir. Ek frontend testleri GridFreq marka varlıklarını, custom domain build çıktısını, veri kaynakları modalının erişilebilir davranışını, Frekans Bölgeleri harita/katalog entegrasyonunu, elektriksel zaman sapması hesabını, hash routing davranışını, 320-430 px mobil günlük düzeni, tooltip taşma kontrolünü, saatlik metrik açıklamalarını, grafik katman/zoom durumunun korunmasını ve Grafik Sıfırla davranışını denetler.

Repo Boyutu ve Yayın Sınırı

Ham TEİAŞ CSV dosyaları, ham Netztransparenz aylık ZIP/CSV dosyaları ve geçici indirmeler repoya veya Pages çıktısına dahil edilmemelidir. Optimize günlük binary dosyalar commitlenebilir. Boyut raporu reports/data_quality/storage_report.md içindedir.

Lisans

Bu repodaki uygulama kodu MIT lisansı altındadır. Ayrıntılar için LICENSE dosyasına bakın.

MIT lisansı yalnızca GridFreq uygulama kodunu kapsar; veri kaynaklarının kullanım haklarını kapsamaz. TEİAŞ, Netztransparenz, GridRadar, ENTSO-E veya ilgili TSO veri kaynaklarının lisansları, yeniden dağıtım izinleri ve kaynak şartları bu lisansın kapsamında değildir; veri kullanımı ilgili kurumların güncel şartlarına tabidir. Canlı Frekans sayfasındaki GridRadar verileri yalnızca kişisel, ticari olmayan ve fonlanmamış akademik araştırma amaçlarıyla görüntülenmek üzere sunulur; ticari veya profesyonel kullanım için GridRadar’dan uygun kullanım izni alınmalıdır.

Sınırlamalar

• Günlük, Analiz, Raporlar ve Veri sekmelerindeki tarihsel veri GitHub Pages üzerinde commitlenmiş statik katalogdan okunur.
• Canlı Frekans sekmesi GitHub Pages ön yüzünden GridRadar'a doğrudan bağlanmaz; Cloudflare Worker güvenli aracı katman olarak kullanılır.
• Canlı/gecikmeli GridRadar görünümü CSV veya toplu ham veri indirme aracı değildir.
• Netztransparenz public Swagger içinde doğrulanmış saniyelik frekans API endpoint'i bulunmadığında otomatik süreç resmi ZIP fallback yolunu kullanır.
• Henüz yayınlanmamış kaynak günleri hata sayılmaz; status içinde not_yet_published olarak izlenir.
• Bu uygulama TEİAŞ, Netztransparenz veya başka bir TSO'nun resmi uygulaması değildir.