研究圖表與地圖 是做什麼的?
一張圖表之所以值得存在,是因為它能呈現表格無法表達的內容(隨時間或流量的變化模式、分佈情況、空間排列),並且在印刷尺寸與灰階下仍能清晰可讀。所有透過腳本生成的圖表都從檔案讀取數據,因此不會與正文中的數值產生偏差。
工作流程
- 用一句話決定圖表必須呈現的內容,並確認表格無法更好地呈現。記下目標期刊及其欄寬。
- 選擇圖表形式,參考 references/figure-guide.md:變數類型、座標軸、轉換(流量與載荷使用對數軸),以及如何呈現不確定性。
- 編寫腳本,使用內部樣式模組
scripts/zfig.py:use_style()、figure("single"|"onehalf"|"double", height_mm),以及函式hydrograph_with_rain、flow_duration、load_duration、obs_vs_sim、scenario_bars。每張圖表一個腳本(figN_short_name.py),數據透過明確路徑讀取,每個軸標籤都包含單位,並對正文中引用的每個數值使用assert。在新的環境中執行一次python scripts/zfig.py進行自我測試。 - 地圖:依據指南中的地圖檢查清單(標註 CRS、比例尺、當方位不明顯時加上指北針、位置索引圖、附帶單位的圖例、圖說中的資料來源與授權聲明)。對於最終版面,QGIS 或 ArcGIS Pro 通常比 matplotlib 更快速;無論使用何者,資料準備工作都應透過腳本進行。
- 在最終尺寸下檢視渲染後的檔案,確認無誤後才算完成:檢查標籤是否被裁切或重疊、圖例是否遮蓋數據、刻度是否無法辨識、顏色在灰階或色覺缺陷下是否無法區分。
- 圖說:說明顯示的內容,接著說明如何解讀(符號、線條、陰影、單位、時間區間、樣本數 n)。將解讀留給正文。
重要的預設設定
- Okabe-Ito 類別色票(內建於
zfig);連續數據使用 viridis、cividis 或 Crameri 科學色圖;僅在圍繞有意義的零點(例如相對於基準的變化)時使用發散色圖。禁止使用 rainbow 或 jet 色票(Crameri et al. 2020)。 - 最終尺寸下文字為 8 pt,最小 7 pt;線寬 0.6–1.0 pt。
- 觀測數據使用黑色或深灰色,模擬數據使用彩色,並在各圖表中保持一致。
- 對於涵蓋數個數量級的流量、載荷與濃度,使用對數軸;並在標籤中說明。
- 呈現不確定性(95PPU 區間、跨情境或氣候成員的範圍、信賴區間);沒有誤差範圍的長條圖會過度誇大確定性。
- 不得虛構數據、座標或標籤;如果數據缺失,應在腳本中明確寫出
NotImplementedError,並列出所需內容。
Python 優先且應加上註解;在每個圖表腳本的 docstring 中說明單位、CRS 與時間步長。