跳到正文
章节与参考

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

读取本地空白分隔的对(两个 ID 和可选的不透明 score)、命名组(组 ID 后接成员)或无名组(仅成员)。结构必须显式选择,不猜表头。跳过空行及整行 # 注释。ID、原分数字符串、物理行、成员顺序、重复及原字段均可追溯。数字状 ID 保持字符串,组索引局限于各文件,无名组不造生物学组 ID。成员关系不生成两两连接,也不宣称直系同源。

用法

R · 示例代码
read_feature_relations(
  file = NULL,
  files = NULL,
  format = c("pairs", "named_groups", "groups"),
  feature_data = NULL,
  unmatched = c("error", "report"),
  source_file = FALSE
)

参数

file

可选本地路径或模式,在 files 之前读取。

files

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

format

显式结构:"pairs"(默认)、"named_groups" 或 "groups"。

feature_data

可选数据框,包含唯一字符 feature_id、字符 accver 及声明源坐标中的数值 start/end。原列保留在 report$feature_data,可选 strand 原样保留。

unmatched

"error"(默认)拒绝在给定 feature_data 中缺失的 ID;"report" 保留不完整行、映射标志并报告每个缺失 ID。未提供 feature_data 时全部行保持未放置。

source_file

为成对关系、成员表及已映射连接添加 .source_file。

返回值

列表包含 pairs、membership、ribbon_data(仅完整映射的原始对)和 report。组输入不产生连接。已映射成员在 membership 中带有源区间。report 保留原文件、字段、缺失 ID、未放置的对和给定 feature_data。不从注释端点生成 seq_data;文件内记录索引须结合 .source_input 使用,不是生物学 ID。

详细说明

可选 feature_data 按唯一 feature_id 精确匹配,不修改大小写、前缀或版本,不猜 gene/CDS 父子关系。提供升序一基闭合连续源区间及可选 strand(+、- 或 .)。负链仅为注释元数据,配对锚点保持升序,direction 保持缺失。这是 feature 关系,不是逐位点比对。分段 feature 需要显式连续锚点表,不能静默使用填满间隙的包围跨度。不推断完整序列长度、identity、支持度、比对方向或源字符。

示例

R · 示例代码
path <- system.file("extdata", "plant-feature-groups.txt", package = "ggchord")
relations <- read_feature_relations(path, format = "named_groups")
relations$membership[c("group_id", "feature_id")]
#>    group_id feature_id
#> 1      1166  AT1G50920
#> 2      1166  AT1G10300
#> 3      1166  AT1G80770
#> 4      1166  AT3G23860
#> 5      1167  AT1G65510
#> 6      1167  AT1G65490
#> 7      1167  AT1G65486
#> 8      1167  AT1G65500
#> 9      1168  AT5G16930
#> 10     1168  AT2G18330
#> 11     1168  AT3G03060
#> 12     1168  AT4G36580

搜索说明

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