Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision
Révision précédente
hex [2017/02/15 09:27] – créée adminhex [2017/02/22 14:43] (Version actuelle) – admin
Ligne 9: Ligne 9:
 </code> </code>
  
-====== How to use it ======+====== How to use it? ======
  
-Hex is used in interactive mode with remote visualization capability with GPU [[visualisation_a_distance]]. +===== Interactive mode  =====
  
  
 +<note>
 +Hex is used in interactive mode with remote visualization capability with GPU [[visualisation_a_distance]].</note> 
 +
 +<note important>
 +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''
 +
 +</note> 
    
 +
 +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.
 +
 +<code bash>
 +hex [-options] [pdbfile(s)]
 +</code>
 +
 +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:
 +
 +<file bash dock_ab.mac>
 +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
 +</file>
 +
 +We run ''hex'' using 2 processors for example:
 +
 +<code bash >
 +$ hex -nogui -ncpu 2 a.pdb  b.pdb -e dock_ab.mac -l docking_ab.log
 +</code>
 +
 +
 +
 +<note important>**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):
 +</note>
 +
 +
 +<code bash>
 +$ singularity exec $SING_SPOOL/ubuntu-16.img hex -nogui -ncpu 2 a.pdb b.pdb -e dock_ab.mac -l docking_ab.log
 +</code>
 +
 +The final SGE script, to run the command above using 16 cores is :
 +<file bash script.sge>
 +#!/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
 +
 +</file>
 +
 +Finally submit the job to SGE:
 +<code bash>
 +$ qsub script.sge
 +</code> 
 +
  • hex.1487150839.txt.gz
  • Dernière modification : 2017/02/15 09:27
  • de admin