beautier
R package to generate the same BEAST2 XML parameter files as generated by BEAUti 2
Science Score: 49.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 2 DOI reference(s) in README -
✓Academic publication links
Links to: zenodo.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (12.8%) to scientific vocabulary
Keywords
Repository
R package to generate the same BEAST2 XML parameter files as generated by BEAUti 2
Basic Info
- Host: GitHub
- Owner: ropensci
- License: gpl-3.0
- Language: R
- Default Branch: main
- Homepage: https://docs.ropensci.org/beautier
- Size: 11 MB
Statistics
- Stars: 13
- Watchers: 2
- Forks: 2
- Open Issues: 11
- Releases: 54
Topics
Metadata Files
README.md
beautier
<!-- markdownlint-disable MD013 --><!-- Badges cannot be split up over lines, hence will break 80 characters per line -->
Branch |
|
---------|---------|---------
main | |
develop||
beautier is BEAUti for R.

The purpose of beautier is to create
a valid BEAST2 XML input file
from a n inference model. In this way, a scientific pipeline using
BEAST2 can be fully scripted, instead of using BEAUti's GUI.
beautier is part of the
babette package suite:
beautiercreate a BEAST2 input (.xml) file from an inference model.tiebeaurcreates an inference model from a BEAST2 input (.xml) file :warning: experimental :warning:beastierruns BEAST2tracererallows to works with BEAST2 output (.log,.trees, etc) files.mauricerinstall BEAST2 packages
Related R packages:
beautier_on_windows: verifiesbeautierbuilds on Windowslumier: Shiny app to help create the function call needed
Examples
See examples.
Installation
beautier can be installed:
- Latest CRAN version: CRAN
- Latest stable version: GitHub,
mainbranch - Bleeding-edge version: GitHub,
developbranch
CRAN
For the latest CRAN version:
r
install.packages("beautier")
GitHub, main branch
For the latest stable version:
r
remotes::install_github("ropensci/beautier")
GitHub, develop branch
For the bleeding-edge version:
r
remotes::install_github("ropensci/beautier", ref = "develop")
FAQ
See FAQ.
Supported
This works, and the interface is unlikely to change.
- 1 DNA alignment
- Site models:
- JC69
- HKY
- TN93
- GTR
- Clock models:
- Strickt
- Relaxed log-normal
- Tree models:
- Yule
- Birth-Death
- Coalescent Bayesian Skyline
- Coalescent Constant Population
- Coalescent Exponential Population
- Handle missing data: simply use a dash (´-´) as a sequence in a FASTA file
Experimental
This works partially, and the interface may change as well.
Tip dating
The tip dates file is a file that needs to not have column, nor row names. The columns need to be tab separated.
See
the example file G_VII_pre2003_dates_4.txt
for an example, of which the first rows are shown here:
text
KF767106_Indonesia_1976_VII 1976
KF767104_Indonesia_1988_VII 1988
KF767105_Indonesia_1988_VII 1988
AY288998_Indonesia_1990_VII 1990
Missing features/unsupported
beautier cannot do everything BEAUti can.
Here are some missing or (yet) unsupported features, some are linked to an Issue:
- Add offset to a distribution
- Two or more DNA alignments
- Two or more site, clock or tree models
- Two or more MRCA priors
- Shared site, clock and/or tree models
- Using an amino acid alignment
- Support for hyper parameters
- Clock models
- Relaxed exponential
- Random local
- Tree priors
- Calibrated Yule model
- Coalescent Extended Bayesian Skyline
- Birth Death Skyline Serial
- Initialization (this is a tab that is hidden by default in
BEAUti)
There is a feature I miss
See CONTRIBUTING, at Submitting use cases
I want to collaborate
See CONTRIBUTING, at 'Submitting code'
I think I have found a bug
See CONTRIBUTING, at 'Submitting bugs'
There's something else I want to say
Sure, just add an Issue. Or send an email.
External links
Files used by continuous integration scripts
<!-- markdownlint-disable MD013 --><!-- Tables cannot be split up over lines, hence will break 80 characters per line -->
Filename |Descriptions
--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------
mlc_config.json |Configuration of the link checker, use markdown-link-check --config mlc_config.json --quiet docs/**/*.md to do link checking locally
.spellcheck.yml |Configuration of the spell checker, use pyspelling -c .spellcheck.yml to do spellcheck locally
.wordlist.txt |Whitelisted words for the spell checker, use pyspelling -c .spellcheck.yml to do spellcheck locally
.markdownlint.jsonc|Configuration of the markdown linter, use markdownlint "**/*.md" to do markdown linting locally. The name of this file is a default name.
.markdownlintignore|Files ignored by the markdown linter, use markdownlint "**/*.md" to do markdown linting locally. The name of this file is a default name.
References
<!-- markdownlint-disable MD013 --><!-- References are not split up over lines, to keep them copy-pastable, hence will break 80 characters per line -->
Article about babette:
- Bilderbeek, Richèl JC, and Rampal S. Etienne. "
babette: BEAUti 2, BEAST 2 and Tracer for R." Methods in Ecology and Evolution (2018). https://doi.org/10.1111/2041-210X.13032
FASTA files anthus_aco.fas and anthus_nd2.fas from:
- Van Els, Paul, and Heraldo V. Norambuena. "A revision of species limits in Neotropical pipits Anthus based on multilocus genetic and vocal data." Ibis.
FASTA file G_VII_pre2003_msa.fas from:
- Durr, PA; Wibowo, MH; Tabbu, CR; Asmara, W; Selleck, P; Wang, J; Broz, I; Graham, K.; Dimitrov, K and Afonso, C. (in preparation). Phylodynamics of Genotype VII Newcastle disease virus in Indonesia.
Owner
- Name: rOpenSci
- Login: ropensci
- Kind: organization
- Email: info@ropensci.org
- Location: Berkeley, CA
- Website: https://ropensci.org/
- Twitter: rOpenSci
- Repositories: 307
- Profile: https://github.com/ropensci
CodeMeta (codemeta.json)
{
"@context": [
"https://doi.org/10.5063/schema/codemeta-2.0",
"http://schema.org"
],
"@type": "SoftwareSourceCode",
"identifier": "beautier",
"description": "'BEAST2' (<http://www.beast2.org>) is a widely used\n Bayesian phylogenetic tool, that uses DNA/RNA/protein data\n and many model priors to create a posterior of jointly estimated \n phylogenies and parameters.\n 'BEAUti 2' (which is part of 'BEAST2') is a GUI tool \n that allows users to specify the many possible setups\n and generates the XML file 'BEAST2' needs to run.\n This package provides a way to create 'BEAST2' input\n files without active user input, but using\n R function calls instead.",
"name": "beautier: 'BEAUti' from R",
"codeRepository": "https://github.com/ropensci/beautier",
"issueTracker": "https://github.com/ropensci/beautier/issues",
"license": "https://spdx.org/licenses/GPL-3.0",
"version": "2.2",
"programmingLanguage": {
"@type": "ComputerLanguage",
"name": "R",
"version": "3.4.2",
"url": "https://r-project.org"
},
"runtimePlatform": "R version 3.4.2 (2017-09-28)",
"author": [
{
"@type": "Person",
"givenName": "Richl J.C.",
"familyName": "Bilderbeek",
"email": "richel@richelbilderbeek.nl",
"@id": "https://orcid.org/0000-0003-1107-7049"
}
],
"contributor": [
{
"@type": "Person",
"givenName": "Paul",
"familyName": "Van Els"
},
{
"@type": "Person",
"givenName": "Raphael",
"familyName": "Scherrer"
},
{
"@type": "Person",
"givenName": "Yacine B.",
"familyName": "Chehida"
},
{
"@type": "Person",
"givenName": "Jana",
"familyName": "Riederer"
}
],
"maintainer": [
{
"@type": "Person",
"givenName": "Richl J.C.",
"familyName": "Bilderbeek",
"email": "richel@richelbilderbeek.nl",
"@id": "https://orcid.org/0000-0003-1107-7049"
}
],
"softwareSuggestions": [
{
"@type": "SoftwareApplication",
"identifier": "spelling",
"name": "spelling",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=spelling"
},
{
"@type": "SoftwareApplication",
"identifier": "devtools",
"name": "devtools",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=devtools"
},
{
"@type": "SoftwareApplication",
"identifier": "knitr",
"name": "knitr",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=knitr"
},
{
"@type": "SoftwareApplication",
"identifier": "ggplot2",
"name": "ggplot2",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=ggplot2"
},
{
"@type": "SoftwareApplication",
"identifier": "hunspell",
"name": "hunspell",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=hunspell"
},
{
"@type": "SoftwareApplication",
"identifier": "lintr",
"name": "lintr",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=lintr"
},
{
"@type": "SoftwareApplication",
"identifier": "rmarkdown",
"name": "rmarkdown",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=rmarkdown"
},
{
"@type": "SoftwareApplication",
"identifier": "testthat",
"name": "testthat",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=testthat"
}
],
"softwareRequirements": [
{
"@type": "SoftwareApplication",
"identifier": "ape",
"name": "ape",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=ape"
},
{
"@type": "SoftwareApplication",
"identifier": "geiger",
"name": "geiger",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=geiger"
},
{
"@type": "SoftwareApplication",
"identifier": "seqinr",
"name": "seqinr",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=seqinr"
},
{
"@type": "SoftwareApplication",
"identifier": "stringr",
"name": "stringr",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=stringr"
},
{
"@type": "SoftwareApplication",
"identifier": "testit",
"name": "testit",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=testit"
}
],
"releaseNotes": "https://github.com/ropensci/beautier/blob/main/NEWS.md",
"readme": "https://github.com/ropensci/beautier/blob/main/README.md",
"contIntegration": [
"https://travis-ci.org",
"https://www.appveyor.com",
"https://www.codecov.io",
"https://travis-ci.org/ropensci/beautier",
"https://ci.appveyor.com/project/ropensci/beautier",
"https://codecov.io/github/ropensci/beautier/branch/main",
"https://travis-ci.org/ropensci/beautier",
"https://ci.appveyor.com/project/ropensci/beautier",
"https://codecov.io/github/ropensci/beautier/branch/develop"
],
"citation": [
{
"@type": "ScholarlyArticle",
"datePublished": "2018",
"author": [
{
"@type": "Person",
"givenName": [
"Richl",
"JC"
],
"familyName": "Bilderbeek"
},
{
"@type": "Person",
"givenName": [
"Rampal",
"S"
],
"familyName": "Etienne"
}
],
"name": "babette: BEAUti 2, BEAST 2 and Tracer for R",
"url": "https://doi.org/10.1111/2041-210X.13032",
"isPartOf": {
"@type": "PublicationIssue",
"datePublished": "2018",
"isPartOf": {
"@type": [
"PublicationVolume",
"Periodical"
],
"name": "Methods in Ecology and Evolution"
}
}
}
],
"keywords": [
"r",
"r-package",
"rstats"
]
}
GitHub Events
Total
- Create event: 3
- Release event: 2
- Issues event: 1
- Delete event: 1
- Issue comment event: 4
- Push event: 51
Last Year
- Create event: 3
- Release event: 2
- Issues event: 1
- Delete event: 1
- Issue comment event: 4
- Push event: 51
Committers
Last synced: about 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| richelbilderbeek | r****l@r****l | 2,815 |
| olivroy | o****1@h****m | 12 |
| Richel Bilderbeek | r****k | 4 |
| ropenscibot | m****t@g****m | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 4 months ago
All Time
- Total issues: 1
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 1
- Total pull request authors: 0
- Average comments per issue: 0.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 1
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 1
- Pull request authors: 0
- Average comments per issue: 0.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- richelbilderbeek (2)
Pull Request Authors
- olivroy (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- cran 494 last-month
- Total docker downloads: 21,661
- Total dependent packages: 6
- Total dependent repositories: 10
- Total versions: 15
- Total maintainers: 1
cran.r-project.org: beautier
'BEAUti' from R
- Homepage: https://docs.ropensci.org/beautier/
- Documentation: http://cran.r-project.org/web/packages/beautier/beautier.pdf
- License: GPL-3
-
Latest release: 2.6.12
published almost 2 years ago
Rankings
Maintainers (1)
Dependencies
- ape * imports
- assertive * imports
- pryr * imports
- rappdirs * imports
- seqinr * imports
- stringr * imports
- testit * imports
- devtools * suggests
- ggplot2 * suggests
- hunspell * suggests
- knitr * suggests
- lintr * suggests
- markdown * suggests
- readr * suggests
- rmarkdown * suggests
- spelling * suggests
- testthat >= 2.1.0 suggests
- actions/checkout v2 composite
- r-lib/actions/setup-pandoc v2 composite
- r-lib/actions/setup-r v2 composite
- actions/checkout v2 composite
- actions/checkout v2 composite
- actions/checkout v2 composite
- gaurav-nelson/github-action-markdown-link-check v1 composite
