The tormes report files

under development
Last modification 10-06-2020
* The content of this wiki refers to TORMES v1.1

Once TORMES analysis ends, the results will be summarized in an interactive html-file, that is automatically performed by the tormes-report script included in TORMES environment. The report file (tormes_report.html) can be viewed in any web browser (if some browser return problems, please try to open it with a different one) and does not require any other data to be visualized, so the results can be easily visualized by different people just by sharing the tormes_report.html file. All the tables and figures included in the report file are downloadable.

However, probably the report is not showing exactly what you want or need. Additionally, you may have extra results, figures and tables that you would like to include before sharing with others. Or perhaps, you might want to modify some of the tables and/or figures that are already present in the report.

This is totally possible!

Some experience in R and R markdowns is needed, but we will try to make it easy through this wiki. Let's go step by step:

The report_files directory

After TORMES run, all the results generated and intermediate files will be contained in the output directory specified when running TORMES (see https://github.com/nmquijada/tormes#output for further information).
Inside this output directory, you will find a zipped directory: report_files.tgz. This directory contains all the files that were required to render the tormes_report.html. The information contained in this directory is redundant, as several results from other directories (antibiotic_resistance_genes, mlst, etc.) are copied into this directory. This is done intentionally, as the unzipped report_files.tgz can be used as the working directory for the user to easily modify the report. The directory is zipped in order to ocupy the less space as possible.

For unzipping report_files.tgz, type:

tar xzf report_files.tgz

Now, a directory (report_files) will appear and the zipped report_files.tgz will remain too. By looking to the content of the report_files directory, you will find the following files (I will sort them in this wiki according to their appearence possition in the tormes_report.html):

Samples description

• metadata.txt: the same information that was parsed to the -m/--metadata option in TORMES)

Assembly analysis

• accessory_binary_genes.fa.newick (newick file with the information of the pangenome tree based on presence/absence of genes between the isolates)
• core_gene_alignment.newick (newick file with the information of pangenome tree based on core-genome-SNP distances)