beautier

R package to generate the same BEAST2 XML parameter files as generated by BEAUti 2

https://github.com/ropensci/beautier

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

bayesian beast beast2 beauti phylogenetic-inference phylogenetics r r-package rstats
Last synced: 4 months ago · JSON representation

Repository

R package to generate the same BEAST2 XML parameter files as generated by BEAUti 2

Basic Info
Statistics
  • Stars: 13
  • Watchers: 2
  • Forks: 2
  • Open Issues: 11
  • Releases: 54
Topics
bayesian beast beast2 beauti phylogenetic-inference phylogenetics r r-package rstats
Created almost 10 years ago · Last pushed 5 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct Codemeta

README.md

beautier

<!-- markdownlint-disable MD013 --><!-- Badges cannot be split up over lines, hence will break 80 characters per line -->

Peer Review Status CRAN_Status_Badge CRAN total downloads CRAN downloads per months DOI

Branch |GitHub Actions logo |Codecov logo ---------|---------|--------- main |R-CMD-check |codecov.io develop|R-CMD-check|codecov.io

beautier is BEAUti for R.

beautier logo

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:

  • beautier create a BEAST2 input (.xml) file from an inference model.
  • tiebeaur creates an inference model from a BEAST2 input (.xml) file :warning: experimental :warning:
  • beastier runs BEAST2
  • tracerer allows to works with BEAST2 output (.log, .trees, etc) files.
  • mauricer install BEAST2 packages

Related R packages:

Examples

See examples.

Installation

beautier can be installed:

  • Latest CRAN version: CRAN
  • Latest stable version: GitHub, main branch
  • Bleeding-edge version: GitHub, develop branch

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:

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:

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.

ropensci_footer

Owner

  • Name: rOpenSci
  • Login: ropensci
  • Kind: organization
  • Email: info@ropensci.org
  • Location: Berkeley, CA

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

All Time
  • Total Commits: 2,832
  • Total Committers: 4
  • Avg Commits per committer: 708.0
  • Development Distribution Score (DDS): 0.006
Past Year
  • Commits: 169
  • Committers: 2
  • Avg Commits per committer: 84.5
  • Development Distribution Score (DDS): 0.071
Top Committers
Name Email 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

  • Versions: 15
  • Dependent Packages: 6
  • Dependent Repositories: 10
  • Downloads: 494 Last month
  • Docker Downloads: 21,661
Rankings
Docker downloads count: 0.6%
Dependent packages count: 7.3%
Dependent repos count: 9.2%
Average: 12.0%
Stargazers count: 15.1%
Downloads: 18.8%
Forks count: 21.0%
Maintainers (1)
Last synced: 5 months ago

Dependencies

DESCRIPTION cran
  • 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
.github/workflows/R-CMD-check.yaml actions
  • actions/checkout v2 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
.github/workflows/build_singularity.yaml actions
  • actions/checkout v2 composite
.github/workflows/check_bash_style.yaml actions
  • actions/checkout v2 composite
.github/workflows/check_links.yaml actions
  • actions/checkout v2 composite
  • gaurav-nelson/github-action-markdown-link-check v1 composite