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.
$ module load tools/hex
~/.bashrc file by adding export HEX_CACHE=$WORK/hex_workHere are the steps to follow:
module load tools/hexvglrun hex
This mode is used to run hex without gui enabled. We are using SGE to execute hex in multicore nodes in batch mode.
hex [-options] [pdbfile(s)]
Say we want to run docking of two structures a.pdb and b.pdb. We will use a macro file dock_ab.mac containing these parameters:
DOCKING_RECEPTOR_SAMPLES 492 DOCKING_LIGAND_SAMPLES 492 DOCKING_ALPHA_SAMPLES 128 RECEPTOR_RANGE_ANGLE 30 LIGAND_RANGE_ANGLE 30 TWIST_RANGE_ANGLE 360 R12_RANGE 21 R12_STEP 0.75 GRID_SIZE 0.6 LIGAND_RANGE_ANGLE 30 RECEPTOR_RANGE_ANGLE 30 DOCKING_MAIN_SCAN 16 DOCKING_MAIN_SEARCH 25 ACTIVATE_DOCKING
We run hex using 2 processors for example:
$ hex -nogui -ncpu 2 a.pdb b.pdb -e dock_ab.mac -l docking_ab.log
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 a.pdb b.pdb -e dock_ab.mac -l docking_ab.log
The final SGE script, to run the command above using 16 cores is :
#!/bin/bash #$ -N Docking #$ -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 $NSLOTS a.pdb b.pdb -e dock_ab.mac -l docking_ab.log
Finally submit the job to SGE:
$ qsub script.sge