NAME

uf-scan - examine peak data in a single MS scan

SYNOPSIS

uf-scan [options] file

Options:

 -d[ump]                       dump the packet header
 -e[xtract]                    extract the entire scan data as a binary chunk
 -l[ist]                       list the called peaks [required]
 -p[rofile]                    print the scan profile as a 2-column table [required]
 -plot                         plot the profile (along with the called peaks, if available) [required]
 -v                            convert f -> M/z [requires: -p]
 -z                            add empty bins [requires: -p]
 -n[unmber] <n:+i>             select scan number <n> [required]
 -mz <low:+n> .. <high:+n>     limit the plot to the range of M/z values between <low> and <high> [requires: -plot]
 <file>                        input file [required]

OPTIONS

-help

Print a brief help message and exits.

-l[ist]

Get the peak list from the scan number -n, if they are available. If the called peaks are not present, uf-scan will print a message to that effect and exit.

-p[rofile]

Prints the scan profile for scan number -n, if it is available. If the profile is not present, uf-scan will print a message to that effect and exit.

-plot

This option generates an R script to plot the profile. Prints the scan profile for scan number -n, if it is available. If the profile is not present, uf-scan will print a message to that effect and exit.

-n[umber]

Gives the number of a single scan to process

-e[xtract]

Used with either -l or -p, this option option clips the binary data chunk corresponding to either the peak list or to the scan profile and sends it to STDOUT.

DESCRIPTION

uf-scan can be used to list or plot the scan data for a single scan. The -profile option instructs uf-scan to print the profile data, the -list options lists the peaks, and the -plot option writes an R script to plot the profile and peak centroids, if both kinds of data are present in the raw file, or just the profile if the centroids are not present.

Options -profile, -list and -plot are mutually exclusive.

To convert the raw scan data into M/z values, use the -v option.

Option -z fills the gaps between the profile peaks with zeroes, to create a continuous table.

SEE ALSO

uf-mzxml

EXAMPLES

uf-scan -p -n 1 sample.raw

 (prints all raw profile bins in the 1st scan)

uf-scan -ep -n 1 sample.raw

 (extracts the entire scan profile in the binary form)

uf-scan -pv -n 1 sample.raw

 (same as above, except the bin values will be converted into M/z)

uf-scan -pvz -n 1 sample.raw

 (same as above, but in addition, all empty bins are wirtten out as well)

uf-scan -l -n 1 sample.raw

 (will print the list of centroids in the 1st scan; note that *uf-scan* does not calculate the peak centroids from the profile; it only lists the existing centroids if they are present)

uf-scan -plot -n 1 -mz 445.0 .. 445.2 sample.raw | R --vanilla --slave > plot.eps

 This command will call R to plot the profile in the given range of M/z values. If called peaks are present, they will be shown as dots on the graph.