samtools

SAM/BAM 파일의 변환·정렬·통계를 처리하고 깊이를 계산합니다. BAM/FASTA 인덱스도 만들 수 있습니다.

API·CLI 도구 ID: samtools

이 도구는 command 값에 따라 입력 구성이 달라집니다.

입력과 결과를 이해하기

SAM과 BAM은 읽기 조각(시퀀싱 장비가 읽은 짧은 염기서열)이 참조 서열 어디에 대응하는지 기록한 파일입니다. SAM은 텍스트, BAM은 압축된 이진 형식입니다. samtools의 sort는 이 기록을 좌표순으로 다시 배치합니다. 읽기 조각의 대응 위치를 새로 찾는 BWA·Bowtie2의 서열 정렬과는 다른 작업입니다.

명령하는 일과 필요한 입력주요 결과 파일
viewSAM/BAM을 BAM으로 변환합니다. region을 지정하려면 좌표순으로 정렬된 BAM이 필요합니다.output.bam
sortSAM/BAM의 기록을 참조 좌표순으로 정렬합니다.output.bam
index좌표순으로 정렬된 BAM에서 특정 위치를 빠르게 찾을 색인을 만듭니다.output.bam.bai
faidxFASTA의 색인을 만듭니다. region을 지정하면 해당 구간의 서열을 추출합니다.reference.fa.fai / region.fa
flagstatSAM/BAM의 상태 플래그를 집계해 읽기 기록의 통계를 만듭니다.flagstat.txt
depth참조 서열의 각 위치를 덮는 읽기 조각 수를 계산합니다.depth.tsv

FASTA는 서열 이름과 염기 문자를 담는 텍스트 파일입니다. 색인 파일은 원본을 빠르게 읽도록 돕는 보조 자료이며, 원본 서열이나 BAM을 대신하지 않습니다.

region의 chr1:1000-2000은 참조 이름 chr1의 1000번째부터 2000번째 위치까지 양끝을 포함합니다. 파일에 있는 참조 이름과 길이를 기준으로 지정하세요. depth 값은 해당 위치를 덮는 읽기 조각의 수이며, 값이 크다고 변이나 질병의 가능성이 높다는 뜻은 아닙니다.

명령의 일반 동작은 samtools 공식 사용 안내, 깊이의 계산 기준은 depth 안내에서 확인할 수 있습니다.

입력 설정

설정형식필수기본값설명과 제약
commandtask선택"view"samtools 하위 명령 — 허용값 view · sort · index · faidx · flagstat · depth
inputFilefile필수—view/sort/flagstat/depth: SAM 또는 BAM, index: 좌표 정렬된 BAM, faidx: 줄 길이가 일정한 FASTA. 16MiB 이하, 원본 파일은 변경하지 않음 — 확장자 bam · sam · fa · fasta
regionstring선택—view/faidx/depth의 영역(chr1:1000-2000, 1부터 세는 양끝 포함). view/depth는 좌표 정렬된 BAM 필요. 참조 이름과 길이 안이어야 함 — 분기 view · faidx · depth

결과 파일

열표시 이름설명
output_file출력 파일명령별 결과 파일 이름

이 항목은 결과 파일의 이름입니다. 점수나 신뢰도를 나타내는 값이 아닙니다. 실제 내용은 해당 파일을 열어 확인하세요.

실행 가능 여부

프로젝트에서 실행 계획을 열면 사용할 수 있는 도구 버전과 비용을 확인할 수 있습니다. 입력·설정·이용 조건을 검토하고 승인한 뒤 실행합니다.

라이선스

코드·모델 가중치·함께 쓰는 자료에는 각각의 이용 조건이 적용됩니다. 아래는 공식 배포처의 조건이며, 나두바이오에서 사용할 구성의 조건은 실행 계획에서 확인합니다. 제3자 고지에서 라이선스 원문을 볼 수 있습니다.

구성라이선스상업 이용근거비고
코드MIT상업 이용 가능(고지 조건 준수)라이선스 원문MIT/Expat 라이선스입니다. 사용할 때 저작권·허가 고지를 유지해야 합니다.

확인일 2026-10-21.

참고

이 페이지의 내용