IPSSA (Integrated Positively Selected Sites Analyses) is a Compi pipeline to automatically identify positively selected amino acid sites using three different methods, namely CodeML, omegaMap, and FUBAR. Moreover, it looks for evidence of recombination in the data. A Docker image is available for this pipeline in this Docker Hub repository.
Warning
This image runs Docker in Docker. Users that are already running Docker 29 should start using the image with the `pegi3s/ipssa:1.2.6`, while users that did not yet update their Docker version to Docker 29 should use the image with the `pegi3s/seda:1.2.5` tag. Starting with version `pegi3s/ipssa:1.2.5-docker29.0.1`, from now on, only images that are compatible with Docker 29 or above will be released. You can check your Docker version by running the command: `docker --version`.
IPSSA (Integrated Positively Selected Sites Analyses) is a Compi pipeline to automatically identify positively selected amino acid sites using three different methods, namely CodeML, omegaMap, and FUBAR. Moreover, it looks for evidence of recombination in the data.
IPSSA applies the same steps to each input FASTA file separately. This process comprises:
In order to use the IPSSA image, create first a directory in your local file system (ipssa_project in the example) with the following structure:
ipssa_project/
├── input
│ ├── 1.fasta
│ ├── 2.fasta
│ ├── .
│ ├── .
│ ├── .
│ └── n.fasta
└── ipssa-project.params
Where:
ipssa_project/input directory.ipssa_project/ipssa-project.params.Once this structure and files are ready, you should run and adapt the following commands to run the entire pipeline using the default parameters (i.e. without a Compi parameters file). Here, you only need to set PROJECT_DIR to the right path in your local file system and COMPI_NUM_TASKS to the maximum number of parallel tasks that can be run. Pipeline parameters can be added at the end of the pipeline (e.g. --sequence_limit 10). Note that the --host_working_dir is mandatory and must point to the pipeline working directory in the host machine.
PROJECT_DIR=/path/to/ipssa_project
COMPI_NUM_TASKS=6
PIPELINE_WORKING_DIR=${PROJECT_DIR}/pipeline_working_dir
INPUT_DIR=${PROJECT_DIR}/input
# Run with default parameter values
docker run -v /tmp:/tmp -v /var/run/docker.sock:/var/run/docker.sock -v ${PIPELINE_WORKING_DIR}:/working_dir -v ${INPUT_DIR}:/input --rm pegi3s/ipssa -o --logs /working_dir/logs --num-tasks ${COMPI_NUM_TASKS} -- --host_working_dir ${PIPELINE_WORKING_DIR}
If you want to specify the pipeline parameters using a Compi parameters file, you should run and adapt the following commands. These are the same commands as above but with the addition of the PARAMS_DIR variable.
An example of a Compi parameters file can be obtained running the following command: docker run --rm --entrypoint cat pegi3s/ipssa /resources/ipssa-project.params.
This parameters file contains the default values recommended for running IPSSA. Please, note that you must update the value of the host_working_dir parameter in this file before using it.
PROJECT_DIR=/path/to/ipssa_project
COMPI_NUM_TASKS=6
PIPELINE_WORKING_DIR=${PROJECT_DIR}/pipeline_working_dir
INPUT_DIR=${PROJECT_DIR}/input
PARAMS_DIR=${PROJECT_DIR}
docker run -v /tmp:/tmp -v /var/run/docker.sock:/var/run/docker.sock -v ${PIPELINE_WORKING_DIR}:/working_dir -v ${INPUT_DIR}:/input -v ${PARAMS_DIR}:/params --rm pegi3s/ipssa -o --logs /working_dir/logs --num-tasks ${COMPI_NUM_TASKS} -pa /params/ipssa-project.params
Some tasks may produce errors that do not cause the pipeline to fail, but they can be important. Such errors are reported in the log files produced in the logs directory of the pipeline working directory. The find-error-tasks.sh script of the pegi3s/ipssa Docker image displays the errored tasks (i.e. those containing the word error in their log files) along with the names of the corresponding input files. Run the following command to find them (assuming the environment variables with the project and working directory paths have been declared):
docker run --entrypoint /opt/scripts/find-error-tasks.sh -v ${PIPELINE_WORKING_DIR}:/working_dir -v ${INPUT_DIR}:/input --rm pegi3s/ipssa /working_dir/logs /input /working_dir/run_lists
To re-run the pipeline in the same project directory, run the following command first in order to clean the pipeline working directory:
sudo rm -rf ${PIPELINE_WORKING_DIR}
These are the pipeline parameters:
sequence_limit: The maximum number of sequences to use for the master file. The default value is 90.random_seed: The random seed.align_method: The alignment method to use, one of: clustalw, muscle, kalign, t_coffee, or amap. The default value is muscle.tcoffee_min_score: The minimum support value for alignment positions. The default value is 3.mrbayes_generations: The number of iterations in MrBayes. The default value is 1000000.mrbayes_burnin: The MrBayes burnin. The default value is 2500.fubar_sequence_limit: The maximum number of sequences to be used by FUBAR. The default value is 90.fubar_runs: The number of independent replicas for FUBAR. The default value is 1.codeml_sequence_limit: The maximum number of sequences to be used by CodeML. The default value is 30.codeml_runs: The number of independent replicas for CodeML. The default value is 1.codeml_models: The CodeML models to be run, one or more of: 1, 2, 7, and/or 8. To declare more than one model use a blank space between models. The default value is 1 2 7 8.omegamap_sequence_limit: The maximum number of sequences to be used by omegaMap. The default value is 90.omegamap_iterations: The number of omegaMap iterations. the default value is 1.omegamap_runs: The number of independent replicas for omegaMap. The default value is 2500.omegamap_recomb: A flag indicating if omegaMap must be executed only if recombination is detected in the master file. By default, the flag is not present and thus omegaMap is executed (if omegamap_iterations > 0).The sample data is available here. Download and uncompress it, and move to the directory named ipssa-m-leprae, where you will find:
ipssa-m-leprae-project, that contains the structure described previously.run.sh, that contains the following commands (where you should adapt the PROJECT_DIR path) to test the pipeline:PROJECT_DIR=/path/to/ipssa-m-leprae-project
COMPI_NUM_TASKS=8
PIPELINE_WORKING_DIR=${PROJECT_DIR}/pipeline_working_dir
INPUT_DIR=${PROJECT_DIR}/input
PARAMS_DIR=${PROJECT_DIR}
docker run -v /tmp:/tmp -v /var/run/docker.sock:/var/run/docker.sock -v ${PIPELINE_WORKING_DIR}:/working_dir -v ${INPUT_DIR}:/input -v ${PARAMS_DIR}:/params --rm pegi3s/ipssa -o --logs /working_dir/logs --num-tasks ${COMPI_NUM_TASKS} -pa /params/ipssa-project.params
To build the Docker image, compi-dk is required. Once you have it installed, simply run compi-dk build from the project directory to build the Docker image. The image will be created with the name specified in the compi.project file (i.e. pegi3s/ipssa:latest). This file also specifies the version of compi that goes into the Docker image.
Content type
Image
Digest
sha256:37f3f09b1…
Size
256.4 MB
Last updated
10 months ago
docker pull pegi3s/ipssa