Package: taxontabletools
TaxonTableToolsBackgroundTaxonTableTools (TTT) aims to provide easy to use tools for biologists and non-bioinformaticians to analyse and visualize their DNA metabarcoding data quickly and reproducible via a graphical user interface.TaxonTableTools is an evolving software and there will be bugs and issues at few points. If so, please leave the report in the git repository or drop me an email. Furthermore, new content and functions will be gradually added. Suggestions and recommendations for new features are always welcome!RequirementsPython version 3.6 or 3.7, 3.8, and 3.9TTT will most likely not work with python 3.10 and 3.11Pip python package installerOS independent (tested on Windows 10, Ubuntu 16 & 18 and MacOS Catalina)Some issues were reported during theinstallation on WindowsSome issues were reported during theinstallation on MacOSInstallationTaxonTableTools requires Python version 3.6 or 3.7 and can be easily installed using pip.First, make sure you run the correct pip version via:python3.9 -m pip --versionWhich should return "pip 21.3.1 from /Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/pip (python 3.9)" or similar.Then install numpy and TaxonTableTools via pip:python3.9 -m pip install numpypython3.9 -m pip install taxontabletoolsTaxonTableTools can then be started via:python3.9 -m taxontabletoolsUpdates can be installed via:python3.9 -m pip install --upgrade taxontabletoolsThe installation ofKrona toolsis optional and needs to be done separately. Note that Krona tools is currently not supported on Windows.TutorialThe easiest way to learn to how to use TaxonTableTools is to check out thetutorial!Quick startWhen first launched TTT will ask to define an output directory. This is where all your projects and respective output files will be stored. A new folder "Projects" will be created in this directory.The next window will always appear when launching TTT. Here you can create new projects or load an already existing one. The output directory can also be changed here.Create a new project by typing the desired name or leave blank to create a "Default_project". Click on "Create new" to proceed.A blank template TaXon table is availablehere.Graphical user interfaceExamplesEcological traitsOTU-specific traits can now be added to the TaXon table. Traits can e.g. be:habitatdiet typedistributionecological traitsRequirements for trait source tables (.xlsx):Column A: One of the TTT-specific taxonomic level (Phylum, Class, Order, Family, Genus, Species)Column B: Name of the traitExample for aquatic invertebratesRequirements for manual import:The traits columns must be located between the 'Status' and 'seq' columns!Do not alter the location of the other TaXon table columns.There is no limit of OTU traits columns that can be added. A TaXon table containing OTU traits is compatible with
all modules (OTU traits will simply be ignored if not required).Example for aquatic invertebratesChange log (only for major changes)v 1.4.8New feature:Added support for easier read and taxonomy table conversion from APSCALE.Important changes:-> Taxonomy table sheet name for the APSCALE import changed to 'Taxonomy table’-> Read table column name for OTU sequences changed to 'Seq'-> Those are the default names generated in APSCALE and makes importing data easier.Bug fixes:Y-axes for alpha diversity and rarefaction plots start at 0.Fixed crash of the venn diagram module.Fixed potentially remaining zero read OTUs after read-based rarefaction.v 1.4.5TTT change log v 1.4.5Added trait import to the data conversion modules.v 1.4.4TTT change log v 1.4.4Bug fixesFixed incorrect text boxes.NMDSChanged back NMDS to raw stress until sclearn updates to normalized stress.TTT will be updated as soon as normalized stress is available!v 1.3.1Metadata entries for specific samples can now be left blank to exclude the sample from the analyses. This avoids the need to create new metadata tables for each subset of a TaXon tableTaxon lists have been overhauled and now include presence/absence indications for samples or metadata groupsFixed incorrect y-axis title in the per taxon plotEnhanced y-axis title of shared OTUs per bin plotFixed Qiime2 conversionFixed OTU and read correlation layout bugsv 1.3.0Enhanced TaXon table check. Missing taxonomy is now marked with a flagUser preferences can now be savedUser will now be informed about available updatesUser can choose what the clustering units (e.g. OTUs, ASVs) shall be calledGenus and species names are displayed in italicAdded additional replicate analysis plotTaXon table filter tools print the number of removed OTUsMetadata tables can be opened in TTTAdded new tool to subtract reads present in negative controls from all samplesAdded option to distinguish different taxa in the rarefaction plotAdded site occupancy heatmap optionAdded parallel category chartAdded option to display single samples in one Krona chartAdded non.metric multidimensional scaling (NMDS) analysisAdded bray-curtis option to diversity and ordination analysesAdded vernacular names download in the taxon listLog files can be opened in TTTSeveral layout changesVarious minor bug fixesv. 1.2.4Fixed "TaXon table consuming" bug on some Windows 10 machinesv. 1.2.3Fixed alpha diversity bugMissing file in installation path fixed.Corrected minor spelling and layout mistakes.v. 1.2.0Major update:The identifier "IDs" was changed to "ID" in the TaXon table header!Please adjust old TaXon tables accordingly!Otherwise TTT will crash!New features:Metadatables can now directly be adjusted from within TTT.Browsing TaXon tables will directly show the current project folder.The OTU prompt is more relaxed. Hash OTUs are accepted now.Qiime2 feature tables can now be converted to the TTT format.Additional options for customizing colors have been added.Font sizes can now be adjusted.Diversity and ordiniation analyses can now be performed on different taxonomic levels.Diversity and ordiniation analyses automatically transform data to boolean values. Thus, also non presence/absence converted tables can be used.Moved various options to drop down menus.Bug fixes:Fixed "shared OTUs" tool. More than 3 replicates are now supported.Changed x*axis value to read proportions in the per taxon analysis.Added missing package 'statsmodels' to installation.How to citeIf you use TTT:Macher, T.H., Beermann, A. J., & Leese, F. (2021). TaxonTableTools—A comprehensive, platformindependent graphical user interface software to explore and visualise DNA metabarcoding data. Molecular Ecology Resources. doi:https://doi.org/10.1111/1755*0998.13358If you create Krona charts, please also cite:Ondov, B. D., Bergman, N. H., & Phillippy, A. M. (2011). Interactive metagenomic visualization in a Web browser. BMC Bioinformatics, 12(1), 385. doi: 10.1186/1471210512*385