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

读取已对齐 FASTA 并建立源位置与列的映射
Source:R/data-alignment.R
read_aligned_fasta.Rd读取单个对齐文件;FASTA 读取器仅去除排版空白,保留 gap 与大小写。各记录宽度必须相同。不运行比对,不推断链、基因组起点、错配类别或 CDS 相位。
用法
R · 示例代码
read_aligned_fasta(
file,
alphabet,
source_data = NULL,
source_file = FALSE,
circular = FALSE
)参数
- file
单个本地已对齐 FASTA 文件路径,不拼接多个独立对齐。
- alphabet
显式指定
"DNA"、"RNA"或"AA"。接受 IUPAC 核酸含糊码及蛋白含糊/稀有残基码;*仅用于 AA。不猜测字母表。- source_data
可选数据框,每个对齐
accver对应一行,包含start(首个非 gap 源位置)和strand("+"或"-")。可选source_accver声明不同的源 ID,可选字符列sequence提供完整正向源字符串以供核对。坐标必须为正且精确的整数。输入元数据保留在ggchord_conversion属性中。- source_file
逻辑值,是否在每个字符行额外保留
.source_file。- circular
显式逻辑声明全部来源为环状,默认 FALSE。必须提供 source_data,其中含完整 source_length 或完整 sequence。坐标在该长度处按声明链方向环绕;非 gap 字符最多覆盖完整一圈。增加 source_circular 和 source_length 列。圆形绘图不会自动启用此转换。
返回值
as_ggchord_alignment() 返回的长表,另含 FASTA 头部物理行号 .source_line、可选 .source_file 和导入来源属性。
示例
R · 示例代码
result <- read_aligned_fasta("examples/alignment/opuntia-aligned.fasta", "DNA")
head(result)
#> accver alignment_column
#> 1 gi|6273285|gb|AF191659.1|AF191 1
#> 2 gi|6273285|gb|AF191659.1|AF191 2
#> 3 gi|6273285|gb|AF191659.1|AF191 3
#> 4 gi|6273285|gb|AF191659.1|AF191 4
#> 5 gi|6273285|gb|AF191659.1|AF191 5
#> 6 gi|6273285|gb|AF191659.1|AF191 6
#> source_accver source_position symbol is_gap strand alphabet
#> 1 gi|6273285|gb|AF191659.1|AF191 1 T FALSE + DNA
#> 2 gi|6273285|gb|AF191659.1|AF191 2 A FALSE + DNA
#> 3 gi|6273285|gb|AF191659.1|AF191 3 T FALSE + DNA
#> 4 gi|6273285|gb|AF191659.1|AF191 4 A FALSE + DNA
#> 5 gi|6273285|gb|AF191659.1|AF191 5 C FALSE + DNA
#> 6 gi|6273285|gb|AF191659.1|AF191 6 A FALSE + DNA
#> sequence_unit source_verified .source_row .source_line
#> 1 bp FALSE 1 1
#> 2 bp FALSE 1 1
#> 3 bp FALSE 1 1
#> 4 bp FALSE 1 1
#> 5 bp FALSE 1 1
#> 6 bp FALSE 1 1