11. Rapor, ODMAP ve çok türlü çalışma (⑧ Report)
Sekme: ⑧ Report · Kod: tabs/tab_report.py (arayüz ve HTML rapor), odmap.py (ODMAP protokolü), batch_species.py (çok türlü toplu çalıştırma), map_widget.py ve study_area_figure.py (yayın haritaları)
11.1 Bu sekme ne yapar
⑧ Report, oturumdaki bütün sonuçları tek bir HTML dosyasında toplar; ayrıca ODMAP raporlama protokolünü kısmen doldurur ve çok türlü bir kayıt dosyasında tamamlanan iş akışını öteki türler için yineler. Sekme ③ Models tamamlanınca açılır (tabs/tab_models.py:1852).
- Girdi: oturum durumu (modeller, topluluk, projeksiyonlar, alan değişimi, doğrulama sonuçları), çıktı klasöründeki
figures\*.pnggrafikleri, kullanıcının harita görüntüleyiciden kaydettiği PNG haritalar,habitus_run_config.jsonve oturum günlüğü (.log). - Çıktı:
<tür>_HABITUS_report_<YYYYMMDD_HHMMSS>.html(bütün görüntüler dosyanın içine gömülü), istenirseodmap_protocol.mdveodmap_protocol.csv, toplu çalıştırmada her tür için bir alt klasör vebatch_summary.csv. - Hesap: Rapor yeni bir hesap yapmaz; var olan sonuçları okur, yorum cümleleri ve tablolar üretir. Haritaları yeniden çizdiği tek yer alan değişimi ve doğrulama haritalarıdır.
11.2 Ekranın düzeni

Sekme tek bölmelidir (tabs/tab_report.py:376-465). Yukarıdan aşağıya: başlık kutusu, Report Sections (bölüm seçimi, §11.3), dört düğme (§11.4, §11.6, §11.8), ilerleme çubuğu ve durum satırı, Report preview (HTML source — first 8 000 characters): önizleme kutusu.

11.3 Rapor seçenekleri (Report Sections)
| Arayüzdeki ad | Ne yapar | Varsayılan | Aralık / seçenekler | Kod |
|---|---|---|---|---|
Variables |
2. bölüm: değişken taraması ve seçilen değişkenler | açık | açık / kapalı | tabs/tab_report.py:400, :2416-2418 |
Methods |
3. bölüm: yöntem metni | açık | açık / kapalı | :401, :2421-2423 |
Parameters |
4. bölüm: genel ayarlar ve algoritma ayarları tablosu | açık | açık / kapalı | :402, :2426-2428 |
Evaluation |
5. bölüm: değerlendirme tabloları ve grafikleri | açık | açık / kapalı | :403, :2431-2433 |
Maps |
6. bölüm: kullanıcının kaydettiği bugünkü harita PNG'leri | açık | açık / kapalı | :404, :2436-2439 |
Future |
7. bölüm: senaryo klasörlerindeki harita PNG'leri | açık | açık / kapalı | :405, :2443-2448 |
Range Change |
8. bölüm: alan değişimi tabloları ve haritaları | açık | açık / kapalı | :406, :2464-2467 |
Validation |
9. bölüm: ⑦ Validation sonuçları | açık | açık / kapalı | :407, :2470-2473 |
Log |
10. bölüm: oturum günlüğü | açık | açık / kapalı | :408, :2476-2481 |
- Ne işe yarar. Her kutu raporun bir bölümünü ekler ya da çıkarır. 1. bölüm (Study Summary), çevresel yenilik bölümü (ExDet) ve işleme notları kutulardan bağımsız olarak her zaman eklenir (
tabs/tab_report.py:2412-2413,:2450-2461): bu üç bölüm haritaların nasıl okunacağını belirlediği için kapatılamaz. - Ne zaman, nasıl ayarlanır. Ek materyal olarak eksiksiz rapor isteniyorsa hepsi açık bırakılır. Ana metne yalnız yöntem ve değerlendirme alınacaksa
Maps,FutureveLogkapatılarak dosya küçültülebilir (gömülü PNG'ler ve uzun günlük boyutu büyütür; örnek rapor 5,5 MB'tır). - Sonuca etkisi. Hiçbir hesabı değiştirmez. Bir kutu işaretli olsa da kaynağı yoksa bölüm yazılmaz: örneğin ⑦ Validation çalıştırılmadıysa 9. bölüm, harita PNG'si kaydedilmediyse 6. ve 7. bölümler rapora girmez (örnek raporda 6, 7 ve 9 yoktur).
- Dikkat. Kutular değişken seçimini, hangi senaryonun ya da hangi alan değişimi analizinin rapora gireceğini seçmez; oturumdaki bütün senaryolar ve alan değişimi analizleri yazılır.
11.4 Generate HTML Report ve Open in Browser
| Arayüzdeki ad | Ne yapar | Varsayılan | Aralık / seçenekler | Kod |
|---|---|---|---|---|
⚙ Generate HTML Report |
Raporu baştan üretir ve çıktı klasörüne kaydeder | — | — | tabs/tab_report.py:417-419, :2365-2539 |
🌐 Open in Browser |
Son üretilen raporu sistemin varsayılan tarayıcısında açar | rapor üretilene dek devre dışı | — | :420-421, :2541-2547 |
Her basışta bütün çıktılar yeniden okunur ve rapor sıfırdan kurulur; durum satırı bunu söyler: Each click re-reads all outputs and re-generates from scratch. (tabs/tab_report.py:449-451). Dosya adı <tür>_HABITUS_report_<zaman damgası>.html olur; her üretim yeni bir dosya yazar, eskileri silinmez (tabs/tab_report.py:2507-2510). Çıktı klasörü yoksa bir kaydetme penceresi açılır. İş bitince Report Ready penceresi yolu gösterir ve önizleme kutusuna HTML kaynağının ilk 8000 karakteri yazılır. Örnek koşuda rapor abies_nordmanniana_HABITUS_report_20261121_051313.html adıyla kaydedilmiştir.
İpucu: Model ya da senaryo yeniden çalıştırıldıysa rapor kendiliğinden güncellenmez;
Generate HTML Report'a yeniden basılmalıdır.
11.5 HTML raporun bölümleri
Rapor İngilizcedir ve dergiye gönderilecek ek materyal taslağı olarak yazılmıştır; en üstteki not bunu açıkça söyler: Results and interpretive text should be reviewed and adapted before submission to a scientific journal. (tabs/tab_report.py:2405-2409). Bölümler ve içerikleri aşağıdadır.
11.5.1 Başlık ve 1. Study Summary
Başlıkta tür adı (italik) ve üretim zamanı vardır. 1. bölüm bir tablodur: hedef tür, süzme sonrası kayıt sayısı (ilk yalancı yokluk kümesindeki varlık sayısı), değişken sayısı, algoritmalar, toplam model sayısı, çıktı klasörü ve üretim tarihi (tabs/tab_report.py:703-725). Örnek koşuda 143 kayıt, 8 değişken, 4 algoritma.
11.5.2 2. Selected Variables and Multicollinearity Assessment
② Variables'taki tarama yöntemi (VIF ve |r| eşikleri, korelasyon yöntemi) bir paragrafla anlatılır; seçilen değişkenlerden VIF eşiğini aşan varsa adlarıyla bildirilir. 2.1 Variable Screening Table her aday değişken için VIF, tek değişkenli AUC, VIF ve korelasyon uygunluğunu; 2.2 Final Selected Variables seçilen değişkenleri listeler. figures\ klasöründeki korelasyon ısı haritası (seçilenlerinki varsa o) ve VIF çubuk grafiği gömülür (tabs/tab_report.py:729-878).
11.5.3 3. Methods
Yöntem bölümü, oturumda gerçekten kullanılan ayarlardan cümle kurar (tabs/tab_report.py:879-1205):
3.1 Occurrence data: süzme adımları ve kalan kayıt sayısı.3.2 Environmental predictors: seçilen değişkenler.3.3 Absence and background data: yokluk kaynağı (yalancı yokluk, kullanıcı yokluğu ya da ikisi), küme sayısı ve büyüklüğü; erişilebilir alan (tampon/zarf yöntemi ve kilometre değeri ya da kullanıcı poligonu ve kaç biriminin seçildiği; kapsamın yüzdesi); seyreltme mesafesi, kaynağı ve kalan kayıt; aynı hücre süzmesi.3.4 Modelling algorithms: algoritma açıklamaları ve kaynakları; çapraz doğrulama tasarımı (mekânsal blok, çevresel blok, öteki tasarımlar ya da rastgele) ve tasarımın skorları nasıl etkilediğine dair uyarı; mekânsal sıralama yanlılığı (SSB) ortalaması; birleştirilen kat sayısı.3.5 Ensemble modelling: iki katmanlı ya da tek katmanlı birleştirme, algoritma başına kopya sayıları, birleştirme kuralı.3.6 Model evaluation: AUC, TSS, Boyce, kalibrasyon ölçüleri ve yokluk kaynağına göre bir uyarı.3.7 Reproducibility: rastgele tohum vehabitus_run_config.jsondosyasına gönderme.
11.5.4 4. Model Parameters
Global Modelling Settings tablosu (seçilen değişkenler, küme başına yalancı yokluk, yalancı yokluk stratejisi, küme sayısı, kat sayısı, eğitim/test oranı, permütasyon önem tekrarları) ve 4.1 Algorithm Settings tablosu (her algoritmanın tam adı, kaynağı, açıklaması ve hiperparametreleri) (tabs/tab_report.py:1209-1267).
Dikkat: Bu tablodaki
Pseudo-absences per replicatevePA strategysatırları, ① Data'da seçilen değerleri değil 1000 verandomvarsayılanlarını gösterir; doğru değerler 3.3 bölümündeki metinde vehabitus_run_config.jsondosyasında (settings.background) bulunur.Train / Test splitsatırı mekânsal blok tasarımında kullanılmaz; kat düzeni 3.4'te anlatılır.
11.5.5 5. Model Evaluation Results
Önce skorların nasıl okunacağını belirleyen uyarılar (rastgele katlama, mekânsal sıralama yanlılığı vb.) tablodan önce verilir (tabs/tab_report.py:1271-1392). Ardından: 5.0 Performance and its variability (kopyalar arası yayılım), 5.1 Individual Model Scores (her model ve kat için AUC, TSS, Boyce, eşik, yaygınlık, kalibrasyon eğimi ve yorum), 5.1a Ensemble Scores (topluluğun çapraz doğrulama dışarıda bırakılan katlardaki skorları), 5.1b Threshold-based Metrics and Omission Rates (Kappa, MCC, duyarlılık, özgüllük, Jaccard, Sørensen, FPB, omisyon oranları, ΔAUC), 5.2 Algorithm Summary (algoritma ortalaması ± SD) ve 5.3 alt başlıklarında figures\ klasöründeki değerlendirme, ROC, omisyon/kesinlik-duyarlılık/kalibrasyon, değişken önemi ve yanıt eğrisi grafikleri. Bu çıktıların ayrıntısı Bölüm 7'dedir.
11.5.6 6. Current Distribution
Rapor bugünkü harita GeoTIFF'lerini çizmez; kullanıcının harita görüntüleyiciden kaydettiği PNG dosyalarını gömer. Çıktı klasörünün kökündeki bütün PNG'ler alınır; adı habitus_ ile başlayan ve _study_area.png ile bitenler hariçtir (tabs/tab_report.py:1794-1880). Harita türü dosya adından tahmin edilir (prob/suitability → uygunluk, bin → ikili, range/src → alan değişimi) ve buna göre hazır bir yorum paragrafı eklenir.
Dikkat: ⑤ ve ⑥'daki görüntüleyicilerin kaydetme penceresi de varsayılan olarak çıktı klasörünün köküne açılır (
map_widget.py:612-620). Oraya kaydedilen bir gelecek haritası bu bölümde "Current Distribution" başlığı altında görünür. Gelecek haritalarını senaryo alt klasörüne kaydedin (§11.5.7).
11.5.7 7. Future Scenarios
Çıktı klasöründeki her alt klasör (figures, validation ve current dışında) bir dönem sayılır; içinde PNG bulunan her alt klasör için 7.k <klasör adı> başlığı açılır ve PNG'ler gömülür (tabs/tab_report.py:1884-1973). Klasör adı senaryo adıdır (⑤'teki Output subdir, boşsa senaryo adı). Hiç PNG yoksa bölüm yazılmaz.
11.5.8 7.1 Environmental Novelty (Extrapolation Detection)
Her projeksiyon (current önce, sonra senaryolar alfabetik) için NT1 < 0, NT2 > 1, iki teste göre benzer hücre yüzdesi ve aralık/birleşim yeniliğinde en etkili üç değişken tablolanır; NT2 hesaplanamadıysa nedeni yazılır (tabs/tab_report.py:2024-2123). Gelecek bölümü (7) yazılmadıysa başlık 7 Environmental Novelty … olur. Yöntem Bölüm 8.9'da anlatılmıştır.

11.5.9 7.2 Processing Notices (işleme notları)
Haritaların okunuşunu değiştiren ama işi durdurmayan durumlar burada maddelenir; yoksa bölüm yazılmaz (tabs/tab_report.py:1981-2022):
- projeksiyonlarda eğitim ızgarasına hizalanan katmanlar ve örtülmeyen hücre uyarıları (§8.10);
- alan değişiminde hizalanan gelecek haritası;
- örnekleme yanlılığı uyarısı (hedef grup ya da yanlılık yüzeyi verilmediyse; örnek raporda tek not budur);
- ayar araması (tuning) yapıldıysa seçim yanlılığı notu;
- topluluk haritası üretilemediyse nedeni;
- veri girişi ve doğrulama notları.
11.5.10 8. Range Change Analysis
Her alan değişimi analizi için bir alt başlık, ⑥'daki tabloyla aynı satırlar (kapsam, bugünkü ve gelecek alan, yüzdeler, hücre sayıları, öteki kapsamların net değişimi, dışdeğerlenmiş değişim payı), değişen hücrelerin %25'i ya da fazlası dışdeğerlenmiş koşullardaysa bir not, net değişime göre üç düzeyli bir yorum (−10'un altı daralma, +10'un üstü genişleme, arası kararlılık) ve _SRC.tif dosyasından yeniden çizilmiş renkli harita (tabs/tab_report.py:2126-2265).

11.5.11 9. Validation
⑦ Validation'da bir doğrulama yapıldıysa: kip, başvuru ve doğrulama katmanları, nokta sayısı, genel doğruluk, Cohen κ, ağırlıklı F1 (varsa R², RMSE, MAE), karışıklık matrisi ve validation\reclassify*.tif dosyalarından en çok iki harita (tabs/tab_report.py:2269-2359). Ayrıntı Bölüm 10'dadır.
11.5.12 10. Session Log ve atıf
Çıktı klasöründeki .log dosyalarından adı en büyük olan (en yeni oturum) kaydırılabilir bir kutuya olduğu gibi yazılır (tabs/tab_report.py:606-614, :2476-2481). Raporun sonunda HABITUS için önerilen atıf bulunur (tabs/tab_report.py:2484-2495).
Not: Günlük her oturumda yeni bir dosyaya yazılır. Program aynı çıktı klasöründe kapatılıp yeniden açıldıysa rapora yalnız son oturumun günlüğü girer; önceki oturumun kayıtları kendi
.logdosyasında kalır.
11.6 ODMAP dışa aktarımı (Export ODMAP protocol)
| Arayüzdeki ad | Ne yapar | Varsayılan | Aralık / seçenekler | Kod |
|---|---|---|---|---|
Export ODMAP protocol |
odmap_protocol.md ve odmap_protocol.csv dosyalarını çıktı klasörüne yazar |
— | — | tabs/tab_report.py:422-430, :537-570 |
- Ne işe yarar. ODMAP (Overview, Data, Model, Assessment, Prediction), tür dağılım modellerinin raporlanması için önerilen standart protokoldür (Zurell vd. 2020). Düğme, protokolün Tablo 1'deki 79 öğesini satır satır kurar;
habitus_run_config.jsondosyasında ve oturumda kaydı bulunan öğeleri doldurur (auto), geri kalanlarıuser_requiredolarak işaretler (odmap.py:42-111,:156,:637-686). Hiçbir değer uydurulmaz; ipucu metni de raporun kullanıcı bu satırları doldurana dek ODMAP uyumlu sayılmayacağını söyler. - Ne zaman, nasıl ayarlanır. Makale gönderiminden önce; dosya yalnız düğmeye basınca yazılır, kendiliğinden yazılmaz (
tabs/tab_report.py:538-540). Önce modeller ve projeksiyonlar tamamlanmalı, sonra dışa aktarılmalıdır. - Sonuca etkisi. Hesabı etkilemez. Örnek koşuda 79 öğenin 46'sı otomatik doldurulmuş, 33'ü kullanıcıya bırakılmıştır. Durum satırı ve günlük şu iletiyi yazar:
ODMAP protocol written (79 elements: 46 filled automatically, 33 to be completed by you): …. - Dikkat. Çıktı klasörü yoksa
No output folder yet. Run the models first.iletisi çıkar.habitus_run_config.jsonbulunamazsa bütün öğeleruser_requiredolur ve iletiye bu not eklenir (tabs/tab_report.py:552-564).
Otomatik doldurulan başlıca öğeler (örnek koşudan): hedef çıktı (algoritmalar, ikili harita kuralı), tür adı, konum ve ızgara (satır × sütun, hücre boyu, koordinat sistemi), kapsam sınırının türü (erişilebilir alan tamponu), yanıt türü (varlık-yalancı yokluk), değişkenler, algoritmalar ve topluluk yöntemi, adımların özeti, yazılım ve paket sürümleri, örneklem büyüklüğü ve süzme gerekçeleri, yalancı yokluk ayarları ve tohum, eğitim/doğrulama bölümlemesi (blok boyu dahil), değişken ön seçimi, algoritma ayarları, aralık dışı tahmin ayarı (clamping), değişken önemi, topluluk ağırlıkları, mekânsal özilişkinin nasıl ele alındığı, eşik kuralı, performans istatistikleri, tahmin birimi, belirsizlik haritaları, aktarılan senaryolar ve yenilik ölçümü (ExDet; seçildiyse MESS ve maskesi).
Kullanıcıya bırakılan öğeler: yazarlar, iletişim, başlık, DOI; çalışmanın amacı; zaman kapsamı ve çözünürlüğü; gözlem türü; hipotezler ve varsayımlar; model karmaşıklığının gerekçesi; kod ve veri erişilebilirliği; taksonomik başvuru sistemi, ekolojik düzey, veri kaynakları, örnekleme tasarımı; bağımsız test verisi; değişkenlerin ve aktarım katmanlarının kaynakları, zaman ve mekân çözünürlükleri, ölçüm hataları; model katsayıları; zamansal özilişki ve iç içe veri; yanıt eğrileri ve uzman değerlendirmesinin sonucu; girdi verisi ve parametre belirsizliği. Çoklu doğrusallık öğesi, ② Variables'taki eşikler oturumda okunabildiğinde otomatik doldurulur (odmap.py:487-495).
11.7 Yayın haritaları
HABITUS haritaları ekrandaki görüntüleyicinin ekran görüntüsü olarak değil, dergi sütun genişliğinde yeniden çizilerek kaydedilir (map_widget.py:597-668). Bu kayıt, ③, ⑤ ve ⑥'daki harita görüntüleyicilerinin araç çubuğundaki disket simgesiyle; çalışma alanı haritası ise 🗺 Map sekmesindeki 💾 Save study-area figure… düğmesiyle yapılır (tabs/tab_map.py:124-130, study_area_figure.py:293-313). Her ikisi de aynı Figure for publication penceresini açar (map_widget.py:180-238).
| Arayüzdeki ad | Ne yapar | Varsayılan | Aralık / seçenekler | Kod |
|---|---|---|---|---|
Width: |
Şeklin basılı genişliği | Double column — 174 mm |
Single column — 85 mm, 1.5 column — 120 mm, Double column — 174 mm |
map_widget.py:112-116, :306 |
Resolution: |
Raster biçimlerde çözünürlük | 600 dpi |
300 dpi, 600 dpi, 1200 dpi |
map_widget.py:117, :197-203 |
Title: |
Başlık metni (yalnız çalışma alanı haritasında) | tür adı | serbest metin | map_widget.py:209-212 |
Include the title above the map |
Başlığı haritanın üstüne yazar | açık (sonuç haritaları), kapalı (çalışma alanı) | açık / kapalı | map_widget.py:204-206, :306, tabs/tab_map.py:139 |
Italic title (scientific name) |
Başlığı italik yazar (çalışma alanı) | tür adı varsa açık | açık / kapalı | tabs/tab_map.py:289 |
Locator map in the upper-left corner |
Konum göstergesi iç haritası (çalışma alanı) | açık | açık / kapalı | tabs/tab_map.py:290 |
| dosya türü | Kaydetme penceresindeki biçim | PNG | PNG, TIFF (LZW), PDF, SVG, EPS, JPEG | map_widget.py:156-177 |
Basılı görünüm Arial 7–9 pt, beyaz arka plan ve ince çizgilerle çizilir; PDF/SVG/EPS'de yazı tipleri gömülür (map_widget.py:126-131, :149-153). Çözünürlük vektör biçimlerde (PDF, SVG, EPS) kullanılmaz. Haritanın yüksekliği coğrafi en-boy oranından (enlem kosinüs düzeltmesiyle) hesaplanır, en çok 9 inç ile sınırlanır (map_widget.py:652-662). Çalışma alanı haritası, pakete gömülü Natural Earth ülke sınırları üzerine kayıtları, sınırı, ölçek çubuğunu ve kuzey okunu çizer (study_area_figure.py:1-10). Görüntüleyicinin öteki denetimleri Bölüm 12'de anlatılır.
İpucu: Raporun 6. ve 7. bölümleri yalnız PNG dosyalarını gömer. Dergi için PDF/TIFF kaydedilecekse aynı haritayı bir kez de PNG olarak (bugünkü harita çıktı klasörünün köküne, gelecek haritası senaryo alt klasörüne) kaydedin. Rapor metni bu haritalar için "300 DPI" yazar; kaydetme penceresinin varsayılanı 600 dpi'dır.
11.8 Çok türlü toplu çalıştırma (Run Selected Species…)
| Arayüzdeki ad | Ne yapar | Varsayılan | Aralık / seçenekler | Kod |
|---|---|---|---|---|
Run Selected Species… |
Tamamlanan iş akışını ① Data'da işaretli öteki türler için aynı ayarlarla yineler | — | onay penceresi | tabs/tab_report.py:431-438, :469-512, batch_species.py |
- Ne işe yarar. Birden çok tür içeren bir kayıt dosyasında, bir tür için iş akışı elle tamamlandıktan sonra, ① Data'da işaretli öteki türler sırayla işlenir. Her tür için yinelenen adımlar (
batch_species.py:145-159): 1. ① Data: etkin tür değiştirilir ve veri hazırlığı aynı ayarlarla çalıştırılır; 2. ② Variables: ilk türde seçilen değişkenler (ve kategorik seçim) aynen atanır; bu türün kayıt sayısına göre değişken sayısı uyarısı günlüğe yazılır (batch_species.py:201-224); 3. ③ Models: sekmedeki ayarlar olduğu gibi kullanılarak modeller kurulur (bugünkü harita dahil); 4. ⑤ her senaryo: aynı raster listesi, algoritmalar, alt klasör, MESS, maske ve clamping seçimiyle (batch_species.py:226-239); 5. ⑥ her alan değişimi analizi: listeden seçilmiş anahtarlar (ör.current :: EMwmean_bin) bu türün dosyalarına çevrilerek, aynı analiz adı ve kapsamla (batch_species.py:241-259); 6. ⑧ HTML raporu.
Tür başına çıktı klasörü <çıktı klasörü>\<tür> biçimindedir (tabs/tab_data.py:1115-1124).
- Ne zaman, nasıl ayarlanır. Önce bir tür için iş akışı eksiksiz ve dikkatle yapılır; ⑤ ve ⑥'da raporlanacak her analiz bir kez çalıştırılmış olmalıdır, çünkü toplu çalıştırma yalnız oturumda çalıştırılmış olanları yineler. Onay penceresi tekrarlanacak türleri, değişkenleri, senaryo ve alan değişimi sayısını listeler (tabs/tab_report.py:489-499).
- Sonuca etkisi. Her tür elle yapılsaydı alacağı sonucu alır; program ayrı bir hat kullanmaz, sekmelerin kendisini sürer (batch_species.py:12-15). Değişken seçimi ise türe göre yeniden yapılmaz: ilk türün seçimi bütün türlere uygulanır.
- Dikkat. Çalışma sırasında açılan bütün ileti pencereleri kendiliğinden yanıtlanır (soru pencerelerine Yes) ve günlüğe [batch, …] önekiyle yazılır (batch_species.py:80-111). Bir adım başarısız olursa o türün kalan adımları atlanır ve sıradaki türe geçilir. İş bitince <çıktı klasörü>\batch_summary.csv yazılır: species, status (done / failed), failed_step, error (hatanın kullanıcıya dönük son satırı), output_dir, minutes (batch_species.py:263-302). Bu dosya başka bir programda açıksa yazılamaz ve günlüğe not düşülür.
Toplu çalıştırmada yinelenmeyenler: ayar araması (tuning) adımı, ⑦ Validation, ODMAP dışa aktarımı ve harita PNG'lerinin kaydedilmesi. Bu yüzden toplu çalıştırmadaki türlerin raporlarında 6., 7. ve 9. bölümler bulunmaz. Ayrıca arayüzde toplu çalıştırmayı yarıda kesecek bir düğme yoktur; iş, bütün türler bitene dek sürer.
İletiler: tür işaretlenmemişse The batch run is for an occurrence file with several species: tick the species to analyse in ① Data.; iş akışı tamamlanmamışsa Complete the workflow for one species first (at least ① Data, ② Variables and ③ Models); …; işaretli tek tür zaten işlenmiş olansa No other species is ticked in ① Data. (tabs/tab_report.py:474-487).
11.9 Çıktılar
<tür>_HABITUS_report_<zaman>.html: tek dosyalık, görüntüleri gömülü rapor.odmap_protocol.md,odmap_protocol.csv: kısmen doldurulmuş ODMAP (CSV sütunlarısection, subsection, element, value, source).- Toplu çalıştırmada:
<tür>\alt klasörleri vebatch_summary.csv. - Kaydedilen yayın haritaları: kullanıcının seçtiği yolda.
11.10 Uzman soruları
S1. Rapordaki yöntem metni doğrudan makaleye konabilir mi?
Cevap: Rapor kendisi bunu önermez: başındaki not metnin gözden geçirilip uyarlanması gerektiğini söyler (tabs/tab_report.py:2405-2409). Metin oturumdaki gerçek ayarlardan kurulur (ör. erişilebilir alan, seyreltme, katlama tasarımı ve SSB, tabs/tab_report.py:930-1092), ama ilke cümleleri ve atıflar genel kalıplardır; 4. bölümdeki yalancı yokluk satırları da varsayılan değerleri gösterir (§11.5.4). Sayılar habitus_run_config.json ile karşılaştırılmalıdır.
S2. ODMAP çıktısı "ODMAP uyumlu" sayılır mı?
Cevap: Hayır. Modül yalnız Zurell vd. (2020) Tablo 1'deki öğeleri kullanır; Ek Tablo A1'deki tam soru listesi kullanılmamıştır ve dosya bunu açıkça yazar (odmap.py:11-21, :661-664). Örnek koşuda 33 öğe kullanıcı tarafından doldurulmalıdır. ODMAP Shiny uygulamasındaki form ile karşılaştırılarak tamamlanması önerilir.
S3. Raporda MESS ya da clamping seçimi görünüyor mu?
Cevap: HTML raporda görünmez; yenilik bölümü yalnız ExDet sonuçlarını tablolar (tabs/tab_report.py:2024-2123). Seçimler ODMAP'ta ("Settings for extrapolation beyond sample range", "Quantification of novel environments", odmap.py:466-508) ve her senaryo klasöründeki _projection_options.json dosyasında bulunur. Makalede bu seçimlerin yöntem kısmında yazılması gerekir.
S4. Rapordaki ExDet yüzdelerinin paydası nedir?
Cevap: Projeksiyonda tahmin edilen (bütün değişkenleri sonlu) hücrelerin tamamı; NT1 < 0, NT2 > 1 ve benzer yüzdeleri toplamı 100'dür (sdm_novelty.py:100-125, rapor notu tabs/tab_report.py:2109-2118). NT2 yüzdesi de NT2'nin hesaplandığı alt kümeye değil bütün hücrelere bölünür. Örnek koşuda SSP585_2090 için 55,4 + 0,3 + 44,3 = 100.
S5. Toplu çalıştırmada her tür için değişken seçimi yeniden yapılıyor mu?
Cevap: Hayır; ilk türde ② Variables'ta onaylanan değişkenler aynen atanır (batch_species.py:201-218). Program yalnız bu türün kayıt sayısının bu kadar değişkene yetip yetmediğini günlüğe yazar (note_selected_predictors, batch_species.py:219-224). Türlerin ekolojisi farklıysa ya da kayıt sayıları çok farklıysa değişken seçimi türe göre elle yapılmalı ve türler ayrı çalıştırılmalıdır. biomod2'de toplu çalışma kullanıcının yazdığı döngüyle yapılır; HABITUS'taki karşılığı aynı ayarların bütün türlere uygulanmasıdır.
S6. Toplu çalıştırmada bir tür başarısız olursa diğerleri etkilenir mi?
Cevap: Hayır. Başarısız adım kaydedilir, o türün kalan adımları atlanır, sıradaki türe geçilir (batch_species.py:161-190, :263-274). batch_summary.csv hangi adımda ve neden başarısız olduğunu yazar; hata metninden kullanıcıya dönük son satır alınır (batch_species.py:26-51). Tam hata izi günlükte [batch, trace] önekiyle kalır.
S7. Yayın haritalarında hangi çözünürlük seçilmeli?
Cevap: Pencere ipucu renkli haritalar için genellikle 300 dpi, ince yazı ve çizgi içeren şekiller için 600 dpi ve üstünü önerir (map_widget.py:201-203); varsayılan 600 dpi'dır. Vektör biçimlerde (PDF, SVG, EPS) dpi kullanılmaz, raster katman yine görüntü olarak gömülür. Sütun genişlikleri Elsevier, Wiley ve Springer'in yaygın ölçüleridir (85, 120, 174 mm; map_widget.py:111-116); derginin kendi ölçüsü farklıysa en yakın genişlik seçilip dergi yönergesine göre ölçeklenmelidir.
S8. Rapordaki harita yorum paragrafları nereden geliyor?
Cevap: Dosya adına göre seçilen sabit metinlerdir (tabs/tab_report.py:1824-1865, :1935-1958): örneğin olasılık haritası için yüksek uygunluk alanlarının arazi çalışmasına öncelik verilmesi önerisi, gelecek haritası için ısınmayla kuzeye/yukarıya kayma cümlesi. Bu cümleler verinin kendisinden çıkarılmaz; makaleye alınmadan önce bulgulara göre yeniden yazılmalıdır. Alan değişimi yorumu ise net değişimin gerçek değerine (±%10 eşikleri) göre kurulur (tabs/tab_report.py:2184-2196).
S9. Rapor yeniden üretilebilir mi; hangi dosyalar yeterli?
Cevap: Rapor her basışta oturumdaki sonuçlardan sıfırdan üretilir; oturum kapandıktan sonra aynı rapor yeniden üretilemez, çünkü modeller ve ExDet özetleri bellektedir. Yeniden üretilebilirlik için habitus_run_config.json (tüm ayarlar, tohum, paket sürümleri), senaryo klasörlerindeki _projection_options.json ve kaydedilen HTML rapor birlikte saklanmalıdır. 3.7 bölümü tohumu ve yapılandırma dosyasını yazar (tabs/tab_report.py:1138-1151).
S10. Raporda kaç senaryo ve kaç alan değişimi analizi görünür?
Cevap: Oturumda yapılan hepsi. Yenilik tablosu state["novelty"]'deki her projeksiyonu, 8. bölüm state["range_results"]'taki her analizi yazar (tabs/tab_report.py:2044-2073, :2140-2207). Rapora girmesi istenmeyen bir deneme varsa ⑤'teki Remove All ile sonuçlar sıfırlanıp yalnız istenenler yeniden çalıştırılmalıdır.
11.11 Sık hatalar ve tuzaklar
- Haritaları PNG olarak kaydetmemek. Rapor GeoTIFF'lerden bugünkü ya da gelecek haritası çizmez; PNG kaydedilmediyse 6. ve 7. bölümler hiç çıkmaz.
- Gelecek haritasını çıktı klasörünün köküne kaydetmek. Raporda "6. Current Distribution" altında görünür.
- 4. bölümdeki yalancı yokluk satırlarına güvenmek. Doğru değerler 3.3 bölümünde ve
habitus_run_config.jsondosyasındadır. - ODMAP dosyasını eksiksiz sanmak.
user_requiredsatırları doldurulmadan dosya bir ODMAP raporu değildir. - Toplu çalıştırmayı tek türde tamamlanmamış iş akışıyla başlatmak. Yalnız oturumda çalıştırılmış senaryolar ve alan değişimi analizleri yinelenir; ⑤'te hiç senaryo çalıştırılmadıysa toplu çalıştırmada da gelecek haritası üretilmez.
- Toplu çalıştırmada değişken uyarısını gözden kaçırmak. Kayıt sayısı az olan türlerde
[batch] ADVISORY:satırları günlüğe düşer; değişken sayısı o tür için fazla olabilir. - Raporu yeniden üretmeyi unutmak. Yeni bir senaryo ya da yeniden kurulan modeller rapora ancak
Generate HTML Report'a yeniden basılınca girer; eski dosya silinmez, yeni zaman damgalı bir dosya yazılır.
11.12 Kaynaklar
Zurell, D., Franklin, J., König, C., Bouchet, P.J., Dormann, C.F., Elith, J., Fandos, G., Feng, X., Guillera-Arroita, G., Guisan, A., Lahoz-Monfort, J.J., Leitão, P.J., Park, D.S., Peterson, A.T., Rapacciuolo, G., Schmatz, D.R., Schröder, B., Serra-Diaz, J.M., Thuiller, W., Yates, K.L., Zimmermann, N.E., Merow, C., 2020. A standard protocol for reporting species distribution models. Ecography 43, 1261–1277. https://doi.org/10.1111/ecog.04960