Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/maraab23/ggseqplot

R library for visualizing (social science) sequence data using ggplot2
https://github.com/maraab23/ggseqplot

ggplot2 r r-package rstats sequence-analysis traminer visualization

Last synced: 7 days ago
JSON representation

R library for visualizing (social science) sequence data using ggplot2

Host: GitHub
URL: https://github.com/maraab23/ggseqplot
Owner: maraab23
License: gpl-3.0
Created: 2022-03-28T09:11:43.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-07-30T12:03:01.000Z (3 months ago)
Last Synced: 2024-10-27T21:55:51.819Z (12 days ago)
Topics: ggplot2, r, r-package, rstats, sequence-analysis, traminer, visualization
Language: R
Homepage: https://maraab23.github.io/ggseqplot/
Size: 28.8 MB
Stars: 14
Watchers: 4
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- License: LICENSE.md

Awesome Lists containing this project

awesome-r-dataviz - ggseqplot - R library for visualizing (social science) sequence data using ggplot2. (ggplot / Domain-specific)

README

        ---

output: github_document

editor_options: 

  markdown: 

    wrap: 72

---

```{r, include = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-",

  out.width = "100%"

)

```

# ggseqplot: ggplotify sequence data plots 

[![CRAN status](https://www.r-pkg.org/badges/version/ggseqplot)](https://cran.r-project.org/package=ggseqplot)

[![R-CMD-check](https://github.com/maraab23/ggseqplot/workflows/R-CMD-check/badge.svg)](https://github.com/maraab23/ggseqplot/actions)

[![Codecov test coverage](https://codecov.io/gh/maraab23/ggseqplot/branch/main/graph/badge.svg)](https://app.codecov.io/gh/maraab23/ggseqplot?branch=main)

[![CRAN Downloads](https://cranlogs.r-pkg.org/badges/grand-total/ggseqplot)](https://cranlogs.r-pkg.org/badges/grand-total/ggseqplot)

[![Codecov test coverage](https://codecov.io/gh/maraab23/ggseqplot/graph/badge.svg)](https://app.codecov.io/gh/maraab23/ggseqplot)

The main goal of [`{ggseqplot}`](https://maraab23.github.io/ggseqplot/) is to 

provide functions that reproduce the sequence plots from

[`{TraMineR}`](http://traminer.unige.ch){target="\_blank"}'s `seqplot`

using [`{ggplot2}`](https://ggplot2.tidyverse.org/){target="\_blank"}.

These plots are produced on the basis of state sequence objects defined with

`TraMineR::seqdef`. The package automates the reshaping and plotting of

sequence data. This library literally builds on the excellent work of the

[`{TraMineR}`](http://traminer.unige.ch){target="\_blank"} and

[`{ggplot2}`](https://ggplot2.tidyverse.org/){target="\_blank"}

developers and uses several of the their functions to produce

ggplot2-flavored figures.

Note, that this library was not written because I personally dislike the

plots produced by

[`{TraMineR}`](http://traminer.unige.ch){target="\_blank"}, but rather

because I am normally using

[`{ggplot2}`](https://ggplot2.tidyverse.org/){target="\_blank"} instead of

base R's `plot` environment for visualizing data.

[`{TraMineR}`](http://traminer.unige.ch){target="\_blank"} was developed before

[`{ggplot2}`](https://ggplot2.tidyverse.org/){target="\_blank"} was as popular 

as it is today and back then many users were more familiar with coding base R 

plots. To date, however, many researchers and students are more accustomed to 

using [`{ggplot2}`](https://ggplot2.tidyverse.org/){target="\_blank"} and

prefer to draw on the related skills and experiences instead of learning

how to refine base R plots just for the single purpose of visualizing

sequence data.

[`{ggseqplot}`](https://maraab23.github.io/ggseqplot/) contains the 

following functions:

-   `ggseqdplot` (equivalent to `TraMineR::seqdplot`)

-   `ggseqeplot` (equivalent to `TraMineRextras::seqplot.tentrop`)

-   `ggseqmsplot` (equivalent to `TraMineR::seqmsplot`)

-   `ggseqmtplot` (equivalent to `TraMineR::seqmtplot`)

-   `ggstrqeplot` (based on transitions rates computed with `TraMineR::seqtrate`)

-   `ggseqiplot` (equivalent to `TraMineR::seqIplot`)

-   `ggseqfplot` (equivalent to `TraMineR::seqfplot`)

-   `ggseqrplot` (equivalent to `TraMineR::seqrplot`)

-   `ggseqrfplot` (equivalent to `TraMineRextras::seqplot.rf`)

If you have change requests or find errors, [create an

issue](https://github.com/maraab23/ggseqplot/issues/new) on github or

send me an

[email](mailto:[email protected]?subject=ggseqplot%3A%20feature%20request).

A complementing [vignette](https://maraab23.github.io/ggseqplot/articles/ggseqplot.html) outlines how [`{ggseqplot}`](https://maraab23.github.io/ggseqplot/) reshapes sequence data

generated with [`{TraMineR}`](http://traminer.unige.ch){target="\_blank"} functions to visualize them using

[`{ggplot2}`](https://ggplot2.tidyverse.org/){target="\_blank"}. Moreover, it 

illustrates how to adjust the baseline output using familiar

[`{ggplot2}`](https://ggplot2.tidyverse.org/){target="\_blank"}

functions (and add-ons).

## Installation

You can install the CRAN version of [`{ggseqplot}`](https://maraab23.github.io/ggseqplot/) by typing:

``` r

install.packages("ggseqplot")

```

The development version can be installed with:

``` r

devtools::install_github("maraab23/ggseqplot")

```

## Acknowledgements

I would like to thank Gilbert Ritschard, Tim Liao, and Emanuela Struffolino for 

their comments on earlier versions of this library.