Code Monkey home page Code Monkey logo

bio's Introduction

Package bio

GitHub version R-CMD-check Updated-on Lifecycle: experimental R-CMD-check

Convenience functions to facilitate installation and management of required resources for course unit Biostatistics (BS-2023).


This package is intended to be used with RStudio 2022.06.0 or newer
and R 4.3.1 or newer.
Functions may not work correctly with the previous versions of RStudio and R.


Bug reports and your feedback are welcome at https://github.com/mokymai/bio/issues. In the report, indicate what operating system you are using.

Install

To install this package from CRAN-like repository, use code (recommended):

repos <- c("https://mokymai.github.io/download/", getOption("repos"))
install.packages("bio", repos = repos)
Install form GitHub

To install this package from GitHub:

if (!require(remotes)) install.packages("remotes")
remotes::install_github("mokymai/bio", dependencies = TRUE)

Note: installation from GitHub requires RTools on Windows.

Examples

Check information about OS and user

Check information about operating system (OS) and R-related user information.

bio::check_user_info()
## Operating system    Windows 10 x64 (build 19044)
## Platform            x86_64-w64-mingw32/x64 (64-bit)
## LOGNAME
## USERNAME            User
## USERPROFILE         C:/Users/User
## HOME                C:/Users/User
## R_USER              C:/Users/User
## R_HOME              C:/PROGRA~1/R/R-4.2.2
## R_LIBS_USER         C:/Users/User/AppData/Local/R/win-library/4.2

Check information about programs

Check versions of presence of installed R-related and other programs. Options:

  • "main" (default) – checks for “R”, “RStudio”, “Quarto”, and “Rtools” (“Windows” only) or “R Build Tools” (non-“Windows” only).
  • "all" – additionally checks for presence of “XQuartz” (“Mac” only), “Git” (all systems), and (sometimes) “Meld”.
bio::check_installed_programs()
## ✔ Program R (4.3.1) is installed (recommended >= 4.3.1).
## ✖ Program RStudio is not installed or is not running.
## ✔ Tool Quarto (1.4.268) is installed (recommended >= 1.3.336).
## ✔ Tool Rtools is installed.
bio::check_installed_programs("all")
## ✔ Program R (4.3.1) is installed (recommended >= 4.2.2, available 4.3.1).
## ✔ Program RStudio (2023.6.1.524) is installed (recommended >= 2023.3.0, available 2023.6.1.524).
## ✔ Tool Quarto (1.4.268) is installed (recommended >= 1.3.336).
## ✔ Tool Rtools is installed.
## ✔ Program Git is installed.
## ✔ Program Meld is installed.

Check installation status of “R” packages

It is recommended to check installation status and version of required packages by name:

bio::check_packages_by_name(c("bio", "remotes", "tidyverse"))
## ✔ Minimal required versions of all 3 packages are already installed.

There is a less recommended way (due to lower transparency) to check installation status of packages by topic. By default, only missing packages or packages with lower versions than recommended are displayed. Currently available lists can be returned by function bio::get_pkg_lists_local().

Details
  • 'addins-rmd'
  • 'bio'
  • 'confidence-intervals'
  • 'ggplot-extra-tools'
  • 'ggplot'
  • 'gmc-r209'
  • 'initial'
  • 'linear-regression'
  • 'markdown'
  • 'mini'
  • 'rcmdr-biostat'
  • 'rcmdr'
  • 'snippets'
  • 'spelling-grammar'
  • 'statistical-tests'
  • 'summary'
  • 'tidyverse'
bio::check_packages_by_topic("mini")
## ℹ Reading list 'mini'
## ✔ Minimal required versions of all 19 packages (from list 'mini') are already installed.
bio::check_packages_by_topic("mini", include = "newer_on_cran")
## ℹ Reading list 'mini'
## ✔ Minimal required versions of all 19 packages (from list 'mini') are already installed.
## ℹ Note: 1 package has newer version on CRAN.

Update packages

These are the convenience functions to update certain R packages. The functions restart R before installation if used in RStudio.

Update package bio.

bio::update_pkg_bio()

Check if there are updates for bio or its dependency packages.

bio::check_updates_pkg_bio()
## ℹ Analyzing dependencies of package bio
##
## [... truncated ...]
##
## ✔ Minimal required versions of all 26 packages (from list 'bio') are already installed.

Update package snippets.

bio::update_pkg_snippets()

RStudio settings and user preferences

Make sure that you understand what you are doing when you try using the functions that reset RStudio key bindings (shortcut keys), settings or snippets. You may loose all your previous settings.

Dictionaries

This function downloads or updates hunspell spelling checking dictionaries dictionaries (including Lithuanian) that can be used by RStudio or by tools from wellspell.addin package.

bio::rstudio_install_spellcheck_dictionaries()

Install improved Lithuanian dictionary.

bio::rstudio_install_spellcheck_dictionary_lt()
## ✔ lt_LT dictionary installed.
##   'C:/Users/ViG/AppData/Roaming/RStudio/dictionaries/languages-system/lt_LT.dic'

Shortcut keys

This function changes shortcut keys in RStudio.

Run function without arguments to see the available options.

bio::rstudio_reset_keybindings()
## Error: The value of argument 'to' is missing.
## Possible options: 'bio-default', 'rstudio-default'.

Options:

  • "bio-default" – shortcut keys recommended for course BS-2023.
  • "rstudio-default" – RStudio defaults.
bio::rstudio_reset_keybindings(to = "bio-default")
## ✔ Back up copy of shortcut keys was created in 'C:/Users/User/.R/_backup/keybindings/'
## ✔ Shortcut keys were reset to bio-default.
Shortcut Action
Shift+Alt+S Insert inline LaTeX equation (R Markdown).
Shift+Alt+A Use “Tidyverse” style on selected lines of R code. Package styler must be installed (R code).
Ctrl+Shift+D Duplicate selected text.
Ctrl+Shift+Alt+S Check spelling in selected text. Package wellspell.addin must be installed.
Ctrl+Shift+Alt+P Align parts of selected lines at a custom pattern.
Ctrl+Shift+] Change heading one level down (R Markdown) [!].
Ctrl+Shift+[ Change heading one level up or remove heading (R Markdown) [!].
Ctrl+Shift+; Insert lower opening quotes .
Ctrl+Shift+ Insert upper closing quotes .
Ctrl+E Insert/Enclose with R code block (R Markdown) [!] .
Ctrl+Alt+T Insert inline code highlighted as R code (R Markdown).
Ctrl+Alt+NumPad8 Insert operator %*% (R code).
Ctrl+Alt+NumPad7 Insert operator %in% (R code).
Ctrl+Alt+D Document R package (that you are building).

Table 1. Some examples of shortcut keys set with option "bio-default".

More on Customizing Keyboard Shortcuts in RStudio.

RStudio settings

This function resets RStudio user preferences and settings.

Run function without arguments to see the available options.

bio::rstudio_reset_user_settings()
#> Error: The value of argument 'to' is missing.
#> Possible choices: 'bio-default', 'bio-dark-blue', 'bio-black', 'rstudio-default'.

The options:

  • "bio-default" – recommended bio settings (and light theme “Textmate (default)”);
  • "bio-dark-blue" – recommended bio settings (and dark blue theme “Cobalt”);
  • "bio-black" – recommended bio settings (and black theme “Chaos”);
  • "rstudio-default" – default RStudio settings.
bio::rstudio_reset_user_settings(to = "bio-default")

To check, how your settings differ from the defaults in a certain list, use:

bio::rstudio_compare_user_settings(to = "bio-default")
## ℹ Show differences between current and bio-default setting lists.
## ✔ No differences

The settings that are not in the list will not be displayed. Available options of to are “bio-default” and “rstudio-default”.

Snippets

The function replaces current R code and R Markdown snippets with those in package “snippets”.

snippets::install_snippets_from_package("snippets", backup = TRUE)
## ✔ File with markdown snippets was updated:
##   'C:/Users/User/AppData/Roaming/RStudio/snippets/markdown.snippets'
## ✔ File with r snippets was updated:
##   'C:/Users/User/AppData/Roaming/RStudio/snippets/r.snippets'
##
## ℹ You will be able to use the snippets after RStudio is closed and reopened.

More information on Code Snippets in RStudio and on package snippets.

Restart R and RStudio

If you want to see the effect of changed settings, you should reload RStudio. You may use this function, which reloads RStudio without closing it:

bio::restart_rstudio()

However, in some cases it is recommended to close and reopen RStudio.

Next, to restart R session without closing RStudio, use:

bio::restart_r()

Useful to apply before trying to install R packages.

bio's People

Contributors

actions-user avatar gegznav avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar

Forkers

jimsforks

bio's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.