samsort

Sort SAM files

Syntax

sortedFile = samsort(inFile)

samsort(inFile,outFile)

Description

sortedFile = samsort(inFile) sorts a SAM file inFile and returns the name of the sorted SAM file sortedFile. The function sorts the alignment records by the reference sequence name first, and then by position within the reference.

samsort(inFile,outFile) sorts inFile and produces a sorted SAM file named outFile.

Examples

Sort SAM File

Sort a sample SAM file. The sorted file has the same base name as the input file, but with the extension ".sorted.sam". By default, the sorted file is saved in the current directory.

sortedFile = samsort("ex1.sam")

sortedFile = 
"ex1.sorted.sam"

You can change the name of output file by specifying it as the second input.

samsort("ex1.sam","sortedEx1.sam")

ans = 
"sortedEx1.sam"

You can also save the output file to an existing directory by providing the file path information.

mkdir("./OutputEx1SAM");
samsort("ex1.sam","./OutputEx1SAM/sortedEx1.sam")

ans = 
"./OutputEx1SAM/sortedEx1.sam"

Input Arguments

inFile — Name of input SAM file to sort

character vector | string

Name of the input SAM file to sort, specified as a string or character vector. You can specify a file name or a path and file name. The file name must have the extension .sam.

Example: "./InputData/ex1.sam"

Data Types: char | string

outFile — Name of output SAM file

character vector | string

Name of the output SAM file, specified as a string or character vector. You can specify a file name or a path and file name. The file name must have the extension .sam. The file is saved in the current directory by default unless you specify the path information. If you specify the file path, the listed directories must exist before you run the function.

Example: "./OutputData/ex1Sorted.sam"

Data Types: char | string

Output Arguments

sortedFile — Name of output SAM file

string

Name of the output SAM file, returned as a string. sortedFile has the same base name as inFile but with the extension .sorted.sam. The file is saved in the current directory by default.

Version History

Introduced in R2019b