Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/dreamRs/datamods

Shiny modules to import and manipulate data into an application or addin
https://github.com/dreamRs/datamods

r shiny shiny-modules

Last synced: about 1 month ago
JSON representation

Shiny modules to import and manipulate data into an application or addin

Host: GitHub
URL: https://github.com/dreamRs/datamods
Owner: dreamRs
License: gpl-3.0
Created: 2020-08-08T07:56:48.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2024-09-09T07:14:55.000Z (4 months ago)
Last Synced: 2024-09-09T08:48:58.944Z (4 months ago)
Topics: r, shiny, shiny-modules
Language: R
Homepage: https://dreamrs.github.io/datamods/
Size: 13.3 MB
Stars: 138
Watchers: 6
Forks: 34
Open Issues: 7
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- License: LICENSE.md

Awesome Lists containing this project

jimsghstars - dreamRs/datamods - Shiny modules to import and manipulate data into an application or addin (R)

README

        ---

output: github_document

---

```{r, include = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

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

  out.width = "100%"

)

```

# datamods

> Shiny modules to import and manipulate data into an application or addin.

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

[![cranlogs](https://cranlogs.r-pkg.org/badges/datamods)](https://cran.r-project.org/package=datamods)

[![R-CMD-check](https://github.com/dreamRs/datamods/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/dreamRs/datamods/actions/workflows/R-CMD-check.yaml)

### Overview

This package provides custom shiny modules to import data from various sources, select, rename and convert variables in a dataset and validate content with [validate](https://github.com/data-cleaning/validate) package.  

The modules can be used in any standard shiny application or RStudio add-in.

### Internationalization

```{r, include=FALSE}

i18n_flag <- function(code, language) {

  code <- strsplit(code, split = "|", fixed = TRUE)[[1]]

  flag <- sprintf("", code)

  paste(paste(flag, collapse = ""), language)

}

i18n_flags <- function(languages) {

  mapply(

    FUN = i18n_flag, 

    code = names(languages),

    language = unlist(languages, use.names = FALSE),

    USE.NAMES = FALSE

  )

}

languages <- list(

  gb = "english (default)",

  fr = "french",

  mk = "macedonian",

  "br|pt" = "brazilian portuguese",

  al = "albanian",

  cn = "chinese",

  es = "spanish",

  de = "german",

  tr = "turkish",

  kr = "korean",

  pl = "polish",

  ja = "japanese"

)

```

Currently you can use {datamods} in the following language: `r i18n_flags(languages)`.

If you want another language to be supported, you can submit a Pull Request to add a CSV file like the one used for french (file is located in `inst/i18n` folder in the package, you can see it [here on GitHub](https://github.com/dreamRs/datamods/blob/master/inst/i18n/fr.csv)).

See the [online vignette](https://dreamrs.github.io/datamods/articles/i18n.html) for more on this topic.

### Installation

Install from [CRAN](https://CRAN.R-project.org/package=datamods) with:

```r

install.packages("datamods")

```

You can install the development version of datamods from [GitHub](https://github.com/dreamRs/datamods) with:

```r

remotes::install_github("dreamRs/datamods")

```

### Import

Import data from:

* **environment**: such as Global environment or from a package

* **file**: text files, Excel, SAS or SPSS format... anything that package [rio](https://github.com/gesistsa/rio#supported-file-formats) can handle

* **copy/paste**: paste data from an other source like Excel or text file

* **Google Sheet**: use the URL to import the Googlesheet

* **URL**: use a URL to import from a flat table

Each module is available in the form `import_file_ui()` / `import_file_server()` and can be use independently.

Or all modules can be launched together in a modal window via `import_modal()` / `import_server()`:

![](man/figures/datamods-modal.png)

This module also allow to view imported data and to update variables.

### Update

Module `update_variables_ui()` / `update_variables_server()` allow to:

* **select** variables of interest in a dataset

* **rename** variables to be used in application after that

* **convert** variables to change their class, from character to numeric for example

![](man/figures/datamods-update.png)

### Validate

Define some validation rules with package [validate](https://github.com/data-cleaning/validate) and check whether data lives up to those expectations.

![](man/figures/datamods-validation.png)

### Filter

Interactively filter a `data.frame`, this module also generates the code to reproduce the filters.

![](man/figures/datamods-filter.png)

### Sample

This module extracts a sample from a `data.frame`, based either on a fixed number of rows or on a percentage of total rows.

![](man/figures/datamods-sample.png)

### Edit

This module makes a `data.frame` editable, allowing the user to add, modify or delete rows.

![](man/figures/datamods-edit-data.png)

### Create column

This module allow to enter an expression to create a new column in a `data.frame`.

![](man/figures/create_column.png)

### Cut numeric variable

This module contain an interface to cut a numeric into several intervals.

![](man/figures/cut_variable.png)

### Update factor

This module contain an interface to reorder the levels of a factor variable.

![](man/figures/update_factor.png)