Package: pear-ebi
Phylogeny Embedding  &Approximate RepresentationGoldman Group - European Bioinformatics InstitutePEAR can:Compute the distance matrix given a set of phylogenetic trees;Embed and represent the distance matrix in 2D or 3D.See also theautogenerated documentationandPyPI.PEAR usagePear is both a python software and library. It can be installed withpython -m pip install pear_ebior downloaded fromGithub. Pear is currently compatible with Linux and Mac OSs.PEAR as a python libraryOnce installed, Pear can be used to upload newick trees in python and represent them in embedded spaces. We recommend to use it on either jupyter notebook or lab, as these tools allow for more interaction with the graphs. On these platforms, the user is allowed to interact with widgets that allows to modify several parameteres of the plots. For specific uses and applications, see theexamples.PEAR as a programRunpear_ebi --helpto see the complete list of arguments and flags.Simple usagepear_ebi examples_trees_sets/beast_trees/beast_run1.trees -m hashrf_RFthis script calculates the unweightedRobison Fouldsdistances between the trees in the file "beast_run1.trees", which contains 1001 phylogenetic trees.the flag-mindicates the method used to compute the dissimilarity between phylogeneic trees. In this case,HasRFhas been used.To embed these distances in a lower-dimensional space, we can use PCoA (MDS) or tSNE:pear_ebi examples_trees_sets/beast_trees/beast_run1.trees -m hashrf_RF -pca 2we therefore embedded the distance matrix in 2 dimensions. Using the flag-qualityone can assess the correlation between the distances in the N-dimensional space and in the embedding.pear_ebi examples_trees_sets/beast_trees/beast_run1.trees -m hashrf_RF -pca 2 -plotThe flag-plotindicates that PEAR has to plot the embeddings and show them, respectively. If an embedding method is specified the plots are produced anyway. Plotting doesn't require any indication on the number of dimensions as the embeddings are represented in 2 dimensions if the distances are embedded in 2 dimensions, while it plots on 2 and 3 dimensions in any other case.One can specify any number of files containing trees. Moreover, it is possible to specify a single directory using-dir, and possibly a pattern using-pattern, in order to select multiple files.Tree SetIt's possible to compute the distance matrix and re-use it in subsequent runs of PEAR by specifying the distance matrix file with the flag-d. Additionally, it's possible to define the name of the output file (-o).If any additional metadata is available, this may be specified by indicating a.csvfile containing a dataframe of compatible shape.Config fileA standard config toml file can be used for specific emebddings of multiple sets of trees. Instances of toml files are reported in theexamplesfolder.Using the config file allows one to use all the features of PEAR, including additional embedding methods and plot designs. The config file can also be used to specify lists of indexes of interesting trees in the sets, in order to highlight them in the final plots.Interactive modepear_ebi --i:
this script launches the program in the interactive mode. Once the program starts, it is going to guide you through its usage thanks to an intuitive interface.LicensingThis project is released under the terms of the MIT Open Source License. ViewLICENSE.txtfor more information.