ARCHAEA TERATA Mac OS
ARCHAEA TERATA Mac OS
- Introduction
- Obtaining Centrifuge
- Running Centrifuge
- Database download and index building
- Command Line
- The
centrifuge-build
indexer- Command Line
- The
centrifuge-inspect
index inspector- Command Line
- Getting started with Centrifuge
- Archaea Terata Mac Os Download
- Archaea Terata Mac Os 11
- Archaea Terata Mac Os Catalina
- Archaea Terata Mac Os X
Mozilla/5.0 (iPhone; CPU iPhone OS 133 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.4 Mobile/15E148 Safari/604.1 United States Muskegon. Install the Docker in your operating system. If you want to use PhySpeTree on other platforms, above all need to install docker on the appropriate platform. For Windows OS, you can install Docker for Windows. For Mac OS, you can install Docker for Mac. Pull the PhySpeTree image. This Teradata Tools and Utilities (TTU) 17.00 package is the full collection of Teradata client tools for macOS. This includes load & unload utilities, open interfaces and drivers to be used to connect to your Teradata Advanced SQL (database) instance. Installation is easy and simple. The size of the download zip file is 50 MB.
Centrifuge is a very rapid and memory-efficient system for the classification of DNA sequences from microbial samples, with better sensitivity than and comparable accuracy to other leading systems.
What is Centrifuge?
Centrifuge is a novel microbial classification engine that enables rapid, accurate, and sensitive labeling of reads and quantification of species on desktop computers. The system uses a novel indexing scheme based on the Burrows-Wheeler transform (BWT) and the Ferragina-Manzini (FM) index, optimized specifically for the metagenomic classification problem. Centrifuge requires a relatively small index (5.8 GB for all complete bacterial and viral genomes plus the human genome) and classifies sequences at a very high speed, allowing it to process the millions of reads from a typical high-throughput DNA sequencing run within a few minutes. Together these advances enable timely and accurate analysis of large metagenomics data sets on conventional desktop computers.
Download Centrifuge and binaries from the Releases sections on the right side. Binaries are available for Intel architectures (x86_64
) running Linux, and Mac OS X.
Building from source
Building Centrifuge from source requires a GNU-like environment with GCC, GNU Make and other basics. It should be possible to build Centrifuge on most vanilla Linux installations or on a Mac installation with Xcode installed. Centrifuge can also be built on Windows using Cygwin or MinGW (MinGW recommended). For a MinGW build the choice of what compiler is to be used is important since this will determine if a 32 or 64 bit code can be successfully compiled using it. If there is a need to generate both 32 and 64 bit on the same machine then a multilib MinGW has to be properly installed. MSYS, the zlib library, and depending on architecture pthreads library are also required. We are recommending a 64 bit build since it has some clear advantages in real life research problems. In order to simplify the MinGW setup it might be worth investigating popular MinGW personal builds since these are coming already prepared with most of the toolchains needed.
First, download the [source package] from the Releases secion on the right side. Unzip the file, change to the unzipped directory, and build the Centrifuge tools by running GNU make
(usually with the command make
, but sometimes with gmake
) with no arguments. If building with MinGW, run make
from the MSYS environment.
Centrifuge is using the multithreading software model in order to speed up execution times on SMP architectures where this is possible. On POSIX platforms (like linux, Mac OS, etc) it needs the pthread library. Although it is possible to use pthread library on non-POSIX platform like Windows, due to performance reasons Centrifuge will try to use Windows native multithreading if possible.
For the support of SRA data access in HISAT2, please download and install the NCBI-NGS toolkit. When running make
, specify additional variables as follow. make USE_SRA=1 NCBI_NGS_DIR=/path/to/NCBI-NGS-directory NCBI_VDB_DIR=/path/to/NCBI-NGS-directory
, where NCBI_NGS_DIR
and NCBI_VDB_DIR
will be used in Makefile for -I and -L compilation options. For example, $(NCBI_NGS_DIR)/include and $(NCBI_NGS_DIR)/lib64 will be used.
Adding to PATH
By adding your new Centrifuge directory to your PATH environment variable, you ensure that whenever you run centrifuge
, centrifuge-build
, centrifuge-download
or centrifuge-inspect
from the command line, you will get the version you just installed without having to specify the entire path. This is recommended for most users. To do this, follow your operating system's instructions for adding the directory to your PATH.
If you would like to install Centrifuge by copying the Centrifuge executable files to an existing directory in your PATH, make sure that you copy all the executables, including centrifuge
, centrifuge-class
, centrifuge-build
, centrifuge-build-bin
, centrifuge-download
centrifuge-inspect
and centrifuge-inspect-bin
. Furthermore you need the programs in the scripts/ folder if you opt for genome compression in the database construction.
Before running Centrifuge
Classification is considerably different from alignment in that classification is performed on a large set of genomes as opposed to on just one reference genome as in alignment. Currently, an enormous number of complete genomes are available at the GenBank (e.g. >4,000 bacterial genomes, >10,000 viral genomes, …). These genomes are organized in a taxonomic tree where each genome is located at the bottom of the tree, at the strain or subspecies level. On the taxonomic tree, genomes have ancestors usually situated at the species level, and those ancestors also have ancestors at the genus level and so on up the family level, the order level, class level, phylum, kingdom, and finally at the root level.
Given the gigantic number of genomes available, which continues to expand at a rapid rate, and the development of the taxonomic tree, which continues to evolve with new advancements in research, we have designed Centrifuge to be flexible and general enough to reflect this huge database. We provide several standard indexes that will meet most of users’ needs (see the side panel - Indexes). In our approach our indexes not only include raw genome sequences, but also genome names/sizes and taxonomic trees. This enables users to perform additional analyses on Centrifuge’s classification output without the need to download extra database sources. This also eliminates the potential issue of discrepancy between the indexes we provide and the databases users may otherwise download. We plan to provide a couple of additional standard indexes in the near future, and update the indexes on a regular basis.
We encourage first time users to take a look at and follow a small example
that illustrates how to build an index, how to run Centrifuge using the index, how to interpret the classification results, and how to extract additional genomic information from the index. For those who choose to build customized indexes, please take a close look at the following description.
Database download and index building
Centrifuge indexes can be built with arbritary sequences. Standard choices are all of the complete bacterial and viral genomes, or using the sequences that are part of the BLAST nt database. Centrifuge always needs the nodes.dmp file from the NCBI taxonomy dump to build the taxonomy tree, as well as a sequence ID to taxonomy ID map. The map is a tab-separated file with the sequence ID to taxonomy ID map.
To download all of the complete archaeal, viral, and bacterial genomes from RefSeq, and build the index:
Centrifuge indices can be build on arbritary sequences. Usually an ensemble of genomes is used - such as all complete microbial genomes in the RefSeq database, or all sequences in the BLAST nt database.
To map sequence identifiers to taxonomy IDs, and taxonomy IDs to names and its parents, three files are necessary in addition to the sequence files:
- taxonomy tree: typically nodes.dmp from the NCBI taxonomy dump. Links taxonomy IDs to their parents
- names file: typically names.dmp from the NCBI taxonomy dump. Links taxonomy IDs to their scientific name
- a tab-separated sequence ID to taxonomy ID mapping
When using the provided scripts to download the genomes, these files are automatically downloaded or generated. When using a custom taxonomy or sequence files, please refer to the section TODO
to learn more about their format.
Building index on all complete bacterial and viral genomes
Use centrifuge-download
to download genomes from NCBI. The following two commands download the NCBI taxonomy to taxonomy/
in the current directory, and all complete archaeal, bacterial and viral genomes to library/
. Low-complexity regions in the genomes are masked after download (parameter -m
) using blast+'s dustmasker
. centrifuge-download
outputs tab-separated sequence ID to taxonomy ID mappings to standard out, which are required by centrifuge-build
.
To build the index, first concatenate all downloaded sequences into a single file, and then run centrifuge-build
:
After building the index, all files except the index *.[123].cf files may be removed. If you also want to include the human and/or the mouse genome, add their sequences to the library folder before building the index with one of the following commands:
After the index building, all but the *.[123].cf index files may be removed. I.e. the files in the library/
and taxonomy/
directories are no longer needed.
Adding human or mouse genome to the index
The human and mouse genomes can also be downloaded using centrifuge-download
. They are in the domain 'vertebrate_mammalian' (argument -d
), are assembled at the chromosome level (argument -a
) and categorized as reference genomes by RefSeq (-c
). The argument -t
takes a comma-separated list of taxonomy IDs - e.g. 9606
for human and 10090
for mouse:
nt database
NCBI BLAST's nt database contains all spliced non-redundant coding sequences from multiplpe databases, inferred from genommic sequences. Traditionally used with BLAST, a download of the FASTA is provided on the NCBI homepage. Building an index with any database requires the user to creates a sequence ID to taxonomy ID map that can be generated from a GI taxid dump:
Custom database
To build a custom database, you need the provide the follwing four files to centrifuge-build
:
--conversion-table
: tab-separated file mapping sequence IDs to taxonomy IDs. Sequence IDs are the header up to the first space or second pipe ().
--taxonomy-tree
:t t
-separated file mapping taxonomy IDs to their parents and rank, up to the root of the tree. When using NCBI taxonomy IDs, this will be thenodes.dmp
fromftp://ftp.ncbi.nlm.nih.gov/pub/taxonomy/taxdump.tar.gz
.--name-table
: ' '-separated file mapping taxonomy IDs to a name. A further column (typically column 4) must specifyscientific name
. When using NCBI taxonomy IDs,names.dmp
is the appropriate file.- reference sequences: The ID of the sequences are the header up to the first space or second pipe (
)
When using custom taxonomy IDs, use only positive integers greater-equal to 1
and use 1
for the root of the tree.
More info on --taxonomy-tree
and --name-table
The format of these files are based on nodes.dmp
and names.dmp
from the NCBI taxonomy database dump.
- Field terminator is
t t
- Row terminator is
t n
The taxonomy-tree
/ nodes.dmp file consists of taxonomy nodes. The description for each node includes the following fields:
Further fields are ignored.
The name-table
/ names.dmp is the taxonomy names file:
name class
has to be scientific name
to be included in the build. All other lines are ignored
Example
Conversion table ex.conv
:
Taxonomy tree ex.tree
:
Name table ex.name
:
Reference sequences ex.fa
:
To build the database, call
which results in three index files named ex.1.cf
, ex.2.cf
and ex.3.cf
.
Centrifuge classification output
The following example shows classification assignments for a read. The assignment output has 8 columns.
Centrifuge summary output (the default filename is centrifuge_report.tsv)
The following example shows a classification summary for each genome or taxonomic unit. The assignment output has 7 columns.
As the GenBank database is incomplete (i.e., many more genomes remain to be identified and added), and reads have sequencing errors, classification programs including Centrifuge often report many false assignments. In order to perform more conservative analyses, users may want to discard assignments for reads having a matching length (8th column in the output of Centrifuge) of 40% or lower. It may be also helpful to use a score (4th column) for filtering out some assignments. Our future research plans include working on developing methods that estimate confidence scores for assignments.
Kraken-style report
centrifuge-kreport
can be used to make a Kraken-style report from the Centrifuge output including taxonomy information:
centrifuge-kreport -x <centrifuge index> <centrifuge out file>
Inspecting the Centrifuge index
The index can be inspected with centrifuge-inspect
. To extract raw sequences:
Extract the sequence ID to taxonomy ID conversion table from the index
Extract the taxonomy tree from the index:
Extract the lengths of the sequences from the index (each row has two columns: taxonomic ID and length):
Extract the names from the index (each row has two columns: taxonomic ID and name):
Wrapper
The centrifuge
, centrifuge-build
and centrifuge-inspect
executables are actually wrapper scripts that call binary programs as appropriate. Also, the centrifuge
wrapper provides some key functionality, like the ability to handle compressed inputs, and the functionality for [--un
], [--al
] and related options.
It is recommended that you always run the centrifuge wrappers and not run the binaries directly.
Performance tuning
If your computer has multiple processors/cores, use
-p NTHREADS
The
-p
option causes Centrifuge to launch a specified number of parallel search threads. Each thread runs on a different processor/core and all threads find alignments in parallel, increasing alignment throughput by approximately a multiple of the number of threads (though in practice, speedup is somewhat worse than linear).
Command Line
Usage
Main arguments
The basename of the index for the reference genomes. The basename is the name of any of the index files up to but not including the final |
Comma-separated list of files containing mate 1s (filename usually includes |
Comma-separated list of files containing mate 2s (filename usually includes |
Comma-separated list of files containing unpaired reads to be aligned, e.g. |
s is a 5-column TSV file where each line corresponds to a sample. The format for the sample sheet file is: the first column specify the sample type: 1: single-end, 2:paired-end. The next two column will specify the read file(s) followed by the classification result output file and report file. If the sample is single-ended (type 1), the third column will be ignored by Centrifuge. |
Comma-separated list of SRA accession numbers, e.g. |
File to write classification results to. By default, assignments are written to the 'standard out' or 'stdout' filehandle (i.e. the console). |
File to write a classification summary to (default: centrifuge_report.tsv). |
Options
Input options
Reads (specified with |
Reads (specified with |
Reads (specified with |
Reads (specified with |
The read sequences are given on command line. I.e. |
Skip (i.e. do not align) the first |
Align the first |
Trim |
Trim |
Input qualities are ASCII chars equal to the Phred quality plus 33. This is also called the 'Phred+33' encoding, which is used by the very latest Illumina pipelines. |
Input qualities are ASCII chars equal to the Phred quality plus 64. This is also called the 'Phred+64' encoding. |
Convert input qualities from Solexa (which can be negative) to Phred (which can't). This scheme was used in older Illumina GA Pipeline versions (prior to 1.3). Default: off. |
Quality values are represented in the read input file as space-separated ASCII integers, e.g., |
Classification
Minimum length of partial hits, which must be greater than 15 (default: 22)' |
It searches for at most |
A comma-separated list of taxonomic IDs that will be preferred in classification procedure. The descendants from these IDs will also be preferred. In case some of a read's assignments correspond to these taxonomic IDs, only those corresponding assignments will be reported. |
A comma-separated list of taxonomic IDs that will be excluded in classification procedure. The descendants from these IDs will also be exclude. |
Output options
Print the wall-clock time required to load the index files and align the reads. This is printed to the 'standard error' ('stderr') filehandle. Default: off. |
Print nothing besides alignments and serious errors. |
Write |
Write |
Write a new |
Performance options
Launch |
Guarantees that output records are printed in an order corresponding to the order of the reads in the original input file, even when |
Use memory-mapped I/O to load the index, rather than typical file I/O. Memory-mapping allows many concurrent |
Other options
Filter out reads for which the QSEQ filter field is non-zero. Only has an effect when read format is |
Use |
Normally, Centrifuge re-initializes its pseudo-random generator for each read. It seeds the generator with a number derived from (a) the read name, (b) the nucleotide sequence, (c) the quality sequence, (d) the value of the |
Print version information and quit. |
Print usage information and quit. |
centrifuge-build
builds a Centrifuge index from a set of DNA sequences. centrifuge-build
outputs a set of 6 files with suffixes .1.cf
, .2.cf
, and .3.cf
. These files together constitute the index: they are all that is needed to align reads to that reference. The original sequence FASTA files are no longer used by Centrifuge once the index is built.
Use of Karkkainen's blockwise algorithm allows centrifuge-build
to trade off between running time and memory usage. centrifuge-build
has two options governing how it makes this trade: --bmax
/--bmaxdivn
, and --dcv
. By default, centrifuge-build
will automatically search for the settings that yield the best running time without exhausting memory. This behavior can be disabled using the -a
/--noauto
option.
Archaea Terata Mac Os Download
The indexer provides options pertaining to the 'shape' of the index, e.g. --offrate
governs the fraction of Burrows-Wheeler rows that are 'marked' (i.e., the density of the suffix-array sample; see the original FM Index paper for details). All of these options are potentially profitable trade-offs depending on the application. They have been set to defaults that are reasonable for most cases according to our experiments. See Performance tuning for details.
The Centrifuge index is based on the FM Index of Ferragina and Manzini, which in turn is based on the Burrows-Wheeler transform. The algorithm used to build the index is based on the blockwise algorithm of Karkkainen.
Archaea Terata Mac Os 11
Command Line
Usage:
Main arguments
A comma-separated list of FASTA files containing the reference sequences to be aligned to, or, if |
The basename of the index files to write. By default, |
Options
Archaea Terata Mac Os Catalina
The reference input files (specified as |
The reference sequences are given on the command line. I.e. |
Disable the default behavior whereby |
Launch |
List of UIDs (unique ID) and corresponding taxonomic IDs. |
Taxonomic tree (e.g. nodes.dmp). |
Name table (e.g. names.dmp). |
List of taxonomic IDs and lengths of the sequences belonging to the same taxonomic IDs. |
The maximum number of suffixes allowed in a block. Allowing more suffixes per block makes indexing faster, but increases peak memory usage. Setting this option overrides any previous setting for |
The maximum number of suffixes allowed in a block, expressed as a fraction of the length of the reference. Setting this option overrides any previous setting for |
Use |
Disable use of the difference-cover sample. Suffix sorting becomes quadratic-time in the worst case (where the worst case is an extremely repetitive reference). Default: off. |
To map alignments back to positions on the reference sequences, it's necessary to annotate ('mark') some or all of the Burrows-Wheeler rows with their corresponding location on the genome. |
The ftab is the lookup table used to calculate an initial Burrows-Wheeler range with respect to the first |
Use |
Use |
|
Print usage information and quit. |
Print version information and quit. |
centrifuge-inspect
extracts information from a Centrifuge index about what kind of index it is and what reference sequences were used to build it. When run without any options, the tool will output a FASTA file containing the sequences of the original references (with all non-A
/C
/G
/T
characters converted to N
s). It can also be used to extract just the reference sequence names using the -n
/--names
option or a more verbose summary using the -s
/--summary
option.
Command Line
Usage:
Main arguments
The basename of the index to be inspected. The basename is name of any of the index files but with the |
Options
When printing FASTA output, output a newline character every |
Print reference sequence names, one per line, and quit. |
Print a summary that includes information about index settings, as well as the names and lengths of the input sequences. The summary has this format: Fields are separated by tabs. Colorspace is always set to 0 for Centrifuge. |
Print a list of UIDs (unique ID) and corresponding taxonomic IDs. |
Print taxonomic tree. |
Print name table. |
Print a list of taxonomic IDs and lengths of the sequences belonging to the same taxonomic IDs. |
Print verbose output (for debugging). |
Print version information and quit. |
Print usage information and quit. |
Centrifuge comes with some example files to get you started. The example files are not scientifically significant; these files will simply let you start running Centrifuge and downstream tools right away.
First follow the manual instructions to obtain Centrifuge. Set the CENTRIFUGE_HOME
environment variable to point to the new Centrifuge directory containing the centrifuge
, centrifuge-build
and centrifuge-inspect
binaries. This is important, as the CENTRIFUGE_HOME
variable is used in the commands below to refer to that directory.
Indexing a reference genome
To create an index for two small sequences included with Centrifuge, create a new temporary directory (it doesn't matter where), change into that directory, and run:
The command should print many lines of output then quit. When the command completes, the current directory will contain ten new files that all start with test
and end with .1.cf
, .2.cf
, .3.cf
. These files constitute the index - you're done!
Archaea Terata Mac Os X
You can use centrifuge-build
to create an index for a set of FASTA files obtained from any source, including sites such as UCSC, NCBI, and Ensembl. When indexing multiple FASTA files, specify all the files using commas to separate file names. For more details on how to create an index with centrifuge-build
, see the manual section on index building. You may also want to bypass this process by obtaining a pre-built index.
Classifying example reads
Stay in the directory created in the previous step, which now contains the test
index files. Next, run:
This runs the Centrifuge classifier, which classifies a set of unpaired reads to the the genomes using the index generated in the previous step. The classification results are reported to stdout, and a short classification summary is written to centrifuge-species_report.tsv.
You will see something like this:
ARCHAEA TERATA Mac OS