章节与参考
本页完整说明已译为现代汉语;函数、参数、代码和原始数据标识保留原样。 用法说明
接收已有对齐,不计算新比对。字符数相同是必要条件,不能证明同源性。每个输入字符都有 alignment_column;- 和 . 保留为 gap,其 source_position 缺失。保留大小写与含糊字符。小写字符消耗源位置;这里不解析 A3M 的插入语义。
参数
- sequences
已对齐字符串的命名字符向量,或含唯一
accver和字符列sequence的数据框。所有字符串的正宽度必须相同,每条记录须至少含一个非 gap 字符。- alphabet
显式指定
"DNA"、"RNA"或"AA"。接受 IUPAC 核酸含糊码及蛋白含糊/稀有残基码;*仅用于 AA。不猜测字母表。- source_data
可选数据框,每个对齐
accver对应一行,包含start(首个非 gap 源位置)和strand("+"或"-")。可选source_accver声明不同的源 ID,可选字符列sequence提供完整正向源字符串以供核对。坐标必须为正且精确的整数。输入元数据保留在ggchord_conversion属性中。- circular
显式逻辑声明全部来源为环状,默认 FALSE。必须提供 source_data,其中含完整 source_length 或完整 sequence。坐标在该长度处按声明链方向环绕;非 gap 字符最多覆盖完整一圈。增加 source_circular 和 source_length 列。圆形绘图不会自动启用此转换。
返回值
普通长表,含 accver、alignment_column、source_accver、source_position、symbol、is_gap、strand、alphabet、sequence_unit、source_verified 和 .source_row。转换来源保留原始输入及规范化源元数据。不推断相似度、共识、翻译、相位或完整序列长度。 source_verified 记录是否已核对该记录的非 gap 字符,在其 gap 行也保留这一记录状态;它不是对所给来源的独立生物学确认。
详细说明
省略 source_data 时,每个去 gap 输入片段按正向从 1 计数,这不是完整基因组坐标。可选源元数据声明首个非 gap 位置及方向;负链位置递减。已对齐字符串必须处于比对方向,不自动反转。若提供完整源字符串,则逐字符核对;DNA/RNA 在负链使用互补,AA 只反序。缺少完整源字符串时标为未核对,不伪造字符。
示例
R · 示例代码
# 明确标记的人工格式示例,不声称为生物学比对结果。
aligned <- as_ggchord_alignment(c(A = "AC-G", B = "ACTG"), "DNA")
aligned
#> accver alignment_column source_accver source_position symbol is_gap strand
#> 1 A 1 A 1 A FALSE +
#> 2 A 2 A 2 C FALSE +
#> 3 A 3 A NA - TRUE +
#> 4 A 4 A 3 G FALSE +
#> 5 B 1 B 1 A FALSE +
#> 6 B 2 B 2 C FALSE +
#> 7 B 3 B 3 T FALSE +
#> 8 B 4 B 4 G FALSE +
#> alphabet sequence_unit source_verified .source_row
#> 1 DNA bp FALSE 1
#> 2 DNA bp FALSE 1
#> 3 DNA bp FALSE 1
#> 4 DNA bp FALSE 1
#> 5 DNA bp FALSE 2
#> 6 DNA bp FALSE 2
#> 7 DNA bp FALSE 2
#> 8 DNA bp FALSE 2
