章节与参考
本页完整说明已译为现代汉语;函数、参数、代码和原始数据标识保留原样。 用法说明
读取制表符分隔的BEDPE:六个必填字段,随后按标准顺序提供可选name、score、strand1、strand2以及任意额外字段。同一文件字段数必须一致。跳过空行、注释和不含制表符的track/browser头。保留accession与双端顺序:第一端为query,第二端为subject。
用法
R · 示例代码
read_bedpe(
file = NULL,
files = NULL,
source_file = FALSE,
unmapped = c("error", "keep")
)返回值
数据框,包含canonical q/s端点、锚点链、完整映射标志、相对方向、原始BEDPE字段、bedpe_extra及物理文件行号.source_line。ggchord_import属性记录文件、行数及坐标约定。keep策略不会使缺失锚点变得可绘制,也不会制造来源位置。
详细说明
将零基半开区间转换为一基闭区间。负链锚点使用降序端点,与配对区间对象的as_ggchord_link()约定一致。缺省链保留".";只有两端完整且两条链均已知时,才有已知相对锚点方向。锚点方向不等于成对序列比对,不推断相似度、比对长度、测序支持度或完整序列长度。原始标准字段保留为字符列,包括任意score字符串。额外字段在bedpe_extra列表列中保留为按物理列号命名的字符向量。name是标签,不保证是唯一HSP ID。未知染色体"."和坐标-1是明确的缺失哨兵。默认拒绝不完整锚点;unmapped = "keep"为审计保留它们,并使用缺失的canonical字段与q_mapped/s_mapped标志。适配或绘图前须筛选两标志均为真的行。非法的已知坐标和零宽区间始终报错。
示例
R · 示例代码
library(dplyr)
#>
#> Attaching package: ‘dplyr’
#> The following objects are masked from ‘package:stats’:
#>
#> filter, lag
#> The following objects are masked from ‘package:base’:
#>
#> intersect, setdiff, setequal, union
data(ribbon_data_example)
# 重编码已有区间作格式往返,不表示双端测序证据。
paired <- ribbon_data_example |>
transmute(
chrom1 = qaccver, start1 = pmin(qstart, qend) - 1, end1 = pmax(qstart, qend),
chrom2 = saccver, start2 = pmin(sstart, send) - 1, end2 = pmax(sstart, send)
)
path <- tempfile(fileext = ".bedpe")
write.table(paired, path,
sep = "\t", quote = FALSE, row.names = FALSE, col.names = FALSE
)
read_bedpe(path)
#> qaccver saccver qstart qend sstart send qstrand sstrand q_mapped
#> 1 MT108731.1 MT118296.1 26298 51139 7121 31959 . . TRUE
#> 2 MT108731.1 MT118296.1 21513 25922 2365 6772 . . TRUE
#> 3 MT108731.1 MT118296.1 20376 20677 403 704 . . TRUE
#> 4 MT108731.1 OQ646790.1 45278 50839 27955 33476 . . TRUE
#> 5 MT108731.1 OQ646790.1 12796 14536 722 2456 . . TRUE
#> 6 MT108731.1 OQ646790.1 2466 3102 49307 49945 . . TRUE
#> 7 MT108731.1 OR222515.1 48107 50830 31245 33968 . . TRUE
#> 8 MT118296.1 OQ646790.1 26098 31659 27955 33476 . . TRUE
#> 9 MT118296.1 OQ646790.1 7922 10392 11415 13891 . . TRUE
#> 10 MT118296.1 OQ646790.1 3464 4527 6711 7777 . . TRUE
#> 11 MT118296.1 OR222515.1 28927 31650 31245 33968 . . TRUE
#> 12 OQ646790.1 OR222515.1 31842 33461 32343 33962 . . TRUE
#> 13 OQ646790.1 OR222515.1 30765 31732 31242 32209 . . TRUE
#> s_mapped orientation_known direction chrom1 start1 end1 chrom2
#> 1 TRUE FALSE <NA> MT108731.1 26297 51139 MT118296.1
#> 2 TRUE FALSE <NA> MT108731.1 21512 25922 MT118296.1
#> 3 TRUE FALSE <NA> MT108731.1 20375 20677 MT118296.1
#> 4 TRUE FALSE <NA> MT108731.1 45277 50839 OQ646790.1
#> 5 TRUE FALSE <NA> MT108731.1 12795 14536 OQ646790.1
#> 6 TRUE FALSE <NA> MT108731.1 2465 3102 OQ646790.1
#> 7 TRUE FALSE <NA> MT108731.1 48106 50830 OR222515.1
#> 8 TRUE FALSE <NA> MT118296.1 26097 31659 OQ646790.1
#> 9 TRUE FALSE <NA> MT118296.1 7921 10392 OQ646790.1
#> 10 TRUE FALSE <NA> MT118296.1 3463 4527 OQ646790.1
#> 11 TRUE FALSE <NA> MT118296.1 28926 31650 OR222515.1
#> 12 TRUE FALSE <NA> OQ646790.1 31841 33461 OR222515.1
#> 13 TRUE FALSE <NA> OQ646790.1 30764 31732 OR222515.1
#> start2 end2 bedpe_extra .source_line
#> 1 7120 31959 1
#> 2 2364 6772 2
#> 3 402 704 3
#> 4 27954 33476 4
#> 5 721 2456 5
#> 6 49306 49945 6
#> 7 31244 33968 7
#> 8 27954 33476 8
#> 9 11414 13891 9
#> 10 6710 7777 10
#> 11 31244 33968 11
#> 12 32342 33962 12
#> 13 31241 32209 13
unlink(path)
