annotate README.txt @ 2:f6f9b47d02b6 draft default tip

"planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit 9955c29ac23ce80b2fbfd4082845a7809c8f2121"
author bgruening
date Mon, 13 Apr 2020 10:54:08 -0400
parents de29b4f35536
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
1 THIS TOOL WILL NOT RUN AT PRESENT.
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
2
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
3 The tool is 'work in progress' and needs at least the following sorting out:
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
4
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
5 1. Execution environment
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
6
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
7 Current the xchem_deep_score.py code can be run in the informaticsmatters/deep-app-ubuntu-1604:latest
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
8 container (see instructions at the top of the python file for doing so). The Galaxy execution environment needs
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
9 to define to run as this docker container.
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
10 Alternatively a conda environment could potentially be created but the dependencies are very complex and
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
11 some components need to be built from source.
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
12 Details for the dependencies are mostly described in the GitHub repo for the docker image:
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
13 https://github.com/InformaticsMatters/dls-deep/tree/ubuntu
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
14
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
15 2. GPU availability
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
16
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
17 The code must run in an environment with a GPU and with the CUDA drivers.
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
18 The docker image mentioned above has everything that is needed and will run on a GPU enabled environment
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
19 (a special version of Docker on the host machine is needed that supports GPUs).
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
20
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
21 Only the predictions need a GPU. The prior and latter steps run on CPU. Without a GPU you can specify the --mock
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
22 option which uses random numbers for the predicted scores.
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
23
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
24 3. Associated Python scripts.
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
25
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
26 The docker image contains additional python scripts (primarily /train/fragalysis_test_files/predict.py)
de29b4f35536 "planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/chemicaltoolbox/transfs commit d9a9e2f0e12fe9d2c37f632d99f2164df577b4af"
bgruening
parents:
diff changeset
27 that are needed. If not running in a container these will need to be made available.