extract.lib: Functions for SAGE library extraction

Description Usage Arguments Details Value Author(s) References See Also Examples

Description

Functions to extract the tags in a library from sequences or base-caller output.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
extract.lib.from.zip(zipfile, libname=sub(".zip","",basename(zipfile)),
                     ...)
extract.lib.from.directory(dirname, libname=basename(dirname),
                           pattern, ...)
extract.library.tags(filelist, base.caller.format="phd",
                     remove.duplicate.ditags=TRUE, 
                     remove.N=FALSE, remove.low.quality=10,
                     taglength=10, min.ditag.length=(2*taglength-2),
                     max.ditag.length=(2*taglength+4),
                     cut.site="catg", default.quality=NA, verbose=TRUE,
                     ...) 
reestimate.lib.from.tagcounts(tagcounts, libname, default.quality=20, ...) 
compute.unique.tags(lib)
combine.libs(..., artifacts=c("Linker", "Ribosomal", "Mitochondrial"))
remove.sage.artifacts(lib,
                      artifacts=c("Linker","Ribosomal","Mitochondrial"),
                      ...)
read.phd.file(file)
read.seq.qual.filepair(file, default.quality=NA)
extract.ditags(sequence, taglength=10, filename=NA,
               min.ditag.length=(2*taglength-2),
               max.ditag.length=(2*taglength+4), cut.site="catg")

Arguments

zipfile,dirname

Name of a ZIP file or a directory that contains base-caller output files

libname

libname a character string to be assigned as library name

pattern

Regular expression to specify pattern for the files that will be read

filelist

List of files to be read

base.caller.format

base.caller.format can be "phd" or "seq" or a character vector of the length of the filelist

remove.duplicate.ditags

Remove duplicate ditags. TRUE or FALSE

remove.N

Remove all tags that contain N. TRUE or FALSE

remove.low.quality

Remove all tags with an average quality score of less than remove.low.quality. Skipped if < 0

taglength

Length of tags. Usually 10 or 17

min.ditag.length,max.ditag.length

Minimum and maximum length for ditags

cut.site

Restriction enzyme cut site. Usually CATG

verbose

Display information during process

lib

Library object

file,filename

Character string indicating file name

default.quality

Quality value to use on sequences, if quality files are missing

sequence

Construct containing sequence and quality values returned by read.phd.file or read.seq.qual.filepair

artifacts

Types of artificially generated tags to remove.

...

Arguments passed on to extraction functions.

tagcounts

Tagcounts from library. Integer Vecotor with Tag sequences as names.

Details

The functions extract.lib.from.zip or extract.lib.from.directory should be used to extract the SAGE TAGS from the sequences of a library, the sequences need to be provided by the output files from the base caller software either in a ZIP archive or in a directory. These are usually the only functions that should directly be called by the user. The other functions are called by these and should only be used directly by experienced users to get more direct control over the process. Most arguments are passed on and can be specified in the high level functions. Zipfilenames must be specified using relative pathnames!

Value

lib returns an SAGE library object.

Author(s)

Tim Beissbarth

References

http://tagcalling.mbgproject.org

See Also

sage.library, error.correction

Examples

1
2
3
4
5
6
#library(sagenhaft)
#file.copy(system.file("extdata", "E15postHFI.zip",package="sagenhaft"),
#          "E15postHFI.zip")
#E15post<-extract.lib.from.zip("E15postHFI.zip", taglength=10,
#                              min.ditag.length=20, max.ditag.length=24)
#E15post

sagenhaft documentation built on Nov. 8, 2020, 4:57 p.m.