:MetaboCoreUtils
作者:约翰Rainer (aut (cre) (https://orcid.org/0000 - 0002 - 6977 - 7147),迈克尔·情报(aut) (https://orcid.org/0000 - 0002 - 1462 - 4426),安德里亚维克尼(aut)
最后修改:2021-10-26 15:31:54
编译:2021年10月26日17:50:11星期二

1介绍

MetaboCoreUtils定义metabolomics-related核心功能提供低级功能允许数据structure-independent使用跨各种R包。这包括离子加合物和化合物之间的函数来计算质荷比和质量或功能与化学公式。包还提供了一组加合物的定义和信息在一些商用内标混合女士常用于实验。

函数的完整列表,请参阅

库(MetaboCoreUtils) ls (pos =“包:MetaboCoreUtils”)
# # [1]“addelement”# #“adductNames”[3]“加合物”“containsElements”# # [5]“correctRindex”“countElements”# # [7]“indexRtime”“internalStandardMixNames”# # [9]“internalStandards”“isotopicSubstitutionMatrix”# # [11]“isotopologues”“mass2mz”# # [13]“mz2mass”“pasteElements”# # [15]“standardizeFormula”“subtractElements”

或者是参考页面包装上的说明网页。

2安装

包可以安装的BiocManager包中。安装BiocManager使用install.packages (“BiocManager”)在那之后,BiocManager::安装(“MetaboCoreUtils”)安装这个包。

3例子

这个包使用基本类中定义的函数,目的是在包被重用,提供一个更正式的、高层次的接口。

下面的例子演示的功能包的基本用法。

库(MetaboCoreUtils)

3.1离子m / z之间的转换和复合质量

mass2mzmz2mass函数允许将复合质量和离子(加合物)之间的质荷比(m / z)。的MetaboCoreUtils包提供的定义,常见离子加合物所产生的电喷雾电离(ESI)。这些可以上市adductNames函数。

adductNames ()
# # [1]”(M + 3 H) 3 +”“[M + 2 H + Na) 3 +”“[M + H +钠)3 +”# # [4][M + Na3] 3 +”“[M + 2 H] 2 +”“[M + H + NH4) 2 +”# # [7]”(M + H + K) 2 +”“[M + H + Na) 2 +”“[M + C2H3N + 2 H] 2 +”# # [10] [M + 2 Na) 2 +”“[M + C4H6N2 + 2 H] 2 +”“[M + C6H9N3 + 2 H] 2 +”# # [13] [M + H) +”“[M + Li) +”“[M + 2氯]+”# # [16][M + NH4) +“”[M +水+ H] + [M + Na) +“# # [19] [M + CH4O + H] +”“[M + K) +”“[M + C2H3N + H] +”# # [22] [M + 2 na-h] +”“[M + C3H8O + H] +”“[M + C2H3N + Na) +”# # [25] [M + 2 K - H) +“”[M +介绍+ H] + [M + C4H6N2 + H] +“# # [28]”(2 M + H) +”“2 M + NH4 +”“(2 M + Na) +”# # [31]”(2 M + K) +”“2 M + C2H3N + H +”“2 M + C2H3N + Na +”# # [34]“3 M + H +”“[M + H-NH3] +”“[M + H-H2O] +”# # [37] [M + H-Hexose-H2O] +”“[M + H-H4O2] +”“[M + H-CH2O2] +”

我们可以使用mass2mz函数计算一组化合物的m / z假设某种离子的生成。在下面的例子中,我们定义群众对一些理论化合物和计算其预期m / z假设离子“[M + H) +”“[M + Na) +”生成。

群众< - c (123、842、324) mass2mz(质量,加合物= c (“[M + H) +”, [M + Na] +))
# # [M + H] + [M + Na] + # # (1) 124.0073 - 145.9892 # # (2) 843.0073 - 864.9892 325.0073 - 346.9892 # # [3]

作为一个结果,我们得到一个矩阵在每一行每一列代表一种化合物和m / z的定义的加合物。与mz2mass我们可以进行反向计算,即从m / z复合质量。

3.2使用化学公式

缺少一致性的化学公式的格式写构成大问题比较公式来自不同资源。的MetaboCoreUtils包提供的功能标准化公式以及结合公式或减元素从公式。下面我们用一个人造的例子来展示此功能。首先我们规范的化学式standardizeFormula函数。

frml < -“Na3C4 frml < - standardizeFormula frml (frml)
# # [1]“C4Na3”

接下来我们添加“水”使用的公式addelement函数。

frml < - addelement (frml,“水”)frml
# # [1]“C4H2ONa3”

我们也可以减元素subtractElements功能:

frml < - subtractElements frml (frml,“H”)
# # [1]“C4HONa3”

单个元素的计算化学公式可以计算countElements函数。

countElements (frml)
# # C H O Na # # 4 1 1 3

3.3Retetion时间索引

保留时间通常是两个质系统之间没有直接的可比性,即使名义上使用相同的分离方法。保留时间转换成retetion指数可以克服这个问题。的MetaboCoreUtils包提供了一个函数来执行这种转换。下面我们用一个例子基于索引与一系列homologoues af N-Alkyl-pyridinium磺酸盐(午睡)。

rti < read.table(系统。文件(“retentionIndex”、“rti。txt”,包= " MetaboCoreUtils”),头= TRUE, 9 = " \ t”) rtime < read.table(系统。文件(“retentionIndex”、“代谢物。txt”,包= " MetaboCoreUtils”),头= TRUE, 9 = " \ t”)

一个data.frame的retetion次小睡和各自的索引值是必需的。

头(rti)
# # rtime rindex 1.14 100 # # 1.18 # # 200 # # 300 # # 1.38 400 2.11 5.92 4.34 500 # # # # 600

索引是peformed使用函数indexRtime

rtime rindex_r < - indexRtime (rtime rtime美元,rti)

比较人工计算保留指数。

头(rtime)
# # 1 # #名rtime rindex_manual rindex_r维生素D2 NA NA NA # # 2角鲨烯15.66 1709.8765 1709.8765 # # 3 4-COUMARATE # # 4 NONANOATE 11.73 1244.5783 1244.5783 6.26 629.3103 629.3103 # # 5 ESTRADIOL-17ALPHA 6辛酸盐10.67 1114.8148 1114.8148 10.27 1065.4321 1065.4321 # #

条件,应当通过保留指数相比可能不完全吻合。如果偏差是线性的一个简单的两点校正可以被应用到数据。这是执行的函数correctRindex。校正需要两个参考标准和测量RIs和RIs的引用。

ref < - data.frame (rindex = c (1709.8765, 553.7975), refindex = c(1700、550)美元rtime rindex_cor < - correctRindex (rtime rindex_r美元,ref)

4贡献

如果你想贡献任何低级功能,请打开一个GitHub的问题讨论它。请注意,任何贡献应该遵循的风格指南,需要一个适当的单元测试。

如果你想重用这个包中的任何函数,请继续。如果你想要任何建议或寻求帮助,请打开一个GitHub的问题

会话信息

# # R版本以下4.4.1(2021-08-10)# #平台:x86_64-pc-linux-gnu(64位)# #下运行:Ubuntu 20.04.3 LTS # # # #矩阵产品:默认# #布拉斯特区:/home/biocbuild/bbs - 3.14 - bioc / R / lib / libRblas。所以# # LAPACK: /home/biocbuild/bbs - 3.14 - bioc / R / lib / libRlapack。# # # #语言环境:# # [1]LC_CTYPE = en_US。utf - 8 LC_NUMERIC = C # #[3]而= en_GB LC_COLLATE = C # # [5] LC_MONETARY = en_US。utf - 8 LC_MESSAGES = en_US。utf - 8 # # [7] LC_PAPER = en_US。utf - 8 LC_NAME = C # # [9] LC_ADDRESS C = C LC_TELEPHONE = # # [11] LC_MEASUREMENT = en_US。utf - 8 LC_IDENTIFICATION = C附加基本包:# # # # # #[1]统计图形grDevices跑龙套数据集方法基础# # # #其他附加包:# # [1]MetaboCoreUtils_1.2.0 BiocStyle_2.22.0 # # # #通过加载一个名称空间(而不是附加):# # [1]knitr_1.36 cluster_2.1.2 magrittr_2.0.1 # # [4] BiocGenerics_0.40.0 MsCoreUtils_1.6.0 MASS_7.3-54 # # [7] clue_0.3-60 R6_2.5.1 rlang_0.4.12 # # [10] fastmap_1.1.0 stringr_1.4.0 tools_4.1.1 # # [13] xfun_0.27 jquerylib_0.1.4 htmltools_0.5.2 # # [16] yaml_2.2.1 digest_0.6.28 bookdown_0.24 # # [19] BiocManager_1.30.16 sass_0.4.0 S4Vectors_0.32.0 # # [22] evaluate_0.14 rmarkdown_2.11 stringi_1.7.5 # # [25] compiler_4.1.1 bslib_0.3.1 stats4_4.1.1 # # [28] jsonlite_1.7.2