diff --git a/README.md b/README.md index 0a750301..d30451af 100644 --- a/README.md +++ b/README.md @@ -75,7 +75,11 @@ source ~/.bashrc ``` conda config --add channels defaults +``` +``` conda config --add channels bioconda +``` +``` conda config --add channels conda-forge ``` @@ -85,23 +89,23 @@ Verify the installation by running `conda` in your terminal ``` conda create -n roadies_env python=3.9 ete3 seaborn +``` +``` conda activate roadies_env ``` 4. Install ROADIES: ``` -conda install roadies +conda install roadies=0.1.10 ``` 5. Locate the installed files: ``` -cd $CONDA_PREFIX/envs/roadies_env/ROADIES - +cd $CONDA_PREFIX/ROADIES ``` - -Now you are ready to follow the [Quick Start](#start) section to run the pipeline. +You will be able to find the contents of the repository within this ROADIES folder. Now you are ready to follow the [Quick Start](#start) section to run the pipeline. ### Option 2: Install via DockerHub @@ -118,7 +122,7 @@ docker pull ang037/roadies:latest docker run -it ang037/roadies:latest ``` -Once you are able to access the ROADIES repository, refer to the [Quick Start](#start) to run the pipeline. +These commands will launch the Docker container in interactive mode, with the roadies_env environment activated and the working directory set to the ROADIES repository containing all necessary files. Once you are able to access the ROADIES repository, refer to the [Quick Start](#start) to run the pipeline. ### Option 3: Install via Local Docker Build @@ -126,6 +130,8 @@ Once you are able to access the ROADIES repository, refer to the [Quick Start](# ``` git clone https://github.com/TurakhiaLab/ROADIES.git +``` +``` cd ROADIES ``` @@ -133,6 +139,8 @@ cd ROADIES ``` docker build -t roadies_image . +``` +``` docker run -it roadies_image ``` @@ -160,6 +168,8 @@ sudo apt-get install -y wget unzip make g++ python3 python3-pip python3-setuptoo ``` git clone https://github.com/TurakhiaLab/ROADIES.git +``` +``` cd ROADIES ``` @@ -167,10 +177,12 @@ cd ROADIES ``` chmod +x roadies_env.sh +``` +``` source roadies_env.sh ``` -After successful setup (Setup complete message), your environment roadies_env will be activated. Proceed to [Quick Start](#start). +After successful setup (Setup complete message), your environment `roadies_env` will be activated. Proceed to [Quick Start](#start). **Note:** If you encounter issues with the Boost library, add its path to `$CPLUS_LIBRARY_PATH` and save it in `~/.bashrc`. @@ -192,11 +204,15 @@ This will save the datasets on a separate `test/test_data` folder within the rep #### IMPORTANT: ROADIES by default runs multiple iterations for generating highly accurate trees. For quick testing, use `--noconverge` to run a single iteration. +**Full run (multiple iterations)** ``` -python run_roadies.py --cores 16 # Full run (multiple iterations) +python run_roadies.py --cores 16 ``` +**OR** + +**Quick test run (one iteration)** ``` -python run_roadies.py --cores 16 --noconverge # Quick test run (one iteration) +python run_roadies.py --cores 16 --noconverge ``` 3. Output: @@ -240,9 +256,11 @@ python run_roadies.py --cores 16 ``` python run_roadies.py --cores 16 --mode accurate - +``` +``` python run_roadies.py --cores 16 --mode balanced - +``` +``` python run_roadies.py --cores 16 --mode fast ``` diff --git a/docs/install.md b/docs/install.md index 70a71752..69558a77 100644 --- a/docs/install.md +++ b/docs/install.md @@ -19,7 +19,11 @@ source ~/.bashrc ```bash conda config --add channels defaults +``` +```bash conda config --add channels bioconda +``` +```bash conda config --add channels conda-forge ``` @@ -29,23 +33,24 @@ Verify the installation by running `conda` in your terminal ```bash conda create -n roadies_env python=3.9 ete3 seaborn +``` +```bash conda activate roadies_env ``` 4. Install ROADIES: ```bash -conda install roadies +conda install roadies=0.1.10 ``` 5. Locate the installed files: ```bash -cd $HOME/miniconda3/envs/roadies_env/ROADIES - +cd $CONDA_PREFIX/ROADIES ``` -Now you are ready to follow the Quick Start section to run the pipeline. +You will be able to find the contents of the repository within this ROADIES folder. Now you are ready to follow the Quick Start section to run the pipeline. ## Option 2: Install via DockerHub @@ -62,7 +67,7 @@ docker pull ang037/roadies:latest docker run -it ang037/roadies:latest ``` -Once you are able to access the ROADIES repository, refer to the Quick Start section to run the pipeline. +These commands will launch the Docker container in interactive mode, with the roadies_env environment activated and the working directory set to the ROADIES repository containing all necessary files. Once you are able to access the ROADIES repository, refer to the Quick Start section to run the pipeline. ## Option 3: Install via Local Docker Build @@ -70,6 +75,8 @@ Once you are able to access the ROADIES repository, refer to the Quick Start sec ```bash git clone https://github.com/TurakhiaLab/ROADIES.git +``` +```bash cd ROADIES ``` @@ -77,6 +84,8 @@ cd ROADIES ```bash docker build -t roadies_image . +``` +```bash docker run -it roadies_image ``` @@ -104,6 +113,8 @@ sudo apt-get install -y wget unzip make g++ python3 python3-pip python3-setuptoo ```bash git clone https://github.com/TurakhiaLab/ROADIES.git +``` +```bash cd ROADIES ``` @@ -111,10 +122,12 @@ cd ROADIES ```bash chmod +x roadies_env.sh +``` +```bash source roadies_env.sh ``` -After successful setup (Setup complete message), your environment roadies_env will be activated. Proceed to Quick Start. +After successful setup (Setup complete message), your environment `roadies_env` will be activated. Proceed to Quick Start. !!! Note If you encounter issues with the Boost library, add its path to `$CPLUS_LIBRARY_PATH` and save it in `~/.bashrc`. diff --git a/docs/quickstart.md b/docs/quickstart.md index c845cce7..e4288fbd 100644 --- a/docs/quickstart.md +++ b/docs/quickstart.md @@ -15,11 +15,15 @@ This will save the datasets on a separate `test/test_data` folder within the rep !!! Note ROADIES by default runs multiple iterations for generating highly accurate trees. For quick testing, use `--noconverge` to run a single iteration. +**Full run (multiple iterations)** ```bash -python run_roadies.py --cores 16 # Full run (multiple iterations) +python run_roadies.py --cores 16 ``` +**OR** + +**Quick test run (one iteration)** ```bash -python run_roadies.py --cores 16 --noconverge # Quick test run (one iteration) +python run_roadies.py --cores 16 --noconverge ``` ## Step 3: Analyze Output: diff --git a/docs/usage.md b/docs/usage.md index be6bf85e..b8e71be4 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -120,7 +120,7 @@ For extensive debugging, other intermediate output files for each stage of the p 7. `ref_dist.csv` - this file provides the iteration number, number of gene trees and the Normalized Robinson-Foulds distance between the final estimated species tree (i.e., `roadies.nwk`) and the reference tree (i.e., REFERENCE parameter in `config.yaml`), for all iterations. 8. `time_stamps.csv`- this file contains the start time in first line, iteration number, number of gene trees required for estimating species tree, end time, and total runtime (in seconds), respectively, for all iterations in subsequent lines. -# Run ROADIES in a multi-node cluster (using SLURM) +# Run ROADIES in a multi-node cluster (using SLURM) (currently being tested) To run ROADIES in a multi-node cluster, make the following changes in the file `workflow/scripts/converge.py` (for `--noconverge` mode - make changes in `workflow/scripts/noconverge.py`)