Ceci est une ancienne révision du document !
Hex
Hex is an interactive protein docking and molecular superposition program, written by Dave Ritchie. Hex understands protein and DNA structures in PDB format, and it can also read small-molecule SDF files.
Installed version
- 8.0.0 with CUDA (from binary distribution files)
$ module load tools/hex
How to use it?
Interactive mode
Hex is used in interactive mode with remote visualization capability with GPU Visualisation à distance HPC.
Before starting using Hex, we need to create a cache directory in WORK folder :
- in your WORK create a directory named hex_work: mkdir hex_work
- append your
~/.bashrcfile by addingexport HEX_CACHE=$WORK/hex_work
Here are the steps to follow:
- Request a remote GPU session: 3dession
- open a VNC session as explained here
- in the remote desktop open a terminal and load hex:
module load tools/hex - and finally run hex:
vglrun hex
Batch mode
This mode is used to run hex without gui enabled. We are using SGE to execute hex in multicore nodes in batch mode.
Here is the list of available options for command line interface:
hex [-options] [pdbfile(s)] where options may be a combination of: -v# (where # is a version number/string - e.g. 4f, 5a) -ncpu n (where n is the number of CPUs to use) -ngpu n (where n is the number of GPUs to use) -nogui don't use gui interface -nice n (runs at lower priority: n a "nice" value) -cuda (request program with CUDA support; the default) -nocuda (request program with no CUDA support) -kill (try to kill any stuck Hex jobs) -g (run within a debugger such as gdb) -debug (print debugging messages; another -debug adds more) -noexec (don't put a batch run in the background) -gui (force GUI mode even when stdin is not a terminal) -stereo (request a stereographic window) -s (same as -stereo) -nostereo (request a non-stereographic window) -nos (same as -nostereo) -messages (write messages to a separate window - the default) -nomessages (write messages to standard output, not separate window) -stdout (same as -nomessages) -log logfile (or -l, write log of entire session to file) -l logfile (same as -log) -pdb pdbfiles (load up to 3 PDB files to be displayed) -browse (same as -pdb, but forces interactive mode for browser) -noligand (treat two PDB files as receptor + complex) -2 (short form of -noligand: superposes two molecules) -pos (position ligand near receptor - the default) -nopos (don't mess with ligand coordinates) -e macfile(s) (execute up to 3 macro files)
For example, docking with macros file using 2 cores:
$ hex -nogui -ncpu 2 r.pdb c.pdb -e docking_job.mac -l docking_job.log
BUT Since
Hex binary are compiled for ubuntu like distribution we will use a container (singularity) to run hex.
Typically, we run hex inside singularity like this (example taken from hex website):
$ singularity exec SING_SPOOL/ubuntu-16.img hex -nogui -ncpu 2 r.pdb c.pdb -e docking_job.mac -l docking_job.log
The final SGE script, to run the command above using 16 cores:
#!/bin/bash #$ -q all.q #$ - pe openmp 16 ## we request 16 cores ## We load singularity module module load tools/singularity ## run hex inside singularity singularity exec SING_SPOOL/ubuntu-16.img hex -nogui -ncpu 16 r.pdb c.pdb -e docking_job.mac -l docking_job.log
