@@ -27,87 +27,55 @@ ProTECT is implemented in the [Toil](https://github.com/BD2KGenomics/toil.git) f
2727runs the workflow described in [ protect/Flowchart.txt] (
2828https://github.com/BD2KGenomics/protect/blob/master/Flowchart.txt ).
2929
30+ ** This manual is a quick adaptation for an adaptation of ProTECT to py3**
31+
3032
3133# Installation
3234
3335ProTECT requires Toil and we recommend installing ProTECT and its requirements in a
3436[ virtualenv] ( http://docs.python-guide.org/en/latest/dev/virtualenvs/ ) .
3537
36- ProTECT also requires [ s3am] ( https://github.com/BD2KGenomics/s3am.git ) version 2.0.1 to download and
38+ ~ ProTECT also requires [ s3am] ( https://github.com/BD2KGenomics/s3am.git ) version 2.0.1 to download and
3739upload files from S3. We recommend installing s3am in its own virtualenv using the directions in
3840the s3am manual, then putting the s3am binary on your $PATH. ProTECT will NOT attempt to install
39- s3am during installation.
41+ s3am during installation.~
4042
41- ProTECT uses pkg_resources from setuptools to verify versions of tools during install. As of setuptools
42- 39.0.1, some modules were moved to the packaging module. If your machine has setuptools >=39.0.1, you
43- will need the packaging module.
43+ currently WIP. for now, ** only references to local files will work** . anything that requires access to s3am (s3 buckets) will ** fail** .
4444
4545Lastly, ProTECT uses [ docker] ( https://www.docker.com/ ) to run the various sub-tools in a
4646reproducible, platform independent manner. ProTECT will NOT attempt to install docker during
4747installation.
4848
49- ### Method 1 - Using PIP (recommended)
50-
51- First create a virtualenv at your desired location (Here we create it in the folder ~ /venvs)
52-
53- virtualenv ~/venvs/protect
54-
55- Activate the virtualenv
56-
57- source ~/venvs/protect/bin/activate
58-
59- NOTE: Installation was tested using pip 7.1.2 and 8.1.1. We have seen issues with the installation
60- of pyYAML with lower versions of pip and recommend upgrading pip before installing ProTECT.
61-
62- pip install --upgrade pip
63-
64- Install Toil
65-
66- pip install toil[aws]==3.5.2
67-
68- Install packaging (required if setuptools>=39.0.1)
69-
70- pip install packaging
71-
72- Install ProTECT and all dependencies in the virtualenv
73-
74- pip install protect
75-
49+ ~ Method 1 - Using PIP (recommended)~
7650### Method 2 - Installing from Source
7751
7852This will install ProTECT in an editable mode.
7953
8054Obtain the source from Github
8155
82- git clone https://www.github.com/BD2KGenomics /protect.git
56+ git clone https://www.github.com/Dranion /protect.git
8357
8458Create and activate a virtualenv in the project folder (Important since the Makefile checks for
8559this and will fail if it detects that you are not in a virtual environment)
8660
8761 cd protect
88- virtualenv venv
62+ virtualenv --python=python3 venv
8963 source venv/bin/activate
9064
9165Install Toil and pytest
9266
9367 make prepare
9468
95- Install packaging (required if setuptools>=39.0.1)
69+ Install the python3 conversion of bd2k and s3am. * s3am is untested as I am running locally *
9670
97- pip install packaging
71+ make special_install
9872
9973Install ProTECT
10074
10175 make develop
10276
103- ## Method 3 - Using Docker
77+ ~ Method 3 - Using Docker~
10478
105- Dockerized versions of ProTECT releases can be found at https://quay.io/organization/ucsc_cgl . These
106- Docker containers run the ProTECT pipeline in single machine mode. The only difference between the
107- Docker and Python versions of the pipeline is that the Docker container takes the config options,
108- described below, as command line arguments as opposed to a config file. Running the container
109- without any arguments will list all the available options. Also, currently the dockerized version of
110- ProTECT only supports local file export.
11179
11280# Running ProTECT
11381
@@ -173,7 +141,7 @@ in the pipeline, and the information on the input samples. Elements before a `:`
173141dictionary read into ProTECT and should ** NOT** be modified (Barring the patient ID key in the
174142patients dictionary). Only values to the right of the ` : ` should be edited.
175143
176- Every required reference file is provided in the AWS bucket ` cgl-pipeline-inputs ` under the folder
144+ Every required reference file is provided in the AWS bucket ` protect-data ` under the folder
177145` protect/hg19_references ` or ` protect/hg38_references ` . The ` README ` file in the same location
178146describes in detail how each file was generated. To use a file located in an s3 bucket, replace
179147` /path/to ` in the following descriptions with ` s3://<databucket>/<folder_in_bucket> ` .
@@ -547,7 +515,7 @@ purposes:
547515 12: g/f/jobO4yiE4 return self.run(fileStore)
548516 13: g/f/jobO4yiE4 File "/home/ucsc/arjun/tools/dev/toil_clean/src/toil/job.py", line 1406, in run
549517 14: g/f/jobO4yiE4 rValue = userFunction(*((self,) + tuple(self._args)), **self._kwargs)
550- 15: g/f/jobO4yiE4 File "/home/ucsc/arjun/tools/protect_toil_clean/local/lib/python2.7 /site-packages/protect/binding_prediction/common.py", line 566, in merge_mhc_peptide_calls
518+ 15: g/f/jobO4yiE4 File "/home/ucsc/arjun/tools/protect_toil_clean/local/lib/python3 /site-packages/protect/binding_prediction/common.py", line 566, in merge_mhc_peptide_calls
551519 16: g/f/jobO4yiE4 raise RuntimeError('No peptides available for ranking')
552520 17: g/f/jobO4yiE4 RuntimeError: No peptides available for ranking
553521 18: g/f/jobO4yiE4 ERROR:toil.worker:Exiting the worker because of a failed job on host sjcb10st7
@@ -581,9 +549,9 @@ do not store logs from tools (see BD2KGenomics/protect#275). The error looks sim
581549 Z/O/job1uH92D return self.run(fileStore)
582550 Z/O/job1uH92D File "/home/ucsc/arjun/tools/dev/toil_clean/src/toil/job.py", line 1406, in run
583551 Z/O/job1uH92D rValue = userFunction(*((self,) + tuple(self._args)), **self._kwargs)
584- Z/O/job1uH92D File "/home/ucsc/arjun/tools/protect_toil_clean/local/lib/python2.7 /site-packages/protect/mutation_calling/radia.py", line 238, in run_filter_radia
552+ Z/O/job1uH92D File "/home/ucsc/arjun/tools/protect_toil_clean/local/lib/python3 /site-packages/protect/mutation_calling/radia.py", line 238, in run_filter_radia
585553 Z/O/job1uH92D tool_version=radia_options['version'])
586- Z/O/job1uH92D File "/home/ucsc/arjun/tools/protect_toil_clean/local/lib/python2.7 /site-packages/protect/common.py", line 138, in docker_call
554+ Z/O/job1uH92D File "/home/ucsc/arjun/tools/protect_toil_clean/local/lib/python3 /site-packages/protect/common.py", line 138, in docker_call
587555 Z/O/job1uH92D 'for command \"%s\"' % ' '.join(call),)
588556 Z/O/job1uH92D RuntimeError: docker command returned a non-zero exit status (1)for command "docker run --rm=true -v /scratch/bio/ucsc/toil-681c097c-61da-4687-b734-c5051f0aa19f/tmped2fnu/f041f939-5c0d-40be-a884-68635e929d09:/data --log-driver=none aarjunrao/filterradia:bcda721fc1f9c28d8b9224c2f95c440759cd3a03 TCGA-CH-5788 17 /data/radia.vcf /data /home/radia/scripts -d /data/radia_dbsnp -r /data/radia_retrogenes -p /data/radia_pseudogenes -c /data/radia_cosmic -t /data/radia_gencode --noSnpEff --noBlacklist --noTargets --noRnaBlacklist -f /data/hg38.fa --log=INFO -g /data/radia_filtered_chr17_radia.log"
589557 Z/O/job1uH92D ERROR:toil.worker:Exiting the worker because of a failed job on host sjcb10st1
0 commit comments