samtools
SAM/BAM ファイルの変換・ソート・統計処理と深さの計算を行います。BAM/FASTA のインデックスも作成できます。
API・CLI のツール ID: samtools
command の値によって入力項目が変わります。
入力と結果の見方
SAM と BAM は、リード(シーケンサーが読み取った短い塩基配列)が参照配列のどこに対応するかを記録するファイルです。SAM はテキスト、BAM は圧縮されたバイナリ形式です。samtools の sort は、その記録を座標順に並べ替えます。BWA・Bowtie2 のようにリードの対応位置を新たに求める作業とは異なります。
| コマンド | 処理内容と必要な入力 | 主な結果ファイル |
|---|---|---|
view | SAM/BAM を BAM に変換します。region を指定する場合は座標順に並べた BAM が必要です。 | output.bam |
sort | SAM/BAM の記録を参照座標順に並べ替えます。 | output.bam |
index | 座標順に並べた BAM から、特定の領域に素早くアクセスするための索引を作ります。 | output.bam.bai |
faidx | FASTA の索引を作ります。region を指定すると、その区間の配列を抽出します。 | reference.fa.fai / region.fa |
flagstat | SAM/BAM の状態フラグを集計し、リード記録の統計を作ります。 | flagstat.txt |
depth | 参照配列の各位置を覆うリード数を計算します。 | depth.tsv |
FASTA は配列名と塩基文字を含むテキスト形式です。索引は元のファイルに効率よくアクセスするための補助データであり、FASTA や BAM の本体を置き換えるものではありません。
region の chr1:1000-2000 は、参照名 chr1 の1000番目から2000番目までを両端を含めて指定します。入力ファイルにある参照名と長さに従ってください。depth はその位置を覆うリード数であり、値が大きいほど変異や疾患の可能性が高いという意味ではありません。
コマンドの一般的な動作は samtools 公式マニュアル、深度の計算基準は depth の説明で確認できます。
入力設定
| 設定 | 形式 | 必須 | 既定値 | 説明と制約 |
|---|---|---|---|---|
command | task | 任意 | "view" | samtools サブコマンド — 許容値 view · sort · index · faidx · flagstat · depth |
inputFile | file | 必須 | — | view/sort/flagstat/depth: SAMまたはBAM、index: 座標順にソートされたBAM、faidx: 行の長さが一定のFASTA。16MiB以下、元ファイルは変更しない — 拡張子 bam · sam · fa · fasta |
region | string | 任意 | — | view/faidx/depthの領域(chr1:1000-2000、1始まりで両端を含む)。view/depthは座標順にソートされたBAMが必要。参照名と長さの範囲内であること — 適用対象 view · faidx · depth |
結果ファイル
| 列 | 表示名 | 説明 |
|---|---|---|
output_file | 出力ファイル | コマンドごとの結果ファイル名 |
この項目は結果ファイルの名前で、スコアや信頼度を表す値ではありません。実際の内容はファイルを開いて確認してください。
実行可否
プロジェクトの実行計画で、利用できるツールのバージョンと費用を確認できます。入力・設定・利用条件を確認し、承認してから実行します。
ライセンス
コード・モデルの重み・付属データには、それぞれの利用条件が適用されます。以下は公式配布元の条件です。使用する構成の条件は実行計画で確認してください。ライセンス原文は第三者のライセンス告知で確認できます。
| 構成要素 | ライセンス | 商用利用 | 根拠 | 備考 |
|---|---|---|---|---|
| コード | MIT | 告知条件を守れば商用利用可 | ライセンス原文 | MIT/Expat ライセンスです。利用時は著作権表示と許諾表示を保持してください。 |
2026-10-21 確認。