Proje: Rat Behavioral Analysis System (Sıçan Davranışsal Analiz Sistemi)
Tez konusu: Yaygın diyet katkı maddelerinin sıçanlarda açık alan (OFT) davranışlarına etkisi
Son güncelleme: 2026-05-07 (Aşama 03C — Plus maze (4 kollu) analizi tamamlandı, 12 sıçan)
- Proje Özeti
- Deney Tasarımı ve Gruplar
- Yazılım ve Teknoloji Altyapısı
- Aşama 01 — Video Ön İşleme ve Kalite Kontrolü
- Aşama 02 — DeepLabCut Pose Tahmini
- Aşama 02B — Kural Tabanlı Davranış Tespiti
- Aşama 03A — Açık Alan Testi (OFT) Uzamsal Analizi
- Aşama 03C — Plus Maze (4 Kollu) Analizi
- Üretilen Çıktı Dosyaları
- Gruplar Arası Temel Bulgular
- Profesör MATLAB Pipeline ile Çapraz Doğrulama
- Mevcut Durum Özeti
- Planlanan Çalışmalar
Bu proje, sıçanların açık alan (OFT) arenasında gerçekleştirilen kayıt videolarından davranışsal metrikleri otomatik olarak çıkarmak için uçtan uca bir analiz boru hattı oluşturmaktadır.
Temel soru: Aspartam ve greyfurt gibi yaygın diyet katkı maddeleri sıçanların açık alan davranışlarını nasıl değiştirmektedir?
Çalışmanın kapsamı:
- 4 tedavi grubu × 3 sıçan = 12 sıçan
- 12 açık alan videosu (OFT) + 12 plus maze videosu = 24 oturum
- Tüm videolar 30 fps hızında çekilmiştir
| Kohort | Sıçanlar | Tedavi | Rol |
|---|---|---|---|
| MA1 | MA1_1, MA1_2, MA1_3 | Hiçbiri (araç) | Kontrol grubu |
| MA3 | MA3_1, MA3_2, MA3_3 | Aspartam | Tatlandırıcı kolu |
| MA5 | MA5_1, MA5_2, MA5_3 | Sadece greyfurt | Greyfurt kolu |
| MA7 | MA7_1, MA7_2, MA7_3 | Aspartam + greyfurt | Kombine / etkileşim kolu |
Greyfurt kolu, greyfurt etkisini aspartam + greyfurt kombinasyonundan ayırt etmemizi ve her ikisini de aspartam ve kontrol gruplarıyla karşılaştırmamızı sağlar.
| Arena | Video Sayısı | Amaç |
|---|---|---|
| Açık alan (dikdörtgen) | 12 | Keşif, kaygı, lokomotor aktivite, rearing, grooming |
| Plus maze (4 kollu) | 12 | Çalışma belleği (alternation), kol tercihi, esneklik, persiverasyon |
| Bileşen | Araç |
|---|---|
| Pose tahmini | DeepLabCut (PyTorch arka ucu) |
| Video işleme | OpenCV |
| Veri işleme | Pandas, NumPy, SciPy |
| Görselleştirme | Matplotlib, Seaborn |
| Planlanan ML modelleri | Scikit-learn, XGBoost, PyTorch |
Sistem gereksinimleri: CUDA 11.8 veya 12.1 destekli NVIDIA GPU (RTX 3060 6 GB ile test edilmiştir). Davranış tespiti ve uzamsal analiz CPU üzerinde çalışmaktadır.
Durum: Tamamlandı
Script: src/video_preprocessing.py
-
Video envanteri oluşturuldu
- Tüm 24
.avivideosu listelendi ve dosya boyutları doğrulandı - Her video açılabilir durumda mı kontrol edildi (
get_video_properties()) - Süre, çözünürlük ve kare hızı kaydedildi
- Tüm 24
-
Metadata CSV üretildi (
data/metadata.xlsx)- Her video için bir satır içeren ana envanter tablosu oluşturuldu
- Sütunlar:
rat_id,session,arena,part,filename,duration_s,fps,resolution,file_path
-
Kalite kontrolü yapıldı
- Tüm oturumlarda tutarlı çözünürlük doğrulandı (
check_consistency()) - Parlaklık tutarsızlıkları kontrol edildi — grafikleri
data/quality_plots/altında - Düşen kareler işaretlendi (
check_dropped_frames()— %1'den fazla eksikse uyarı) - Bulanık kareler tespit edildi (
check_blur()— Laplacian varyansı, eşik=80) data/quality_report.xlsxdosyası üretildi
- Tüm oturumlarda tutarlı çözünürlük doğrulandı (
| Dosya | Açıklama |
|---|---|
data/metadata.xlsx |
24 videonun tüm meta verileri |
data/quality_report.xlsx |
Kalite kontrol özeti |
data/quality_plots/ |
Video başına parlaklık grafikleri |
data/part0_trajectories/ |
Hızlı bakış trajektori görüntüleri |
Durum: Tamamlandı (tüm 12 OFT videosu filtrelenmiş)
Scriptler: src/dlc/dlc_setup.py, src/dlc/dlc_train.py, src/dlc/dlc_inference.py
Açık alan (OFT) videolarını kapsayan tek bir DLC modeli eğitildi. Model, ResNet-50 omurgası ile 12 sıçanın tüm oturumlarını kapsamaktadır.
| Anahtar Nokta | Rol |
|---|---|
nose |
Burun ucu — grooming ve duvar yakınlığı |
head |
Kafa merkezi — htdist ve htd_y özelliklerinde kullanılır |
body_center |
Vücut merkezi — thigmotaxis ve heatmap için birincil referans |
left_forepaw, right_forepaw |
Ön ayaklar — rearing ve grooming tespiti |
left_hindpaw, right_hindpaw |
Arka ayaklar — dikey yükselme referansı |
tail_base |
Kuyruk tabanı — htdist ve htd_y özelliklerinde kullanılır |
tail_tip |
Kuyruk ucu |
-
DLC Proje Kurulumu (
dlc_setup.py)- DLC projesi oluşturuldu
- 12 OFT videosu config'e eklendi
- Vücut parçaları ve iskelet tanımlandı
-
Çerçeve Çıkarımı ve Etiketleme
- Her videodan ~20 çerçeve çıkarıldı (kmeans yöntemi)
- Etiketleme GUI'si ile 200–400 çerçeve etiketlendi
- Her vücut parçası için koordinatlar atandı
-
Model Eğitimi (
dlc_train.py)- Eğitim veri seti oluşturuldu
pose_cfg.yamlRTX 3060 için ayarlandı (batch_size=8)maxiters=50000ile model eğitildi (ResNet-50 omurgası)- Test RMSE < 8px hedefi
-
Çıkarım ve Filtreleme (
dlc_inference.py)- 12 OFT videosu üzerinde çıkarım yapıldı
- Medyan filtresi uygulandı (pencere = 5 kare)
data/DLCfiltered/<subject>/altında filtrelenmiş CSV'ler dışa aktarıldı
Her data/DLCfiltered/<KOHORT>_<N>/ klasöründe bir CSV dosyası:
- Sütunlar:
frame,<bodypart>_x,<bodypart>_y,<bodypart>_likelihood(30 fps) - 9 vücut parçası × 3 koordinat = 27 sütun
Durum: Tamamlandı — MA1_2 (rearing) ve MA5_1 (grooming) üzerinde doğrulandı
Script: src/behavior_detection.py
ML eğitimi gerektirmeyen kural tabanlı dedektör. Postüral özellikler üzerindeki eşikler, davranışları ayırt etmektedir.
| Özellik | Formül | Davranışsal Anlam |
|---|---|---|
htdist |
√((head_x - tail_x)² + (head_y - tail_y)²) |
Duvar rearing'inde beden projeksiyonu kısalır |
fp_hp_vert |
hindpaw_y − forepaw_y |
Ön-arka ayak dikey ayrımı (rearing yönü) |
nose_y |
Burun dikey pozisyonu | Duvar yakınlığı (üst/alt duvar) |
nose2fp |
Burun ile ön ayak arası mesafe | Grooming sırasında burun ön ayağa yakın |
htd_y |
` | head_y − tail_y |
nose_x |
Burun yatay pozisyonu | Sol/sağ duvar yakınlığı |
Rearing (Ayağa Kalkma) Kuralları — herhangi biri tetiklenince:
| Kural | Koşul | Tespit Ettiği |
|---|---|---|
| R1 — Kompakt Rearing | htdist < 55 |
Herhangi bir duvara karşı güçlü kompresyon |
| R2 — Üst Duvar Uzatmalı | fp_hp_vert > 45 VE nose_y < 165 |
Üst duvara karşı uzanma |
| R3 — Alt Duvar Güçlü | fp_hp_vert < -80 VE nose_y > 500 |
Alt duvara karşı güçlü postür |
| R4 — Alt Duvar Kompakt | fp_hp_vert < -45 VE nose_y > 500 VE htdist < 105 |
Alt duvara karşı ılımlı kompresyon |
| R5 — Yan Duvar | 40 < htd_y < 60 VE (nose_x > 760 VEYA nose_x < 430) |
Sol/sağ duvara karşı rearing |
Grooming (Tımar) Kuralı:
| Kural | Koşul | Not |
|---|---|---|
| G1 — Grooming | nose2fp < 22 VE fp_hp_vert < 10 VE rearing değil |
Yüz yıkama postu |
Öncelik sırası: Rearing > Grooming > Diğer
| Parametre | Değer | Anlam |
|---|---|---|
INTER_BOUT_GAP |
15 kare (0.50 s) | Bu kadar boşlukla ayrılmış pozitifler birleştirilir |
MIN_BOUT_FRAMES |
10 kare (0.33 s) | Bundan kısa boutlar gürültü olarak atılır |
- Rearing: 9 onaylı pencere, tüm R1–R5 kuralları devreye girdi
- Grooming: 2 onaylı pencere — 72.7–73.2 s (kısa) ve 160.2–167.7 s (uzun)
- Bilinen yanlış pozitiflerin giderilmesi: 4 adet tanımlanmış ve düzeltilmiş
| Dosya | İçerik |
|---|---|
*_behavior_timeline.png |
3 satırlı renk kodlu zaman çizelgesi: gerçek zemin / tespit edilen boutlar / kare bazlı etiketler |
*_behavior_bouts.csv |
Bout başına tablo: davranış, başlangıç/bitiş kare ve saniye, süre |
*_behavior_frames.csv |
Kare başına tablo: kare indeksi, zaman (s), davranış etiketi |
Durum: Tamamlandı — tüm 4 kohort (MA1, MA3, MA5, MA7)
Script: analysis/run_analysis.py (tek komutla 4 görsel üretir)
- Likelihood filtresi (varsayılan ≥ 0.6) — düşük güvenilirlikli DLC tahminleri atılır
- Arena sınır filtresi — alan dışı noktalar NaN yapılır (görsel taşmayı önler)
- Atlama eşiği (varsayılan 60 piksel) — ardışık kareler arasındaki takip atlamalarını kaldırır
- Yuvarlanmalı medyan yumuşatma (varsayılan pencere=5) — gerçek NaN boşlukları korunarak temporal gürültü azaltılır
Sonuç: Vücut parçası başına ~%85–99 kare tutma oranı
analysis/show_frame_coords.py ile interaktif 2 aşamalı sınır belirleme:
- Aşama 1: Arena duvarlarının 4 köşesi tıklanır
- Aşama 2: Thigmotaxis sınırı için 4 iç bölge köşesi tıklanır
- 4×3 ızgara, her vücut parçası için bir panel
- Trajektori rengi: açık (erken kareler) → koyu (geç kareler)
- Arena (beyaz kesik) ve iç bölge (turuncu noktalı) sınırları
body_centertek panel trajektorisi- Dış bölge (turuncu): iç sınır dışında kalan noktalar
- İç bölge (mavi): iç sınır içinde kalan noktalar
- Başlıkta thigmotaxis oranı raporlanır
Thigmotaxis: Duvar yakınında kalma davranışı — açık alan testlerinde kaygıyı ölçen klasik bir indeks.
- Gaussian kernel yoğunluk tahmini
infernorenk haritası (siyah → mor → sarı)- 150 dpi çözünürlükte yayın kalitesi
- Tez için onaylanmış görsel
- 2D bölgelenmiş sayım yoğunluğu
- KDE'nin yanı sıra ham dağılımı doğrulamak için kullanılır
- Her vücut parçası için bir panel (4×3 ızgara)
- Farklı vücut parçalarının hareket örüntülerini karşılaştırmak için kullanılır
| Metrik | Açıklama | Davranışsal Anlam |
|---|---|---|
| Toplam mesafe | Kümülatif yol uzunluğu (piksel) | Lokomotor aktivite |
| Ortalama hız | Ortalama hareket hızı | Arousal / inhibisyon |
| Donma süresi | Neredeyse sıfır hızda geçirilen süre | Korku / donma |
| Thigmotaxis oranı | İç bölge dışında geçirilen süre % | Kaygı benzeri davranış |
| Merkez giriş sayısı | İç bölgeye giriş sıklığı | Keşif dürtüsü |
Durum: Tamamlandı — tüm 4 kohort × 3 sıçan = 12 sıçan
Klasör: analysis/tmaze/ (script adları korundu, çıktılar _plus_maze_* olarak)
Sıçanlar T-maze değil, 4 kollu plus/cross mazete kayıt edilmiştir (alt + sol + sağ + üst kol, ortada bir junction). Aşama 03A açık alan boru hattıyla aynı temizleme adımları (likelihood, jump, smoothing) kullanıldı. DLC kaynak CSV'leri filtresiz sürüm (yumuşatılmamış raw output) — Aşama 03A ile tutarlı, çift filtreleme önlendi.
[TOP ARM]
||
[LEFT ARM] == JUNCTION == [RIGHT ARM]
||
[BOTTOM ARM]
Sıçanlar deney başında bottom arm (start) içine bırakılır.
| Adım | Script | Amaç |
|---|---|---|
| 1 | show_frame_coords.py |
İnteraktif 4-fazlı arena seçimi (her kol için 4 köşe) |
| 2 | tmaze_metrics.py |
Sıçan başına nicel metrikler |
| 3 | orbit_plot.py |
Bölge renkli trajektori (ana + 4 panel bodypart grid) |
| 4 | activity_heatmap.py |
KDE + 2D histogram yoğunluk haritaları |
| 5 | run_analysis.py |
Yukarıdaki 4 adımı zincirleyen master script |
Tek koordinat seti kullanıldı (Part1 ve Part2 videolarında kamera konumu özdeş):
- bottom-arm: 544 605 404 717
- left-arm: 258 551 348 403
- right-arm: 604 893 345 404
- top-arm: 544 608 39 348
| Eski | Yeni |
|---|---|
data/DLCfiltered/<kohort>/TmazeMA*_n/ |
data/DLCfiltered/<kohort>/PlusMazeMA*_n/ |
*_tmaze_metrics.csv |
*_plus_maze_metrics.csv |
*_tmaze_orbit.png |
*_plus_maze_orbit.png |
*_tmaze_bodyparts.png |
*_plus_maze_bodyparts.png |
| Kategori | Metrikler | Davranışsal Anlam |
|---|---|---|
| Bölge işgali | pct_time_bottom/left/right/top/junction, time_*_s |
Mekânsal tercih, kol seçimi |
| Kol girişleri | total_entries, bottom/left/right/top_entries |
Genel keşif aktivitesi |
| Alternasyon | successive_alternation_pct (her giriş öncekinden farklı), tetrad_alternation_pct (4'lü grup tüm 4 kolu kapsar) |
Çalışma belleği, esneklik |
| Persiverasyon | perseveration_count, perseveration_rate_pct (üst üste aynı kol) |
Bilişsel katılık |
| Kol tercihi | most_visited_arm, arm_preference_index (en çok ziyaret / toplam) |
Lateralizasyon, alışkanlık |
| Locomotion | mean_speed_px_s, total_distance_px |
Hareket aktivitesi |
| Sequence | entry_sequence (örn. R->L->T->B->...) |
Davranış zamanlaması analizi için ham dizi |
PlusMazeMA1_2/
├── PlusMazeMA1_2.csv ← DLC filtresiz raw girdi
├── PlusMazeMA1_2_plus_maze_metrics.csv ← 30 sütunluk metrik
├── PlusMazeMA1_2_plus_maze_orbit.png ← Bölge renkli trajektori
├── PlusMazeMA1_2_plus_maze_bodyparts.png ← 4 panel bodypart grid (nose, head, body_center, tail_base)
├── PlusMazeMA1_2_heatmap_kde.png ← KDE yoğunluk haritası
└── PlusMazeMA1_2_heatmap_histogram.png ← 2D histogram
| Dosya | İçerik |
|---|---|
data/plus_maze_metrics_all.csv |
12 sıçan × 30 sütunluk birleştirilmiş tablo |
- Kontrol (MA1): Aşırı bottom/top tercihi (örn. MA1_1 %98 top, MA1_2 %87 bottom). Yan kollara minimal giriş.
- Aspartam (MA3): Yüksek thigmotaxis benzeri pattern — MA3_3 %97 bottom, neredeyse hareketsiz.
- Greyfurt (MA5): Bottom + top dengesi, sınırlı keşif (5–10 toplam giriş).
- ASP+Greyfurt (MA7): En yüksek varyans — MA7_3 dengeli 4-kol kullanımı (
R->L->R->R->L->L->T->R...), MA7_1 ise %50 top dominansı.
activity_heatmap.pyhistogram düzeltmesi:hist2dveri aralığına otomatik fit ediyordu; veri küçük bir alanda yoğunlaşınca grafik köşeye sıkışıyordu.auto_extent(zones)ile sabitrangevexlim/ylimbelirlendi.- CSV tipi:
_filtered.csv(DLC'nin pre-smoothed çıktısı) yerine raw CSV kullanıldı — analiz scriptleri kendi yumuşatmasını uyguladığı için çift filtreleme engellendi. - Klasör/script ayrımı:
analysis/altındaki scriptleranalysis/open_field/veanalysis/tmaze/olarak ayrıldı;speed_analysis.pypaylaşılan ortak script olarakanalysis/kökünde kaldı.
Her data/DLCfiltered/<KOHORT>_<N>/ klasörü şu 9 dosyayı içermektedir:
OpenFieldMA3_2/
├── OpenFieldMA3_2.csv ← DLC filtreli girdi (gerçek kaynak)
│
│ Davranış tespiti (src/behavior_detection.py)
├── OpenFieldMA3_2_behavior_timeline.png
├── OpenFieldMA3_2_behavior_bouts.csv
├── OpenFieldMA3_2_behavior_frames.csv
│
│ Uzamsal / lokomotor analiz (analysis/*.py)
├── OpenFieldMA3_2_orbit_grid.png
├── OpenFieldMA3_2_thigmotaxis.png
├── OpenFieldMA3_2_heatmap_kde.png
├── OpenFieldMA3_2_heatmap_histogram.png
└── OpenFieldMA3_2_bodypart_heatmaps.png
| Dosya | İçerik |
|---|---|
data/behavior_summary.csv |
Sıçan başına davranış bout istatistikleri |
data/behavior_group_stats.csv |
Kohort düzeyinde davranış özetleri |
data/behavior_comparison.png |
Gruplar arası karşılaştırma grafiği |
data/part0_oft_metrics.xlsx |
Tüm sıçanları kapsayan OFT metrik tablosu |
Ayrıntılı analiz için bkz. behavior_comparison.md.
Toplam mesafe (px): Kontrol 4.449 < Aspartam 4.982 < Greyfurt 5.960 < ASP+GF 6.949
Ortalama hız (px/s): Kontrol 26.5 < Aspartam 29.8 < Greyfurt 33.6 < ASP+GF 39.9
Kombine tedavi, kontrole göre yaklaşık %50 daha hızlıdır. Muhtemelen CYP3A4 aracılı greyfurt + aspartam etkileşimi.
Donma süresi (%): Kontrol 18.6% > Greyfurt 9.7% > ASP+GF 6.1% ≈ Aspartam 6.0%
Daha fazla hareket eden hayvanlar daha az donuyor. Tüm tedavi grupları, yenilik kaynaklı korkuyu azaltıyor.
Grooming süresi (%): Kontrol 2.3% ≈ Aspartam 2.1% << Greyfurt 17.9% > ASP+GF 11.3%
Bu, veri setindeki en keskin tedavi-kontrol sinyalidir. Greyfurt grooming'i yaklaşık 8× artırıyor; aspartam eklendiğinde bu artış hafifliyor.
| Metrik | Kontrol | Aspartam | Greyfurt | ASP+GF |
|---|---|---|---|---|
| Rearing parçalanma indeksi | 0.926 | 0.837 | 0.590 | 0.711 |
| Grooming parçalanma indeksi | 1.279 | 1.248 | 0.680 | 1.023 |
Düşük değer = daha uzun, sürekli boutlar. Greyfurt rearing ve grooming'i uzun episodlar halinde düzenliyor; aspartam eklenmesi bu düzeni bozuyor.
Klasik kaygı teorisi duvar yakınlaşması ve donmanın birlikte görüldüğünü öngörür — ancak burada görülmüyor:
- Greyfurt en güçlü thigmotaxis gösteriyor (%93 çevre) ama yalnızca ara düzeyde donma
- ASP+GF en düşük donmayı (%6.1) ve en fazla merkez girişini gösteriyor
- Bu ayrışma, kaygı hedefinin birden fazla metriği birlikte ağırlıklandırması gerektiğini ortaya koyuyor
data/kutu_validation_summary.csv dosyası, DLC pose çıktımızı profesörün 2017 HSV-blob tabanlı MATLAB pipeline'ıyla karşılaştırmaktadır.
- Pearson r ≥ 0.78 — 12 sıçanın 9'unda (medyan 0.85)
- İstisna: MA3_1 (r=0.45), MA3_3 (r=0.54) — trajektori görüntüleri gözden geçirilmeli
- Hız oranı: kutu/dlc = 0.79–0.90 — DLC tutarlı biçimde %10–20 daha hızlı okuyor
Bu sapma sistematik ve uniform — tüm kohortlarda aynı yönde. Muhtemelen DLC bireysel vücut parçalarını takip ederken HSV-blob tıkandığında ince hareketi kaybediyor. Grup karşılaştırmalarını geçersiz kılmaz, ancak tez yöntemler bölümünde belirtilmesi gerekir.
| Aşama | Durum |
|---|---|
| 01 — Video ön işleme / kalite kontrolü | Tamamlandı |
| 02 — DeepLabCut pose tahmini | Tamamlandı (tüm 12 OFT videosu filtrelenmiş) |
| 02B — Kural tabanlı davranış tespiti | Tamamlandı, MA1_2 / MA5_1 üzerinde doğrulandı |
| 03A — OFT uzamsal analizi — tüm kohortlar (MA1, MA3, MA5, MA7) | Tamamlandı |
| 03C — Plus maze (4 kollu) analizi — 12 sıçan | Tamamlandı (2026-05-07) |
| 05 — Özellik mühendisliği (yalnızca OFT) | Tamamlandı |
| 06 — ML modeli eğitimi + SHAP analizi | Tamamlandı |
| 06B — Rapor görselleştirme (CSV → PNG) | Tamamlandı |
| 05B — OFT + Plus Maze özellik birleştirmesi | Sıradaki |
| 07 — Gruplar arası raporlama | Planlandı |
Durum: Tamamlandı
Script: src/features.py
oft_metrics_all.csv ve behavior_summary.csv dosyaları subject_id üzerinden birleştirilerek 26 özellikten oluşan tek bir tablo üretildi. Türetilmiş özellikler eklendi (locomotion_pct, rear_per_min, groom_per_min, exploration_ratio). Dört hedef etiket hesaplandı.
Üretilen dosyalar:
| Dosya | İçerik |
|---|---|
data/features/features_raw.csv |
12 satır × 26 özellik (ham) |
data/features/features_normalized.csv |
StandardScaler uygulanmış |
data/features/labels.csv |
anxiety_score, anxiety_level, rearing_profile, grooming_profile |
models/classifier/scaler.pkl |
Kaydedilmiş ölçekleyici |
Durum: Tamamlandı
Script: src/train_baseline.py
4 model × 4 hedef = 16 model LOOCV (Leave-One-Out) ile eğitildi. Her sıçan tam olarak 1 kez test örneği oldu. XGBoost ile SHAP analizi yapıldı.
LOOCV F1-Macro Sonuçları:
| Model | group | anxiety_level | rearing_profile | grooming_profile |
|---|---|---|---|---|
| LogisticReg | 0.083 | 0.520 | 0.303 | 0.383 |
| RandomForest | 0.155 | 0.520 | 0.451 | 0.238 |
| XGBoost | 0.255 | 0.520 | 0.341 | 0.506 |
| SVM | 0.267 | 0.196 | 0.316 | 0.196 |
| Rastgele baz | 0.250 | 0.333 | 0.333 | 0.333 |
One-vs-Rest SHAP — Her Grubun Ayırt Edici Özellikleri:
| Grup | En Belirleyici Özellik | Biyolojik Yorum |
|---|---|---|
| Control | freeze_bout_count, total_distance_px |
Düşük lokomotor + yüksek donma |
| Aspartame | rear_bout_count, groom_total_s |
Kontrol ve greyfurt arası geçiş profili |
| Grapefruit | center_zone_entries (tutarlı biçimde = 6) |
Kaygı kaynaklı thigmotaxis |
| ASP+GF | groom_pct_time (en güçlü sinyal) |
Grooming + lokomotor sinerjik aktivasyon |
Üretilen dosyalar:
| Dosya | İçerik |
|---|---|
reports/model_comparison.csv |
4 model × 4 hedef × F1/accuracy |
reports/loocv_predictions.csv |
Sıçan bazlı LOOCV tahmin detayları |
reports/ovr_binary_f1.csv |
OvR ikili sınıflandırma F1 skorları |
reports/figures/confusion_<hedef>.png |
4 adet karışıklık matrisi |
reports/figures/shap_<hedef>.png |
4 adet çok-sınıflı SHAP grafikleri |
reports/figures/shap_ovr_groups.png |
Grup bazlı OvR SHAP (tez için birincil görsel) |
reports/figures/table_model_comparison.png |
Model karşılaştırma ısı haritası (tez tablosu) |
reports/figures/table_loocv_predictions.png |
XGBoost sıçan bazlı doğru/yanlış tahmin tablosu |
reports/figures/chart_ovr_f1.png |
OvR F1 bar grafiği |
models/classifier/<model>_<hedef>.pkl |
16 eğitilmiş model dosyası |
Örneklem kısıtı ve F1 yorumu:
n=12 (3/grup) ile grup tahmini F1=0.25–0.27 (rastgele baza eşit) elde edildi. Bu beklenen bir sonuçtur — güvenilir 4-sınıf ML için grup başına en az 10 örnek (toplam 40) gereklidir. Buna karşın anxiety_level (F1=0.52) ve grooming_profile (F1=0.51) tahminleri rastgele bazın anlamlı biçimde üzerindedir. Bu bulgular pipeline'ın gerçek davranışsal sinyal ürettiğini kanıtlamakta, ancak grup ayrımı için daha büyük örneklem gerektiğini göstermektedir.
| F1 aralığı | Yorum |
|---|---|
| ≤ 0.33 | Rastgele veya altı |
| 0.33–0.45 | Zayıf sinyal |
| 0.45–0.60 | İyi (n=12 için gerçekçi başarı) |
| 0.60–0.75 | Çok iyi |
| > 0.75 | Şüpheli — veri sızıntısı kontrol edilmeli |
Durum: Tamamlandı
Script: src/visualize_reports.py
reports/ altındaki CSV çıktıları teze doğrudan alınabilecek PNG görsellerine dönüştürüldü.
| Görsel | Açıklama |
|---|---|
table_model_comparison.png |
4 model × 4 hedef F1 ısı haritası (kırmızı=kötü, yeşil=iyi) |
table_loocv_predictions.png |
XGBoost'un her sıçan için doğru/yanlış tahmin tablosu (kohort renkli) |
chart_ovr_f1.png |
OvR grup bazlı F1 ve accuracy bar grafiği |
Ön koşul: 05 ve 06 çıktılarının tamamlanmış olması.
Hedef: Tüm pipeline çıktılarını yapılandırılmış bir tez raporu haline getirmek.
7.1 — Sıçan başına davranışsal profiller
Her kohort (MA1, MA3, MA5, MA7) için tek sayfalık özet:
- OFT occupancy KDE heatmap'leri (3 seans yan yana)
- Rearing + grooming heatmap'leri
- OFT metrik eğilimleri seans boyunca (çizgi grafikleri)
- ML modelinin tahminlediği kaygı / rearing / grooming etiketleri
7.2 — Grup karşılaştırma istatistikleri
Her özellik için Kruskal-Wallis testi (4 grup, n=3/grup) + Bonferroni düzeltmeli Dunn post-hoc testi. Çıktı: özellik × p-değeri × etki büyüklüğü tablosu.
7.3 — Davranış bout istatistikleri
Rearing ve grooming için grup bazında kutu / violin grafikleri:
- Bout sayısı, ortalama süre, toplam süre yüzdesi
- Parçalanma indeksi (fragmentation index)
7.4 — Heatmap galerisi
| Görsel | Açıklama |
|---|---|
| 4 grup × occupancy KDE | Mekânsal tercih karşılaştırması |
| 4 grup × rearing heatmap | Rearing bölgesi dağılımı |
| 4 grup × grooming heatmap | Grooming bölgesi dağılımı |
7.5 — Model performans özeti
Model × etiket × F1 tablosu, SHAP özet grafikleri ve karışıklık matrisleri (sıçan ID'leriyle).
Tez rapor yapısı:
reports/
├── figures/
│ ├── heatmaps/open_field/ # OFT: occupancy, rearing, grooming
│ ├── trajectories/ # Davranış renkli rota grafikleri
│ ├── ethograms/ # Seans zaman çizelgeleri
│ ├── statistics/ # Grup karşılaştırma grafikleri
│ └── model/ # SHAP, karışıklık matrisleri, ROC
├── tables/
│ ├── oft_metrics_summary.csv
│ ├── behavior_bout_stats.csv
│ ├── group_comparisons.csv
│ └── model_comparison.csv
└── profiles/
├── MA1_profile.pdf (Kontrol)
├── MA3_profile.pdf (Aspartam)
├── MA5_profile.pdf (Greyfurt)
└── MA7_profile.pdf (ASP + Greyfurt)
| Görev | Durum |
|---|---|
Etiket oluşturma (anxiety_score, rearing_profile, grooming_profile) |
Tamamlandı — src/features.py |
Özellik tablosu birleştirme (features_raw.csv, features_normalized.csv) |
Tamamlandı — src/features.py |
| 4 model × 4 hedef LOOCV eğitimi | Tamamlandı — src/train_baseline.py |
| SHAP analizi (çok-sınıflı + One-vs-Rest) | Tamamlandı — src/train_baseline.py |
| CSV çıktılarının PNG görselleştirmesi | Tamamlandı — src/visualize_reports.py |
| Plus maze pipeline (4 kollu metrikler + heatmap + orbit) | Tamamlandı — analysis/tmaze/ |
12 sıçanın plus maze metriklerinin birleştirilmesi (plus_maze_metrics_all.csv) |
Tamamlandı |
src/features.py güncellenecek. İki arenanın metrikleri sıçan ID üzerinden birleştirilip ML pipeline'ına bağlanacak.
- ID normalleştirme:
subject_idformatları farklı — OFTMA1_1, plus mazePlusMazeMA1_1. Plus maze ID'lerindenPlusMazeprefix kaldırılarak ortakMA1_1formatına indirgenecek. - Sütun çakışmaları:
mean_speed_px_s,total_distance_px,session_duration_sher iki arenada da var. Plus maze sütunlarınapm_prefix eklenecek (pm_mean_speed_px_svb). - Yeni özellikler eklenecek:
pm_pct_time_bottom/left/right/top/junction(5)pm_total_entries,pm_*_entries(5)pm_arm_preference_index(1)pm_successive_alternation_pct,pm_tetrad_alternation_pct(2 — çalışma belleği)pm_perseveration_rate_pct(1 — esneklik)pm_total_distance_px,pm_mean_speed_px_s(2)- Toplam +16 özellik → mevcut 26 OFT özelliğine eklenir = 42 özellik
- Yeniden eğitim: 4 model × 4 hedef LOOCV ile yeniden eğitilecek; SHAP analizinde plus maze özelliklerinin grup ayrımına katkısı incelenecek.
- Yeni etiket önerisi:
cognitive_flexibility—pm_successive_alternation_pctvepm_perseveration_rate_pctüzerinden tanımlanan üçlü etiket (low/moderate/high).
Tüm pipeline çıktılarını yapılandırılmış bir tez raporu haline getirmek:
- Kruskal-Wallis + Dunn post-hoc istatistik testi — her özellik için grup karşılaştırması (p-değeri ve etki büyüklüğü tablosu) — OFT + plus maze metrikleri ayrı ayrı
- Violin / kutu grafikleri — rearing, grooming, alternation, perseveration istatistikleri grup bazında
- KDE heatmap galerisi — 4 grup yan yana (OFT occupancy + plus maze occupancy)
- Sıçan başına profil sayfaları — her kohort için özet görsel (OFT heatmap + plus maze trajektori + ML tahminleri)
- Plus maze sequence analizi —
entry_sequenceüzerinden Markov geçiş matrisleri (gruplar arası karşılaştırma)
Mevcut n=12 (3/grup) ile 4-sınıf grup tahmini güvenilir değildir. Gelecek çalışmalar için grup başına en az 10 sıçan (toplam 40) önerilir. Anxiety ve grooming profil tahminlerindeki F1>0.50 değerleri, pipeline'ın biyolojik sinyal ürettiğini göstermiştir.
Bu dosya, docs/behavior_comparison.md, docs/final_report.md, docs/WORKFLOW_SUMMARY.md ve docs/plans/ altındaki aşama planlarından derlenerek hazırlanmıştır.