研究図表・マップ作成 は何をしますか?
図表は、表では表現できないもの(時間や流量にわたるパターン、分布、空間配置)を示し、かつ印刷サイズ・グレースケールで読める場合にのみ掲載する価値があります。すべてのスクリプト化された図はファイルからデータを読み込むため、テキスト内の数値と乖離することはありません。
ワークフロー
- 図が何を示すべきかを一文で決定し、表の方が適切でないかを確認します。対象ジャーナルとその段組幅を記録します。
- 形式を選択します。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。図ごとに1スクリプト(figN_short_name.py)、データは明示的なパスで読み取り、すべての軸ラベルに単位を付け、テキストで引用する各数値に対してassertを記述します。新しい環境で一度python scripts/zfig.pyを実行してセルフテストを行います。 - マップ:ガイド内のマップチェックリストに従います(CRSの明記、スケールバー、方位が自明でない場合は方位記号、インセットロケータ、凡例に単位、キャプションにデータソースとライセンスクレジット)。最終レイアウトには、matplotlib よりも QGIS または ArcGIS Pro の方が迅速な場合が多いです。いずれの場合もデータ準備はスクリプト化します。
- レンダリングされたファイルを最終サイズで確認してから完成とします:ラベルのクリップや重なり、凡例がデータを覆っていないか、目盛りが読めないか、色がグレースケールや色覚障害でつぶれていないか。
- キャプション:何が示されているか、次にその読み方(記号、線、網掛け、単位、期間、標本数)。解釈は本文に残します。
重要なデフォルト設定
- Okabe-Ito 定性パレット(
zfigに組み込み);連続データには viridis、cividis、または Crameri 科学カラーマップ;分岐マップは意味のあるゼロ(例:ベースラインからの変化)の周辺のみ。虹色や jet は使用禁止(Crameri et al. 2020)。 - 最終サイズで8ptテキスト、最小7pt;線幅0.6~1.0pt。
- 観測データは黒または濃いグレー、シミュレーションは色で、図間で一貫して使用。
- 流量、負荷、濃度で桁違いに及ぶものには対数軸;ラベルにその旨を明記。
- 不確実性を表示する(95PPUバンド、シナリオ間や気候メンバー間の範囲、信頼区間);ばらつきのない棒グラフは確実性を過大評価します。
- データ、座標、ラベルをでっち上げない。データが不足している場合は、明確な
NotImplementedErrorを含むスクリプトを作成し、必要なものをリストします。
Python を第一とし、コメントを付ける;各図スクリプトの docstring に単位、CRS、時間ステップを記述します。