-
Notifications
You must be signed in to change notification settings - Fork 2
/
README.Rmd
95 lines (66 loc) · 4.76 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
---
output:
bookdown::github_document2:
html_preview: false
---
```{r setup, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# ezpickr: Convenient Package for Choosing Any Rectangular Data File Using Interactive GUI Dialog Box, and Seamlessly Manipulating Tidy Data between an Excel Window and R Session
[](http://www.gnu.org/licenses/gpl-3.0)
[](https://cran.r-project.org/package=ezpickr)
[](https://cranlogs.r-pkg.org/badges/grand-total/ezpickr)
[](https://www.tidyverse.org/lifecycle/#stable)
[](https://travis-ci.org/jooyoungseo/ezpickr)
[](https://ci.appveyor.com/project/jooyoungseo/ezpickr)
[](https://codecov.io/gh/jooyoungseo/ezpickr?branch=master)
The goal of ezpickr is to provide R beginners with a convenient way to pick up their data files in a tidy tibble form into an R environment using GUI file-picker dialogue box (`ezpickr::pick()`), and to open and manipulate their data objects using Excel application for a seamless data communication between an Excel and R session (`ezpickr::viewxl()`).
You can alternatively use `ezpickr::pick()` function for choosing *.csv, *.csv2, *.tsv, *.txt, *.xls, *.xlsx, *.json, *.html, *.htm, *.php, *.pdf, *.doc, *.docx, *.rtf, *.RData, *.Rda, *.RDS, *.sav (SPSS), *.por, *.sas7bdat, *.sas7bcat, *.dta, *.xpt, *.mbox, and *.Rmd files in an interactive GUI mode A file choose dialog box will be prompted.
Any additional arguments available for each file type and extension: `vroom::vroom()` for 'CSV' (Comma-Separated Values); 'CSV2' (Semicolon-Separated Values); 'TSV' (Tab-Separated Values)'txt' (plain text) files; `readxl::read_excel()` for 'Excel' files; `haven::read_spss()` for 'SPSS' files; `haven::read_stata()` for 'Stata' files; `haven::read_sas()` for 'SAS' files; `textreadr::read_document()` for 'Microsoft Word', 'PDF', 'RTF', 'HTML', 'HTM', and 'PHP' files; `jsonlite::fromJSON()` for 'JSON' files; `mboxr::read_mbox()` for 'mbox' files; `rmarkdown::render()` for 'Rmd' files; `base::source()` for 'R' files; `base::readRDS()` for 'RDS' files; `base::load()` for 'RDA' and 'RDATA' files.
Each corresponding function depending upon a file extension will be automatically matched and applied once you pick up your file using either the GUI-file-chooser dialog box or explicit path/to/filename.
## Installation
### Development Version
You can install the latest development version as follows:
```{r, eval=F}
if(!require(remotes)) {
install.packages("remotes")
}
remotes::install_github('jooyoungseo/ezpickr')
```
### Stable Version
You can install the released version of ezpickr from [CRAN](https://CRAN.R-project.org) with:
```{r, eval=F}
install.packages("ezpickr")
```
## Example
### Usage of the `pick()` Function
This is a basic example which shows you how to import data files:
```{r example1, eval=F}
library(ezpickr)
# Choosing file and saving it into a variable
## Scenario 1: Picking up a file using interactive GUI dialog box:
data <- pick() ## Please use `picko()` instead if your path/file contains any Korean characters.
## Scenario 2: Picking up a file using an explicit file name ("test.sav" in the example below; however, you can feed other files through this function such as *.SAS, *.DTA, *.csv, *.csv2, *.tsv, *.xlsx, *.txt, *.html, webpage URL, *.json, *.Rda, *.Rdata, and more):
data <- pick("test.sav") ## Please use `picko("test.sav")` instead if your path/file contains any Korean characters.
# Now you can use the imported file as a tibble data frame.
str(data)
```
### Usage of the `viewxl()` Function
You can open any data.frame, tibble, matrix, table or vector from an R session into your default-set spreadsheet application window as follows:
```{r example2, eval=F}
library(ezpickr)
data(airquality)
str(airquality)
# Use `viewxl()` function to open your data object in your spreadsheet:
viewxl(airquality)
# Then, when necessary, you can modify the opened data in the spreadsheet and save it as a new data.
# You can pass a list object to the `viewxl()` function like below:
l <- list(iris = iris, mtcars = mtcars, chickwts = chickwts, quakes = quakes)
viewxl(l)
# Then, each list item will appear in your Excel window sheet by sheet.
```