decompressBeadData: Decompress a file in the beadarray binary format

Description Usage Arguments Value Author(s) Examples

View source: R/decompressBeadData.R

Description

Decompressed a file create by BeadDataPackR. The original files that were compressed will be restored as accurately as possible, depending upon the degree of precision specified during the compression.

Usage

1
2
decompressBeadData(input, inputPath = ".", outputMask = NULL, outputPath = ".",
                   outputNonDecoded = FALSE, roundValues = TRUE, progressBar = TRUE)

Arguments

input

The name of the .bab file(s) to be read. Can be a vector of file names, such as generated by list.files().

inputPath

Path where the compress file is located. The default is to use the current working directory.

outputMask

Text specify the names of the output files. The output files will have ".txt", "_Grn.locs" and (if approriate "_Red.locs") appended to this mask. If left NULL the original names of the section will be used.

outputPath

Path to where the uncompressed version of the files should be written to. The default is to use the current working directory.

outputNonDecoded

If TRUE the undecoded beads will be included in the output .txt file. They will have ProbeID 0 and intensity 0, but the bead centre coordinates will be included.

roundValues

The original Illumina text files give the bead centre coordinates to 7 significant figures. When this argument is TRUE decompressed files are also truncated in this manner, whilst FALSE writes them to the full precision they are stored in the compressed file.

progressBar

By default the function uses a txtProgressBar to indicate progress through the compression. Setting this argument to FALSE supresses the drawing of this progress bar.

Value

Called primarily for its side effect, in which two (or three) files are written to the disk. These files should be representative of the original files that were compressed. The function returns, invisibly, the number of lines written in the .txt file.

Author(s)

Mike L. Smith

Examples

1
2
3
 
    dataPath <- system.file("extdata", package = "BeadDataPackR")
    decompressBeadData(input = "example.bab", inputPath = dataPath, outputPath = tempdir())

BeadDataPackR documentation built on Nov. 8, 2020, 8:04 p.m.