Professor is hosted by Hepforge, IPPP Durham

Professor2 and Docker

This page briefly describes how to set up and use professor in 3 simple steps.

Downloading the image

Our releases are readily available as docker image from dockerhub. To pull the image use this command:

docker pull iamholger/professor:2.2.1

Mounting the current directory and run parametrisation and tuning

The following shows how to set up aliases to conventiently use prof2-commands. At the same time, the current directory is mounted into the container with read/write permissions thus allowing to work with local files.

alias prof2-ipol='docker run -it  --rm -u `id -u $USER`  -v $PWD:$PWD -w $PWD docker.io/iamholger/professor:2.2.1 prof2-ipol'
alias prof2-residuals='docker run -it  --rm -u `id -u $USER`  -v $PWD:$PWD -w $PWD docker.io/iamholger/professor:2.2.1 prof2-residuals'
alias prof2-tune='docker run -it  --rm -u `id -u $USER`  -v $PWD:$PWD -w $PWD docker.io/iamholger/professor:2.2.1 prof2-tune'

Try out:

prof2-ipol --help

To run the parametrisation on an existing set of files (contained in the local folder scan/)you can do:

prof2-ipol --order 4 scan/
prof2-residuals scan/

To run the minimisation step using a folder data/ that contains reference data, the following command can now be used:

prof2-tune data/

For further command line options etc please have a look at the documentation.

Troubleshooting directory permission

Although the -u option to docker should be sufficient, some systems require and additional flag --privileged to allow read/write permissions for home directories.

In cases where 'permission denied' messages appear or messages from prof2-ipol like this

Not enough runs for order 3 polynomials --- would require 1

the aliases above need to be modified to

alias prof2-ipol='docker run -it  --rm --privileged -v $PWD:$PWD -w $PWD docker.io/iamholger/professor:2.2.1 prof2-ipol'
alias prof2-residuals='docker run -it  --rm --privileged -v $PWD:$PWD -w $PWD docker.io/iamholger/professor:2.2.1 prof2-residuals'
alias prof2-tune='docker run -it  --rm -u --privileged -v $PWD:$PWD -w $PWD docker.io/iamholger/professor:2.2.1 prof2-tune'
Last modified 8 months ago Last modified on Feb 3, 2017, 1:10:26 PM