From c84c8f01a3af40db377930ac19c80a1c81310aed Mon Sep 17 00:00:00 2001 From: gnoblet Date: Sun, 1 May 2022 11:54:59 +0200 Subject: [PATCH] Add logo and update readme --- README.Rmd | 11 +++++++---- README.md | 45 +++++++++++++++++++++++++++++++++++++++++++ man/figures/logo.png | Bin 0 -> 22889 bytes 3 files changed, 52 insertions(+), 4 deletions(-) create mode 100644 README.md create mode 100644 man/figures/logo.png diff --git a/README.Rmd b/README.Rmd index 36a8106..52638b5 100644 --- a/README.Rmd +++ b/README.Rmd @@ -11,14 +11,17 @@ knitr::opts_chunk$set( fig.path = "man/figures/README-", out.width = "100%" ) + +desc = read.dcf('DESCRIPTION') +desc = setNames(as.list(desc), colnames(desc)) ``` -# visualizeR - - +# `r desc$Package` -The goal of visualizeR is to propose some utils to get REACH and AGORA colors, ready-to-go color palettes, and a few visualization functions (horizontal hist graph for instance). +> `r desc$Title` + +`visualizeR` proposes some utils to get REACH and AGORA colors, ready-to-go color palettes, and a few visualization functions (horizontal hist graph for instance). ## Installation diff --git a/README.md b/README.md new file mode 100644 index 0000000..f1cc152 --- /dev/null +++ b/README.md @@ -0,0 +1,45 @@ + + + +# visualizeR + +> What a color! What a viz! + +`visualizeR` proposes some utils to get REACH and AGORA colors, +ready-to-go color palettes, and a few visualization functions +(horizontal hist graph for instance). + +## Installation + +You can install the last version of visualizeR from +[GitHub](https://github.com/) with: + +``` r +# install.packages("devtools") +devtools::install_github("gnoblet/visualizeR", build_vignettes = TRUE) +``` + +## Roadmap + +Roadmap is as follows: + +- [ ] Add IMPACT’s colors +- [ ] Add all color palettes from the internal documentation +- [ ] Add new types of visualization (e.g. dumbbell plot) +- [ ] Use examples +- [ ] Add some ease-map functions +- [ ] Add some interactive functions (maps and graphs) + +## Request + +Please, do not hesitate to pull request any new viz or colors or color +palettes, or to email request any change +( or ). + +## Example + +``` r +library(visualizeR) +# Get all saved REACH colors, named +cols_reach(unnamed = F) +``` diff --git a/man/figures/logo.png b/man/figures/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..145688bd3a8ed279ceb87cb1cdabc197fb098a09 GIT binary patch literal 22889 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 literal 0 HcmV?d00001