Description Usage Arguments Details Value Author(s) References See Also Examples
An index needs to be built before read mapping can be performed. This function creates a hash table index for the reference genome, which can then be used by Subread and Subjunc aligners for read alignment.
1 2 3 4 5 6 7 8 9 10 11 12 | buildindex(
# basic input/output options
basename,
reference,
# options for the details of the index
gappedIndex = FALSE,
indexSplit = FALSE,
memory = 8000,
TH_subread = 100,
colorspace = FALSE)
|
basename |
a character string giving the basename of created index files. |
reference |
a charater string giving the name of a FASTA or gzipped FASTA file that includes sequences of all chromosomes and contigs. |
gappedIndex |
logical indicating if a gapped index or a full index will be built. A gapped index contains 16mers (subreads) that are extracted every three bases from a reference genome, whereas a full index contains subreads extracted from every chromosomal location of a genome. The index contains a hash table, which includes sequences of subreads and their corresponding chromosomal locations. Default value of this argument is |
indexSplit |
logical indicating if an index can be split into multiple blocks. The block size is determined by value of parameter |
memory |
a numeric value specifying the amount of memory (in megabytes) used for storing the index during read mapping. 8000 MB by default. Note that this option is ignored when |
TH_subread |
a numeric value specifying the threshold for removing highly repetitive subreads (16bp mers). 100 by default. Subreads will be excluded from the index if they occur more than threshold number of times in the genome. |
colorspace |
logical specifying the mode of the index. If |
This function generates a hash-table index for a reference genome, in which keys are subreads (16mers) and values are their chromosomal locations in the reference genome.
The built index can then be used by Subread (align
) and subjunc
aligners to map reads (Liao et al. 2019; Liao et al. 2013).
Index building is an one-off operation.
Highly repetitive subreads (or uninformative subreads) are excluded from the hash table so as to reduce mapping ambiguity.
TH_subread
specifies the maximal number of times a subread is allowed to occur in the reference genome to be included in hash table.
Maximum mapping speed can be achieved by building a full index for the reference genome.
By default buildindex
builds a full index.
Building a gapped index will significantly reduce the memory use, at a modest cost to read mapping time.
It is recommended to use a gapped index on a personal computer due to the limited amount of computer memory available.
Memory use can be further reduced by splitting an index to multiple blocks.
The amount of memory to be used in read mapping is determined at the index building stage.
To build a full index for human/mouse genome, buildindex
function requires 15GB memory.
When using a full index to map reads to human/mouse genome, align
and subjunc
requires 17.8GB memory.
To build a gapped index for human/mouse genome, buildindex
function only requires 5.7GB memory.
When using a gapped index to map reads to human/mouse genome, align
requires 8.2GB memory and subjunc
requires 8.8GB memory.
Sequences of reference genomes can be downloaded from public databases. For instance, primary assembly of human genome GRCh38/hg38 or mouse genome GRCm38/mm10 can be downloaded from the GENCODE database via the following links:
No value is produced but index files are written to the current working directory.
Wei Shi and Yang Liao
Yang Liao, Gordon K Smyth and Wei Shi (2019). The R package Rsubread is easier, faster, cheaper and better for alignment and quantification of RNA sequencing reads. Nucleic Acids Research, 47(8):e47. http://www.ncbi.nlm.nih.gov/pubmed/30783653
Yang Liao, Gordon K Smyth and Wei Shi (2013). The Subread aligner: fast, accurate and scalable read mapping by seed-and-vote. Nucleic Acids Research, 41(10):e108. http://www.ncbi.nlm.nih.gov/pubmed/23558742
1 2 3 | # Build an index for the artifical sequence included in file 'reference.fa'
ref <- system.file("extdata","reference.fa",package="Rsubread")
buildindex(basename="./reference_index",reference=ref)
|
========== _____ _ _ ____ _____ ______ _____
===== / ____| | | | _ \| __ \| ____| /\ | __ \
===== | (___ | | | | |_) | |__) | |__ / \ | | | |
==== \___ \| | | | _ <| _ /| __| / /\ \ | | | |
==== ____) | |__| | |_) | | \ \| |____ / ____ \| |__| |
========== |_____/ \____/|____/|_| \_\______/_/ \_\_____/
Rsubread 2.4.2
//================================= setting ==================================\\
|| ||
|| Index name : reference_index ||
|| Index space : base space ||
|| Index split : no-split ||
|| Repeat threshold : 100 repeats ||
|| Gapped index : no ||
|| ||
|| Free / total memory : 0.3GB / 1.9GB ||
|| ||
|| Input files : 1 file in total ||
|| o reference.fa ||
|| ||
|| ||
|| WARNING: the free memory is lower than 3.0GB. ||
|| the program may run very slow or crash. ||
|| ||
\\============================================================================//
//================================= Running ==================================\\
|| ||
|| Check the integrity of provided reference sequences ... ||
|| No format issues were found ||
ERROR: No memory can be allocated.
|| ||
|| WARNING: available memory is lower than 1.2 GB. ||
|| The program may run very slow. ||
|| Build a gapped index and/or split index into blocks to reduce memory use. ||
|| ||
|| ||
\\============================================================================//
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.