miRNAVersionConvert {miRBaseConverter} | R Documentation

## miRBase version convert for miRNA Names

### Description

This function converts a group of any species' miRNA names (including precursor and mature miRNA) to the specified miRBase version if the miRNAs have been defined in miRBase.

### Usage

    miRNAVersionConvert(
      miRNANames,
      targetVersion = "v22",
      exact = TRUE,
      verbose = TRUE
    )

### Arguments

`miRNANames` | A character vector representing the source miRNA names needed to be convert.
`targetVersion` | A character value representing the target miRBase version corresponding the source miRNA names. Users can apply the function getAllVersionInfo() to get the available miRNA version names. The optional values are in below: "v6","v7_1","v8","v8_1","v8_2","v9","v9_1","v9_2","v10","v10_1","v11","v12","v13","v14", "v15","v16","v17","v18","v19","v20","v21","v22"
`exact` | Logical value. If true, the result will be the most exactly matched result. If FALSE, the result will include all the possible matched miRNA name. If one miRNA can match multiple names. All the matched names are concatenated with "&".
`verbose` | Logical value. If true, it will print the multiple matched miRNA Names and Accessions to the console.

### Value

A data frame with three columns. The number of rows equal to the input miRNA names. The three columns are defined as below:

- OriginalName : The original miRNA names (Column 1).

- TargetName : The converted miRBase names (in specified version) corresponding to the original miRNA names (Column 2).

- Accession : The corresponding miRBase Accessions (Column 3).

### Note

Please note: Due to some miRNA names changing many times in history. Even if choose the third parameter "exact"=TRUE, it may still have some miRNAs that can't match the unique name in the target version. In order to return the accurate result as possible, we also concatenate the multiple matched miRNA names with "&". This is the rare case but it happens sometimes.

### Author(s)

Xu, Taosheng taosheng.x@gmail.com

### Examples

    data(miRNATest)
    miRNANames=miRNATest$miRNA_Name
    result1=miRNAVersionConvert(miRNANames,targetVersion="v13",exact=TRUE,verbose=TRUE)
    result2=miRNAVersionConvert(miRNANames,targetVersion="v22",exact=TRUE,verbose=TRUE)
    result3=miRNAVersionConvert(miRNANames,targetVersion="v22",exact=FALSE,verbose=TRUE)

    miRNANames=c( "hsa-let-7c","hsa-miR-3190-3p","hsa-let-7c","hsa-miR-34b","hsa-miR-378",
    "hsa-miR-499a-3p","hsa-miR-499a-5p","hsa-miR-500","hsa-miR-516a-5p","hsa-miR-550","hsa-miR-589")
    result4=miRNAVersionConvert(miRNANames, targetVersion="v22", exact=TRUE, verbose=TRUE)

[Package miRBaseConverter version 1.16.0 Index]