Main Content

samsort

Sort SAM files

collapse all in page

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.

example

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

example

Examples

collapse all

Open Live Script

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

collapse all

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

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

collapse all

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

See Also

| | | |

Topics

External Websites