deeptools

deeptools スキルの概要

deeptools は何のためのスキルか

deeptools スキルは、NGS解析で deepTools を使う作業を助けるスキルです。BAM を bigWig に変換する、QC を実行する、サンプルを比較する、ChIP-seq・RNA-seq・ATAC-seq などのヒートマップやプロファイルプロットを作成するといった用途に向いています。すでにアライン済みのシーケンスファイルがあり、解析用トラックや論文向けの可視化が必要なときに特に役立ちます。

どんな人にインストール向きか

日常的なゲノム解析で使える実用的な deeptools ガイドが必要なら、deeptools スキルをインストールする価値があります。正規化、リプリケート比較、遺伝子やピーク周辺のシグナルプロファイリング、可視化前の QC などがその対象です。一般的なプロンプト応答ではなく、再現性のあるコマンドラインワークフローを求める人に特に向いています。

何が役立つのか

deeptools スキルの主な価値は、ワークフローの見通しが立つことです。「ChIP-seq のプロットを作りたい」という曖昧な目的を、適切な deepTools のコマンド群、必要な入力、出力形式に落とし込むのを助けます。deeptools では、ゲノムビルド、正規化手法、領域定義、リードのアライン品質といった細部を飛ばすと失敗しやすいため、ここが重要です。

deeptools スキルの使い方

deeptools をインストールする

まずはディレクトリのインストール手順に従い、その後でスキルファイルを開いて上位セクションを確認してから解析を依頼してください。実践的には、deeptools スキルをインストールし、scientific-skills/deeptools/SKILL.md を確認し、自分のデータと目的が解析パスに合っているかを確かめてからコマンド生成を頼むのが安全です。

スキルに正しい入力を与える

deeptools をうまく使うには、次の情報を伝えてください。

• ファイル種別: BAM、BED、bigWig、BEDPE、またはサンプルファイルの一覧
• アッセイ種別: ChIP-seq、RNA-seq、ATAC-seq、MNase-seq
• ゲノムビルドと染色体名の表記ルール
• 必要なら正規化の希望
• 必要な出力の種類: coverage track、heatmap、profile plot、QC matrix、sample correlation

弱いプロンプトの例: 「deeptools で ChIP-seq データを解析して」
強いプロンプトの例: 「deeptools を使って hg38 の 2 本の ChIP-seq BAM と 1 つの input control から、正規化済み bigWig と TSS profile を作って。リプリケート比較も含め、TSS の上下 3 kb の領域で matrix も出して」

リポジトリは正しい順番で読む

まず SKILL.md を読み、続いて、そのスキルをいつ使うべきか、クイックスタート時の挙動、入力検証について説明しているリンク先セクションを確認してください。リポジトリに 1 ファイルしかない場合は、そのファイルを唯一の正本として扱い、存在しない補助スクリプトを探すのではなく、コマンド構成、オプション選択、制約に集中するのがよいです。

出力を良くするプロンプトのコツ

tool 名だけでなく、deeptools の具体的なサブタスクを指定してください。bamCoverage、computeMatrix、plotHeatmap、plotProfile、multiBigwigSummary、plotCorrelation、plotPCA のどれが欲しいのかを明示すると、タスクによってコマンドの流れが変わるためです。また、コマンドが欲しいのか、説明が欲しいのか、その両方なのかも伝えると、deeptools スキルが実行向けか学習向けかを最適化しやすくなります。

deeptools スキル FAQ

deeptools は可視化専用ですか？

いいえ。deeptools スキルはプロットだけに限りません。coverage 生成、正規化、QC、サンプル比較にも使え、これらは最終的な可視化の前に必要になることがよくあります。

deepTools の経験がなくても使えますか？

はい。ファイルと解析目標を具体的に説明できれば、deeptools スキルは初心者にも使いやすいです。重要なのは、アッセイ、参照ゲノム、出力形式をできるだけ明確にすることです。

どんなときに使わないほうがいいですか？

生リードのトリミング、アラインメント、バリアントコーリング、deepTools の範囲外にある下流の統計検定が目的なら、deeptools は使わないでください。1 回だけのプロットで、しかも正確なコマンドをすでに知っているなら、一般的なプロンプトで足りることもあります。スキルの価値が大きいのは、複数の判断が必要なワークフローです。

一般的なプロンプトと何が違いますか？

一般的なプロンプトは、正規化、領域選択、プロット設定を推測しがちです。deeptools スキルは、そうした選択をデータ型と出力目的にきちんと合わせた deeptools ガイドが欲しいときにより強力で、使えないプロットや入力不一致のリスクを減らせます。

deeptools スキルを改善するには

解析の前提情報を増やす

deeptools で最も良い結果が出るのは、コマンド選択に影響する文脈を与えたときです。アッセイ種別、strandedness、リプリケート数、input control の有無、対象領域、結果が QC 用か論文用か、などを伝えてください。これらが欠けると、技術的には正しくても実験に合わないコマンドになることがあります。

欲しい出力を具体的に指定する

heatmap が欲しいなら、何を基準にするのかを明確にしてください。TSS、gene bodies、peaks、peaks に flanks を足したもの、カスタム BED 領域などです。coverage が欲しいなら、genome browser 用の bigWig が必要なのか、下流処理用の bedGraph が必要なのか、両方なのかを伝えてください。出力の具体化は、deeptools の使い方を最も早く改善する方法です。

最初の出力を確認してから修正する

まずは最初の応答で、正規化、領域選択、サンプルのグルーピングを確認し、全データセットに対して実行する前に見直してください。結果がおかしければ、空の matrix、ノイズの多いプロット、予期しない strand の挙動、染色体名の不一致など、失敗内容を具体的に書き直します。そうすると deeptools スキルに明確な修正対象が伝わり、次の試行でより良いコマンドにつながることが多いです。