.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.16. .TH HYPHY "1" "January 2021" "hyphy 2.5.26" "User Commands" .SH NAME hyphy \- Hypothesis testing using Phylogenies (pthreads version) .SH DESCRIPTION usage: hyphy or HYPHYMPI [\-h] [\-\-help][\-c] [\-d] [\-i] [\-p] [BASEPATH=directory path] [CPU=integer] [LIBPATH=library path] [USEPATH=library path] [ or ] [\-\-keyword value ...] [positional arguments ...] .PP Execute a HyPhy analysis, either interactively, or in batch mode optional flags: .TP \fB\-h\fR \fB\-\-help\fR show this help message and exit .TP \fB\-c\fR calculator mode; causes HyPhy to drop into an expression evaluation until 'exit' is typed .TP \fB\-d\fR debug mode; causes HyPhy to drop into an expression evaluation mode upon script error .TP \fB\-i\fR interactive mode; causes HyPhy to always prompt the user for analysis options, even when defaults are available .TP \fB\-p\fR postprocessor mode; drops HyPhy into an interactive mode where general post\-processing scripts can be selected upon analysis completion .TP \fB\-m\fR write diagnostic messages to messages.log .SS "optional global arguments:" .TP BASEPATH=directory path defines the base directory for all path operations (default is pwd) .TP CPU=integer if compiled with OpenMP multithreading support, requests this many threads; HyPhy could use fewer than this but never more; default is the number of CPU cores (as computed by OpenMP) on the system .TP LIBPATH=directory path defines the directory where HyPhy library files are located (default installed location is \fI\,/usr/local/lib/hyphy\/\fP or as configured during CMake installation .TP USEPATH=directory path specifies the optional working and relative path directory (default is BASEPATH) .TP ENV=expression set HBL environment variables via explicit statements for example ENV='DEBUG_MESSAGES=1;WRITE_LOGS=1' .TP batch file to run if specified, execute this file, otherwise drop into an interactive mode .TP analysis arguments if batch file is present, all remaining positional arguments are interpreted as inputs to analysis prompts .PP optional keyword arguments (can appear anywhere); will be consumed by the requested analysis .TP \fB\-\-keyword\fR value will be passed to the analysis (which uses KeywordArgument directives) multiple values for the same keywords are treated as an array of values for multiple selectors .PP usage examples: .SS "Select a standard analysis from the list :" .IP hyphy \fB\-i\fR .PP Run a standard analysis with default options and one required user argument; .IP hyphy busted \fB\-\-alignment\fR path/to/file .PP Run a standard analysis with additional keyword arguments .IP hyphy busted \fB\-\-alignment\fR path/to/file \fB\-\-srv\fR No .PP See which arguments are understood by a standard analysis .IP hyphy busted \fB\-\-help\fR .PP Run a custom analysis and pass it some arguments .IP hyphy path/to/hyphy.script argument1 'argument 2' .PP Available standard keyword analyses (located in /home/nilesh/packages/hyphy/hyphy/res/) .TP meme [MEME] Test for episodic site\-level selection using MEME (Mixed Effects Model of Evolution). .TP mh Merge two datafiles by combining sites (horizontal merge). .TP mv Merge two datafiles by combining sequences (vertical merge). .TP mcc Compare mean within\-clade branch length or pairwise divergence between two or more non\-nested cladesd in a tree .TP mclk Test for the presence of a global molecular clock on the tree using its root (the resulting clock tree is unrooted, but one of the root branches can be divided in such a way as to enforce the clock). .TP mgvsgy Compare the fits of MG94 and GY94 models (crossed with an arbitrary nucleotide bias) on codon data. .TP mt Select an evolutionary model for nucleotide data, using the methods of 'ModelTest' \- a program by David Posada and Keith Crandall. .TP fel [FEL] Test for pervasive site\-level selection using FEL (Fixed Effects Likelihood). .TP fubar [FUBAR] Test for pervasive site\-level selection using FUBAR (Fast Unconstrained Bayesian AppRoximation for inferring selection). .TP fade [FADE] Test a protein alignment for directional selection towards specific amino acids along a specified set of test branches using FADE (a FUBAR Approach to Directional Evolution). .TP faa Fit a multiple fitness class model to amino acid data. .TP fmm "Fit a model that permits double (and triple) instantaneous nucleotide substitutions" .TP fst Compute various measures of F_ST and (optionally) perform permutation tests. .TP slac [SLAC] Test for pervasive site\-level selection using SLAC (Single Likelihood Ancestor Counting). .TP sm Peform a classic and structured Slatkin\-Maddison test for the number migrations. .TP sns Parse a codon alignment for ambiguous codons and output a complete list/resolutions/syn and ns counts by sequence/position .TP sw Perform a sliding window analysis of sequence data. .TP sa Perform a phylogeny reconstuction for nucleotide, protein or codon data with user\-selectable models using the method of sequential addition. .TP sbl Search an alignment for a single breakpoint. .TP spl Plot genetic distances (similarity) of one sequence against all others in an alignment, using a sliding window. Optionally, determine NJ\-based clustering and bootstrap support in every window. This is a HyPhy adaptation of the excellent (but Windows only tool) SimPlot (and/or VarPlot) written by Stuart Ray (http://sray.med.som.jhmi.edu/SCRoftware/simplot/) .TP busted [BUSTED] Test for episodic gene\-wide selection using BUSTED (Branch\-site Unrestricted Statistical Test of Episodic Diversification). .TP bgm [BGM] Apply Bayesian Graphical Model inference to substitution histories at individual sites. .TP bva Run a selection analysis using a general discrete bivariate (dN AND dS) distribution; the appropriate number of rate classes is determined automatically. .TP brp Interpret bivariate codon rate analysis results. .TP bsel Split a tree into two clades (compartments) and a separating branch and test for equality of dN/dS between compartments and for selection along the separating branch using a series of Likelihood Ratio Tests. .TP bst Use the improved branch\-site REL method of Yang and Nielsen (2005) to look for episodic selection in sequences. .TP bt Test whether a branch (or branches) in the tree evolves under different dN and dS than the rest of the tree. .TP absrel [aBSREL] Test for lineage\-specific evolution using the branch\-site method aBS\-REL (Adaptive Branch\-Site Random Effects Likelihood). .TP acd Analyse codon data with a variery of standard models using given tree. .TP ad Analyse nucleotide or aminoacid data with a variery of standard models using given tree. .TP adn Analyse di\-nucleotide data with a variery of standard models using given tree. .TP afd Analyse nucleotide data with a variery of standard models using given tree, estimating equilibrium frequencies as parameters .TP ana Run a selection analysis. .TP ai Peter Simmonds' Association Index (AI). .TP relax [RELAX] Test for relaxation of selection pressure along a specified set of test branches using RELAX (a random effects test of selection relaxation). .TP red Replace sufficiently close sequence with their MRCA .TP rpc Interpret analysis results. .TP rmv Remove sequences with stop codons from the data. .TP rble Use a series of random effects branch\-site models to perform robust model\-averaged branch length estimation under a codon model with episodic selection. .TP rclk Test for the presence of a global molecular clock on the tree. The tree is rooted at every possible branch. .TP rr Use relative rate test on three species and a variety of standard models .TP rrt Use relative ratio test on 2 datasets and a variety of standard models .TP prime [PRIME] .TP protein Compare the fit of several amino\-acid substitution models to an alignment using AIC and c\-AIC. .TP prr Using the model and the outgroup provided by the user, perform relative rate tests with all possible pair of species from the data file. .TP prrti Given a list of files (and optionally genetic code tables), perform relative ratio tests on all possible pair of the data files. .TP pdf Read sequence data, select a contiguous subset of sites and save it to another datafile. .TP phb Run an example file from our book chapter in 'The Phylogentic Handbook' (2nd edition). .TP psm Test for positive selection using the approach of Nielsen and Yang, by sampling global dN/dS from an array of distributions, and using Bayesian posterior to identify the sites with dN/dS>1. Multiple subsets of one data set with shared dN/dS. .TP parris A PARtitioning approach for Robust Inference of Selection (written by K. Scheffler) .TP contrast\-fel [Contrast\-FEL] "Perform a site\-level test for differences in selective pressures between predetermined sets of branches." .TP conv Translate an in\-frame codon alignment to proteins. .TP corr Assess the correlation between phylogenetic and compartment segregation using generalized correlation coefficients and permutation tests. .TP cod Compare all 203 reversible nucleotide models composed with MG94 to extend them to codon data, and perform LRT and AIC model selection. .TP cmp Use a series of LR tests to decide if dN and dS rate distributions are the same or different between two codon alignments. .TP caln Align coding sequences to reference (assuming star topology) using a codon\-based dynamic programming algorithm (good for fixing multiple frameshifts). Designed with within\-patient HIV sequences in mind. .TP clg Remove 'gappy' sites from alignments based on a user\-specified gap threshold. .TP cln Convert sequence names to HyPhy valid identifiers if needed and replace stop codons with gaps in codon data if any are present. .TP clsr Partition sequences into clusters based on a distance matrix. .TP clst Apply clustering methods for phylogeny reconstruction (UPGMA,WPGMA,complete or minimal linkage) to nucleotide, protein and codon data, using MLE of pairwise distances with user\-selectable models. These methods produce trees with global molecular clock. .TP leisr Infer relative evolutionary rates on a nucleotide or protein alignment, in a spirit similar to Rate4Site (PMID: 12169533). .TP lz Compute Lempel\-Ziv complexity and entropy of (possibly unaligned) sequences .TP lclk Test for the presence of a local molecular clock. Every subtree of the given tree is subjected to the clock constraint, while the remainder of the tree is free of the clock constraint. .TP lht A Likelihood Ratio Test to detect conflicting phylogenetic signal Huelsenbeck and Bull, 1996. [Contributed by Olivier Fedrigo]. .TP tc Test whether a group of sequences in a sample cluster together .TP ts Perform an exhaustive tree space search for nucleotide or protein data with user\-selectable models. Should only be used for data sets with less than 10 taxa! .TP dtr Read sequence data (#,PHYLIP,NEXUS) and convert to a different format .TP dist Generate a pairwise sequence distance matrix in PHYLIP format. .TP kh Perform a Kishino\-Hasegawa test on two competing phylogenies .TP ub Obtain an upper bound on the likelihood score of a dataset. .TP nuc Compare all 203 reversible nucleotide models and perform LRT and AIC model selection. .TP nj Perform a phylogeny reconstuction for nucleotide, protein or codon data with user\-selectable models using the method of neighbor joining. .TP ny Test for positive selection using the approach of Nielsen and Yabg, by sampling global dN/dS from an array of distributions, and using Bayesian posterior to identify the sites with dN/dS>1. .TP gard [GARD] Screen an alignment using GARD (requires an MPI environment). .SH AUTHOR This manpage was written by Nilesh Patra for the Debian distribution and can be used for any other usage of the program.