https://github.com/4ment/torchtree-experiments
Science Score: 36.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
✓Academic publication links
Links to: arxiv.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (12.8%) to scientific vocabulary
Keywords
Repository
Statistics
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
README.md
torchtree-experiments
This repository contains the pipeline and data supporting the results of the following article:
Mathieu Fourment, Matthew Macaulay, Christiaan J Swanepoel, Xiang Ji, Marc A Suchard, Frederick A Matsen IV. torchtree: flexible phylogenetic model development and inference using PyTorch. arXiv:2406.18044
Data
SARS-CoV-2
We reproduce the SARS-CoV-2 analysis perfomed by Magee et al., 2023. Detailed information on installing the appropriate versions of BEAST and BEAGLE is available on their GitHub repository. Due to data sharing limitations, sequences need to be downloaded from GISAID and the alignment (FASTA format) needs to be provided to the pipeline. The GISAID accession IDs are available in acknowledgements_table.xlsx.
Dependencies
To execute this pipeline, it is necessary to install nextflow. Docker is not required but it is highly recommended to use it due to the numerous dependencies.
Installation
git clone 4ment/torchtree-experiments.git
cd torchtree-experiments/
chmod +x bin/*.py
Pipeline without docker/singularity
Installing dependencies with conda
conda env create -f environment.yml
conda activate torchtree-experiments
RUN wget https://github.com/4ment/physher/archive/refs/tags/v2.0.1.tar.gz
tar -xzvf v2.0.1.tar.gz
cmake -S physher-2.0.1 -B physher-2.0.1/build -DBUILD_CPP_WRAPPER=on -DBUILD_TESTING=on -DCMAKE_INSTALL_PREFIX=$CONDA_PREFIX/envs/torchtree-experiments
cmake --build physher-2.0.1/build/ --target install
export LIBRARY_PATH=$LIBRARY_PATH:$CONDA_PREFIX/envs/torchtree-experiments/lib
pip install torch==1.12.1 numpy==1.22 torchtree==1.0.2
pip install torchtree-physher==1.0.0 torchtree-scipy==1.0.0
Running the pipeline
nextflow run main.nf -profile conda --sc2 sc2.fa
sc2.fa is the sequence alignment file containing the SARS-CoV-2 sequences (see SARS-CoV-2 section for more details)
Pipeline with docker or singularity
There is no need to install dependencies with docker or singularity.
Running the pipeline with docker
nextflow run main.nf -profile docker --sc2 sc2.fa
Running the pipeline with singularity and PBS
nextflow -C configs/uts.config run main.nf -profile singularity --sc2 sc2.fa
Since the pipeline will take weeks to run to completion one should use a high performance computer. An example of configuration file for PBS Pro can be found in the configs folder.
Summarizing results
All R packages used for plotting the results can be installed using renv. This command needs to be run only once.
Rscript -e 'renv::restore()'
Generate figures in a single pdf:
Rscript -e 'rmarkdown::render("index.Rmd")'
Note:
rmarkdown requires pandoc to be installed. The conda environment provided in this repo includes pandoc.
It is also possible to use RStudio to run the index.Rmd script.
Program and library versions
For reproducibility, we provide below the version of each library/program used in the benchmark.
| Program/Library | Version | | --------------- | ------- | | physher | 2.0.1 | | torchtree | 1.0.2 | | torchtree-physher | 1.0.0 | | torchtree-scipy | 1.0.0 | | pytorch | 1.12.1 |
The R scripts use the skyplotr package, and it is downloadable using devtools:
Rscript -e 'devtools::install_github("4ment/skyplotr", ref="8abc10a")'
Owner
- Name: Mathieu Fourment
- Login: 4ment
- Kind: user
- Location: Australia
- Company: University of Technology Sydney
- Repositories: 58
- Profile: https://github.com/4ment
GitHub Events
Total
Last Year
Issues and Pull Requests
Last synced: 9 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- actions/checkout v3 composite
- docker/login-action v3 composite
- continuumio/anaconda3 2022.10 build