跳到正文
章节与参考

本页完整说明已译为现代汉语;函数、参数、代码和原始数据标识保留原样。 用法说明

读取制表符分隔的BEDPE:六个必填字段,随后按标准顺序提供可选name、score、strand1、strand2以及任意额外字段。同一文件字段数必须一致。跳过空行、注释和不含制表符的track/browser头。保留accession与双端顺序:第一端为query,第二端为subject。

用法

R · 示例代码
read_bedpe(
  file = NULL,
  files = NULL,
  source_file = FALSE,
  unmapped = c("error", "keep")
)

参数

file

可选的本地路径向量或通配模式,在files之前读取。

files

可选的其他本地路径或通配模式。

source_file

逻辑值,是否添加.source_file列,默认FALSE。

unmapped

不完整锚点的处理方式:默认"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)

搜索说明

↑ ↓ 选择 · Enter 打开 · Esc 关闭;也可按任务查找。 API 与功能