====== 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_a_distance]].
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 ''~/.bashrc'' file by adding ''export HEX_CACHE=$WORK/hex_work''
Here are the steps to follow:
- Request a remote GPU session: 3dession
- open a VNC session as explained [[visualisation_a_distance|here]]
- in the remote desktop open a terminal and load hex: ''module load tools/hex''
- and finally run hex: ''vglrun hex''
{{:hex.png|}}
===== 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.
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
**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 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