Différences

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

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
hex [2017/02/15 09:36] – [How to use it] adminhex [2017/02/22 14:43] (Version actuelle) – admin
Ligne 10: Ligne 10:
  
 ====== How to use it? ====== ====== How to use it? ======
 +
 +===== Interactive mode  =====
 +
  
 <note> <note>
 Hex is used in interactive mode with remote visualization capability with GPU [[visualisation_a_distance]].</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 : 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   - in your WORK create a directory named hex_work: mkdir hex_work
-  - append your ''~/.bashrc'' file by adding ''export HEX_CACHE=$WORK/hex_work'' +  - append your ''~/.bashrc'' file by adding ''export HEX_CACHE=$WORK/hex_work'' 
 + 
 +</note> 
    
  
Ligne 28: Ligne 33:
  
 {{:hex.png|}} {{: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.1487151365.txt.gz
  • Dernière modification : 2017/02/15 09:36
  • de admin