Learn R Programming

pedMermaid

R package pedMermaid generates Mermaid syntax for creating a pedigree flowchart in Markdown and R Markdown, from a pedigree data frame.

Installation

You can install the development version of pedMermaid like so:

devtools::install_github('nilforooshan/ggroups')

Example

This is a basic example of a pedigree flowchart created by the Mermaid syntax generated by the R package pedMermaid.

library(pedMermaid)
ped <- data.frame(ID = 1:7,
                  SIRE = c(0, 0, 1, 0, 3, 0, 5),
                  DAM = c(0, 0, 2, 2, 4, 0, 6))
x <- mermaid_md(ped)
# cat(x, sep = "\n") # Display the output syntax on-screen
flowchart TB
    1 & 2 --> 3
    2 --> 4
    3 & 4 --> 5
    5 & 6 --> 7

R package pedMermaid is equipped with functions mermaid_md and mermaid_rmd for generating Mermaid flowchart syntax for Markdown and R Markdown, respectively. The syntax generated by mermaid_rmd is also applicable to Markdown. However, the syntax is more restricted (less customizations) and less compact. The mermaid_md function provides the following customizations:

  • Links
    • Orientation (top-to-bottom or left-to-right)
    • Type (arrow or line)
    • Curve (not supported by mermaid_rmd)
    • Dash (dashed or solid) (not supported by mermaid_rmd)
    • Line width (not supported by mermaid_rmd)
    • Color (not supported by mermaid_rmd)
  • Nodes (node-specific)
    • Text color (not supported by mermaid_rmd)
    • Background color
    • Border color
    • Round border
    • Dashed (or solid) border
    • Line width of the border

Copy Link

Version

Install

install.packages('pedMermaid')

Monthly Downloads

145

Version

1.0.2

License

GPL (>= 3)

Issues

Pull Requests

Stars

Forks

Maintainer

Mohammad Ali Nilforooshan

Last Published

April 9th, 2024

Functions in pedMermaid (1.0.2)

pedMermaid-package

pedMermaid: Pedigree Mermaid Syntax
mermaid_md

Generate Mermaid syntax for a pedigree flowchart in Markdown
mermaid_rmd

Generate Mermaid syntax for a pedigree flowchart in Markdown & R Markdown