Difference between revisions of "BEAST"

From UFRC
Jump to navigation Jump to search
 
(35 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 
__NOEDITSECTION__
 
__NOEDITSECTION__
[[Category:Software]][[Category:Bioinformatics]][[Category:Phylogenetics]]
+
[[Category:Software]][[Category:Biology]][[Category:Phylogenetics]]
<!-- ########  Template Configuration ######## -->
+
{|<!--Main settings - REQUIRED-->
<!--Edit definitions of the variables used in template calls
 
Required variables:
 
app - lowercase name of the application e.g. "amber"
 
url - url of the software page (project, company product, etc) - e.g. "http://ambermd.org/"
 
Optional variables:
 
INTEL - Version of the Intel Compiler e.g. "11.1"
 
MPI - MPI Implementation and version e.g. "openmpi/1.3.4"
 
-->
 
{|
 
<!--Main settings - REQUIRED-->
 
 
|{{#vardefine:app|beast}}
 
|{{#vardefine:app|beast}}
|{{#vardefine:url|http://beast.bio.ed.ac.uk/Main_Page}}
+
|{{#vardefine:url|http://www.beast2.org}}
<!--Compiler and MPI settings - OPTIONAL -->
 
|{{#vardefine:intel|}} <!-- E.g. "11.1" -->
 
|{{#vardefine:mpi|}} <!-- E.g. "openmpi/1.3.4" -->
 
<!--Choose sections to enable - OPTIONAL-->
 
|{{#vardefine:mod|1}} <!--Present instructions for running the software with modules -->
 
 
|{{#vardefine:exe|1}} <!--Present manual instructions for running the software -->
 
|{{#vardefine:exe|1}} <!--Present manual instructions for running the software -->
 
|{{#vardefine:conf|}} <!--Enable config wiki page link - {{#vardefine:conf|1}} = ON/conf|}} = OFF-->
 
|{{#vardefine:conf|}} <!--Enable config wiki page link - {{#vardefine:conf|1}} = ON/conf|}} = OFF-->
Line 31: Line 16:
 
<!--Description-->
 
<!--Description-->
 
{{#if: {{#var: url}}|
 
{{#if: {{#var: url}}|
{{App_Description|app={{#var:app}}|url={{#var:url}}}}|}}
+
{{App_Description|app={{#var:app}}|url={{#var:url}}|name={{#var:app}}}}|}}
 +
 
 
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. We include a simple to use user-interface program for setting up standard analyses and a suit of programs for analysing the results.
 
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. We include a simple to use user-interface program for setting up standard analyses and a suit of programs for analysing the results.
<!--Location-->
+
<!--Modules-->
{{App_Location|app={{#var:app}}|{{#var:ver}}}}
+
==Environment Modules==
==Available versions==
+
Run <code>module spider {{#var:app}}</code> to find out what environment modules are available for this application.
* 1.6.2
+
==System Variables==
* 1.7.0
+
* HPC_{{uc:{{#var:app}}}}_DIR - installation directory
* 1.7.1 (default)
+
 
* 1.7.2 (EL6), using beagle-lib (SSE) to speed up computation.
 
<!-- -->
 
{{#if: {{#var: mod}}|==Running the application using modules==
 
{{App_Module|app={{#var:app}}|intel={{#var:intel}}|mpi={{#var:mpi}}}}|}}
 
* HPC_BEAST_BIN - executable directory
 
* HPC_BEAST_DOC - docs directory
 
* BEAST - Beast directory
 
 
==Galaxy==
 
==Galaxy==
Beast is also available for use through the friendly web interface of the [http://galaxy.hpc.ufl.edu/root?tool_id=beast UF HPC Galaxy instance]. It's located in the "Phylogenetics" section.
+
Beast is also available for use through the friendly web interface of the [http://galaxy.rc.ufl.edu/root?tool_id=beast UFRC Galaxy instance]. It's located in the "Phylogenetics" section.
 +
 
 +
==Interactive BEAUti use==
 +
See [https://beast.community/beauti https://beast.community/beauti] for general documentation on using BEAUti.
 +
 
 +
* Start an [https://ood.rc.ufl.edu OnDemand] session (console or desktop)
 +
* Load the beast module in the terminal
 +
 
 +
See [[GUI Programs]] for reference.
 +
<!--Additional-->
 +
{{#if: {{#var: exe}}|==Additional Information==
 +
* Use -beagle_GPU beast command-line argument to invoke BEAST with GPU acceleration when running in a [[GPU_Access|GPU Job]]
 +
* To use CPU acceleration with the beagle library, use the <code>'-beagle_SSE -beagle_instances N'</code> command line switches where 'N' equals to the number of requested Beagle library instances.
 +
* To limit the number of computing cores Beast will use for posterior computation to the number requested from the batch system use the <code>'-threads N'</code> where 'N' is the number of threads. Then, the job resource request should be equal to
 +
#SBATCH --ntasks=1
 +
#SBATCH --cpus-per-task=X
 +
where X = N + 1.
 +
* General performance considerations - [http://www.beast2.org/beagle-beast-2-in-cluster/ http://www.beast2.org/beagle-beast-2-in-cluster/].
  
==Interactive beauti use==
+
==Installing BEAST2 plugins==
{{Connect_test05}}
+
* Start an OnDemand session (console or desktop)
Once connected run
+
* Load the beast module in the terminal
module load beast
+
* Run beauti; use the File/Manage Packages menu to select the add-ons to (un)install.
beauti
+
Note: Beast2 plugins are installed into your personal directory.
{{#if: {{#var: exe}}|==How To Run==
 
* To use the beagle library use the <code>'-beagle_SSE -beagle_instances X'</code> command line switches where 'X' equals to the number of requested Beagle library instances.
 
* To limit the number of computing cores Beast uses to the number requested from the batch system use the <code>'-threads N'</code> where 'N' is the number of threads Beast will use for posterior computation.
 
 
|}}
 
|}}
 
{{#if: {{#var: conf}}|==Configuration==
 
{{#if: {{#var: conf}}|==Configuration==
Line 62: Line 55:
 
{{#if: {{#var: pbs}}|==PBS Script Examples==
 
{{#if: {{#var: pbs}}|==PBS Script Examples==
 
See the [[{{PAGENAME}}_PBS]] page for {{#var: app}} PBS script examples.|}}
 
See the [[{{PAGENAME}}_PBS]] page for {{#var: app}} PBS script examples.|}}
{{#if: {{#var: policy}}|==Usage policy==
+
{{#if: {{#var: policy}}|==Usage Policy==
 
WRITE USAGE POLICY HERE (perhaps templates for a couple of main licensing schemes can be used)|}}
 
WRITE USAGE POLICY HERE (perhaps templates for a couple of main licensing schemes can be used)|}}
 
{{#if: {{#var: testing}}|==Performance==
 
{{#if: {{#var: testing}}|==Performance==

Latest revision as of 14:27, 27 June 2023

Description

beast website  

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. We include a simple to use user-interface program for setting up standard analyses and a suit of programs for analysing the results.

Environment Modules

Run module spider beast to find out what environment modules are available for this application.

System Variables

  • HPC_BEAST_DIR - installation directory

Galaxy

Beast is also available for use through the friendly web interface of the UFRC Galaxy instance. It's located in the "Phylogenetics" section.

Interactive BEAUti use

See https://beast.community/beauti for general documentation on using BEAUti.

  • Start an OnDemand session (console or desktop)
  • Load the beast module in the terminal

See GUI Programs for reference.

Additional Information

  • Use -beagle_GPU beast command-line argument to invoke BEAST with GPU acceleration when running in a GPU Job
  • To use CPU acceleration with the beagle library, use the '-beagle_SSE -beagle_instances N' command line switches where 'N' equals to the number of requested Beagle library instances.
  • To limit the number of computing cores Beast will use for posterior computation to the number requested from the batch system use the '-threads N' where 'N' is the number of threads. Then, the job resource request should be equal to
#SBATCH --ntasks=1
#SBATCH --cpus-per-task=X

where X = N + 1.

Installing BEAST2 plugins

  • Start an OnDemand session (console or desktop)
  • Load the beast module in the terminal
  • Run beauti; use the File/Manage Packages menu to select the add-ons to (un)install.

Note: Beast2 plugins are installed into your personal directory.