Docker¶
The fastest way to try out tcrdist3 is to use our Docker image.
If you run Linux, we assume you know how to use Docker. If you use a Mac or Windows machine, you will need to download Docker Desktop in order to run a Docker container.
Running a Container¶
Run a container iteractively (flag -it):
docker run -it quay.io/kmayerb/tcrdist3:0.1.9
The tcrdist3 image runs Python 3.8 and IPython, so the fastest way to try things out is to run IPython and copy and paste the code snippets on this doc page. It’s easy to copy a file from inside a running Docker container to your host machine, but remember once you exit a container your files don’t persist.
Mounting Files¶
Tip
Mounting your docker container to a working director is easy. (For more on this see Docker for the busy researcher)
docker run -v ${HOME}/mydata/:/yourdata/ -it quay.io/kmayerb/tcrdist3:0.1.9
ls data
Copying Files¶
You can also copy a file out of running container if you forget to mount a shared folder.
"""
find the container ID
"""
docker ps
"""
CONTAINER ID IMAGE COMMAND
3a51162eb585 quay.io/kmayerb/tcrdist3:0.1.9 "/bin/bash"
"""
docker cp 3a51162eb585:hierdiff_example_PA_v_PB1.html hierdiff_example_PA_v_PB1.html