13 Triumph: Project report

CURRENTLY NOT MAINTAINED OR SUPPORTED

The code here generates a report that collects the results of multiple runs of the Triumph report. Note that in order to use it, all the individual runs should have been analyzed with the “Triumph: Run pipeline”

13.1 Handbook

13.1.1 Requirements and preparation

See the General Instructions for all pipelines first.

  • Make sure that your folder has the right name and structure. Your input folder should have one subfolder per different run. Each of this subfolders contains the results of the “Triumph: Run pipeline” for that specific run. Please, do not rename any of the files produced by the “Triumph: Run pipeline”, otherwise they will not be found and cannot be included in the project report. Neither your folder nor your subfolders can have “rare” characters (only letters, numbers, dashes and underscores accepted). If your folder name contains different characters, it may not be recognized by the pipeline. IMPORTANT: Your folder name MUST NOT CONTAIN SPACES!!!!

13.1.2 Download the pipeline

YOU NEED TO DOWNLOAD THE PIPELINE ONCE OR EVERY TIME YOU WANT TO UPDATE IT

Make sure to have followed the instructions to set up conda before installing any of our pipelines!

Please follow the instructions to download pipelines from the Juno team of the IDS-bioinformatics group. The triumph_microbiome_project pipeline can be found in this link.

13.1.3 Start the analysis. Basics

  1. Open the terminal.

  2. Enter the folder of the pipeline:

cd /mnt/scratch_dir/<my_folder>/triumph_project_report-master/
  • Exact name of downloaded folder might be slightly different depending on the version that was downloaded.
  1. Run the pipeline
bash create_triumph_report.sh -i /mnt/scratch_dir/<my_folder>/
  • The input directory (in this case /mnt/scratch_dir/my_folder) should be a folder containing one subfolder per run you want to include in the project report. These subfolders should contain the results of running the Triumph run pipeline using the --metadata option. Refer to the manual of that pipeline to see what that argument means.

Note 1: If you are updating the project report because you added the analysis of an old run, you should first delete or rename the “old” report. This script might fail otherwise.

Note 2: THE PROJECT REPORT PIPELINE ONLY WORKS WHEN ALL RUNS COLLECTED WERE EVALUATED WITH THE “Triumph: Run pipeline” USING A METADATA FILE!!!

13.1.4 Output

A folder called out/, inside the folder of the pipeline, will be created. If you prefer to store your output in a different folder, you can use the -o argument to give another path.

bash triumph_run_pipeline.sh -i /mnt/scratch_dir/<my_folder>/<my_data>/ -o /mnt/scratch_dir/<my_folder>/<my_results>/

If you chose another site for the output, then you will find the same results there.

In both cases, the output folder will contain the Triumph_Project_report.html file that is the actual report and a Triumph_Project_Report.log that contains messages, warnings and errors from R, where you can find more info if something goes wrong and the report could not be produced.

13.1.5 Troubleshooting

Please read first the General Troubleshooting section!

13.1.5.1 Other problems or failing rules

The triumph_microbiome_project pipeline is currently not maintained or supported.