Beast-Sapelo2: Difference between revisions

From Research Computing Center Wiki
Jump to navigation Jump to search
No edit summary
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:Sapelo2old]][[Category:Software]][[Category:Bioinformatics]]   
[[Category:Sapelo2]][[Category:Software]][[Category:Bioinformatics]]   
=== Category ===
=== Category ===


Line 10: Line 10:
=== Version ===
=== Version ===


1.10.4, 2.6.2, 2.6.3
1.10.4, 2.5.1, 2.6.3, 2.7.3, 2.7.5


=== Author / Distributor ===
=== Author / Distributor ===
Line 26: Line 26:


=== Running Program ===
=== Running Program ===
====Versions with CPU support====


* version 1.10.4, installed in /apps/eb/Beast/1.10.4-GCC-8.3.0. This version of Beast is using beagle-lib v3.0.1 with CPU support.
====Versions without GPU support====
 
* version 1.10.4 installed in /apps/eb/Beast/1.10.4-GCC-11.3.0


To use this version of Beast, please first load the module with  
To use this version of Beast, please first load the module with  
<pre class="gscript">
<pre class="gscript">
module load Beast/1.10.4-GCC-8.3.0
module load Beast/1.10.4-GCC-11.3.0
</pre>
</pre>
 
*version 2.5.1 installed in /apps/eb/Beast/2.5.1-GCC-11.3.0
* version 2.6.2, installed in /apps/eb/Beast/2.6.2-GCC-8.3.0. This version of Beast is using beagle-lib v3.0.1 with CPU support.


To use this version of Beast, please first load the module with  
To use this version of Beast, please first load the module with  
<pre class="gscript">
<pre class="gscript">
module load Beast/2.6.2-GCC-8.3.0
module load Beast/2.5.1-GCC-11.3.0
</pre>
</pre>
 
* version 2.7.5 installed in /apps/eb/Beast/2.7.5-GCC-11.3.0
* version 2.6.3, installed in /apps/eb/Beast/2.6.3-foss-2019b. This version of Beast is using beagle-lib v3.0.1 with CPU support.


To use this version of Beast, please first load the module with  
To use this version of Beast, please first load the module with  
<pre class="gscript">
<pre class="gscript">
module load Beast/2.6.3-foss-2019b
module load Beast/2.7.5-GCC-11.3.0
</pre>
</pre>


====Versions with CPU and GPU support====


Beast is a X window program with graphic interface. It has to be run in an interactive session. Please refer to [[Running_Jobs_on_Sapelo2#How_to_open_an_interactive_session | Run interactive Jobs]] and [[Running_Jobs_on_Sapelo2#How_to_run_an_interactive_job_with_Graphical_User_Interface_capabilities | Run X window Jobs]].
* version 1.10.4 with CPU and GPU support, installed in /apps/eb/Beast/1.10.4-GCC-11.3.0-CUDA-11.4.1. This version of Beast is using beagle-lib/3.1.2 with GPU support.


Start X Terminal (Mac), X window (Windows) at the local computer first, then
To use this version of Beast, please first load the module with
<pre class="gscript">
module load Beast/1.10.4-GCC-11.3.0-CUDA-11.4.1
</pre>
* version 2.6.3 with CPU and GPU support, installed in /apps/eb/Beast/2.6.3-foss-2021b-CUDA-11.4.1/. This version of Beast is using beagle-lib/4.0.0 with GPU support.


<pre class="gcommand">
To use this version of Beast, please first load the module with
xqlogin
<pre class="gscript">
module load Beast/2.4.8pre-foss-2016b
module load Beast/2.6.3-foss-2021b-CUDA-11.4.1
beauti
...
beast
...
exit
</pre>
</pre>
* version 2.7.3 with CPU and GPU support, installed in /apps/eb/Beast/2.7.3-foss-2021b-CUDA-11.4.1/. This version of Beast is using beagle-lib/4.0.0 with GPU support.


* beast/beauti in this app is set to 64GB max memory. If larger memory needed, please contact us.
To use this version of Beast, please first load the module with  
 
====Run Beast with CPU support====
 
Example job submission script (bt-CPU.sh) to run version 2.4.8pre in a batch job:
 
<pre class="gscript">
<pre class="gscript">
#PBS -S /bin/bash
module load Beast/2.7.3-foss-2021b-CUDA-11.4.1
#PBS -q batch
</pre>
#PBS -l nodes=1:ppn=4
#PBS -l walltime=480:00:00
#PBS -l mem=80gb
 
cd $PBS_O_WORKDIR


module load Beast/2.4.8pre-foss-2016b
====Run Beast in an interactive session====


beast -threads 4 [options]
Beast is a X window program with graphic interface. It has to be run in an interactive session. Please refer to [[OnDemand#X%20Desktop%20Session%20.28A.K.A.%20The%20Interactive%20X%20login%20app.29|X Desktop Sessions]] in [https://ondemand.gacrc.uga.edu/pun/sys/dashboard/ Open OnDemand].
</pre>


Example of submission to the queue:
# Start an [[OnDemand#X%20Desktop%20Session%20.28A.K.A.%20The%20Interactive%20X%20login%20app.29|X Desktop Session]] via Open OnDemand
<pre  class="gcommand">
# Open the Terminal application in your X Desktop session (icon at the bottom of the Desktop or via the "Applications" button in the top left)
qsub bt-CPU.sh
# <code>ml Beast/2.7.3-foss-2021b-CUDA-11.4.1</code>  
</pre>
# <code>beauti</code> ...
# <code>beast</code> ...


where [options] need to be replaced by the options (command and arguments) you want to use. Other parameters of the job, such as the maximum wall clock time, maximum memory, the number of cores per node, and the job name need to be modified appropriately as well.
* beast/beauti in this app is set to '''16GB''' max heap memory. If larger memory is needed, please contact us.


====Run Beast with GPU support====
====Run Beast with GPU support in a batch job====


Example job submission script (bt-GPU.sh) to run version 2.5.0 in a batch job:
Example job submission script (sub.sh) to run version 2.6.3 with GPU support in a batch job:


<pre class="gscript">
<pre class="gscript">
#PBS -S /bin/bash
#!/bin/bash
#PBS -q gpu_q
#SBATCH --job-name=testBeast-GPU
#PBS -l nodes=1:ppn=2:gpus=1:default
#SBATCH --partition=gpu_p
#PBS -l walltime=240:00:00
#SBATCH --gres=gpu:A100:1
#PBS -l mem=80gb
#SBATCH --nodes=1
#SBATCH --ntasks=1
#SBATCH --cpus-per-task=4
#SBATCH --mem=20gb
#SBATCH --time=120:00:00
#SBATCH --output=log.%j.out
#SBATCH --error=log.%j.err
#SBATCH --mail-user=username@uga.edu 
#SBATCH --mail-type=ALL 


cd $PBS_O_WORKDIR
cd $SLURM_SUBMIT_DIR


module load Beast/2.5.0-foss-2018a
ml Beast/2.7.3-foss-2021b-CUDA-11.4.1


beast -beagle_GPU [options]
beast -threads 4 -beagle -beagle_GPU [options]
</pre>  
</pre>
 
where [options] need to be replaced by the options (command and arguments) you want to use. Other parameters of the job, such as the maximum wall clock time, maximum memory, the number of cores per node, and the job name need to be modified appropriately as well. You need to use #SBATCH --gres=gpu:A100:1 to run the job on a A100 GPU node.


Example of submission to the queue:
Example of submission to the queue:
<pre  class="gcommand">
<pre  class="gcommand">
qsub bt-GPU.sh
sbatch sub.sh
</pre>
</pre>
where [options] need to be replaced by the options (command and arguments) you want to use.  Other parameters of the job, such as the maximum wall clock time, maximum memory, the number of cores per node, and the job name need to be modified appropriately as well. Note that Beast runs multiple processes concurrently on the GPU device, so it is important to select  the "Default" GPU compute mode, as it is done on line 3 of this sample script.


=== Documentation ===
=== Documentation ===
 
<pre class="gcommand">ml Beast/2.7.3-foss-2021b-CUDA-11.4.1
<pre class="gcommand">  
module load Beast/2.4.8pre-foss-2016b
beast -help
beast -help
Checking out /home/pakala/.beast/2.4/BEAST/lib
   Usage: beast [-window] [-options] [-working] [-seed] [-prefix <PREFIX>] [-statefile <STATEFILE>] [-overwrite] [-resume] [-validate] [-errors <i>] [-threads <i>] [-java] [-noerr] [-loglevel <LEVEL>] [-instances <i>] [-beagle] [-beagle_info] [-beagle_order <order>] [-beagle_CPU] [-beagle_GPU] [-beagle_SSE] [-beagle_single] [-beagle_double] [-beagle_scaling <default|none|dynamic|always>] [-help] [-version] [-strictversions] [-D <DEFINITIONS>] [-DF <DEFINITIONFILE>] [-DFout <DEFINITIONRESULTFILE>] [-sampleFromPrior] [-version_file <VERSIONFILE>] [-packagedir <PACKAGEDIR>] [<input-file-name>]
jardir = /usr/local/apps/eb/Beast/2.4.8pre-foss-2016b/lib/launcher.jar
Checking out /usr/local/apps/eb/Beast/2.4.8pre-foss-2016b/lib
Loaded URL file:/usr/local/apps/eb/Beast/2.4.8pre-foss-2016b/lib/beast.jar
Loading package BEAST v2.4.8
   Usage: beast [-window] [-options] [-working] [-seed] [-prefix <PREFIX>] [-statefile <STATEFILE>] [-overwrite] [-resume] [-validate] [-errors <i>] [-threads <i>] [-java] [-noerr] [-loglevel <LEVEL>] [-instances <i>] [-beagle] [-beagle_info] [-beagle_order <order>] [-beagle_CPU] [-beagle_GPU] [-beagle_SSE] [-beagle_single] [-beagle_double] [-beagle_scaling <default|none|dynamic|always>] [-help] [-version] [-strictversions] [<input-file-name>]
     -window Provide a console window
     -window Provide a console window
     -options Display an options dialog
     -options Display an options dialog
Line 155: Line 145:
     -version Print version and stop
     -version Print version and stop
     -strictversions Use only package versions as specified in the 'required' attribute
     -strictversions Use only package versions as specified in the 'required' attribute
    -D attribute-value pairs to be replaced in the XML, e.g., -D "arg1=10,arg2=20"
    -DF as -D, but attribute-value pairs defined in file in JSON format
    -DFout BEAST XML file written when -DF option is used
    -sampleFromPrior samples from prior for MCMC analysis (by adding sampleFromPrior="true" in the first run element)
    -version_file Provide a version file containing a list of services to explicitly allow. (Useful for package development.)
    -packagedir Set user package directory instead of using the default


   Example: beast test.xml
   Example: beast test.xml
   Example: beast -window test.xml
   Example: beast -window test.xml
   Example: beast -help
   Example: beast -help
ml Beast/2.7.3-foss-2021b-CUDA-11.4.1
beast -beagle_info
                        BEAST v2.7.3, 2002-2022
            Bayesian Evolutionary Analysis Sampling Trees
                      Designed and developed by
Remco Bouckaert, Alexei J. Drummond, Andrew Rambaut & Marc A. Suchard
                                   
                  Centre for Computational Evolution
                        University of Auckland
                      r.bouckaert@auckland.ac.nz
                        alexei@cs.auckland.ac.nz
                                   
                  Institute of Evolutionary Biology
                        University of Edinburgh
                          a.rambaut@ed.ac.uk
                                   
                    David Geffen School of Medicine
                University of California, Los Angeles
                          msuchard@ucla.edu
                                   
                      Downloads, Help & Resources:
                          http://beast2.org/
                                   
  Source code distributed under the GNU Lesser General Public License:
                  http://github.com/CompEvol/beast2
                                   
                          BEAST developers:
  Alex Alekseyenko, Trevor Bedford, Erik Bloomquist, Joseph Heled,
Sebastian Hoehna, Denise Kuehnert, Philippe Lemey, Wai Lok Sibon Li,
Gerton Lunter, Sidney Markowitz, Vladimir Minin, Michael Defoin Platel,
          Oliver Pybus, Tim Vaughan, Chieh-Hsi Wu, Walter Xie
                                   
                              Thanks to:
          Roald Forsberg, Beth Shapiro and Korbinian Strimmer
--- BEAGLE RESOURCES ---
0 : CPU (x86_64)
    Flags: PRECISION_SINGLE PRECISION_DOUBLE COMPUTATION_SYNCH EIGEN_REAL EIGEN_COMPLEX SCALING_MANUAL SCALING_AUTO SCALING_ALWAYS SCALERS_RAW SCALERS_LOG VECTOR_SSE VECTOR_NONE THREADING_NONE PROCESSOR_CPU FRAMEWORK_CPU
1 : NVIDIA A100-SXM4-80GB
    Global memory (MB): 81051
    Clock speed (Ghz): 1.41
    Number of cores: 13824
    Flags: PRECISION_SINGLE PRECISION_DOUBLE COMPUTATION_SYNCH COMPUTATION_ASYNCH EIGEN_REAL EIGEN_COMPLEX SCALING_MANUAL SCALING_AUTO SCALING_ALWAYS SCALERS_RAW SCALERS_LOG VECTOR_NONE THREADING_NONE PROCESSOR_GPU FRAMEWORK_CUDA
</pre>
</pre>



Latest revision as of 09:10, 12 July 2024

Category

Bioinformatics

Program On

Sapelo2

Version

1.10.4, 2.5.1, 2.6.3, 2.7.3, 2.7.5

Author / Distributor

BEAST2 BEAST

Description

BEAST is a cross-platform program for Bayesian MCMC analysis of molecular sequences. It is entirely orientated towards rooted, time-measured phylogenies inferred using strict or relaxed molecular clock models. It can be used as a method of reconstructing phylogenies but is also a framework for testing evolutionary hypotheses without conditioning on a single tree topology. BEAST uses MCMC to average over tree space, so that each tree is weighted proportional to its posterior probability. More information: http://beast2.org/; http://beast.community/

Running Program

Versions without GPU support

  • version 1.10.4 installed in /apps/eb/Beast/1.10.4-GCC-11.3.0

To use this version of Beast, please first load the module with

module load Beast/1.10.4-GCC-11.3.0
  • version 2.5.1 installed in /apps/eb/Beast/2.5.1-GCC-11.3.0

To use this version of Beast, please first load the module with

module load Beast/2.5.1-GCC-11.3.0
  • version 2.7.5 installed in /apps/eb/Beast/2.7.5-GCC-11.3.0

To use this version of Beast, please first load the module with

module load Beast/2.7.5-GCC-11.3.0

Versions with CPU and GPU support

  • version 1.10.4 with CPU and GPU support, installed in /apps/eb/Beast/1.10.4-GCC-11.3.0-CUDA-11.4.1. This version of Beast is using beagle-lib/3.1.2 with GPU support.

To use this version of Beast, please first load the module with

module load Beast/1.10.4-GCC-11.3.0-CUDA-11.4.1
  • version 2.6.3 with CPU and GPU support, installed in /apps/eb/Beast/2.6.3-foss-2021b-CUDA-11.4.1/. This version of Beast is using beagle-lib/4.0.0 with GPU support.

To use this version of Beast, please first load the module with

module load Beast/2.6.3-foss-2021b-CUDA-11.4.1
  • version 2.7.3 with CPU and GPU support, installed in /apps/eb/Beast/2.7.3-foss-2021b-CUDA-11.4.1/. This version of Beast is using beagle-lib/4.0.0 with GPU support.

To use this version of Beast, please first load the module with

module load Beast/2.7.3-foss-2021b-CUDA-11.4.1

Run Beast in an interactive session

Beast is a X window program with graphic interface. It has to be run in an interactive session. Please refer to X Desktop Sessions in Open OnDemand.

  1. Start an X Desktop Session via Open OnDemand
  2. Open the Terminal application in your X Desktop session (icon at the bottom of the Desktop or via the "Applications" button in the top left)
  3. ml Beast/2.7.3-foss-2021b-CUDA-11.4.1
  4. beauti ...
  5. beast ...
  • beast/beauti in this app is set to 16GB max heap memory. If larger memory is needed, please contact us.

Run Beast with GPU support in a batch job

Example job submission script (sub.sh) to run version 2.6.3 with GPU support in a batch job:

#!/bin/bash
#SBATCH --job-name=testBeast-GPU
#SBATCH --partition=gpu_p
#SBATCH --gres=gpu:A100:1
#SBATCH --nodes=1
#SBATCH --ntasks=1
#SBATCH --cpus-per-task=4
#SBATCH --mem=20gb
#SBATCH --time=120:00:00
#SBATCH --output=log.%j.out
#SBATCH --error=log.%j.err
#SBATCH --mail-user=username@uga.edu  
#SBATCH --mail-type=ALL   

cd $SLURM_SUBMIT_DIR

ml Beast/2.7.3-foss-2021b-CUDA-11.4.1 

beast -threads 4 -beagle -beagle_GPU [options]

where [options] need to be replaced by the options (command and arguments) you want to use. Other parameters of the job, such as the maximum wall clock time, maximum memory, the number of cores per node, and the job name need to be modified appropriately as well. You need to use #SBATCH --gres=gpu:A100:1 to run the job on a A100 GPU node.

Example of submission to the queue:

sbatch  sub.sh

Documentation

ml Beast/2.7.3-foss-2021b-CUDA-11.4.1 
beast -help
  Usage: beast [-window] [-options] [-working] [-seed] [-prefix <PREFIX>] [-statefile <STATEFILE>] [-overwrite] [-resume] [-validate] [-errors <i>] [-threads <i>] [-java] [-noerr] [-loglevel <LEVEL>] [-instances <i>] [-beagle] [-beagle_info] [-beagle_order <order>] [-beagle_CPU] [-beagle_GPU] [-beagle_SSE] [-beagle_single] [-beagle_double] [-beagle_scaling <default|none|dynamic|always>] [-help] [-version] [-strictversions] [-D <DEFINITIONS>] [-DF <DEFINITIONFILE>] [-DFout <DEFINITIONRESULTFILE>] [-sampleFromPrior] [-version_file <VERSIONFILE>] [-packagedir <PACKAGEDIR>] [<input-file-name>]
    -window Provide a console window
    -options Display an options dialog
    -working Change working directory to input file's directory
    -seed Specify a random number generator seed
    -prefix Specify a prefix for all output log filenames
    -statefile Specify the filename for storing/restoring the state
    -overwrite Allow overwriting of log files
    -resume Allow appending of log files
    -validate Parse the XML, but do not run -- useful for debugging XML
    -errors Specify maximum number of numerical errors before stopping
    -threads The number of computational threads to use (default 1), -1 for number of cores
    -java Use Java only, no native implementations
    -noerr Suppress all output to standard error
    -loglevel error,warning,info,debug,trace
    -instances divide site patterns amongst number of threads (use with -threads option)
    -beagle Use beagle library if available
    -beagle_info BEAGLE: show information on available resources
    -beagle_order BEAGLE: set order of resource use
    -beagle_CPU BEAGLE: use CPU instance
    -beagle_GPU BEAGLE: use GPU instance if available
    -beagle_SSE BEAGLE: use SSE extensions if available
    -beagle_single BEAGLE: use single precision if available
    -beagle_double BEAGLE: use double precision if available
    -beagle_scaling BEAGLE: specify scaling scheme to use
    -help Print this information and stop
    -version Print version and stop
    -strictversions Use only package versions as specified in the 'required' attribute
    -D attribute-value pairs to be replaced in the XML, e.g., -D "arg1=10,arg2=20"
    -DF as -D, but attribute-value pairs defined in file in JSON format
    -DFout BEAST XML file written when -DF option is used
    -sampleFromPrior samples from prior for MCMC analysis (by adding sampleFromPrior="true" in the first run element)
    -version_file Provide a version file containing a list of services to explicitly allow. (Useful for package development.)
    -packagedir Set user package directory instead of using the default

  Example: beast test.xml
  Example: beast -window test.xml
  Example: beast -help


ml Beast/2.7.3-foss-2021b-CUDA-11.4.1 
beast -beagle_info

                        BEAST v2.7.3, 2002-2022
             Bayesian Evolutionary Analysis Sampling Trees
                       Designed and developed by
 Remco Bouckaert, Alexei J. Drummond, Andrew Rambaut & Marc A. Suchard
                                    
                   Centre for Computational Evolution
                         University of Auckland
                       r.bouckaert@auckland.ac.nz
                        alexei@cs.auckland.ac.nz
                                    
                   Institute of Evolutionary Biology
                        University of Edinburgh
                           a.rambaut@ed.ac.uk
                                    
                    David Geffen School of Medicine
                 University of California, Los Angeles
                           msuchard@ucla.edu
                                    
                      Downloads, Help & Resources:
                           http://beast2.org/
                                    
  Source code distributed under the GNU Lesser General Public License:
                   http://github.com/CompEvol/beast2
                                    
                           BEAST developers:
   Alex Alekseyenko, Trevor Bedford, Erik Bloomquist, Joseph Heled, 
 Sebastian Hoehna, Denise Kuehnert, Philippe Lemey, Wai Lok Sibon Li, 
Gerton Lunter, Sidney Markowitz, Vladimir Minin, Michael Defoin Platel, 
          Oliver Pybus, Tim Vaughan, Chieh-Hsi Wu, Walter Xie
                                    
                               Thanks to:
          Roald Forsberg, Beth Shapiro and Korbinian Strimmer


--- BEAGLE RESOURCES ---

0 : CPU (x86_64)
    Flags: PRECISION_SINGLE PRECISION_DOUBLE COMPUTATION_SYNCH EIGEN_REAL EIGEN_COMPLEX SCALING_MANUAL SCALING_AUTO SCALING_ALWAYS SCALERS_RAW SCALERS_LOG VECTOR_SSE VECTOR_NONE THREADING_NONE PROCESSOR_CPU FRAMEWORK_CPU

1 : NVIDIA A100-SXM4-80GB
    Global memory (MB): 81051
    Clock speed (Ghz): 1.41
    Number of cores: 13824
    Flags: PRECISION_SINGLE PRECISION_DOUBLE COMPUTATION_SYNCH COMPUTATION_ASYNCH EIGEN_REAL EIGEN_COMPLEX SCALING_MANUAL SCALING_AUTO SCALING_ALWAYS SCALERS_RAW SCALERS_LOG VECTOR_NONE THREADING_NONE PROCESSOR_GPU FRAMEWORK_CUDA

Back to Top

Installation

Source codes download from BEAST2

System

64-bit Linux