科学図表・スケマティックス(Scientific Schematics and Diagrams)
概要
科学図表・スケマティックスは、複雑な概念を明快なビジュアル表現に変換し、出版物で利用できるようにします。このスキルは、図表生成にNano Banana 2 AIを、品質レビューにGemini 3.6 Flashを使用します。
動作の仕組み:
- 図表を自然言語で記述します
- Nano Banana 2が自動的に出版物品質の画像を生成します
- Gemini 3.6 Flashがドキュメントタイプに応じたしきい値で品質をレビューします
- スマート反復: 品質がしきい値を下回る場合のみ再生成します
- 数分で出版物対応の出力を生成
- コーディング、テンプレート、手動描画は不要です
ドキュメントタイプ別品質しきい値:
| ドキュメントタイプ | しきい値 | 説明 |
|---|---|---|
| journal | 8.5/10 | Nature、Science、査読付きジャーナル |
| conference | 8.0/10 | 学会発表論文 |
| thesis | 8.0/10 | 学位論文、博士論文 |
| grant | 8.0/10 | 研究助成金申請書 |
| preprint | 7.5/10 | arXiv、bioRxivなど |
| report | 7.5/10 | テクニカルレポート |
| poster | 7.0/10 | アカデミックポスター |
| presentation | 6.5/10 | スライド、発表資料 |
| default | 7.5/10 | 汎用 |
希望する図表を説明するだけで、Nano Banana 2が作成します。 すべての図表はfigures/サブフォルダに保存され、論文やポスターで参照されます。
出力内容: 画像モデルが返す解像度のラスターPNGです。このスキルにベクターパスやDPI制御機能はありません。ジャーナルがPDF、EPS、または300 dpiのTIFFを要求する場合は、PNGをダウンロード後に変換し、最終印刷サイズで結果を確認してください。
クイックスタート: 図表を生成する
任意の科学図表を、説明するだけで作成できます。Nano Banana 2がスマート反復によりすべてを自動処理します:
# ジャーナル論文用に生成(最高品質しきい値:8.5/10)
python scripts/generate_schematic.py "CONSORT参加者フローダイアグラム、スクリーニング500、除外150、ランダム化350" -o figures/consort.png --doc-type journal
# プレゼンテーション用に生成(低いしきい値:6.5/10 - 高速)
python scripts/generate_schematic.py "マルチヘッドアテンションを示すTransformerエンコーダ-デコーダアーキテクチャ" -o figures/transformer.png --doc-type presentation
# ポスター用に生成(中程度のしきい値:7.0/10)
python scripts/generate_schematic.py "EGFRから遺伝子転写までのMAPKシグナル伝達経路" -o figures/mapk_pathway.png --doc-type poster
# カスタム最大反復回数(最大2)
python scripts/generate_schematic.py "オペアンプ、抵抗、コンデンサを使用した複雑な回路図" -o figures/circuit.png --iterations 2 --doc-type journal
バックグラウンドで行われる処理:
- 生成 1: Nano Banana 2が科学的図表のベストプラクティスに従って初期画像を作成
- レビュー 1: Gemini 3.6 Flashがドキュメントタイプのしきい値に対して品質を評価
- 判定: 品質 >= しきい値 → 完了(これ以上の反復は不要!)
- しきい値未満の場合: 批評に基づいてプロンプトを改善し、再生成
- 繰り返し: 品質がしきい値を満たすか、最大反復回数に達するまで
スマート反復の利点:
- ✅ 最初の生成で十分な場合、API呼び出しを節約
- ✅ ジャーナル論文にはより高い品質基準を適用
- ✅ プレゼンテーション/ポスターでは迅速なターンアラウンド
- ✅ 各ユースケースに適切な品質を提供
出力: バージョン管理された画像(name_v1.png、name_v2.png)、指定されたパスへの勝者画像のコピー、反復ごとのスコア、批評、早期停止理由を含むname_review_log.json。
レビューが実行できない場合(レート制限、コンテンツフィルター、レビューアが予期しない形式で応答したなど)、画像は引き続き生成・保存されますが、スコアは生成されません。ログには"score": null、"reviewed": false、および"review_error"に理由が記録され、実行時にはReview unavailable — image kept, quality not verifiedと表示されます。その画像は未チェックとして扱い、自分で確認してください。再実行を試みる価値はあります。失敗は通常一時的なものです。
設定
OpenRouter APIキーを設定:
export OPENROUTER_API_KEY='your_api_key_here'
APIキーはこちらから取得: https://openrouter.ai/keys
データはマシン外に送信されます。 プロンプトは画像生成のためにOpenRouterに送信され、生成された画像は品質レビューのためにOpenRouterに返送されます。どちらもOpenRouterおよび基盤となるモデルプロバイダーのデータポリシーの対象となります。プロンプトに未発表データ、患者情報、または機密情報を記述しないでください。
AI生成のベストプラクティス
科学図表のための効果的なプロンプト:
✓ 適切なプロンプト(具体的、詳細):
- "CONSORTフローチャート:スクリーニング(n=500)からランダム化、最終解析までの参加者の流れ"
- "Transformerニューラルネットワークアーキテクチャ:左側にエンコーダースタック、右側にデコーダースタック、マルチヘッドアテンションとクロスアテンション接続を示す"
- "生物学的シグナル伝達カスケード:EGFR受容体→RAS→RAF→MEK→ERK→核、各リン酸化ステップをラベル付け"
- "IoTシステムのブロック図:センサー→マイクロコントローラー→WiFiモジュール→クラウドサーバー→モバイルアプリ"
✗ 避けるべきあいまいなプロンプト:
- "フローチャートを作成"(汎用的すぎる)
- "ニューラルネットワーク"(どのタイプ?どのコンポーネント?)
- "経路図"(どの経路?どの分子?)
含めるべき重要な要素:
- タイプ: フローチャート、アーキテクチャ図、経路図、回路図など
- コンポーネント: 含める具体的な要素
- フロー/方向: 要素の接続方法(左から右、上から下)
- ラベル: 含める主要な注釈やテキスト
- スタイル: 特定のビジュアル要件
科学的品質ガイドライン(自動適用):
- 清潔な白/薄い背景
- 読みやすさのための高いコントラスト
- 明確で読みやすいラベル(最小10pt)
- プロフェッショナルなタイポグラフィ(サンセリフフォント)
- 色覚異常に配慮した色(Okabe-Itoパレット)
- 混雑を防ぐ適切なスペーシング
- スケールバー、凡例、軸(必要に応じて)
このスキルを使用すべき場合
このスキルは以下の場合に使用します:
- ニューラルネットワークアーキテクチャ図の作成(Transformers、CNN、RNNなど)
- システムアーキテクチャとデータフロー図の図示
- 研究デザインの方法論フローチャートの作成(CONSORT、PRISMA)
- アルゴリズムワークフローと処理パイプラインの可視化
- 回路図と電気スケマティックの作成
- 生物学的経路と分子間相互作用の描写
- ネットワークトポロジーと階層構造の生成
- 概念的枠組みと理論モデルの図示
- 技術論文のブロック図のデザイン
このスキルの使用方法
図表を自然言語で説明するだけです。 Nano Banana 2が自動的に生成します:
python scripts/generate_schematic.py "図表の説明" -o output.png
これだけです! AIが以下を処理します:
- ✓ レイアウトと構成
- ✓ ラベルと注釈
- ✓ 色とスタイリング
- ✓ 品質レビューと改良
- ✓ 出版物対応の出力
すべての図表タイプに対応:
- フローチャート(CONSORT、PRISMAなど)
- ニューラルネットワークアーキテクチャ
- 生物学的経路
- 回路図
- システムアーキテクチャ
- ブロック図
- あらゆる科学ビジュアライゼーション
コーディング、テンプレート、手動描画は不要です。
AI生成モード(Nano Banana 2 + Gemini 3.6 Flashレビュー)
スマート反復改良、高度な使用法、例
生成-レビュー-改良ループ、Python APIとコマンドラインオプション、プロンプトエンジニアリングガイダンス、および4つの実例(CONSORTフローチャート、ニューラルネットワークアーキテクチャ、生物学的経路、システムアーキテクチャ)は、references/iterative_refinement.mdにあります。
レビューに合格するとすぐにループが停止するため、単純な図表は通常1回の反復で完了し、複雑な図のみが全予算を使用します。
コマンドラインの使用法
科学的スケマティックス生成のための主要エントリポイント:
# 基本的な使用法
python scripts/generate_schematic.py "図表の説明" -o output.png
# カスタム反復回数(最大2)
python scripts/generate_schematic.py "複雑な図" -o diagram.png --iterations 2
# 詳細モード
python scripts/generate_schematic.py "図" -o out.png -v
注: Nano Banana 2 AI生成システムは、反復改良プロセスに自動品質レビューを含みます。各反復は、科学的正確性、明確性、アクセシビリティについて評価されます。
ベストプラクティスのまとめ
デザイン原則 — プロンプトでこれらを指定する
- 複雑さよりも明確さ - 簡素化し、不要な要素を削除する
- 一貫したスタイリング - 論文全体の図で同じビジュアル規則を記述する
- 色覚異常へのアクセシビリティ - Okabe-Itoパレットと冗長なエンコーディングを指定する
- 適切なタイポグラフィ - サンセリフフォント、十分な大きさのラベル
- 論理的なフロー - 方向(左から右、上から下)を明示的に指定する
ジェネレーターはデフォルトでこれらすべてを適用しますが、特定の図に対して自分の言葉でこれらを指定する方が、組み込みガイドラインのみに依存するよりも効果的です。
パイプラインでできないこと
- ベクター出力 - PNGのみ。PDF、SVG、EPSは生成されません。
- 解像度制御 - 画像モデルが決定します。DPIフラグはありません。
- カラースペース - RGBのみ。CMYK印刷ワークフローが必要な場合はダウンストリームで変換します。
- 正確な線の太さやテキストサイズ - プロンプトで記述し、目視で確認します。
ベクターアートや300 dpi以上のTIFFを要求するジャーナルの場合は、生成後にPNGを変換し、実際に印刷されるサイズで結果を確認してください。
統合ガイドライン
- LaTeXに含める - 生成画像には
\includegraphics{}を使用する - 詳細にキャプションを付ける - すべての要素と略語を説明する
- テキストで参照する - 説明の流れの中で図を説明する
- 一貫性を維持する - 論文内のすべての図で同じスタイルを使用する
- バージョン管理 - プロンプトと生成画像をリポジトリで管理する
よくある問題のトラブルシューティング
生成は確率的であり、反復回数は最大2回に制限されているため、実際に結果を変える手段はプロンプト、ドキュメントタイプ、再実行です。このスキルには後処理ステップや品質チェックライブラリはありません。検査できるものはすべて、生成されたPNGと<name>_review_log.jsonにあります。
図が間違っている
テキストの重なり、要素の密集、矢印のターゲットミス
- レイアウトをプロンプトで指定する: "垂直フロー、行ごとに1ボックス、ステージ間のスペースを広く"
- 接続を指定する: "リン酸化とラベル付けされたRAFからMEKへの矢印"("カスケードを示す"ではない)
- 再実行する。同じプロンプトの2回の実行は異なり、悪いレイアウトは単に不運な場合が多いです。
内容が科学的に間違っている、またはコンポーネントが欠落している
- コンポーネントを数とラベルとともに明示的にリストする。モデルは推測しません。
- レビューログの
critiqueフィールドを読む。レビューアは通常、欠落しているものを挙げています。
ラベルのテキストが間違っている、または画像に図番号が埋め込まれている
- プロンプトはすでに"Figure 1:"キャプションを禁止しています。もし現れた場合は再実行してください。
- スペルミスのあるラベルは、画像モデルの最も一般的な失敗です。使用前にすべてのラベルを読んでください。
スコアが間違っているように見える
スコアが図に値するよりも低い
- 再実行する前に批評を読む。レビューアの指摘は多くの場合正当かつ具体的です。
- 反復を決定するのはスコアではなくしきい値です。
--doc-type journalは8.5を要求します。
しきい値を下回るスコアで実行が停止する
- それは反復回数の上限です。
--iterations 2が最大値です。最後の画像が保持され、実際のスコアとともに報告されます。
ログに"score": nullと"reviewed": falseがある
- レビュー呼び出しが失敗したか、使用できない形式で応答しました。画像自体は問題なく保持されています。品質が測定されなかっただけです。
"review_error"を確認し、自分で画像を確認し、再実行してください。
セットアップ
Error: OPENROUTER_API_KEY not found
export OPENROUTER_API_KEY='sk-or-v1-...'、または.envファイルに追加、または--api-keyを渡す
Error: requests library not found
uv pip install requests
APIエラー全般 — -vを付けて実行し、リクエスト、モデルスラッグ、エラー本文全体を確認する
リソースと参照
詳細な参照
特定のトピックに関する包括的な情報については、以下のファイルを参照:
references/iterative_refinement.md- 生成-レビュー-改良ループ、Python API、すべてのコマンドラインオプション、プロンプトエンジニアリングガイダンス、4つの実例references/best_practices.md- プロンプト作成時と結果評価時に参照する出版基準とアクセシビリティガイドライン
外部リソース
出版基準
- Nature図表ガイドライン: https://www.nature.com/nature/for-authors/final-submission
- Science図表ガイドライン: https://www.science.org/content/page/instructions-preparing-initial-manuscript
- CONSORTダイアグラム: http://www.consort-statement.org/consort-statement/flow-diagram
他のスキルとの統合
このスキルは以下と相乗効果を発揮します:
- サイエンティフィックライティング - 図表が図のベストプラクティスに従います
- サイエンティフィックビジュアライゼーション - カラーパレットとスタイリングを共有
- LaTeXポスター - ポスター発表用の図表を生成
- 研究助成金 - 提案書の方法論図
- ピアレビュー - 図の明確さとアクセシビリティを評価
クイックリファレンスチェックリスト
図を提出する前に、以下を確認:
レビューログを読む(これが唯一の自動チェックです)
-
<name>_review_log.jsonが存在し、最終反復の"reviewed"がtrueである -
"final_score"が実数(nullではない)であり、ドキュメントタイプのしきい値を満たしている -
"critique"を読む — レビューアの残りの問題は、合格スコアの場合でもリストされています - 複数のバージョンが生成された場合は、
_v1と_v2を比較し、良い方を保持する
自分で画像を確認する
- すべてのラベルが正しくスペルされている — 画像モデルはテキストのスペルを間違えることがあり、ここではそれを自動的にチェックしません
- テキストの重なりやクリッピングがない
- すべての矢印が意図した要素に接続されている
- 科学的内容が正しい
図の例
CONSORTフローチャート(ジャーナル論文用)
figures/consort.pngに保存されたCONSORTフローチャート図。スクリーニング、登録、割り当て、フォローアップ、分析の各段階を示します。ラベルには各段階の参加者数が含まれます。
Transformerアーキテクチャ(プレゼンテーション用)
figures/transformer.pngに保存されたTransformerアーキテクチャ図。エンコーダーとデコーダーのスタック、マルチヘッドアテンションメカニズム、位置エンコーディング、フィードフォワードネットワークを示します。
MAPKシグナル伝達経路(ポスター用)
figures/mapk_pathway.pngに保存されたMAPKシグナル伝達経路図。EGFR受容体の活性化からRAS、RAF、MEK、ERKを経て核内の遺伝子転写に至るカスケードを示し、各ステップのリン酸化イベントをラベル付けします。
IoTシステムアーキテクチャ(テクニカルレポート用)
figures/iot_architecture.pngに保存されたIoTシステムアーキテクチャ図。センサーからクラウド、そしてモバイルアプリへのデータフローを示します。
このスキルは、科学的な図表作成を簡素化し、高品質な出力を確保するために設計されています。詳細な使用例と高度な機能については、references/ディレクトリ内のファイルを参照してください。