addNuId2lumi {lumi} | R Documentation

## Add the nuID information to the LumiBatch object

### Description

Replace the Illumina Id (Target ID or Probe Id) as nuID (nucleotide universal identifier) for indexing genes in the LumiBatch object

### Usage

    addNuId2lumi(x.lumi, annotationFile=NULL, sep = NULL, lib = NULL,  annotationColName = c(sequence = "Probe_Sequence", target = "Target", probe='ProbeId'))

### Arguments

`x.lumi` | a LumiBatch object
`annotationFile` | a annotation file, which includes the TargetID and probe sequence information
`sep` | the separation used in the annotation file. Automatically detect the separator if it is "," or "t".
`lib` | a lumi annotation package
`annotationColName` | the annotation column name used for the probe sequence and TargetID and ProbeID

### Details

Since the default TargetID and ProbeId are not consistent between different arrays and batches, we invented a nuID, which is one-to-one matching with the probe sequence. This function is to replace the TargetID (or ProbeID) with the nuID. If the annotation library is provided, the function will automatically check whether the TargetID or ProbeID is provided for the microarray data. We recommend output the data using ProbeID when using Illumina BeadStudio software, because the TargetID are not unique.

### Value

a LumiBatch object with TargetID (or ProbeID) replaced by nuID.

### Author(s)

Pan Du

### References

Du, P., Kibbe, W.A., Lin, S.M., "nuID: A universal naming schema of oligonucleotides for Illumina, Affymetrix, and other microarrays", submitted.

### See Also

`lumiR`

### Examples

    ## load example data
    # data(example.lumi)

    ## specify the annotation file for the Illumina chip
    # annotationFile <- 'Human_RefSeq-8.csv'
    ## Replace the Target ID with nuID
    # lumi.nuId <- addNuId2lumi(example.lumi, annotationFile)

    ## An alternative way is to load the Annotation library and match the targetID (or Probe Id) with nuID
    # lumi.nuId <- addNuId2lumi(example.lumi, lib='lumiHumanV1')

[Package lumi version 1.4.0 Index]